用戶端下載 · 設定文件

V2Ray文件中心v2rayN 下載與設定

從匯入訂閱開始,依平台挑選用戶端,再了解路由分流與DNS 設定。

下載平台

訂閱 → 規則 → 出站

訂閱管理與路由設定

用戶端負責整理設定,核心負責處理連線。先確認一條連線正常運作,再逐項新增規則,排查時就能找出變更來源。

訂閱分組 · 結構示意
  • 訂閱管理
    • 日常使用 啟用更新
    • 備用設定 獨立維護
伺服器篩選依備註關鍵字

先分組,再更新訂閱

多個訂閱混在同一份清單時,很難判斷伺服器來自哪裡。先在 v2rayN 中為不同來源建立獨立分組,填入訂閱網址,再執行更新;想縮小清單範圍時,可用備註關鍵字篩選。篩選只會改變顯示內容,不會修改遠端訂閱。更新前記下目前的分組與選取項目,更新後查看記錄,避免把清單為空誤認為連線失敗。相較於逐一貼上分享連結,分組更方便集中更新與還原。

訂閱網址是設定入口,請妥善保管,視為敏感資訊。 查看手冊相關章節 →

依作業系統選擇安裝檔

V2Ray 用戶端下載

桌面平台可先看 v2rayN,安卓裝置則可先看 v2rayNG。安裝檔的處理器架構必須符合裝置;同一款用戶端的不同介面或封裝方式,不代表需要重新購買或更換訂閱。

Windows

推薦 v2rayN

v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面,WPF 版則保留熟悉的經典操作配置;先依使用習慣挑選,再確認系統環境符合相應的安裝需求。

更新前請保留訂閱分組與自訂路由。若啟動異常,先檢查執行環境與解壓縮位置,別反覆覆寫設定。

macOS

v2rayN

先在系統的「關於這台 Mac」查看晶片資訊,再選擇 Apple Silicon 或 Intel 對應的 v2rayN 安裝檔。兩種架構的設定方式相同,主要差異在程式的執行環境。

安裝後先完成系統要求的授權,再測試系統代理。如果已安裝其他代理工具,請先關閉可能衝突的程式,避免多處設定互相覆蓋。

Android

推薦 v2rayNG

v2rayNG 使用 Xray 核心,適合作為安卓端的優先選擇;需要 V2Fly 核心環境時,可參考 v2flyNG。近年推出的多數裝置可選 arm64;不確定架構時,再了解通用版。

首次啟動連線時,需確認 VPN 授權。切換用戶端前先中斷原有連線,並檢查系統的背景執行限制,避免把授權或休眠問題誤當成伺服器故障。

Linux

v2rayN

依發行版選擇 deb 或 rpm,再確認 x64 或 arm64 架構。先使用桌面介面匯入訂閱並測試連線,確認基本設定有效後,再考慮虛擬網路介面的相關設定。

桌面系統代理與終端機環境變數是兩種不同的連線入口。瀏覽器正常但命令列異常時,應分開檢查,不必直接重裝用戶端或更換訂閱。

首次設定順序

v2rayN 訂閱匯入與連線

