DESKTOP
Windows
Windows 桌面環境可優先查看 v2rayN。下載頁會分別說明新一代桌面介面與經典 WPF 介面的適用範圍;已有設定可先備份訂閱群組與路由設定,再決定安裝方式。
前往下載PLATFORM DOWNLOAD
先確認裝置平台與處理器架構,再選擇對應用戶端。首頁入口只負責平台分流,具體安裝檔類型、系統需求與檔案說明請集中到下載頁核對。
DESKTOP
Windows 桌面環境可優先查看 v2rayN。下載頁會分別說明新一代桌面介面與經典 WPF 介面的適用範圍;已有設定可先備份訂閱群組與路由設定,再決定安裝方式。
前往下載DESKTOP
macOS 使用 v2rayN 桌面用戶端。下載前應在系統資訊中確認處理器類型,Apple Silicon 與 Intel 對應不同檔案;匯入訂閱後的代理模式、路由規則與桌面端操作邏輯,和其他平台大致相同。
前往下載MOBILE
Android 可在 v2rayNG 與 v2flyNG 之間選擇。前者採用 Xray 核心,適合常見的 Xray 設定;後者採用 v2fly 核心,可作為 V2Fly 生態設定的對應用戶端。下載時還需區分 arm64 與通用版本。
前往下載DESKTOP
Linux 桌面端使用 v2rayN,可依發行版選擇 deb 或 rpm,同時核對 x64 與 arm64 架構。安裝完成後應分別檢查用戶端程序、系統代理狀態與桌面環境的網路設定,避免只啟動核心卻未接管應用程式流量。
前往下載CLIENT WORKSTATION
用戶端名稱相近,但平台、核心家族與設定入口並不完全相同。先依裝置選擇用戶端,再依訂閱、節點、代理模式、路由規則的順序設定。
v2rayN 涵蓋 Windows、macOS 與 Linux,適合需要集中管理多個訂閱群組、手動節點與路由規則的桌面環境。常見流程是建立訂閱群組、更新伺服器清單、執行真實連線測試、選擇使用中的節點,再啟用合適的系統代理模式。用戶端可呼叫 Xray 或 V2Fly 相關核心功能,實際協定可用性取決於目前核心與設定內容。排查時應分別驗證用戶端日誌、系統代理與瀏覽器連線,不要只根據節點清單中的單一狀態判斷。
v2rayNG 面向 Android,採用 Xray 核心,適合匯入 VLESS、VMess、Trojan 等常見設定。訂閱更新後,應先確認新設定已進入目前群組,再選擇使用中的節點並啟動系統連線。分應用程式代理、略過區域網路與路由預設會直接影響哪些流量進入代理鏈路,因此出現部分應用程式可用、部分失敗時,應優先核對這些選項。行動網路與無線網路切換後,可重新建立連線並查看日誌中的網域解析、握手與路由結果。
v2flyNG 同樣面向 Android,但核心路線對應 V2Fly 生態。它適合已有設定明確依賴 v2fly 核心行為,或需要與其他裝置上的 V2Fly 設定保持一致的情境。操作順序仍是匯入訂閱、更新群組、選擇節點、啟動連線並檢查日誌。若同一訂閱在不同用戶端中的表現不同,應比較協定參數、傳輸層欄位、DNS 設定與路由規則,而不是直接複製某個用戶端的所有開關;核心支援範圍與用戶端介面選項需要分別核對。
QUICK START
首次設定不要同時修改大量進階選項。先建立一條可重現的基礎連線,再逐步加入路由、DNS 與分應用程式規則,遇到問題時才能明確定位變更來源。
複製完整的 V2Ray 訂閱連結,在用戶端的訂閱群組或訂閱設定中新增網址,然後執行更新。更新完成後不要立即連線,先檢查伺服器清單是否確實出現設定,並確認這些設定位於剛建立的群組。若清單為空,應依序檢查網址是否複製完整、網路是否能存取訂閱來源,以及用戶端日誌是否回傳格式解析錯誤。QR Code 與單節點連結適合臨時匯入,長期維護多個節點時,使用訂閱群組更容易統一更新並區分來源。
從目前群組中選擇一個節點作為使用中的設定,可先執行真實連線測試,確認完整握手鏈路能夠建立。桌面端接著設定系統代理模式,Android 端則啟動系統連線。首次驗證建議先使用用戶端提供的基礎代理模式,暫緩疊加複雜分流。全域代理代表更多流量進入代理輸出,規則模式則依據網域、IP、連接埠與程序等條件決定直連或代理。兩者只是流量選擇策略,無法修復訂閱參數錯誤或節點本身無法連線的問題。
啟動連線後,先用瀏覽器造訪一個確定可用的頁面,再觀察用戶端日誌是否記錄對應請求。桌面端還應確認作業系統的代理設定已寫入,以及關閉用戶端後是否如預期恢復。若只有部分網站失敗,應查看網域解析與路由比對;若所有連線都逾時,則優先檢查節點位址、連接埠、協定參數與本地網路。完成基礎驗證後,再加入 geosite、geoip、廣告封鎖或分應用程式規則,每次只變更一組設定並保留前後日誌。
OPEN SOURCE ECOSYSTEM
用戶端負責介面、訂閱與系統整合,核心負責協定、傳輸、路由與輸出處理。區分這兩個層次,是理解用戶端差異與排查設定問題的基礎。
Project V 是由 V2Ray 相關技術與工具形成的早期開源生態,核心設定模型圍繞入站、輸出、路由、DNS、傳輸與策略組織。隨著社群演進,V2Fly 延續並維護 v2ray-core 路線,Xray 則在相近設定思路上發展出另一條核心路線。兩者存在大量相通概念,但協定支援、欄位細節、傳輸能力與預設行為可能不同。因此,看到「V2Ray 設定」時不能只看名稱,還需要確認用戶端實際呼叫的核心,以及訂閱產生的設定目標。
圖形化用戶端不等於核心。v2rayN 主要處理桌面端的訂閱管理、節點選擇、系統代理、路由編輯、日誌檢視與核心呼叫;v2rayNG 與 v2flyNG 則將相似功能整合到 Android 的系統連線流程。連線失敗時,介面層可能正常顯示節點,但核心仍可能因欄位不相容、憑證名稱不匹配、傳輸參數缺失或路由標籤錯誤而停止處理。日誌中的具體階段,比單一的「已啟動」狀態更具判斷價值。
開源授權規定了程式碼使用、修改與再發佈的界線,不同專案應以各自發佈內容中的授權文字為準。對一般使用者而言,開源維護的直接意義在於設定格式、問題討論與變更紀錄能持續接受檢視。選擇用戶端時仍應根據平台、核心需求與設定來源判斷,而不是把所有採用相似協定名稱的用戶端視為完全等價。
更新機制也應分層理解:用戶端更新負責介面功能、平台適配與訂閱管理邏輯,核心更新負責協定實作、路由能力與底層網路處理,規則資料更新則會影響網域與 IP 分類。三者不一定同步發佈。遇到舊設定在更新後行為改變時,應記錄用戶端設定、核心類型、規則來源與錯誤日誌,再逐項比較;直接清空所有設定會遺失最有價值的排查脈絡。
開源桌面用戶端,負責多個桌面系統上的訂閱群組、節點管理、代理模式與路由設定。使用時需同時確認介面版本、所選核心類型與系統代理狀態。
開源 Android 用戶端,採用 Xray 核心路線。適合需要分應用程式代理、行動網路切換、QR Code 匯入與常見 Xray 協定設定的裝置。
開源 Android 用戶端,採用 v2fly 核心路線。適合需要匹配 V2Fly 設定行為,或希望在行動裝置上保留該核心體系的使用情境。
CHECKLIST
以下問題依設定鏈路排序。先檢查本地代理接管,再檢查節點握手,最後處理路由與 DNS,通常比反覆切換節點更容易定位原因。
先確認更新的是目前使用的訂閱群組,再檢查訂閱網址是否完整,以及更新日誌是否回傳解析錯誤。多個群組名稱相近時,節點可能已進入另一個群組。
查看訂閱問題 →桌面端檢查系統代理是否寫入,以及瀏覽器是否採用系統設定;Android 則檢查系統連線是否建立。接著再查看節點握手與網域解析日誌。
進入故障排除 →全域模式會將更多流量交給代理輸出,規則模式則依比對條件選擇直連、代理或封鎖。首次連線可先驗證基礎鏈路,再逐步設定分流規則。
查看路由術語 →ping、真實連線延遲與下載測速測量的對象不同。完整速度還會受到握手、線路壅塞、伺服器負載、傳輸方式與目標網站回應影響。
了解測速差異 →LATEST NOTES
從路由規則、首次連線與用戶端介面三個入口補充操作細節。文章中的步驟與術語頁、故障排除頁相互對應,方便依問題繼續查閱。