Windows
v2rayN下載頁提供桌面版與經典 WPF 版。桌面版採用跨平台介面,WPF 版保留經典操作配置;兩者的選單位置可能不同,設定時請依欄位名稱對照。先在系統設定中確認裝置架構,再選擇相符的安裝檔。
已有設定時,請先備份再更換介面版本。不要同時啟動多個會接管系統代理的客戶端,否則瀏覽器可能仍連到另一個程序的本機連接埠,看起來就像訂閱無法連線。
前往下載訂閱、代理入口、路由與核心屬於不同層次的設定。先將分組內容匯入客戶端,再決定應用程式流量如何進入核心,最後檢查符合條件的規則。選單名稱可能隨介面更新略有不同,遇到差異時請依設定項目的功能判斷,不要只憑圖示位置操作。
訂閱是可重複取得設定的網址;節點則是更新後取得的單筆連線設定。在 v2rayN 中開啟「訂閱分組設定」,填入備註與網址並儲存,再執行更新訂閱。只儲存並不會自動產生節點。相較於逐筆手動新增,分組更方便統一更新來源內容;更新時也可能移除來源已刪除的項目,因此不要只把手動修改保存在訂閱項目中。網址中的存取憑證務必保密,求助時請隱藏完整連結。更新後先確認分組與協定類型,再選擇要使用的設定。
查看入門指南 →「自動設定系統代理」會將系統代理網址指向客戶端的本機監聽連接埠,適用於遵循系統代理設定的應用程式。這不代表所有程式都會經過代理,也不等於路由中的全域模式。「清除系統代理」用於撤除系統代理入口;「不變更系統代理」則會保留目前的系統設定。相較於需要額外權限的虛擬網卡接管,初次設定時使用系統代理更容易縮小排查範圍。先用一個確定遵循系統代理的應用程式測試連線,再考慮啟用其他接管方式;停止使用後,請確認系統代理設定已還原。
查看入門指南 →路由規則會處理已進入核心的請求,並依網域、目的位址等條件選擇直連、代理或阻擋。規則模式與全域模式的差異在於是否依條件分流,而不是節點協定有所變化。初次使用時,先保留客戶端的預設規則,確認連線正常後再新增自訂項目。多個條件可能互相覆蓋;若較寬泛的規則排在前面,後續更細的規則可能無法符合。網域解析也會影響位址規則的結果,因此修改路由後,應一併檢查 DNS 設定與記錄,避免同時變更多個因素。
查看入門指南 →客戶端負責介面與設定管理,核心則負責實際連線。v2rayN 可管理不同核心,但同一份設定能否執行,仍取決於協定、傳輸層與安全層是否受支援。Xray 與 V2Fly 有共同的技術背景,但功能已各自發展,不能假設設定欄位完全相容。訂閱使用 VLESS 與 REALITY 組合時,應確認所選核心支援相關功能,而不是只修改協定名稱。與其反覆更換客戶端,不如先檢查記錄中是否有不支援的欄位,更容易找出問題。切換前請保留原設定,切換後重新確認路由與 DNS 行為。
查看入門指南 →桌面端可使用 v2rayN,Android 裝置可使用 v2rayNG;在來源允許的裝置範圍內,同一份訂閱可分別匯入。訂閱通常只會同步連線項目,不會自動同步系統代理、應用程式分流、DNS 與背景執行權限。相較於直接搬移整份設定檔,重新匯入訂閱更能避免平台路徑與監聽連接埠不同所造成的問題。移轉後請逐項確認使用中的設定、路由模式與解析方式,並確認訂閱來源對裝置數量及同時連線數的限制。QR Code 與分享連結也可能包含連線憑證,請只透過可信管道傳送,截圖時勿公開完整內容。
查看入門指南 →桌面端以 v2rayN 為主,Android 端可先考慮 v2rayNG,再依核心需求選擇 v2flyNG。客戶端只是設定工具,安裝後仍需要有效的訂閱或分享連結。進入下載頁後,先確認處理器架構與安裝檔類型,再閱讀該平台的安裝說明。
下載頁提供桌面版與經典 WPF 版。桌面版採用跨平台介面,WPF 版保留經典操作配置;兩者的選單位置可能不同,設定時請依欄位名稱對照。先在系統設定中確認裝置架構,再選擇相符的安裝檔。
已有設定時,請先備份再更換介面版本。不要同時啟動多個會接管系統代理的客戶端,否則瀏覽器可能仍連到另一個程序的本機連接埠,看起來就像訂閱無法連線。
前往下載先開啟「關於這台 Mac」確認晶片類型,再選擇 Apple Silicon 或 Intel 安裝檔。安裝應用程式後,分別確認客戶端是否啟動,以及系統代理是否設定完成;應用程式視窗能開啟,不代表系統流量已經進入代理。
若系統限制開啟應用程式,請先確認取得來源與系統提示內容,再依系統提供的安全性設定處理。初次測試使用系統代理即可;虛擬網卡相關權限與分流設定,可等基本連線正常後再調整。
前往下載v2rayNG 使用 Xray 核心,v2flyNG 使用 V2Fly 核心;選擇時應考量設定相容性,不能因名稱相近就認為兩者可互換。多數新款手機適用 arm64 版本;若不確定裝置架構,請先查閱裝置資訊,再考慮通用版本。
首次連線時會出現系統 VPN 授權提示,這表示客戶端正在申請接管本機流量的權限,不代表訂閱已驗證成功。若切換至背景後連線中斷,請檢查電池最佳化、背景執行權限,以及是否有其他網路工具占用相同的系統入口。
前往下載依發行版的套件格式選擇 deb 或 rpm,再確認 x64 或 arm64 架構。下載頁會列出對應入口,圖形安裝程式可用來查看相依套件提示。安裝檔格式與處理器架構是兩項獨立條件,兩者都必須相符。
不同桌面環境讀取系統代理的方式可能不同,部分應用程式也有自己的網路設定。測試時先使用一個確定支援代理的應用程式;若該應用正常、其他應用卻失敗,應檢查應用程式的代理入口,而不是立刻更換訂閱。
前往下載初次設定時,建議每次只修改一類設定。先確認訂閱能否讀取,再檢查代理入口,最後驗證實際連線。這樣遇到問題時,才能明確判斷該回頭檢查哪一步,而不是在節點、DNS 與核心之間反覆切換。
複製訂閱來源提供的完整網址,在「訂閱分組設定」中新增分組,填入容易辨識的備註後儲存。接著執行更新,確認清單中出現連線項目。分享連結則應使用對應的剪貼簿匯入入口,不要把分享連結當成可定期更新的訂閱網址。
更新結果為空時,先確認提示是請求失敗還是解析失敗。前者優先檢查網址是否有效,以及更新時是否透過代理;後者則檢查訂閱格式與協定支援。反覆按下更新無法修復已失效的網址。
在清單中選擇準備使用的設定。桌面端先使用「自動設定系統代理」,並保留符合目前用途的預設路由;Android 端則啟動連線並完成系統授權。連線尚未確認前,不要同時加入複雜規則、修改 DNS 或切換核心。
系統代理決定應用程式是否將請求交給客戶端;路由規則則決定客戶端收到請求後使用哪個出口。請分別檢查這兩項設定。若應用程式本身設定了代理網址,也要確認本機連接埠與客戶端的監聽設定一致。
使用常用應用程式連線至明確的目標,並查看客戶端記錄是否出現連線錯誤。單次連線測試只能反映當下測試條件的結果,不能取代瀏覽器、應用程式與 DNS 的實際驗證。測試時保留原始設定,方便發現問題後還原。
若只有某個應用程式連線失敗,請檢查該應用的代理入口;若全部失敗,再檢查使用中的設定、系統時間與協定參數。離開客戶端前,視需要清除系統代理,避免應用程式繼續連線至已停止監聽的本機連接埠。
V2Ray 常被用來泛指一類工具。實際設定時,最好將其分為圖形客戶端、連線核心與協定參數三個層次。了解這三個層次,有助於判斷要下載什麼、哪些部分需要更新,以及為什麼同一份訂閱在不同裝置上的表現會不一樣。
Project V 是相關代理工具與協定生態的背景,V2Ray 是其中的重要專案。V2Fly 延續 V2Ray 的社群開發,Xray 則以相關程式碼為基礎,發展出獨立的功能路線。兩者共享部分歷史與設定概念,但不是同一核心的兩種介面名稱,也不能只憑檔名判斷功能完全相同。
在這個生態中,核心負責建立連線、處理傳輸、安全層、路由與解析;圖形客戶端則負責將這些功能整合為設定介面。遇到錯誤時,先分辨是「介面無法儲存」還是「核心無法啟動」:前者可能是輸入格式或客戶端設定問題,後者通常需要根據核心記錄檢查欄位與功能是否受支援。
v2rayN、v2rayNG 與 v2flyNG 都是開源圖形客戶端。v2rayN 適用於桌面平台,可管理訂閱、路由與不同核心;v2rayNG 在 Android 端使用 Xray 核心;v2flyNG 則提供以 V2Fly 為基礎的 Android 客戶端選擇。它們負責設定與連線管理,安裝完成後不會自動取得可用的訂閱來源。
開源代表專案程式碼依各自授權公開;使用、修改與再散布時都必須遵守相應授權。客戶端與核心可能採用不同授權,不能用單一標籤概括所有組成部分。日常設定時,更重要的是選擇來源明確的軟體套件、閱讀更新說明,並了解應用程式向系統申請的網路權限。
VMess、VLESS、Trojan 與 Shadowsocks 代表不同的協定設計;REALITY 則屬於安全層方案,不能把它們全都視為同一層級的選項。客戶端中的協定、傳輸方式與安全層,必須依服務端提供的參數搭配填寫。只把 VMess 改成 VLESS,或隨意啟用安全選項,都無法完成有效轉換。
連線體驗也會受到網路路徑、伺服器負載、傳輸設定與裝置資源影響,不能只憑協定名稱預測速度或耗電量。行動裝置還要考量背景執行與流量接管方式。選擇時先確認相容性,再於相同網路與用途下比較實際表現;若想了解設計取捨,可繼續閱讀協定詳解。
查看協定與核心選擇指南 →更新訂閱會重新讀取來源提供的設定;更新客戶端則會變更介面、管理方式,以及可能隨軟體附上的核心。兩者解決的問題不同:網址過期應向訂閱來源確認;核心不支援某項功能時,才需要檢查軟體與核心的相容範圍。重新整理分組無法補上缺少的功能,升級軟體也無法恢復已被來源撤銷的存取權限。
調整前請備份必要設定,並記錄原本的路由模式、DNS 與代理入口。更新後先確認一筆已知設定可正常使用,再逐步還原自訂選項。若需要求助,保留錯誤類型與發生步驟即可;公開截圖中不應出現完整訂閱網址、分享 QR Code、使用者識別資訊或存取憑證。
基本連線正常後,再處理具體使用問題。以下三篇文章將說明訂閱讀取、新手常見概念與 DNS 行為。排查時保留錯誤原文,並記下剛才修改過的設定,通常比反覆重新安裝更能縮小問題範圍。
從連結過期、編碼格式不相容、更新時是否使用代理,以及客戶端版本過舊四個方向列出檢查步驟,協助找出訂閱匯入後沒有節點的原因。
查看檢查清單 →整理訂閱與節點的差異、客戶端選擇、Xray 與 V2Fly 核心差別,以及全域與規則模式的適用情況,逐題提供簡明解答。
閱讀新手十問 →說明 DNS 洩漏的成因與檢測方式,逐步檢查遠端 DNS、本機 DNS 分流及 FakeIP 選項,降低查詢未經預期出口送出的情況。
閱讀 DNS 設定步驟 →