Windows
v2rayN · 桌面版 / 經典 WPF 版
桌面版採用跨平台介面,WPF 版則保留經典桌面配置。選擇前先確認作業系統與處理器需求,再依使用習慣決定介面,不必同時安裝兩種介面才能開始設定。初次使用可先熟悉「伺服器」、「訂閱分組」與底部的系統代理入口,確認目前使用的伺服器後再連線。
從其他資料夾遷移時,請先在客戶端內備份設定;不要直接覆蓋正在執行的程式資料夾。若首次啟動時出現權限或執行環境提示,請依下載頁的套件說明處理,再檢查記錄,避免將啟動問題誤認為訂閱失效。
前往下載依裝置選擇開源客戶端,從匯入訂閱到路由分流,依照實際選單逐項設定。
先釐清三個部分:客戶端管理設定,核心處理連線,路由決定流量走向。
設定導覽
訂閱更新成功,只代表伺服器設定已匯入;應用程式是否使用代理,還取決於目前選取的伺服器、路由預設與流量接入方式。請沿著左側導覽檢視各項設定,先確認基本連線,再依需求設定 TUN、DNS 與自訂規則。不同版本的選單位置可能略有差異,請以客戶端實際顯示為準。
訂閱分組
訂閱分組可將不同來源的伺服器分開管理,適合同時保留工作、測試等設定。前往「訂閱分組設定」新增名稱與訂閱網址,再執行相應的更新訂閱操作。更新後先確認目前的分組篩選條件,避免誤以為清單空白就是匯入失敗。若直接連線更新失敗,可在已有可用連線的情況下改用代理更新。訂閱網址可能包含帳戶憑證,請勿放入截圖或公開記錄;刪除單一伺服器不代表取消訂閱,下次更新時它可能再次出現。
查看教學 →路由預設示意
路由分流會決定送入核心的請求要透過代理、直接連線或封鎖。先在路由設定中選擇預設,再依需求補上網域、位址或連接埠規則,比直接堆疊大量規則更容易排查。「略過中國大陸」需要相應的網域與位址資料,並不等於依應用程式分流;「全域」也只會影響已送入核心的流量。自訂規則通常依序比對,應將較明確的例外規則排在較廣泛的規則之前。修改後以相同目標重新測試,並查看記錄確認實際使用的出口。
查看教學 →流量接入方式
TUN 透過虛擬網路介面接收流量,適合處理不讀取系統代理設定的應用程式,但不建議一開始就啟用。先確認一般代理連線正常,再檢查執行權限、虛擬介面與其他網路工具是否衝突,最後開啟「啟用 Tun 模式」。啟用後仍由路由規則決定流量出口,並非所有連線都必須走代理。若發生斷線,先關閉 TUN 恢復網路,再依序檢查路由、DNS 與介面狀態。切換網路後也應重新測試,避免一次更動多項設定。
查看教學 →伺服器清單 · 右鍵選單
真實連線測試會透過伺服器連線至測試目標,比單純查看網路往返時間更貼近實際使用情況。選取伺服器後,在右鍵選單中執行真實連線延遲測試,優先確認連線是否成功,再比較相同網路下的多次結果。單次逾時可能是測試目標、網域解析或網路暫時不穩所致,不能直接判定設定失效。延遲也不等於下載頻寬;選定目前使用的伺服器後,還要用瀏覽器測試連線,並確認系統代理狀態符合目前的使用方式。
查看教學 →核心選擇
客戶端介面與代理核心屬於不同層次。v2rayN 可管理多種核心,但實際可選項目取決於版本與伺服器協定;切換核心並非通用的修復方式。在參數設定或核心設定中確認選項前,先查看目前伺服器使用的協定、傳輸方式與安全選項,再確認目標核心是否支援。切換後重新載入設定並查看啟動記錄;若出現未知欄位或不支援的傳輸方式,應從設定相容性著手排查。兩款行動裝置客戶端則各有不同的核心選擇方式。
查看教學 →系統代理選單
系統代理會將遵循系統設定的應用程式請求送至本機代理連接埠;路由模式則決定核心收到請求後如何處理。選好目前使用的伺服器後,可選擇「自動設定系統代理」,再用瀏覽器確認連線。若應用程式忽略系統代理,仍需在應用程式內指定代理,或評估是否使用 TUN。結束使用後若無法正常連線,先檢查系統是否仍保留指向本機連接埠的代理設定,再執行「清除系統代理」。同時執行多個代理工具容易互相覆寫設定,排查時應只保留一個接管流量的入口。
查看教學 →平台下載入口
桌面裝置可先選 v2rayN,Android 裝置優先考慮 v2rayNG;需要 V2Fly 核心時,可選 v2flyNG。安裝套件的處理器架構須符合裝置規格;同一客戶端的不同套件類型並不代表不同訂閱服務。以下連結會直接開啟下載頁的對應平台區塊,套件類型、系統需求與安裝說明都可在該頁查閱。
v2rayN · 桌面版 / 經典 WPF 版
桌面版採用跨平台介面,WPF 版則保留經典桌面配置。選擇前先確認作業系統與處理器需求,再依使用習慣決定介面,不必同時安裝兩種介面才能開始設定。初次使用可先熟悉「伺服器」、「訂閱分組」與底部的系統代理入口,確認目前使用的伺服器後再連線。
從其他資料夾遷移時,請先在客戶端內備份設定;不要直接覆蓋正在執行的程式資料夾。若首次啟動時出現權限或執行環境提示,請依下載頁的套件說明處理,再檢查記錄,避免將啟動問題誤認為訂閱失效。
前往下載v2rayN · Apple Silicon / Intel
先開啟系統的「關於這台 Mac」確認晶片:Apple Silicon 請選 arm64,Intel 請選 x64。安裝後先以一般權限完成訂閱匯入與基本連線驗證;需要使用 TUN 時,再依提示處理相關權限。架構不相符造成的啟動異常,與伺服器設定沒有直接關係。
系統代理的生效範圍取決於應用程式是否遵循系統設定。若瀏覽器可正常連線,但其他應用程式仍無法使用,先檢查該應用程式內的網路選項,不要立刻重設所有路由。若出現系統安全性提示,應先確認安裝來源與提示內容,不建議直接關閉整套系統防護。
前往下載優先選 v2rayNG · v2flyNG 為替代選擇
v2rayNG 使用 Xray 核心,v2flyNG 則提供 V2Fly 核心選項。較新的主流手機通常適用 arm64;若不確定裝置架構,先查看裝置資訊,再考慮通用套件。匯入訂閱後選擇一筆設定,點選連線按鈕,並依系統提示允許建立 VPN 連線。
Android 的 VPN 連線與桌面系統代理並不是同一項設定。連線可能受到其他 VPN 應用程式、背景執行限制與依應用程式代理設定影響。若鎖定螢幕後連線中斷,優先檢查背景執行策略;若只有少數應用程式無法連線,先確認依應用程式代理清單,不要反覆刪除訂閱並重新安裝。
前往下載v2rayN · deb / rpm
依發行版的套件管理系統選擇 deb 或 rpm,再確認架構是 x64 或 arm64。完成圖形介面安裝後,先確認客戶端能否啟動、核心是否成功載入,再匯入設定。桌面環境中的代理設定位置可能不同,不能只因客戶端已執行,就認定所有應用程式都已接入。
需要使用 TUN 時,應另外確認權限、虛擬網路介面與現有網路管理工具是否相容。公司網路、容器或虛擬機環境也可能有額外路由,變更前請先記錄目前狀態。先使用系統代理完成基本驗證,再逐步擴大流量接管範圍,較容易保留可復原的設定。
前往下載客戶端負責讀取設定並接入流量,連線參數需另外準備。本網站整理客戶端下載入口與操作說明,不提供訂閱服務。
查看所有客戶端 →開源生態系
V2Ray 源自 Project V 的模組化代理工具體系。要了解這段背景,首先須區分圖形客戶端與核心:視窗中的伺服器清單、訂閱管理及選單屬於客戶端;協定處理、路由比對與連線出口主要由核心負責。客戶端會將介面上的選項轉換成核心可讀取的設定,再負責啟動及管理相關程序。
V2Fly 延續 V2Ray 的社群維護路線,Xray 則是在相關技術基礎上發展出的另一條核心路線。兩者的設定概念與部分協定有共同基礎,但功能演進、欄位要求與傳輸方式支援並不完全相同。即使看到相同的協定名稱,也應進一步確認安全層、傳輸方式及具體選項,不能只更改核心名稱就認定設定可直接互換。
因此,選擇客戶端時應先釐清兩件事:裝置適合哪種圖形介面,以及現有連線參數需要哪些核心功能。桌面裝置可在 v2rayN 的核心設定中確認支援範圍;行動裝置則可透過 v2rayNG 或 v2flyNG 選擇相應的核心。核心家族不是速度排名,實際體驗也會受到網路環境、伺服器狀態、DNS 與路由設定影響。
查看協定與核心術語 →v2rayN、v2rayNG 與 v2flyNG 都是程式碼開源的圖形客戶端,但並非同一個程式的不同外觀。v2rayN 面向桌面裝置,集中管理伺服器、訂閱與執行設定;v2rayNG 將 Xray 的連線功能整合至 Android 網路介面;v2flyNG 則適合需要 V2Fly 核心的行動裝置設定。操作方式可以互相參考,但選單與欄位仍應分別確認。
開源授權規範程式碼的使用、修改與散布條件。v2rayN 與 v2rayNG 的客戶端程式碼採用 GPL 系列授權,v2flyNG 的客戶端程式碼也採用 GPL 系列授權;呼叫的核心與隨附相依套件則依各自授權散布。V2Fly 的 V2Ray 核心採用 MIT 授權,Xray 核心採用 MPL 系列授權,不能將客戶端的授權名稱直接套用到所有組成部分。
開源不代表安裝後就不需要設定或維護。客戶端只能使用實際取得的連線參數,無法取代伺服器端設定,也不能保證任何訂閱都能使用。遇到異常時,先判斷問題出在匯入、啟動、流量接入或目標連線哪個環節,再檢查對應設定,通常比只看客戶端名稱反覆切換更有效。本網站的關於頁面說明了內容範圍與維護原則。
客戶端更新主要涉及介面、設定管理與程式修正;核心更新會影響協定實作與連線行為;GeoIP、GeoSite 等規則資料更新則會影響位址或網域集合的比對。這三類內容不必採用相同的更新週期。下載新版客戶端不代表舊規則資料也已同步更新;更新訂閱只是重新取得伺服器設定,不會自動解決本機監聽連接埠被占用的問題。
更新前先使用客戶端提供的備份或匯出功能保存設定,並記下目前使用的伺服器、路由預設、系統代理狀態及自訂規則。更新後先重新測試一筆原本可用的連線,再檢查分流與 DNS;若啟動失敗,先查看記錄中最早出現的錯誤。連接埠遭占用、權限不足與設定欄位不相容需要不同的處理方式,不應一概歸因於網路波動。若涉及規則資料庫,可參考GeoIP 與 GeoSite 更新說明。
「已連線」通常只表示本機代理或網路介面已啟動,不一定代表所有目標都能連線。瀏覽器無法連線時,先確認目前使用的伺服器與真實連線測試結果,再確認應用程式是否讀取系統代理;若只有部分網域異常,再檢查 DNS、規則順序與對應出口。桌面客戶端結束後仍無法瀏覽一般網頁,應檢查系統是否仍保留指向本機連接埠的代理設定。
行動裝置鎖定螢幕後連線中斷,較可能與背景執行限制有關;若在前景也無法完成測試,應先檢查連線參數,並確認是否與其他 VPN 應用程式衝突。記下故障發生時間、操作前後的變化及必要的錯誤訊息,並遮蔽訂閱網址與帳戶資訊。若要依完整流程排查,請前往常見問題;不熟悉路由、出口或傳輸等術語時,先閱讀術語表,再依照快速入門恢復一組可驗證的基本設定。
教學文章更新
以下是最新三篇教學。匯入訂閱後不確定代理是否生效,可先閱讀首次連線說明;啟動錯誤與背景連線中斷則分別參考本機連接埠和行動裝置背景執行策略的文章。先依問題發生的環節選擇文章,再逐步檢查,避免將所有異常都視為同一種連線故障。
說明匯入訂閱後如何選擇節點、透過真實連線測速確認可用性,並利用瀏覽器與系統代理狀態確認流量是否經過代理。
閱讀文章 →分析 v2rayNG 在 Android 上耗電量偏高的常見原因,並說明電池最佳化白名單、背景執行限制與依應用程式代理的取捨方式。
閱讀文章 →從啟動錯誤判斷是否發生本機連接埠衝突,使用系統指令找出占用 10808/10809 的程序,再到 v2rayN 參數設定中改用未占用的連接埠。
閱讀文章 →