Windows
v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面,WPF 版保留熟悉的經典版面,兩者都能管理訂閱與路由。
安裝前先在系統設定中確認處理器類型。若出現執行階段套件提示,請依對應的安裝說明處理,不必反覆更換訂閱;程式無法啟動與訂閱是否可用是兩回事。
前往下載 Windows 用戶端→桌面端可選 v2rayN,Android 端建議先了解 v2rayNG。進入下載頁後,再依處理器架構與安裝套件類型選擇。
v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面,WPF 版保留熟悉的經典版面,兩者都能管理訂閱與路由。
安裝前先在系統設定中確認處理器類型。若出現執行階段套件提示,請依對應的安裝說明處理,不必反覆更換訂閱;程式無法啟動與訂閱是否可用是兩回事。
前往下載 Windows 用戶端→選擇 v2rayN,並依「關於這台 Mac」顯示的晶片資訊,區分 Apple Silicon 與 Intel 安裝套件。安裝套件架構應與電腦晶片相符,比依外觀判斷更可靠。
首次開啟時若出現系統安全性提示,請先確認軟體來源與提示內容,再依系統提供的方式處理。完成設定後,檢查系統代理是否生效;需要管理員權限的功能則另行授權。
前往下載 macOS 用戶端→建議優先選用採用 Xray 核心的 v2rayNG;若需要 V2Fly 核心,可了解 v2flyNG。近年多數主流手機採用 arm64;無法確認架構時,請查看通用版說明。
Android 會透過 VPN 介面接管連線,首次啟動時需要確認系統授權。若切換到背景後連線中斷,請檢查電池最佳化與背景執行限制,不要直接把所有問題都歸咎於訂閱格式。
前往下載 Android 用戶端→v2rayN 提供 deb 與 rpm 安裝套件,並分為 x64、arm64 架構。先確認 Linux 發行版的套件格式,再選擇相符的架構,避免混淆安裝格式與處理器類型。
不同桌面環境讀取系統代理的方式可能不同。若瀏覽器能連線、其他程式卻不行,請先確認該程式是否遵循桌面代理設定;需要接管更多連線時,再閱讀 TUN 設定章節。
前往下載 Linux 用戶端→用戶端負責讀取設定並建立連線,安裝程式本身不會提供可連線的伺服器參數。請先備妥可信來源的訂閱網址或分享連結,再匯入設定。更換電腦或手機時,也應重新確認協定支援與匯入結果,不要只因用戶端名稱相似,就直接沿用所有設定。
查看所有用戶端 →將設定拆成四個環節:先確認內容已匯入,再決定哪些程式使用代理,以及連線進入核心後如何分流。
訂閱網址是取得一組設定的入口,不是用來在瀏覽器開啟一般網頁的連結。在 v2rayN 的訂閱群組設定中填入備註與網址,儲存後執行更新;Android 端則從訂閱群組選單新增。群組能將不同來源的設定分開,之後更新時也更容易確認影響範圍。相較於一次貼上單一分享連結,訂閱能保留再次取得設定的管道。更新失敗時,先檢查網址是否完整或已失效,再分辨是取得失敗還是解析失敗,避免重複建立同名群組。
路由分流會決定進入核心的連線使用哪個出站。可依網域、IP 或規則集進行比對,再交由 direct、proxy 或 block 處理;這些名稱必須對應實際設定中的出站標籤。規則通常由上而下判斷,較具體的條件應排在較廣泛的條件之前。相較於將所有連線交給同一個出站,分流能保留區域網路存取並細分處理範圍。調整時一次只改一類規則,並查看記錄確認命中結果;規則集缺漏或解析策略不同,都可能導致非預期的比對結果。
系統代理會讓遵循該設定的應用程式,將連線交給本機代理入口。v2rayN 的「自動設定系統代理」會寫入這一層設定,但不代表所有程式都會接入,也不等同於路由中的全域代理。相較於在每個應用程式中手動填入位址,這種方式更適合用來先確認瀏覽器能否連線。若瀏覽器可用、其他應用程式卻失敗,應檢查後者的代理行為,而不是立刻重新安裝用戶端。離開前可清除系統代理,避免程式關閉後,系統仍指向未在監聽的本機連接埠。
TUN 透過虛擬網路介面接管連線,適合處理不遵循系統代理設定的程式。它與路由分流位於不同層次:前者負責接入,後者決定出站。相較於只設定系統代理,TUN 涉及更多系統權限、路由與 DNS 行為,也需要留意其他 VPN 或虛擬網卡的影響。建議先在一般代理模式下確認同一份設定能正常連線,再啟用 TUN;若發生異常,可關閉新增的接管功能進行對照,分別檢查權限、網卡與解析記錄,不要同時更換訂閱和規則。
以上為設定項目與規則語意示意,並非可直接匯入的完整設定。詳細操作順序請見入門教學 →
先分清用戶端、核心與協定。三者屬於不同層次,介面相似不代表所有設定都能互換。
Project V 是理解 V2Ray 技術生態的起點。V2Ray 將入口、出站、傳輸、路由與解析等功能拆分為可設定的模組;圖形用戶端則在這些功能之上,提供訂閱管理、模式切換與記錄檢視等操作入口。因此,「用戶端已安裝完成」和「已具備可用設定」是兩回事。用戶端能啟動,只代表程式可以執行;要實際連線,還需要完整的伺服器參數、相符的協定與正確的網路接入方式。
V2Fly 延續 V2Ray 相關專案的社群開發,Xray 則是從相關程式碼基礎發展而來的另一條核心路線。兩者有共同的技術背景,也各自持續演進。閱讀教學時,應同時確認用戶端名稱與實際使用的核心;看到某個協定名稱,不能直接推斷所有擴充參數都受到支援。伺服器提供的設定需求,應逐項對照用戶端目前可呼叫的核心功能。
v2rayN 適用於桌面環境,可透過圖形介面管理訂閱群組、系統代理與路由設定。桌面使用者可以先熟悉同一款用戶端的操作方式,再依作業系統選擇對應的安裝套件。由於它涵蓋 Xray、V2Fly 等核心生態,因此必須分別理解「介面程式」與「實際負責連線的核心」;可選核心與功能應以使用的發行套件及介面選項為準,不要直接套用其他平台截圖中的功能。
v2rayNG 是 Android 上常用的開源用戶端,採用 Xray 核心。Android 系統透過 VPN 授權提供接管連線的入口,因此啟動方式與桌面端的系統代理選單不同。v2flyNG 則提供採用 V2Fly 核心的 Android 選擇。兩者名稱相近,但選擇時應依現有設定需要的核心路線判斷,不要把其中一款當成另一款的通用修復工具。更換用戶端前,先確認設定欄位與協定特性是否相容。
| 用戶端 | 主要用途 | 優先確認事項 |
|---|---|---|
| v2rayN | 桌面圖形介面設定與訂閱管理 | 安裝套件架構、執行環境、實際使用的核心 |
| v2rayNG | Android 端 Xray 設定 | 協定支援、VPN 授權、背景執行限制 |
| v2flyNG | Android 端 V2Fly 設定 | 核心相容性、匯入欄位、系統權限 |
這三款用戶端都屬於開源軟體,公開原始碼與授權條款讓使用者能了解軟體的實作方式與使用條件。生態系中的不同專案可能採用不同授權,修改、重新散布或引用程式碼時,應分別閱讀各專案的授權要求。開源描述的是軟體的開發與授權方式,不代表任何來源的訂閱或伺服器都值得信任,也不表示連線記錄、服務品質或可用範圍由用戶端專案負責。
訂閱網址常包含可識別使用者的參數,應視為敏感設定妥善保存。向他人求助時,可以保留錯誤類型、用戶端名稱與相關設定項目,但務必遮蔽完整網址、身分欄位及認證內容。匯入來源不明的設定前,也要留意其中是否包含額外的路由或 DNS 設定。了解這些界線,比只根據介面顯示「執行中」就判斷連線是否符合預期更有幫助。
軟體更新會變更用戶端程式及其配套元件;訂閱更新會重新取得遠端提供的連線設定;規則更新則可能改變網域與 IP 的比對清單。這三者並非同一項操作。舊網址失效時,更新軟體未必能解決問題;新協定參數無法解析時,反覆重新整理訂閱也可能無濟於事。先判斷變化發生在哪個層次,再決定更新項目,才能降低重複操作與設定遺失的風險。
準備升級前,先記下目前正常運作的代理模式、路由方案與必要的自訂設定,並依用戶端提供的方式儲存設定。升級後使用同一份已知可用的設定進行比對,確認程式能啟動、訂閱可讀取且基本連線正常,再恢復其他功能。不要同時更換核心、匯入陌生規則並啟用 TUN;一次變更多個條件後,即使發生問題,也很難從記錄判斷是哪一項造成的。
第一次設定建議依序進行:先安裝能正常啟動的用戶端,再新增訂閱群組並更新內容,接著選擇要使用的設定,最後啟用適合目前系統的接管方式。桌面端可以先使用系統代理;Android 端則先確認 VPN 授權。完成後,開啟實際需要使用的應用程式,確認連線是否成功,並查看用戶端記錄,確認確實有連線進入。狀態列顯示正在執行,不能取代實際應用程式的連線測試。
若無法連線,先判斷是所有應用程式都失敗,還是只有某一個失敗;接著確認是網域解析失敗、連線逾時,還是伺服器拒絕。若瀏覽器可用、其他程式卻不行,優先檢查接管範圍;訂閱清單為空,優先檢查取得與解析流程;只有特定網域異常,再檢查路由順序與 DNS。依照現象逐步縮小範圍,通常比直接重新安裝更能保留線索。想按階段學習,可繼續閱讀V2Ray 系統教學。
不相同。訂閱網址應儲存在訂閱群組中,再執行更新;單一分享連結通常透過剪貼簿匯入等方式新增。先確認手上的內容類型,再依入門教學操作,避免把訂閱網址當成單一設定匯入。
兩者需要分開理解。系統代理決定支援此設定的應用程式如何連上本機代理;路由規則則決定連線進入核心後使用哪個出站。啟用系統代理不會取代路由規則,設定順序可繼續參考教學。
更新成功只代表設定已取得並完成解析,不代表伺服器一定能連線。請繼續確認目前選用的設定、系統接管方式與記錄中的錯誤,再檢查伺服器參數和網路狀況。依照連線確認步驟逐項判斷問題所在的層次。
桌面端建議先使用一般代理方式確認基本連線,再依應用程式需求決定是否啟用 TUN。這樣能將設定本身的問題,與虛擬網卡、權限或系統路由問題區分開來。具體操作請從基礎教學開始。
近期文章聚焦於具體問題:先找到操作入口,再了解設定結構;遇到啟動異常時,依執行環境逐項排查。
分別標示 v2rayN 訂閱群組設定與 v2rayNG 訂閱群組選單的位置,說明 Base64 訂閱與純文字連結清單的格式差異,以及訂閱更新失敗的常見原因。
閱讀文章 →透過一份精簡的範例設定,逐段說明 log、inbounds、outbounds、routing、dns 各欄位的用途,協助理解用戶端匯出的完整設定與連線處理順序。
閱讀文章 →從執行階段套件、核心遭封鎖、資料夾寫入權限,到 Android VPN 授權與電池最佳化,依常見原因列出檢查順序。先確認程式在哪個步驟退出,再採取相應的處理方式。
閱讀文章 →