Windows
v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面,WPF 版則保留 Windows 原生介面架構。若已習慣使用某個版本,可先沿用原本的版本,不必只因名稱不同就重新建立所有設定。
下載前,請到系統「設定」→「系統」→「系統資訊」確認系統類型。安裝或遷移前先備份現有設定,避免新舊程式目錄混用。首次執行時,先匯入訂閱並選擇伺服器,再設定系統代理;TUN 所需權限也應與一般介面啟動權限分開確認。
前往下載依作業系統選擇開源用戶端,從匯入訂閱開始,逐步了解路由分流與代理設定。
依來源儲存網址,分開更新設定。
依目標網域名稱和 IP 決定流量出口。
geoip:private→directgeosite:category-ads-all→block了解應用程式代理入口與虛擬網卡接管的差異。
以上為靜態設定示意,不會變更裝置設定。選單名稱可能隨用戶端介面更新而調整;路由範例中的流量出口標記必須實際存在於設定中。
先確認流量是否進入用戶端,再檢查比對規則與遠端連線。訂閱、路由及系統代理各自解決不同問題,不必一次改完所有設定。
用戶端提供操作介面,核心負責建立連線及執行路由。匯入訂閱只是儲存伺服器參數,不代表所有應用程式都已使用代理。第一次設定時,建議先保留預設路由,選擇一筆現有設定,透過系統代理測試瀏覽器連線,再依需求處理其他應用程式。如此一來,便能分別排查訂閱、代理入口與協定問題。
訂閱可批次取得伺服器參數,但不能取代路由及代理入口設定。在 v2rayN 的「訂閱分組」中開啟「訂閱分組設定」,新增備註並貼上完整網址,儲存後執行更新訂閱。不同來源建議分別建立分組,方便確認更新結果及清理項目。更新失敗時,先查看記錄,再確認連結是否過期、是否需要透過代理取得。訂閱網址通常含有存取憑證,分享截圖前請先遮住網址;自行修改的項目也可能在下次更新時遭到覆寫。
查看匯入訂閱步驟 →geoip:private→directgeosite:category-ads-all→block路由會決定進入核心的請求要走哪個流量出口。開啟 v2rayN 的「設定」→「路由設定」,先確認已啟用的路由設定,再調整個別規則。規則通常依序比對,較廣泛的條件若排在前面,可能會優先攔截後續的細部條件。網域分類仰賴 GeoSite,位址分類仰賴 GeoIP;若資料庫沒有相應分類,設定可能無法載入。範例中的 direct 和 block 是流量出口標記,不是隨意填寫就會生效的開關。修改後應查看記錄,確認實際比對結果。
查看規則庫與路由設定方式 →系統代理會將本機代理位址寫入系統設定,主要影響遵循這項設定的應用程式。在 v2rayN 的「系統代理」選單中選擇「自動設定系統代理」後,可先用瀏覽器測試。部分應用程式不會讀取系統代理,需另外設定代理位址,或在環境允許時使用 TUN。TUN 透過虛擬網卡接管流量,還牽涉權限、DNS 與路由。排除問題時不要同時切換兩種入口;先讓其中一種正常運作,再擴大接管範圍。結束程式後若連線異常,請檢查系統是否仍保留本機代理位址。
查看代理入口設定 →協定、傳輸方式與安全層是三組不同的參數。VLESS 與 VMess 是代理協定,WebSocket 是傳輸方式,TLS 與 REALITY 則用於相應的安全設定。匯入後,應在伺服器編輯視窗確認這些欄位,並確保與伺服器端一致。只修改協定名稱,無法將一份設定轉換成另一種可用連線。若遇到不明欄位或匯入缺漏,請先確認目前使用的核心是否支援這種組合,再檢查分享連結格式。選擇用戶端時,實際設定所需的功能比協定名稱的數量更重要。
查看協定與傳輸術語 →核心負責解析設定並建立連線,介面程式則負責將設定轉換成核心可讀的內容。在提供此選項的 v2rayN 中,可從「設定」→「參數設定」→「核心設定」確認協定對應的核心類型;可選項目取決於安裝內容。切換前請記下原本設定,並確認目標核心是否支援現有欄位。Android 版 v2rayNG 與 v2flyNG 分別面向 Xray 和 V2Fly 生態,不能只因介面相似就認定功能相同。若需要特定功能,應先確認核心支援情況,再決定是否遷移。
比較用戶端與核心選擇 →桌面端選用 v2rayN;Android 裝置可先了解 v2rayNG,需要 V2Fly 核心時再考慮 v2flyNG。先確認作業系統與處理器架構,再選擇介面版本。
v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面,WPF 版則保留 Windows 原生介面架構。若已習慣使用某個版本,可先沿用原本的版本,不必只因名稱不同就重新建立所有設定。
下載前,請到系統「設定」→「系統」→「系統資訊」確認系統類型。安裝或遷移前先備份現有設定,避免新舊程式目錄混用。首次執行時,先匯入訂閱並選擇伺服器,再設定系統代理;TUN 所需權限也應與一般介面啟動權限分開確認。
前往下載v2rayN 桌面版依 Apple Silicon 與 Intel 提供不同下載方式。點選系統選單中的「關於這台 Mac」,查看「晶片」或「處理器」資訊,再選擇相符的安裝套件;不要只憑電腦外觀或購買年份判斷。
安裝後,將應用程式移至常用的應用程式資料夾再執行。遇到系統安全提示時,請依下載來源與提示內容判斷如何處理。如果瀏覽器可以連線,其他程式卻不行,請先確認該程式是否遵循系統代理。啟用 TUN 前,也要確認授權程序已完成,並留意是否有其他網路工具同時接管流量。
前往下載v2rayNG 使用 Xray 核心,是本站優先推薦的 Android 用戶端;v2flyNG 則是採用 V2Fly 核心的替代選項。大多數較新的裝置可使用 arm64 套件;若不確定處理器架構,請查看裝置資訊,再參考下載頁的通用套件說明。
在用戶端匯入訂閱或分享連結,選取設定後啟動連線,並確認系統的 VPN 連線要求。Android 的本機 VPN 介面負責將應用程式流量送入用戶端,與遠端伺服器是否可連線是兩回事。若背景執行時斷線,除了查看記錄,也請檢查電池最佳化、背景執行權限,以及其他 VPN 類應用程式是否正在使用連線。
前往下載v2rayN 桌面版提供 deb 與 rpm 套件,並區分 x64 和 arm64。請先確認 Linux 發行版使用的套件格式與處理器架構,再使用系統的套件安裝工具開啟對應檔案,避免將套件格式不同誤認為程式故障。
不同桌面環境讀取系統代理的方式不盡相同。匯入完成後,可先在支援手動代理的應用程式中測試本機監聽位址與連接埠。若要使用 TUN,請另外確認權限與路由,避免直接以高權限執行整個桌面工作階段。連線異常時,同時查看用戶端記錄與系統網路設定,較容易找出問題所在。
前往下載先確認已選取伺服器且核心正常執行,再檢查系統代理是否指向目前使用的用戶端。伺服器清單中出現項目,只能表示設定已載入。瀏覽器擴充功能的獨立代理設定也可能覆蓋系統設定。請依「核心記錄→系統代理→應用程式本身的設定」順序檢查,避免反覆刪除訂閱。查看使用與疑難排解問答 →
兩者並非同一層級的替代選項。VLESS 是代理協定,REALITY 是相關連線中的安全機制,實際設定可以搭配使用。能否連線還取決於傳輸方式、伺服器端參數與核心支援。匯入後應保留服務提供者提供的組合,不要自行更換名稱。查看 REALITY 術語說明 →
不必一開始就使用 TUN。若目標應用程式會讀取系統代理,可先測試這個入口;若應用程式忽略系統代理,且確實需要接管流量,再確認 TUN 的權限、DNS 與路由。Android 用戶端透過系統 VPN 介面的流程與桌面系統代理不同,請依各自的教學操作。查看代理與 TUN 設定 →
分別了解專案生態、執行核心與圖形介面用戶端。名稱相近,不代表設定欄位、更新節奏與功能範圍完全相同。
V2Ray 源自 Project V 生態,將入站、出站、路由與傳輸等功能組合成可彈性配置的設定。了解這套架構,比記住特定用戶端按鈕的位置更有助於移轉設定。
V2Fly 延續 V2Ray 核心專案的社群維護,並依自身支援的設定格式與傳輸能力持續發展。v2flyNG 提供 Android 圖形介面,適合明確需要此核心體系的設定。
Xray 源自 V2Ray,之後獨立維護。VLESS、REALITY 等設定應依個別核心的功能確認;v2rayNG 則將 Xray 的相關功能帶到 Android 圖形介面用戶端。
v2rayN、v2rayNG 和 v2flyNG 都是開源圖形介面用戶端,但並非同一個程式在不同作業系統上的簡單改名。用戶端負責管理訂閱、顯示伺服器、儲存介面選項,並整理核心執行時所需的設定。核心則依據這些設定建立連線、處理傳輸並執行路由。因此,介面能正常開啟,不代表核心已成功啟動;訂閱能正常更新,也不代表伺服器參數一定適用於目前的核心。
v2rayN 適用於桌面系統,可管理不同核心所需的設定;實際可用功能應以目前的安裝內容與介面為準。v2rayNG 與 v2flyNG 則分別以 Xray 和 V2Fly 體系提供 Android 操作介面。遷移時,建議先轉移標準分享連結或訂閱,再重新確認本機相關設定。系統代理連接埠、TUN 權限、應用程式分流清單與檔案路徑,通常無法直接從另一台裝置照搬。
開源表示程式原始碼依照相應授權條款公開,可在授權規範下閱讀、使用及參與改進。v2rayN、v2rayNG、v2flyNG 用戶端專案採用 GPL 系列授權;V2Fly 與 Xray 核心專案則採用 MPL 2.0。用戶端、核心與其相依元件的授權對象各不相同,散布或修改時應分別閱讀軟體隨附的授權條款,不能只看其中一個專案的名稱。
開源不代表可以忽略遠端服務與設定來源的安全性。訂閱網址可能包含帳戶識別資訊,分享連結也可能帶有驗證參數。向他人求助時,請先遮住完整網址、使用者識別資訊、密碼與金鑰等欄位,只保留錯誤訊息及必要的設定名稱。也不要將實際設定貼到不明網站轉換格式。本網站的術語說明旨在解釋參數含義,不需要提交個人設定。
更新介面程式、更新執行核心,以及更新 GeoIP 與 GeoSite,是不同的操作。介面更新可能調整選單或訂閱解析方式;核心更新可能增加欄位支援或變更參數驗證;規則庫更新則會影響分類比對內容。發生問題時,先記下變更的是哪一個部分,不要同時更換所有元件,否則很難判斷是哪項修改造成影響。
更新前先備份可用的設定,並記下使用中的路由設定與代理入口。更新後先用原本可正常運作的設定確認基本連線,再測試新增設定。若記錄顯示找不到分類,先檢查規則庫;若顯示未知欄位,先確認核心相容性;若只有特定應用程式異常,先檢查該應用程式的代理入口。依這個順序排查,可減少與問題無關的重新安裝。
TCPing、實際連線延遲與下載測速,測量的是不同環節。連接埠能建立 TCP 連線,不代表代理交握、網域解析與目標網站存取都正常。實際連線測試也會受到測試位址、路由與 DNS 影響;下載測速則更仰賴傳輸時間、目標服務與目前的網路狀態。比較結果前,請先確認使用相同的測試方式與條件。
第一次設定時,建議先測試明確的存取目標,再查看記錄中的錯誤位置。不要只因某項測試沒有回傳數值,就判定所有設定都失效;也不要因為連接埠測試成功,就忽略應用程式無法連線的情況。若不確定測試結果代表什麼,可先閱讀測速原理文章,再決定是否需要調整伺服器、DNS 或分流規則。
從實際問題出發:如何解讀測試結果、如何選擇桌面介面,以及如何在多部裝置間移轉設定。操作方式請依目前用戶端的設定項目確認。
同一份設定的測試結果為何差異明顯?透過連接伺服器連接埠、完成代理請求與持續下載三個階段,了解測試涵蓋的連線範圍,再選擇適合目前問題的驗證方式。
閱讀文章 →WPF 適用於 Windows,Avalonia 桌面版則支援多種桌面作業系統。比較執行相依項目、介面差異與設定移轉時應確認的內容,避免只憑名稱就決定取代現有安裝。
閱讀文章 →訂閱適合持續更新伺服器參數,分享連結適合移轉單筆設定,備份則適合保留用戶端狀態。了解三種方式各自涵蓋的範圍,以及跨裝置移轉時仍須手動確認的本機設定。
閱讀文章 →