Windows
使用 v2rayN 桌面用戶端。安裝套件頁面同時說明新一代桌面介面與經典 WPF 版本的差異,並列出執行環境、解壓縮安裝、啟用系統代理及處理連接埠衝突的方法。
前往下載PLATFORM ENTRY
首頁僅負責依作業系統分流。進入安裝套件頁面後,再依處理器架構、套件格式與用戶端核心選擇檔案。桌面裝置以 v2rayN 為主,Android 裝置則可在 v2rayNG 與 v2flyNG 之間選擇。
使用 v2rayN 桌面用戶端。安裝套件頁面同時說明新一代桌面介面與經典 WPF 版本的差異,並列出執行環境、解壓縮安裝、啟用系統代理及處理連接埠衝突的方法。
前往下載使用 v2rayN 跨平台桌面用戶端。下載前需確認裝置採用 Apple Silicon 或 Intel 處理器;進入對應分頁後,可查看架構辨識、首次啟動與系統代理設定說明。
前往下載優先查看使用 Xray 核心的 v2rayNG;需要 V2Fly 核心時,可選擇 v2flyNG。安裝套件頁依 arm64 與通用架構區分,並說明訂閱匯入、VPN 權限及背景執行設定。
前往下載使用 v2rayN 桌面用戶端。安裝入口依 deb、rpm 與處理器架構分類,適合常見桌面發行版;安裝後仍需依桌面環境設定系統代理,或使用用戶端提供的 TUN 功能。
前往下載CLIENT CAPABILITIES
用戶端只是設定與核心之間的圖形介面。實際使用效果由節點參數、協定欄位、路由順序、DNS 路徑與系統接管方式共同決定。以下分成四個常見環節說明。
ROUTING
路由規則負責決定流量進入代理出口、直連出口或阻擋出口。常見條件包括網域、目標 IP、連接埠、入站標籤與協定類型。v2rayN 可以套用預設規則,也可以載入自訂 JSON。設定時應先建立少量且容易理解的規則,再逐步加入 geosite 與 geoip 項目;規則越多不代表比對越準確。排查異常時,應留意由上到下的命中順序、最終備援出口與網域解析結果,避免同一目標同時符合互相衝突的條件。
相較於簡單的全域代理,路由分流保留了控制不同業務流量的能力。中國大陸服務直連、特定網域代理、區域網路位址繞過與廣告網域阻擋可以分別處理,也方便從記錄確認特定規則是否生效。
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}
PROTOCOL
VMess、VLESS、Trojan、Shadowsocks 與 SOCKS 所描述的驗證方式和資料封裝並不相同,傳輸層還可能組合 TCP、WebSocket、gRPC、HTTP/2 或 QUIC。用戶端匯入節點時,會將協定、位址、連接埠、使用者識別碼、TLS、SNI 與傳輸參數交給核心。任何關鍵欄位不一致,都可能表現為連線逾時、握手失敗,或雖能連線卻無法存取目標。
協定選擇應以伺服器實際提供的設定為準,不能只更換名稱。VLESS 常與 Xray 生態中的擴充能力組合;VMess 是 Project V 生態中長期使用的協定;Trojan 的設定重點在 TLS 網域與憑證鏈。遇到故障時,應先逐項核對欄位,再討論協定本身。
SUBSCRIPTION
訂閱網址通常會回傳一組節點設定,用戶端負責擷取、解析並寫入本機設定清單。首次匯入後,應手動執行一次更新並留意用戶端提示;若清單為空,請依序檢查網址是否完整、系統時間是否準確、目前網路是否能連線至訂閱來源,以及訂閱內容是否符合用戶端支援的格式。更新失敗不代表現有節點會立即消失,但繼續使用舊設定可能導致參數過期。
節點分組、備註、排序與自動更新屬於本機管理功能。建議保留清楚的分組名稱,修改訂閱產生的節點前先複製一份獨立設定,避免下次重新整理時覆蓋手動欄位。涉及隱私的訂閱網址不應出現在截圖、記錄分享或公開文件中。
TRAFFIC CAPTURE
系統代理主要影響會主動讀取作業系統代理設定的應用程式,部分命令列工具、遊戲或獨立網路元件可能會繞過它。TUN 模式透過虛擬網路介面接管更廣泛的流量,再交由核心執行路由與 DNS 處理。它能減少逐一為應用程式設定代理的工作,但同時涉及管理員權限、路由表、虛擬網卡與本機安全策略,排查路徑比一般系統代理更長。
啟用 TUN 前,應先確認一般系統代理能正常連線,再關閉其他會修改路由表的網路工具。若出現斷網,請優先退出 TUN、還原系統代理,並檢查虛擬網卡狀態與 DNS 設定。如此可分開定位節點、核心與系統接管等問題。
OPEN SOURCE ECOSYSTEM
V2Ray 並不是單一圖形化用戶端的名稱。它更常用來指稱由 Project V 形成的協定、核心與用戶端生態。理解核心與介面的分工,有助於判斷設定問題發生在哪一層。
Project V 早期建立了 V2Ray Core 及其設定體系,VMess、入站、出站、路由與傳輸層等概念由此形成。後來社群維護方向出現分支,V2Fly 延續並維護 v2fly-core,Xray 則在相容既有設定概念的基礎上發展 xray-core。兩者都是目前常見的核心實作,但支援的協定擴充、設定欄位與發佈節奏並不完全相同。
圖形化用戶端通常不直接負責協定處理。v2rayN、v2rayNG 與 v2flyNG 負責訂閱管理、節點編輯、參數產生、啟動核心、切換系統代理與顯示記錄,真正的資料連線則由其呼叫的核心執行。因此,同一個節點在不同用戶端中的表現,可能受核心類型、核心設定範本與用戶端版本相容性影響。排查時應記錄用戶端名稱、使用的核心、協定欄位與錯誤記錄,而不是只描述為「V2Ray 無法連線」。
開放原始碼授權允許開發者檢視程式碼、研究設定實作並建構衍生工具,但每個專案的授權文字、相依套件與發佈方式仍需分別查看。站內文件以公開設定模型與用戶端實際介面為基礎,重點說明安裝、參數含義與排查順序,不會把不同專案混成同一個軟體套件。
V2FLY
V2Fly 社群維護的核心延續 Project V 設定體系,涵蓋入站、出站、路由、DNS 與多種傳輸方式。v2flyNG 以該核心作為 Android 端的圖形化入口之一,適合需要維持 V2Fly 核心路徑的設定。
XRAY
Xray 核心與既有 V2Ray 設定概念保持高度關聯,同時發展了 VLESS、REALITY 等能力。v2rayN 與 v2rayNG 常在其用戶端生態中呼叫 Xray,實際支援範圍仍取決於用戶端與核心的組合。
CLIENTS
v2rayN 面向 Windows、macOS 與 Linux 桌面系統;v2rayNG 面向 Android,主要使用 Xray 核心;v2flyNG 同樣面向 Android,但採用 V2Fly 核心。三者定位不同,不應只按名稱相似程度選擇。
用戶端、核心、GeoIP 與 GeoSite 資料並不是同一個元件。用戶端更新通常涉及介面與設定產生邏輯;核心更新會影響協定處理與執行行為;地理資料更新則會影響路由規則比對。出現分流不準時,先檢查資料檔案;出現無法辨識協定欄位時,再核對核心與用戶端的相容關係。
分享連結與訂閱格式只是設定交換方式,不能保證所有用戶端都支援其中每個欄位。匯入成功只表示用戶端識別了基本結構,仍需查看傳輸、安全層、SNI、指紋與路由設定是否完整。跨核心移轉時,應逐項比對欄位,而不是直接覆蓋原有設定。
有效的記錄應包含發生時間、連線階段與錯誤類型。DNS 解析失敗、TCP 連線逾時、TLS 握手失敗、驗證欄位錯誤與路由未命中,分別指向不同層級。先確認錯誤發生在哪一層,再修改對應設定,可避免同時變更多個變數而造成新的干擾。
QUICK DIAGNOSIS
以下問題涵蓋首次安裝後最容易混淆的四個環節。需要系統化排查時,請繼續查看教學、概念速查與疑難排解手冊。
先確認使用的是「更新訂閱」,而不是只新增訂閱分組,並檢查複製網址時是否遺漏開頭或結尾字元。接著確認系統時間、目前網路連線與用戶端記錄。若請求成功但解析結果為空,可能是回傳格式與用戶端支援範圍不一致。不要反覆刪除所有設定,應保留原訂閱項目並逐項驗證。
查看訂閱匯入步驟 →系統代理只會對讀取該設定的應用程式生效。先檢查目標程式是否有獨立代理選項,再確認它是否使用自己的網路堆疊。需要接管更廣泛的流量時,可以評估 TUN 模式,但應先確保節點在一般代理模式下運作正常,並避免多個網路工具同時修改路由表。
查看系統代理與 TUN 概念 →先區分 DNS 解析慢、建立連線慢與內容傳輸慢。可以更換目標網站交叉測試,並觀察記錄中是否反覆解析或重新連線。接著檢查路由規則、DNS 查詢路徑、傳輸方式與本機網路。不要只依賴單次測速結果,因為不同目標、時間與線路會產生明顯差異。
進入速度問題排查章節 →協定必須與伺服器設定一致,不能在用戶端中任意互換。選擇時應核對伺服器提供的協定、連接埠、使用者識別碼、安全層與傳輸參數。若取得的是完整訂閱,通常直接匯入比手動改寫更可靠;若需要手動設定,則應逐欄位對照原始資料。
查看協定概念速查 →FIELD NOTES
整理路由規則、地理資料與 Windows 安裝流程的長篇文章。文中的設定片段用於說明欄位關係,實際參數仍應以目前用戶端介面與伺服器設定為準。
以 v2rayN 路由設定為例,說明 domain、ip、geosite 規則的比對順序,整理直連、代理與廣告阻擋的常用組合,並說明規則衝突時如何從記錄與出口標籤定位問題。
閱讀全文 →說明 geoip.dat 與 geosite.dat 的職責、常見存放位置與載入關係,介紹 v2rayN、v2rayNG 更新地理資料後的驗證方法,以及資料過期導致路由命中偏差的典型現象。
閱讀全文 →從安裝套件類型開始,涵蓋執行環境、解壓縮啟動、訂閱匯入、系統代理與連線驗證,並整理安全軟體攔截、連接埠占用、權限不足與設定目錄遷移等常見問題。
閱讀全文 →