v2rayN · v2rayNG · v2flyNG

V2Ray 客戶端下載與設定

從訂閱匯入到路由分流,依照實際設定項目檢查連線,透過核心日誌找出故障原因。

VMessVLESSTrojanREALITY
Xray 核心V2Fly 核心
設定入口 / SETTINGS

訂閱、代理與路由設定

先確認連線在哪個環節中斷,再修改對應設定。系統代理負責接入,路由負責分流,核心負責執行;三者不能互相取代。

v2rayN / 訂閱群組
訂閱群組設定編輯 →
更新訂閱(不透過代理)直接連線取得
更新訂閱(透過代理)透過代理取得
從剪貼簿匯入多個 URL分享連結

訂閱網址用來取得伺服器設定,分享連結通常只包含單一連線資訊。先在 v2rayN 的訂閱群組設定中儲存網址,再更新訂閱;如果目前代理尚未連線,可先試試「更新訂閱(不透過代理)」。若網址只能透過代理存取,請先建立可用連線,再改用透過代理更新。相較於逐筆貼上分享連結,使用訂閱群組更方便日後更新,但無法自動修復已失效的網址。v2rayNG 可從側邊欄進入訂閱群組設定,實際操作名稱請以安裝版本的介面為準。

客戶端選擇 / CLIENTS

依作業系統選擇下載項目

桌面端使用 v2rayN,行動端可優先查看 v2rayNG;需要相容 V2Fly 設定時,再考慮 v2flyNG。安裝檔也必須符合處理器架構與系統套件格式,不必在同一台裝置上安裝所有版本。

Windows

v2rayN

提供桌面版與經典 WPF 版下載項目。桌面版採用跨平台介面,WPF 版則保留熟悉的經典桌面配置;若已有使用習慣,可先選擇相應介面,再依系統需求確認安裝條件。

首次執行時,先查看核心日誌是否正常啟動,再啟用自動設定系統代理。如果瀏覽器先前設定過手動代理或擴充功能規則,也應一併檢查,避免請求被送往舊的連接埠。

macOS

v2rayN

依晶片選擇 Apple Silicon 或 Intel 版安裝項目,可在「關於這台 Mac」查看晶片或處理器資訊。兩種架構使用不同安裝檔,不能只憑裝置外觀或購買時間判斷。

安裝後,分別確認應用程式的執行狀態與網路代理設定。若已切換 Wi-Fi、有線網路或其他網路服務,請重新檢查目前網路服務的代理選項,並確認系統設定指向正在執行的客戶端。

Android

v2rayNG / v2flyNG

優先使用以 Xray 為核心的 v2rayNG;若需要相容 V2Fly 生態系的設定,則可查看 v2flyNG 備選項目。多數新型裝置應選擇 arm64;若不確定架構,可再查看通用安裝套件說明。

啟動連線時需確認系統 VPN 授權。若切換至背景後連線中斷,請檢查電池最佳化與背景執行限制;若只有特定應用程式無法連線,先檢查個別應用程式的代理設定,不要立刻刪除訂閱再重新匯入。

Linux

v2rayN

依發行版選擇 deb 或 rpm,再確認 x64 或 arm64 架構。套件格式決定安裝方式,處理器架構則決定程式能否執行;兩者須分別確認,不能把發行版名稱當成處理器架構。

不同桌面環境與應用程式對系統代理的支援各有差異。若瀏覽器能連線、其他程式卻仍直接連線,請先檢查該程式的代理設定;圖形介面顯示已連線,不代表所有程序都使用相同的網路路徑。

首次連線 / QUICK START

匯入、接入、驗證

