桌面系統
前往下載
Windows · v2rayN
提供新一代桌面介面與經典 WPF 介面。首次使用可優先選擇桌面版；若已有固定操作習慣或需要經典選單結構，可在下載頁查看 WPF 版說明。
平台 Windows · macOS · Android · Linux
用戶端 v2rayN · v2rayNG · v2flyNG
核心 Xray · V2Fly
特性 免費 · 開源 · 社群維護
平台下載入口
依作業系統選擇 V2Ray 用戶端
桌面系統使用 v2rayN，Android 可在 v2rayNG 與 v2flyNG 之間選擇。以下入口會開啟下載頁對應的平台面板，安裝套件類型、架構選擇與系統需求皆會在面板中說明。
桌面系統
前往下載
macOS · v2rayN
請依裝置處理器選擇 Apple Silicon 或 Intel 安裝套件。進入系統的「關於這台 Mac」即可查看晶片類型，安裝後的訂閱與路由選單和其他桌面版本大致相近。
行動系統
前往下載
Android · v2rayNG / v2flyNG
v2rayNG 使用 Xray 核心，適合作為日常使用的入口；v2flyNG 使用 V2Fly 核心，可依伺服器端設定與使用偏好選擇。主流裝置通常選擇 arm64，無法確認時可查看通用版。
桌面系統
前往下載
Linux · v2rayN
Debian、Ubuntu 等系統選擇 deb，Fedora、Rocky Linux 等系統選擇 rpm。下載頁也會區分 x64 與 arm64 架構，並列出安裝前需確認的桌面環境條件。
設定能力
從訂閱到路由的完整操作流程
用戶端的關鍵價值不只是匯入一個連線。訂閱如何更新、系統代理接管哪些程式、路由規則依何種順序比對、何時需要啟用 TUN 模式，都會直接影響實際使用結果。本區依照實際設定項目拆分六類能力，先提供操作入口，再說明適用範圍與檢查方式。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}分開檢查位址、分組與更新狀態
在 v2rayN 中可透過「訂閱分組 → 訂閱分組設定」儲存訂閱位址，再執行「更新所有訂閱」取得伺服器清單。分組名稱用於整理不同來源，不會改變節點參數。若更新後清單為空，應依序確認位址是否完整、回傳內容能否由用戶端解析、目前網路是否允許請求，以及用戶端日誌是否出現格式提示。相較於逐筆貼上分享連結，訂閱更適合持續維護一組會變動的設定。
先確認接管範圍，再選擇代理模式
系統代理主要接管遵循作業系統代理設定的瀏覽器與桌面程式。v2rayN 啟動核心後，還需要在系統匣選單中選擇相應的系統代理狀態；只啟動用戶端並不代表所有程式都已使用代理。若某個應用程式的連線方式不同，應先檢查它是否讀取系統代理，再決定是否設定應用程式本身的代理或使用 TUN。如此可避免將程式相容性問題誤判為節點故障。
規則依序比對，出口標籤決定去向
routing 區段可依網域、IP、連接埠、協定或入站標籤選擇出站。常見做法是先處理區域網路與私有位址，再比對需要直連或代理的目標，最後保留預設出口。規則並非彼此覆蓋，而是依設定順序尋找符合項目。修改後應重點檢查網域策略、規則順序，以及 outboundTag 是否對應現有出站；若標籤拼寫不一致，核心通常會在啟動日誌中給出明確提示。
用於不讀取系統代理的程式與更完整的流量接管
TUN 模式透過虛擬網路介面處理流量，適合部分不讀取系統代理設定的程式。啟用前應確認用戶端所需權限、虛擬介面狀態，以及本機其他網路工具是否存在衝突。排查時不要同時頻繁切換多項設定：先關閉系統代理測試 TUN，再恢復單一路由方案，並透過日誌確認 DNS 與出站選擇。清楚控制變數，比反覆重新安裝更容易定位問題。
用戶端負責互動，核心負責協定與轉發
v2rayN 是桌面圖形化用戶端，可搭配其支援的核心處理連線；v2rayNG 以 Xray 核心為主要實作，v2flyNG 則採用 V2Fly 核心路線。兩類核心都源自 Project V 生態系，但支援的設定範圍與功能演進節奏並不完全相同。選擇時應以伺服器端協定、傳輸參數與用戶端支援情況為準，不宜只按名稱判斷。若匯入成功但啟動失敗，核心相容性是需要檢查的項目之一。
先讀取第一筆有效錯誤，再決定要修改哪一層
核心啟動失敗、訂閱解析異常與連接埠遭占用，通常都會留下可定位的日誌。排查時從錯誤發生時間附近開始，優先讀取第一筆包含欄位名稱、連接埠或設定區段的有效錯誤，而不是只看最後一行退出訊息。連接埠遭占用時檢查本機監聽程式，設定錯誤時檢查對應 JSON 欄位，傳輸不匹配時則對照伺服器端參數。每次只修改一個變數並重新啟動，才能保留清楚的因果關係。
快速入門
安裝、匯入、啟用三步驟
先建立一條可重現的基礎連線，再逐步加入自動更新、路由與 TUN。初次設定時一次只變更一個選項，發生問題時更容易判斷出錯環節。
-
01
選擇系統與用戶端
桌面系統進入 v2rayN 對應的平台面板，Android 則依核心需求選擇 v2rayNG 或 v2flyNG。安裝前確認處理器架構與安裝套件類型，避免將架構不匹配誤認為程式無法啟動。首次開啟後先維持預設路由與預設連接埠，不要急著調整進階參數。
-
02
匯入訂閱並更新清單
在用戶端的訂閱分組設定中新增位址，儲存後執行更新。伺服器清單出現後，選擇一筆設定並設為作用中伺服器。若清單為空，先查看訂閱更新日誌；若節點存在但無法啟動，再查看核心日誌，不要在同一輪排查中混淆兩類問題。
-
03
啟動核心並選擇接管方式
確認作用中伺服器後啟動核心，再依應用程式類型選擇系統代理。一般瀏覽器通常先測試系統代理；不讀取系統代理的程式，再評估 TUN。基礎連線穩定後，最後加入略過區域網路、網域比對與指定出口等路由規則。
開源生態系
Project V、V2Fly 與 Xray 的關係
用戶端、核心、協定設定與訂閱服務各自負責不同工作。理解這些界線，有助於判斷問題屬於介面操作、設定內容、核心相容性，還是遠端服務。
從 Project V 到平行維護的核心家族
Project V 奠定了 V2Ray 設定體系的基本結構：入站負責接收本機流量，出站負責定義轉發目標，routing 在兩者之間執行比對，dns 與 log 則提供網域解析與執行紀錄。V2Fly 社群持續維護 V2Ray Core 及相關規範，Xray 則沿著相同技術脈絡發展出獨立核心。兩者共用不少設定概念，但實際欄位、協定擴充與發佈節奏可能有所差異。
因此，「用戶端支援某種分享連結」與「目前核心能完整處理對應參數」是兩個不同的判斷。圖形化用戶端可以解析訂閱、產生設定並管理程序，真正執行協定交握、路由與轉發的是核心。伺服器端參數變更時，應同時核對用戶端解析能力與核心支援範圍，而不是只檢查介面中是否出現伺服器名稱。
開源協定與公開協作方式
v2rayN、v2rayNG、v2flyNG 以及相關核心皆採開源方式維護。原始碼、設定格式與變更紀錄由各專案公開管理，功能討論、問題修復與相容性調整由維護者和社群參與者持續推進。開源特性方便開發者理解設定如何產生，也讓進階使用者能依據日誌與欄位定義找出行為差異。
不同元件可能採用不同的開源授權條款；授權條款規範的是程式碼複製、修改與再發布方式，不代表所有用戶端都由同一團隊維護。閱讀文件時應明確確認對象：v2rayN 的選單路徑不能直接套用於行動端用戶端，Xray 的擴充欄位也不應假定能在每個 V2Fly 設定中使用。依元件查閱對應說明，可減少概念混用。
更新機制與相容性判斷
用戶端更新通常包含介面調整、訂閱解析變更、設定產生修正與核心管理能力；核心更新則更集中於協定實作、傳輸行為、路由與 DNS。發生「更新前可用、更新後異常」時，應先記錄變更的是用戶端、核心還是訂閱內容，再逐層回看日誌。若同時替換多個元件，很難判斷真正影響結果的變數。
日常維護可採用固定順序：先更新訂閱並觀察節點清單，再啟動目前已知的設定，最後才調整代理模式與路由。對於長期使用的規則，應保留規則目的、比對條件與出口標籤說明。如此即使介面選單調整，也能從設定語意還原原本的行為，而不必依賴某個按鈕的位置。
v2rayN
面向 Windows、macOS 與 Linux 的圖形化用戶端，集中管理訂閱分組、伺服器清單、系統代理、路由規則、TUN 與核心日誌。適合需要在桌面端維護多組設定並觀察執行狀態的使用者。
v2rayNG
以 Xray 核心為主要實作的行動端用戶端，支援透過掃描 QR Code、剪貼簿與訂閱匯入設定。常用操作圍繞設定清單、作用中節點、路由設定與連線日誌展開。
v2flyNG
採用 V2Fly 核心路線的行動端選擇，介面操作與常見訂閱流程保持清楚分層。適合明確需要 V2Fly 核心相容範圍，或希望比較兩類核心行為的使用情境。
常見問題精選
先區分訂閱、核心與代理模式
多數設定問題都可以先依發生階段分類。清單沒有內容時，重點查看訂閱請求與解析；程式無法啟動時，重點查看核心日誌；只有部分應用程式不生效時，重點查看流量接管方式。
訂閱更新後伺服器清單為空
先確認儲存的是完整訂閱位址，再查看更新日誌中的網路請求與解析提示。能開啟位址不代表回傳內容符合用戶端支援的訂閱格式；若近期更換了訂閱來源，也應檢查分組中是否仍保留舊位址。
查看訂閱匯入步驟 →啟動後瀏覽器仍使用原本的連線
檢查是否已選取作用中伺服器、核心是否正在執行，以及系統匣選單中的系統代理狀態。部分程式有獨立的代理設定，或不會讀取系統設定，需要個別設定，或確認權限與衝突後使用 TUN。
查看連線與驗證步驟 →核心啟動後立即退出
從日誌中找出第一筆明確錯誤，常見線索包括連接埠遭占用、出站標籤不存在、設定欄位類型不正確或傳輸參數缺失。修正一項後重新啟動，不要同時修改連接埠、路由與核心。
查看完整排查流程 →全域代理與路由分流該如何選擇
全域代理適合短時間驗證節點與核心是否能正常運作；確認基礎連線後，再切換至路由分流並逐條加入規則。先驗證預設出口，再增加區域網路、網域與 IP 規則，可以更快找出比對順序問題。
查看路由分流章節 →
設定資訊
最新 v2rayN 使用與排查文章
圍繞主介面分區、日誌定位與 JSON 設定結構整理具體操作。文章以單一問題展開，方便完成基礎教學後繼續查閱。