這三個步驟能先建立容易驗證的基本狀態。桌面端使用 v2rayN、安卓端使用 v2rayNG 時,選單名稱可能不同,但匯入設定、選擇連線入口及檢查結果的順序可以相同。

  1. 建立分組並匯入訂閱

    在訂閱設定中新增分組,取一個方便辨認來源的名稱,再貼上完整訂閱網址並更新。分享連結通常對應單一伺服器,訂閱連結則用來批次取得設定,不能只靠網址長度判斷格式。匯入後先檢查伺服器清單與更新記錄,確認沒有多貼空格、網址遭截斷,或誤把網頁網址當成訂閱網址。

    訂閱通常包含存取憑證。排查問題時,只分享已移除敏感內容的錯誤訊息,請勿公開完整連結或 QR 碼。

  2. 選擇伺服器並啟用連線入口

    選取一筆伺服器設定,先保留容易理解的基本路由。在 v2rayN 中啟用系統代理,讓遵循系統代理設定的瀏覽器透過用戶端連線;在 v2rayNG 中啟動連線並確認系統授權。暫時不要同時啟用多個代理程式,也不要一次變更 TUN、DNS 與路由,以免發生問題後無法判斷原因。

    「用戶端已啟動」只代表程式正在執行,不代表每個應用程式都已使用代理;仍需另外確認連線入口設定。

  3. 檢查網頁、記錄與直連範圍

    先開啟平常使用的網站,再查看用戶端記錄是否有連線或解析錯誤,同時確認區域網路裝置仍可存取。如果只有某個應用程式異常,檢查它是否遵循系統代理;如果所有要求都失敗,再檢查訂閱是否有效、伺服器設定及網路狀態。成功測試一次後,再逐項加入細分路由並記錄變更。

    停止使用時,請還原不再需要的系統代理設定,避免用戶端關閉後,應用程式仍向已關閉的本機連接埠傳送要求。

Project V · V2Fly · Xray

V2Ray 核心與開源用戶端

挑選時先釐清三個層次:協定描述通訊方式,核心負責執行連線與路由,圖形化用戶端則將這些功能整理成可操作的介面。名稱相近,不代表功能範圍與設定格式完全相同。

專案背景

Project V

V2Ray 的專案體系與模組化設計

V2Fly

由社群維護的 V2Ray 核心體系

v2flyNG

Xray

由 V2Ray 發展而來的獨立核心分支

v2rayNG

v2rayN 可管理不同核心,實際支援範圍須以所選核心與設定為準。

Project V 的模組化背景

V2Ray 是 Project V 體系中的網路代理工具,其設定將入站、出站、路由與 DNS 等功能分開管理。圖形化用戶端雖將常用設定放入選單,這些層次仍然存在。了解其結構後,就能分辨「應用程式未連上本機入口」與「要求進入核心後選錯出站」,不再把所有連線問題都歸咎於伺服器無法使用。

V2Fly 與 Xray 的關係

V2Fly 延續 V2Ray 的社群維護,Xray 則從 V2Ray 發展而來,並朝獨立方向演進。兩者共享部分概念與歷史基礎,但協定功能、欄位支援及預設行為可能不同。看到某種協定名稱時,也要確認具體傳輸方式、安全設定與核心支援情況,不能直接把一個核心的完整設定當成另一個核心通用的設定。

三款用戶端的開源狀態

v2rayN、v2rayNG 與 v2flyNG 都是開源圖形化用戶端。v2rayN 主要用於桌面操作與設定管理;v2rayNG 和 v2flyNG 則面向安卓裝置,採用不同的核心架構。開源授權規定程式碼的使用、修改與散布條件,詳情請以各專案的授權條款為準;用戶端採用開源程式碼,不代表伺服器營運、訂閱服務與用戶端專案屬於同一個組織。

用戶端更新與訂閱更新

更新用戶端是更換程式,更新訂閱則是重新取得伺服器設定,兩者解決的問題不同。若遇到協定功能不足,可能需要檢查用戶端與核心;若訂閱項目有所變動,應先查看訂閱更新記錄。更新前保留自訂規則,更新後重新確認系統代理與權限。別只因介面出現新選項就全部啟用;穩定的設定應清楚說明每個開關的用途。

用戶端不會提供伺服器資源。安裝程式後仍須匯入有權使用的設定;訂閱有效期限、服務範圍與帳號狀態由訂閱來源決定。本網站文件著重於用戶端操作與設定概念,挑選前可先閱讀三款用戶端評測比較,遇到陌生名詞再查閱名詞解釋。

設定實作與故障排除

V2Ray 用戶端使用指南

完成基本設定後,可依照遇到的症狀查找文章。啟動失敗、系統代理無效與核心挑選是不同問題:先確認故障發生在哪個環節,再選擇相應的排查方式,比一次更換所有設定更容易找到原因。