客戶端本身不提供遠端連線服務。開始前請準備可用的訂閱網址或分享連結,並確認來源與使用權限;只安裝軟體、沒有連線設定,無法繼續存取網路。

  1. 匯入訂閱並選擇伺服器

    桌面端請在訂閱群組設定中儲存網址,執行一次訂閱更新,再選擇要使用的伺服器。單筆分享連結可使用從剪貼簿匯入的功能。行動端也應先分清訂閱網址與單筆連結,避免貼到錯誤欄位。匯入後,請檢查協定類型與伺服器資訊是否完整;若清單為空,先查看更新日誌、確認網址是否過期,以及目前網路能否取得訂閱內容。

  2. 啟用接入方式與路由模式

    v2rayN 日常使用可先選擇「自動設定系統代理」,並以「略過中國大陸(Whitelist)」作為分流起點。v2rayNG 則需啟動連線並授予系統 VPN 權限。系統代理、VPN 接入與路由規則屬於不同層次:前兩者負責讓應用程式請求進入客戶端,路由則決定進入後使用哪個出口。先使用預設規則確認連線,再新增自訂例外,比同時修改多項設定更容易找出問題。

  3. 交叉確認連線結果與日誌

    分別造訪預期直連與預期透過代理的網站,觀察日誌是否記錄請求及選用的出口。核心已啟動只代表設定載入成功;瀏覽器能顯示網頁,也無法單獨證明所有流量都依預期分流。若沒有請求日誌,先檢查應用程式的代理入口與日誌層級;若出現連線錯誤,再確認遠端位址、協定參數與 DNS。每次只修改一項設定,並重複同一組測試,留下清楚的變更前後紀錄。

開源生態系 / PROJECT & CORE

Project V、V2Fly 與 Xray

先分清專案生態系、代理核心與圖形客戶端。名稱相近不代表設定可以直接互換;即使支援相同協定,也不代表所有擴充欄位都一致。

生態系起源

Project V / V2Ray

核心系列

V2Fly · Xray

圖形客戶端

v2rayN · v2rayNG · v2flyNG

生態系發展歷程與職責範圍

Project V 是以網路代理工具為核心的開源生態系,V2Ray 是其中的重要專案。隨著專案發展,V2Fly 社群持續維護相關核心,Xray 則發展出另一條核心演進路線。圖形客戶端在這些功能之上提供訂閱管理、伺服器選擇與設定介面。使用者看到的按鈕由客戶端負責呈現,真正建立連線及執行路由的通常是背景核心,因此介面更新不等於協定能力也同步變更。

核心系列與協定支援

VMess、VLESS、Trojan 是連線設定中常見的協定名稱;REALITY 則是安全層相關方案,並非獨立客戶端。實際設定組合也可能包含傳輸方式、伺服器名稱及其他交握參數。遇到設定不相容時,應確認客戶端能否產生相應欄位、所選核心能否讀取這些欄位,以及遠端是否使用相符設定。訂閱成功匯入,不代表特定協定組合一定可用。

三款客戶端的開源特性

v2rayN、v2rayNG、v2flyNG 都以開源專案形式提供客戶端程式,並可免費使用。v2rayN 適用於桌面環境,方便集中管理訂閱與路由;v2rayNG 主要用於 Xray 生態系設定;v2flyNG 則提供 V2Fly 路線的行動端選擇。開源代表程式碼可依各自授權條款檢視及使用,不表示所有元件都採用相同授權。V2Fly 與 Xray 核心通常採用 MPL 2.0;客戶端及其相依元件則應分別遵循各專案的聲明。

更新機制與設定保留

客戶端、核心、訂閱內容,以及 geosite、geoip 資料的更新時程各不相同。更新訂閱只會刷新伺服器設定,不會自動升級程式;更新規則資料也不等於更換核心。遇到問題時,先確認需要更新的是哪一層,再記錄目前設定與自訂規則。升級後重新測試原本的使用情境,尤其留意路由順序、監聽連接埠與協定相容性。保留可追溯的設定紀錄,比一次更新所有元件後再猜測原因更有效。

設定筆記 / FIELD NOTES

路由規則與核心日誌文章

基本連線正常後,再處理規則例外與複雜設定。以下文章依操作主題說明:先認識比對語法,再閱讀啟動日誌,最後設定中國大陸與海外網站的分流情境。遇到單一故障時,可直接前往相關主題,不必從頭修改整份設定。

Linux 企鵝圖示:Font Awesome Tux,依 CC BY 4.0 授權使用。

v2rayN 下載