Windows
v2rayN提供桌面版與經典 WPF 版下載項目。桌面版採用跨平台介面,WPF 版則保留熟悉的經典桌面配置;若已有使用習慣,可先選擇相應介面,再依系統需求確認安裝條件。
首次執行時,先查看核心日誌是否正常啟動,再啟用自動設定系統代理。如果瀏覽器先前設定過手動代理或擴充功能規則,也應一併檢查,避免請求被送往舊的連接埠。
| outboundTag | 類型 | 規則內容 |
|---|---|---|
| proxy | domain | geosite:geolocation-!cn |
| direct | domain | geosite:cn |
| direct | ip | geoip:private, geoip:cn |
| block | domain | geosite:category-ads-all |
Xray[Info] app/dispatcher: default route for tcp:www.example.com:443
core: Xray started
先確認連線在哪個環節中斷,再修改對應設定。系統代理負責接入,路由負責分流,核心負責執行;三者不能互相取代。
訂閱網址用來取得伺服器設定,分享連結通常只包含單一連線資訊。先在 v2rayN 的訂閱群組設定中儲存網址,再更新訂閱;如果目前代理尚未連線,可先試試「更新訂閱(不透過代理)」。若網址只能透過代理存取,請先建立可用連線,再改用透過代理更新。相較於逐筆貼上分享連結,使用訂閱群組更方便日後更新,但無法自動修復已失效的網址。v2rayNG 可從側邊欄進入訂閱群組設定,實際操作名稱請以安裝版本的介面為準。
geosite:cndirectgeoip:privatedirectgeosite:geolocation-!cnproxy路由模式會決定已進入核心的請求要交由哪個出口處理。日常分流可先選擇「略過中國大陸(Whitelist)」,再依日誌新增特定網域規則。Xray 會依規則順序比對,範圍較明確的例外通常應排在通用規則之前;domain 與 ip 條件的意義也不同。相較於全域模式,分流可保留區域網路及指定網站的直連路徑,但前提是網域、位址與資料檔案設定正確。修改後請儲存並重新載入設定,再測試目標網站;不要只看模式名稱就判斷實際出口。
瀏覽器無法開啟網頁時,先確認核心是否已啟動,以及瀏覽器是否使用代理。v2rayN 的「自動設定系統代理」會設定系統代理入口,支援此設定的應用程式才會將請求送入客戶端。「不變更系統代理」只會保留目前狀態,並不代表已啟用代理;「清除系統代理」則會移除相關系統設定。相較於 TUN 接管,系統代理的影響範圍較明確,但部分應用程式仍需個別設定。排查時先暫停其他代理工具,再確認本機監聽連接埠與瀏覽器擴充功能,避免兩組設定互相覆蓋。
客戶端介面負責產生設定,實際協定處理由核心執行。若出現不支援欄位、無法載入傳輸設定等錯誤,應先確認該協定是否相容於目前使用的核心,而不是反覆切換系統代理模式。v2rayN 可依伺服器類型與可用核心產生設定;v2rayNG 主要使用 Xray 核心,v2flyNG 則適用於 V2Fly 生態系的設定。相較於單純更換客戶端,確認核心與設定的對應關係,更能縮小問題範圍。使用 REALITY 等選項時,也要逐項比對伺服器端參數;切換核心本身無法補上缺少的資訊。
跨裝置使用時,適合沿用的是訂閱來源與協定參數,而不是直接覆寫整個客戶端設定資料夾。桌面端的本機連接埠、檔案路徑及系統代理設定,與行動裝置的 VPN 授權及應用程式分流並不相同。先在另一台裝置匯入相同訂閱,確認節點可連線後,再逐條遷移自訂規則;原生 JSON 設定也要確認核心與入站設定。相較於複製整個資料夾,分層遷移更容易找出差異。訂閱網址可能包含存取憑證,請透過可信管道傳送;截圖、提問或匯出日誌時,也應遮蔽敏感內容。
桌面端使用 v2rayN,行動端可優先查看 v2rayNG;需要相容 V2Fly 設定時,再考慮 v2flyNG。安裝檔也必須符合處理器架構與系統套件格式,不必在同一台裝置上安裝所有版本。
提供桌面版與經典 WPF 版下載項目。桌面版採用跨平台介面,WPF 版則保留熟悉的經典桌面配置;若已有使用習慣,可先選擇相應介面,再依系統需求確認安裝條件。
首次執行時,先查看核心日誌是否正常啟動,再啟用自動設定系統代理。如果瀏覽器先前設定過手動代理或擴充功能規則,也應一併檢查,避免請求被送往舊的連接埠。
依晶片選擇 Apple Silicon 或 Intel 版安裝項目,可在「關於這台 Mac」查看晶片或處理器資訊。兩種架構使用不同安裝檔,不能只憑裝置外觀或購買時間判斷。
安裝後,分別確認應用程式的執行狀態與網路代理設定。若已切換 Wi-Fi、有線網路或其他網路服務,請重新檢查目前網路服務的代理選項,並確認系統設定指向正在執行的客戶端。
優先使用以 Xray 為核心的 v2rayNG;若需要相容 V2Fly 生態系的設定,則可查看 v2flyNG 備選項目。多數新型裝置應選擇 arm64;若不確定架構,可再查看通用安裝套件說明。
啟動連線時需確認系統 VPN 授權。若切換至背景後連線中斷,請檢查電池最佳化與背景執行限制;若只有特定應用程式無法連線,先檢查個別應用程式的代理設定,不要立刻刪除訂閱再重新匯入。
依發行版選擇 deb 或 rpm,再確認 x64 或 arm64 架構。套件格式決定安裝方式,處理器架構則決定程式能否執行;兩者須分別確認,不能把發行版名稱當成處理器架構。
不同桌面環境與應用程式對系統代理的支援各有差異。若瀏覽器能連線、其他程式卻仍直接連線,請先檢查該程式的代理設定;圖形介面顯示已連線,不代表所有程序都使用相同的網路路徑。
客戶端本身不提供遠端連線服務。開始前請準備可用的訂閱網址或分享連結,並確認來源與使用權限;只安裝軟體、沒有連線設定,無法繼續存取網路。
桌面端請在訂閱群組設定中儲存網址,執行一次訂閱更新,再選擇要使用的伺服器。單筆分享連結可使用從剪貼簿匯入的功能。行動端也應先分清訂閱網址與單筆連結,避免貼到錯誤欄位。匯入後,請檢查協定類型與伺服器資訊是否完整;若清單為空,先查看更新日誌、確認網址是否過期,以及目前網路能否取得訂閱內容。
v2rayN 日常使用可先選擇「自動設定系統代理」,並以「略過中國大陸(Whitelist)」作為分流起點。v2rayNG 則需啟動連線並授予系統 VPN 權限。系統代理、VPN 接入與路由規則屬於不同層次:前兩者負責讓應用程式請求進入客戶端,路由則決定進入後使用哪個出口。先使用預設規則確認連線,再新增自訂例外,比同時修改多項設定更容易找出問題。
分別造訪預期直連與預期透過代理的網站,觀察日誌是否記錄請求及選用的出口。核心已啟動只代表設定載入成功;瀏覽器能顯示網頁,也無法單獨證明所有流量都依預期分流。若沒有請求日誌,先檢查應用程式的代理入口與日誌層級;若出現連線錯誤,再確認遠端位址、協定參數與 DNS。每次只修改一項設定,並重複同一組測試,留下清楚的變更前後紀錄。
先分清專案生態系、代理核心與圖形客戶端。名稱相近不代表設定可以直接互換;即使支援相同協定,也不代表所有擴充欄位都一致。
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 資料的更新時程各不相同。更新訂閱只會刷新伺服器設定,不會自動升級程式;更新規則資料也不等於更換核心。遇到問題時,先確認需要更新的是哪一層,再記錄目前設定與自訂規則。升級後重新測試原本的使用情境,尤其留意路由順序、監聽連接埠與協定相容性。保留可追溯的設定紀錄,比一次更新所有元件後再猜測原因更有效。
基本連線正常後,再處理規則例外與複雜設定。以下文章依操作主題說明:先認識比對語法,再閱讀啟動日誌,最後設定中國大陸與海外網站的分流情境。遇到單一故障時,可直接前往相關主題,不必從頭修改整份設定。
拆解 domain:、full:、regexp:、geosite:、geoip: 的比對範圍,了解規則為何依序由上而下生效。要為指定網站新增例外時,先檢查是否已被前面的通用規則比對,再調整規則位置。
將啟動失敗分為連接埠被占用、設定語法錯誤、未知欄位與規則資料缺漏等類型。先找出日誌中的第一個關鍵錯誤,再檢查對應設定,避免把後續連帶錯誤當成獨立故障。
以略過中國大陸規則集為起點,說明 direct、proxy、block 三種出口如何搭配。修改後請搭配目標網站與日誌確認結果,也要檢查區域網路存取及廣告網域規則是否符合預期。