Windows
v2rayN選擇 v2rayN 桌面版或經典 WPF 版。桌面版採用跨平台介面框架,WPF 版則適用於 Windows;兩種介面的按鈕位置可能不同,但訂閱管理與代理設定的基本流程相近。
先確認系統類型是否為 x64,再查看下載頁的執行環境說明。初次安裝後,先更新一次訂閱並測試連線,不必同時調整 DNS、路由與 Tun,以免混淆安裝問題與設定問題。
前往下載先選安裝套件
先確認作業系統與處理器架構,再前往對應的下載區。桌面裝置選擇 v2rayN;Android 裝置可先查看 v2rayNG,需要 V2Fly 核心時再了解 v2flyNG。安裝套件不含訂閱網址,安裝完成後仍須匯入可用的設定。
選擇 v2rayN 桌面版或經典 WPF 版。桌面版採用跨平台介面框架,WPF 版則適用於 Windows;兩種介面的按鈕位置可能不同,但訂閱管理與代理設定的基本流程相近。
先確認系統類型是否為 x64,再查看下載頁的執行環境說明。初次安裝後,先更新一次訂閱並測試連線,不必同時調整 DNS、路由與 Tun,以免混淆安裝問題與設定問題。
前往下載選擇 v2rayN 的 Apple Silicon 或 Intel 安裝套件。開啟「關於這台 Mac」,確認顯示的是晶片名稱還是 Intel 處理器,再選擇相符的架構,別只憑電腦外觀判斷。
依照系統提示安裝應用程式並首次開啟。系統代理是否生效,也取決於應用程式是否讀取代理設定;若瀏覽器可以連線、其他程式卻不行,先檢查該程式的網路選項,再評估是否需要透過虛擬網卡接管流量。
前往下載建議先選擇使用 Xray 核心的 v2rayNG。多數較新的手機適用 arm64 套件;不確定裝置架構時,可查看系統資訊或選擇通用版。若需要 V2Fly 核心,下載頁也提供 v2flyNG 作為替代選擇。
匯入訂閱後,選擇一筆設定,點選連線並確認系統的 VPN 授權。授權代表允許客戶端建立本機流量接管通道,不代表遠端設定一定可用。若背景執行時斷線,請檢查省電限制與背景執行權限。
前往下載選擇 v2rayN 的 deb 或 rpm 套件,並確認符合 x64 或 arm64 架構。Debian、Ubuntu 系列通常使用 deb;Fedora 等發行版通常使用 rpm,實際仍須依系統的套件管理方式選擇。
安裝後先從桌面環境啟動圖形介面,確認設定可以載入。不同桌面環境讀取系統代理的方式可能不同,終端機程式也可能需要另外設定代理。啟用 Tun 前,先確認權限設定,並檢查是否與現有網路服務衝突。
前往下載逐項完成設定
依序處理連線來源、規則與流量接管範圍。下方列出常見設定名稱,僅供靜態操作示意,不代表目前裝置已完成設定;實際選單請以安裝的客戶端介面為準。
開啟「訂閱群組設定」,新增訂閱網址與方便辨識的備註,儲存後再更新訂閱。首次尚無可用連線時,可先嘗試「不經代理」的更新選項;若網址本身需要透過代理存取,則使用現有的可用連線更新。v2rayNG 也須先新增訂閱群組,再更新訂閱;只貼上網址不會自動建立設定。更新後確認群組中是否出現項目;若失敗,先檢查連結是否過期及回傳內容,避免重複新增相同網址。
開啟路由設定,先選擇符合連線需求的預設,再檢查規則的比對順序。路由會決定進入核心的流量要直連、經代理或阻擋,不會自動讓所有應用程式都經過客戶端。「中國大陸直連」依據網域與 IP 規則判斷,不是根據網站介面語言。新增自訂規則時,請明確指定目標網域與輸出路徑,避免將範圍過廣的規則排在前面,遮蔽後續項目。若只有特定網站走錯路徑,先檢查命中的規則與解析結果,再調整預設。
選好可用設定後,選擇「自動設定系統代理」,讓讀取系統設定的應用程式連上本機代理入口。這項設定改變的是應用程式接入方式,不等於將所有流量都設為經代理輸出;實際路徑仍由路由規則決定。「清除系統代理」會還原系統代理設定;「不變更系統代理」則保留目前設定。部分程式使用自己的代理選項,或直接建立連線。因此,若瀏覽器可以連線、其他程式卻不行,先確認該程式是否讀取系統代理,再決定是否啟用 Tun。
先分辨問題是網域解析失敗,還是遠端連線失敗,再調整 DNS。直連網域與代理網域可能需要不同的解析路徑,解析伺服器本身也必須能透過預期的輸出路徑存取。瀏覽器的安全 DNS、系統 DNS 與核心 DNS 不一定採用相同設定,只更換一組 DNS 位址未必能解決問題。調整前先記下原有設定;測試時固定使用同一網站,並搭配記錄檢查解析與連線階段。詳細設定須一併考量所用核心、路由規則與 Tun 是否啟用,不要直接照搬其他裝置的所有參數。
目標程式不讀取系統代理時,再考慮啟用 Tun。Tun 透過虛擬網卡接管符合條件的流量,通常需要額外權限;實際接管範圍也會受到排除規則與網路環境影響,並不代表所有連線一定都經過代理。先在一般代理模式下確認設定可用,再啟用 Tun,可減少排查變數。啟用後若無法正常存取本機網路,請檢查路由、DNS 及其他 VPN 服務是否衝突;結束使用時,確認虛擬網卡與系統網路設定已還原。
分清客戶端與核心
先了解各層的職責,再選擇設定方式。介面名稱、核心功能與訂閱格式是三個不同問題,不能只憑客戶端名稱判斷某種協定或傳輸組合是否可用。
可將 Project V 理解為代理工具及相關技術所組成的開源生態,而非單一的圖形化應用程式。V2Ray 是其中的重要專案,設定架構涵蓋入站、出站與路由等部分。常見的 v2rayN、v2rayNG 和 v2flyNG,則透過圖形介面管理設定與連線操作。一般使用者不一定需要手動撰寫完整設定,但仍須了解「已安裝客戶端」與「已有可用的連線參數」並非同一回事。
隨著社群持續發展,V2Fly 延續 V2Ray 的社群維護工作;Xray 則發展出相關的核心分支與功能演進方向。兩者雖有共同的技術背景,但功能細節與設定選項不一定完全相同。因此,教學中提到的欄位,應依實際執行的核心判斷,不要看到 V2Ray 就直接照填。
核心負責實際處理協定並建立連線。v2rayNG 使用 Xray 核心,v2flyNG 使用 V2Fly 核心;v2rayN 則可依發行套件與設定管理功能使用支援的核心。若要確認特定功能,先查看客戶端的核心設定與記錄,再核對連線設定的需求。介面能匯入某種分享連結,不代表執行所需的傳輸參數都已符合條件。
VMess、VLESS、Trojan 是常見的協定名稱;REALITY 則涉及安全握手機制,不宜將它們視為完全平行的選項。可用的設定還可能包含傳輸方式、伺服器名稱與驗證參數。匯入後先保留來源提供的參數;只有確認服務端有此需求時,才修改相關選項,避免把成功識別協定誤認為完全相容。
v2rayN、v2rayNG、v2flyNG 都是開源圖形化客戶端,原始碼依各專案的授權條款提供。圖形介面、連線核心與隨附元件可能採用不同授權;散布或修改時,請分別閱讀相關授權內容。開源描述的是程式碼的使用與協作方式,不代表訂閱服務、遠端連線路徑或網路資源也由客戶端專案提供。
選擇客戶端時,先考量使用需求:桌面端需要管理訂閱與系統代理,可優先了解 v2rayN;Android 使用 Xray 相關設定,可先查看 v2rayNG;需要 V2Fly 核心時,再考慮 v2flyNG。三款客戶端的設定概念相近,但選單與備份格式並不完全相同。跨裝置移轉時,優先共用訂閱網址,再分別確認介面偏好與路由規則,不要將整份設定直接覆寫到另一款應用程式。
更新客戶端是更換應用程式版本,更新訂閱則是重新取得連線設定,兩者解決的問題不同。訂閱內容變更時,重複下載安裝套件通常不會更新清單;應用程式功能或相容性有變動時,只更新訂閱也不會升級核心。先判斷要更新的項目,再前往相應選單操作,避免誤刪原有設定。
升級前請備份群組資訊、自訂路由與必要設定,並記下目前使用的核心和流量接管模式。升級後先用原有設定重新測試連線,再檢查自訂規則、背景執行與系統代理狀態。若介面有所變更,請依設定功能尋找選項,不要依賴舊截圖中的位置。下載頁集中提供安裝套件選擇,首頁不固定顯示特定版本,方便分開查看客戶端選擇與版本資訊。
連線按鈕顯示啟用,只代表客戶端已進入執行流程,不表示目標網站已可連線。先確認訂閱是否更新成功,以及是否已選取設定;接著檢查核心是否啟動失敗,最後再查看網域解析與遠端連線。連線逾時、驗證失敗、連接埠占用與解析失敗的處理方式不同,先保留關鍵錯誤訊息,避免同時更換多項設定。
延遲測試也要分清類型:連線測試主要觀察端點回應,實際連線測試還會受到目標網站、DNS 與路由影響。單次結果無法代表所有應用程式的使用狀況。使用固定目標連續測試,比只看清單中的單次結果更有參考價值。如需系統性排查,可依照 系統教學 的章節順序檢查;分享記錄前,請先隱去訂閱網址、驗證資訊與個人網路資訊。
連線前後檢查
先確認具體症狀,再查看對應說明。保留能重現問題的操作步驟,排查時一次只變更一項條件。
儲存網址只是建立訂閱群組,還需要執行更新訂閱。先確認是否切換到正確群組,再查看更新訊息。若回傳的是網頁,而非可辨識的訂閱內容,請向設定提供者確認網址用途;不要把服務管理頁面當成訂閱連結匯入。
查看訂閱匯入問題 →系統代理決定哪些應用程式依照系統設定接入本機代理;全域路由通常表示進入核心的流量採用代理輸出策略。兩者分別處理「流量是否進入」與「進入後要往哪裡走」,不能互相取代。若程式沒有讀取系統代理,改用全域路由也不一定有幫助。
分辨代理模式與路由術語 →先固定一個測試目標,確認設定有效,再檢查目標應用程式是否使用代理。若瀏覽器可以連線、其他程式不行,應優先檢查流量接管方式;若所有目標都無法連線,再查看記錄中的解析、驗證與逾時訊息。請先保留原有設定,避免排查時一次修改太多參數。
查看連線故障排除方法 →只要服務允許多部裝置使用,且各客戶端支援訂閱中的設定,就能分別新增相同網址。訂閱同步的是連線項目,不一定包含自訂 DNS、路由與介面偏好。裝置數量與同時連線限制依服務規則而定;分享 QR Code 或匯出備份前,也請確認內容是否包含驗證資訊。
閱讀多裝置設定方式 →繼續閱讀
先完成基本連線,再依照實際需求擴充設定。以下文章分別說明虛擬網卡接管、訂閱格式與多裝置同步,適合在確認基本設定可用後逐篇閱讀。
說明 TUN 虛擬網卡與系統代理的差異,以及為何能接管不讀取系統代理的程式。包含 v2rayN 啟用 Tun 的步驟、權限需求與常見衝突的處理方式。
閱讀設定步驟 →分別標示 v2rayN 訂閱群組設定與 v2rayNG 訂閱群組的入口,說明新增網址、更新訂閱的操作方式,並解釋常見訂閱內容格式的差異。
查看訂閱匯入說明 →整理桌面裝置與 Android 之間同步節點和設定的幾種方式:共用同一個訂閱、透過 QR Code 或分享連結互傳,以及匯出再匯入設定備份,並說明各自適用情境與限制。
了解裝置間設定移轉 →