Windows
v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面,WPF 版則保留熟悉的桌面操作方式。日常使用不必同時安裝兩種介面,依下載頁說明選擇一種,再匯入訂閱並設定系統代理即可。
從舊環境移轉時,先備份訂閱群組、路由規則與個人設定。不要直接以新程式覆蓋正在執行的資料夾;先關閉用戶端再操作,可減少檔案占用與設定混淆。啟用 TUN 前,也要確認目前帳戶具備必要權限。
前往下載 · Windows依平台選擇開源用戶端,從訂閱匯入到協定與路由設定。
設定視窗僅示意欄位關係。實際參數應與伺服器提供的設定一致,不能只憑協定名稱推斷。
桌面平台可選 v2rayN,Android 優先選擇 v2rayNG。先確認作業系統與處理器架構,再前往下載中心選擇安裝套件;安裝完成後,仍須匯入有效的伺服器設定或訂閱。
v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面,WPF 版則保留熟悉的桌面操作方式。日常使用不必同時安裝兩種介面,依下載頁說明選擇一種,再匯入訂閱並設定系統代理即可。
從舊環境移轉時,先備份訂閱群組、路由規則與個人設定。不要直接以新程式覆蓋正在執行的資料夾;先關閉用戶端再操作,可減少檔案占用與設定混淆。啟用 TUN 前,也要確認目前帳戶具備必要權限。
前往下載 · Windowsv2rayN 安裝套件分為 Apple Silicon 與 Intel 晶片版本。可先查看系統的「關於這台 Mac」,再選擇相符的架構。晶片類型必須與安裝套件相符,不能只依電腦外觀或購買年份判斷。
首次啟動後,先匯入一組可用設定並測試系統代理。若瀏覽器可以連線,但其他應用程式仍使用原本的網路,請檢查應用程式是否遵循系統代理設定,不要立刻修改節點參數。虛擬網卡權限與流量接管另有設定步驟,依教學逐項確認會更容易找出問題。
前往下載 · macOS優先使用採用 Xray 核心的 v2rayNG;若已有 V2Fly 設定需求,可考慮 v2flyNG。多數較新的裝置適用 arm64 安裝套件;不確定架構時,再查看通用版說明。兩款用戶端的介面與核心功能應分別確認。
首次連線時,需允許系統提出 VPN 連線要求。連線建立後,若切換到背景便中斷,請先檢查電池最佳化、背景執行設定,以及是否有其他 VPN 應用程式占用連線。訂閱網址與分享連結包含設定資訊,不宜貼在公開留言或截圖中。
前往下載 · Androidv2rayN 提供 deb 與 rpm 版本的下載入口,並分為 x64 和 arm64 架構。先確認發行版採用的套件格式,再確認處理器架構。套件格式、架構與桌面執行環境是不同條件,不能互相取代。
系統代理是否生效,也取決於桌面環境與應用程式本身的設定。排查時先用明確支援代理的應用程式測試連線,再考慮使用 TUN 接管流量;若涉及虛擬網卡權限或系統路由變更,請依教學操作並保留原有設定,避免多個網路工具同時修改預設路由。
前往下載 · Linux依實際需求理解各項設定:先處理伺服器參數與訂閱來源,再決定流量如何進入核心,以及由哪條規則送往出口。以下僅示意欄位,不包含可直接連線的伺服器資料。
多協定支援是為了連接不同伺服器設定,並不代表各種協定參數可以互換。新增伺服器時,先依分享資訊選擇 VMess、VLESS 或 Trojan,再核對位址、連接埠、驗證欄位與傳輸層安全性。VLESS 搭配 REALITY 時,還須確認公開金鑰、ShortId 與伺服器名稱。相較於只顯示連線開關的簡化介面,分層欄位更方便逐項找出錯誤;實際可選項目仍取決於核心支援,切換協定不會自動修正參數。
查看協定與核心參考 →REALITY 是安全層方案,不是與 VLESS 並列的代理協定。
訂閱群組可集中管理同一來源的伺服器項目,適合區分工作、測試或不同服務來源的設定。先在群組設定中填入別名與訂閱網址,儲存後執行更新,再確認是否已產生伺服器項目。相較於逐一貼上分享連結,透過群組更新更方便同步來源變更,但不會替使用者判斷服務是否有效。更新失敗時,先檢查網址是否完整或已失效,以及目前網路是否能連線;手動修改的項目也應另外備份,避免更新時遭到覆蓋。
查看訂閱匯入步驟 →新增群組後顯示訂閱項目
更新訂閱只會刷新設定,不代表已選擇伺服器並建立連線。
路由規則會決定已進入核心的連線要分配至直連、代理或阻擋出口。設定時先明確指定目標網域或 IP,再確認 outboundTag 引用的出口確實存在;規則順序與網域解析策略也會影響結果。相較於簡單的全域模式,分流可保留本機服務連線並減少不必要的轉送,但需要維護比對範圍。遇到單一網站異常時,應先檢查規則是否命中及 DNS 結果,避免為了一個目標修改整組伺服器參數,擴大故障影響。
了解 DNS 與分流的關係 →domain網域比對條件ipIP 比對條件outboundTag已定義的出口標籤先確認連線已進入核心,再檢查路由;規則無法接管尚未進入核心的流量。
TUN 模式透過虛擬網卡,將符合接管條件的流量交由網路處理元件處理,適合不遵循系統代理設定的應用程式。啟用前,先用一般代理確認伺服器可用,再檢查權限、虛擬網卡與 DNS 設定。相較於系統代理,TUN 的涵蓋範圍更廣,也更容易與其他 VPN、虛擬機網卡或自訂路由互相影響。開啟開關不代表所有連線都會走代理,實際出口仍受分流規則影響;若啟用後整體無法上網,先關閉 TUN 恢復原狀,再逐項排查。
查看 TUN 啟用與排查說明 →啟用前確認系統權限與 DNS 策略。
接管範圍與出口選擇是兩回事;TUN 也能依規則直連。
圖形化用戶端負責編輯設定與管理連線,核心負責執行協定、傳輸與路由邏輯。v2rayN 可依實際支援情況選擇核心;需要 REALITY 與 XTLS Vision 時,應確認 Xray 是否支援相關功能。與更換介面主題不同,切換核心可能改變欄位支援情況與設定產生方式。既有設定不能只更改核心名稱就視為移轉完成,應重新檢查啟動記錄與出口行為。保留原本可用的方案,再於相同網路下比較,才能分辨相容性問題與線路變化。
查看核心家族關係 →設定結構相近,不代表擴充欄位可以直接互換。
多平台共用設定來源,是指在不同裝置上使用同一來源的伺服器資訊,不代表可直接複製整個用戶端設定資料夾。可先匯入相同訂閱,再分別調整系統代理、TUN 權限、DNS 與路由規則。相較於逐一手動輸入欄位,標準分享格式可減少輸入錯誤,但訂閱格式與擴充參數仍有相容性限制。移轉後應逐項核對協定、安全層與流量控制;本機連接埠、檔案路徑及系統服務選項則應在各裝置分別設定,避免將桌面環境的預設假設套用到行動裝置。
依裝置選擇用戶端 →沿用伺服器資訊,不代表系統權限與本機路徑也能共用。
用戶端名稱、核心名稱與協定名稱屬於不同層次。分清三者,才能理解「可以匯入卻無法啟動」、「切換核心後欄位失效」等問題,也能避免因單一連線故障而反覆更換軟體。
Project V 是理解 V2Ray 生態系的起點。它將入口、出口、路由與傳輸等功能拆分為可組合的模組,讓不同使用情境能透過設定描述。使用者平常看到的伺服器清單只是圖形介面的一種呈現方式;核心實際讀取的是協定、驗證、傳輸與路由等結構化資訊。因此,「V2Ray 用戶端」並非所有功能都完全相同的單一產品名稱,而是一系列圍繞相關核心與設定方式發展的工具。
V2Fly 延續 V2Ray 的社群開發與維護;Xray 則從相關程式碼基礎發展出自己的功能方向。兩者背景相近,但實作與擴充功能各自演進。選擇時,與其追問哪個名稱較新,不如列出目前伺服器所需的協定、安全層與流量控制,再確認用戶端及核心是否支援。只要現有方案符合需求,移轉就應有明確理由,例如欄位相容性、系統支援或特定功能,而非只因名稱有所變更。
VMess、VLESS、Trojan 與 Shadowsocks 是不同的代理協定;TCP、WebSocket 等屬於傳輸相關選項;TLS 與 REALITY 則涉及連線安全層。介面將這些項目放在同一張設定表中,不代表它們屬於相同層次。尤其是 VLESS 本身不能取代完整的傳輸安全設定;XTLS Vision 也是需要相應條件的流量控制方案,不能在不相符的伺服器上任意啟用。
設定涉及 REALITY 與 XTLS Vision 時,應特別確認 Xray 的功能支援與用戶端欄位對應。V2Fly 與 Xray 的部分基礎設定概念相近,但擴充欄位、預設行為與支援範圍可能不同。設定檔能被某個介面讀取,不代表所有欄位都會完整保留;訂閱匯入成功,也不代表對應的核心一定能啟動。遇到不相容時,先查看啟動階段的明確錯誤,再判斷問題出在用戶端解析、核心支援或伺服器參數。
速度與資源占用也不能只依協定名稱排序。交握次數、傳輸封裝、連線重用、伺服器負載與網路往返時間都會影響表現。行動裝置的耗電量也受背景連線、網路切換與流量接管範圍影響。較合理的比較方式是在相同裝置、相同網路及相近負載下測試日常任務,同時觀察連線穩定度;單次延遲測試不足以證明某種協定永遠較快。
v2rayN 是桌面平台的主要入口,適合透過圖形介面管理訂閱群組、伺服器、路由與連線設定。它的用途是整合設定操作,不是取代伺服器參數或自動提供伺服器。選擇桌面版或經典 WPF 版時,應考量目前系統與介面使用習慣;後續設定能否使用,仍須依所選核心與伺服器資訊判斷。詳細差異可參閱選擇指南。
Android 用戶可優先考慮 v2rayNG,其 Xray 核心適合需要相關協定功能的設定。v2flyNG 採用 V2Fly 核心,可作為既有 V2Fly 使用環境的替代選擇。兩款應用程式名稱相近,不代表進階功能一致。跨用戶端匯入前,先確認訂閱屬於伺服器分享格式,還是完整設定檔;完整設定可能包含本機入口、路由標籤與平台專屬項目,移轉時需要檢查的內容比單一分享連結更多。
三款用戶端都屬於開源軟體生態系,原始碼、授權條款與社群維護構成其技術背景。開源代表可研究實作,並依授權條款使用或重新散布,不代表所有元件採用相同授權。用戶端外殼、核心與附帶元件可能各有不同要求。日常使用可先閱讀產品說明;若要修改、整合或散布,則應分別確認相關授權,不能將「免費使用」簡化為可任意重新包裝。
用戶端程式、執行核心與訂閱內容是三條不同的更新流程。更新用戶端主要會改變介面、設定產生方式與系統整合;更新核心可能影響協定支援及執行行為;更新訂閱則會重新整理伺服器項目。排查問題時不必一次變更三者。較穩妥的做法是先備份目前設定、記錄原本可用的連線方式,每次只調整一個因素,再觀察是否出現預期變化。
例如,訂閱更新失敗時不必先重新安裝軟體。應先確認連結是否完整、來源是否仍有效,以及目前的連線方式是否能存取,再查看錯誤資訊。如果伺服器項目已存在卻無法連線,就將問題拆分為核心能否啟動、位址能否解析、目標連接埠能否建立連線,以及驗證欄位是否相符。若瀏覽器可連線但某個應用程式異常,優先檢查流量接管範圍;若只有特定網域異常,則先檢查路由與 DNS。
回報問題時,可保留操作步驟、錯誤發生階段與相關設定名稱,並隱去訂閱網址、使用者 ID 等個人設定資訊。記錄檔通常比「無法連線」四個字更有助於排查,但也應先確認其中是否包含位址或驗證資訊。依照設定教學建立可運作的最小設定,再逐步加入分流與 TUN 設定,通常比一次啟用所有進階選項更容易找出問題。
從用戶端設定深入了解設定結構。先弄清楚各模組的用途,再決定是否要修改預設行為;以下三篇文章分別說明欄位關係、DNS 分流與 REALITY 的技術定位。
依序拆解 log、inbounds、outbounds、routing、dns,說明欄位用途及標籤之間的引用關係。適合已會匯入訂閱,並想看懂用戶端匯出結果的使用者。
閱讀設定結構說明 →說明 servers、domains 與 queryStrategy 的用途,以及本機與遠端解析如何配合路由。先分辨網域解析失敗與連線失敗,再檢查規則,避免把 DNS 問題誤認為協定問題。
閱讀 DNS 分流說明 →整理 VLESS、XTLS Vision 流量控制與 REALITY 安全層各自負責的部分,說明交握與處理負載的設計取捨,並對照用戶端設定項目,了解效能結論成立的條件。
閱讀協定原理說明 →