桌面端 · Windows / macOS / Linux
v2rayN
桌面端圖形化用戶端,涵蓋 Windows、macOS 與 Linux;預設搭配 Xray 核心,訂閱管理、路由分流與日誌查看都在同一介面完成。
訂閱管理、路由分流、核心選擇與日誌診斷,是日常使用中最常接觸的四組設定;以下按設定片段逐項說明。
訂閱 → 新增訂閱
位址 https://example.com/api/v1/client/subscribe?token=xxxx
備註 範例訂閱
更新間隔 1440 分鐘
自動更新 開啟
訂閱連結是節點設定的分發方式:用戶端按設定的間隔拉取一份節點清單,本機只保存連結本身,節點的新增與刪除由訂閱方在伺服器端完成。v2rayN 支援新增多條訂閱並分別設定更新間隔,也可以關閉自動更新改為手動重新整理;v2rayNG 的訂閱入口在側邊欄,匯入後可長按重新命名。匯入失敗通常集中在三類原因:連結本身已失效、拉取時網路不通、回傳內容不是標準節點清單。排查時先在瀏覽器開啟連結確認有回傳,再看用戶端更新日誌裡的具體錯誤。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{ "type": "field", "domain": ["geosite:cn"], "outboundTag": "direct" },
{ "type": "field", "ip": ["geoip:cn"], "outboundTag": "direct" },
{ "type": "field", "network": "tcp,udp", "outboundTag": "proxy" }
]
}
}
路由決定一條連線走代理還是直連,規則按由上到下的順序比對,命中即停止,所以直連規則必須排在最後的代理規則之前。網域規則用 geosite:cn 涵蓋常見的中國大陸網站,IP 規則用 geoip:cn 兜住網域解析後的位址;domainStrategy 設為 IPIfNonMatch 時,網域規則不命中才會解析出 IP 再比對一次。改動規則後需要重新載入設定或重啟核心才會生效,日誌裡會印出實際命中的規則標籤,可以用它驗證分流是否符合預期。
核心設定
目前核心 Xray-core
備選核心 V2Fly-core
切換路徑 設定 → 核心設定 → 選擇核心檔案
生效方式 重啟核心後生效
圖形化用戶端本身不處理代理流量,真正建立連線的是核心:v2rayN 與 v2rayNG 預設搭配 Xray-core,也支援切換到 V2Fly-core。兩者共享 VMess、VLESS 等協定基礎,設定格式高度一致,Xray 在 REALITY、XTLS Vision 等新特性上跟進更快,V2Fly 對舊設定的相容更保守。切換核心只影響本機的解析與對外連線實作,節點能否使用仍取決於伺服器端設定;遇到某個協定在新核心下報錯,可以先用另一個核心驗證問題出在設定還是核心差異。
{
"log": {
"loglevel": "warning",
"access": "none",
"error": ""
}
}
執行日誌按時間順序記錄三件事:設定載入、與節點握手、連線按規則對外送出。看日誌先找第一條 error,它上方的幾行通常提供上下文;failed to parse 指向設定語法問題,connection refused 表示目標不可達,context deadline exceeded 多為逾時。把 loglevel 調到 warning 可以過濾日常雜訊,調成 debug 則能看到完整的握手過程,排查完記得調回。日誌面板支援清空與匯出,對照出問題的時間點定位會更直接。
每個平台對應不同的用戶端與安裝檔格式,點擊卡片進入下載頁查看檔案明細與系統需求。
三款用戶端都建立在 Project V 的開源協定體系之上;理解核心與用戶端的關係,有助於選擇版本與讀懂設定。
Project V 是一套開源網路代理工具的統稱,最初指 v2ray-core 核心及其配套的設定協定。2020 年前後,社群圍繞維護節奏產生分歧:一支團隊以 V2Fly 的名義繼續維護 v2ray-core,另一支團隊在相同協定體系上重寫了傳輸層,形成 Xray-core。今天所說的 V2Ray 用戶端,實際上是這兩個核心的圖形化外殼——用戶端負責介面、訂閱管理與路由設定,核心負責建立連線、處理加密與傳輸。
V2Fly 與 Xray 共享 VMess、VLESS、Trojan 等協定基礎,設定檔的欄位名稱與結構高度一致,同一份設定通常可以在兩個核心之間轉移。差異在演進方向:Xray 側重傳輸效能與新協定特性,REALITY、XTLS Vision 這類方案都先在 Xray 落地;V2Fly 側重穩定性,對舊版本設定的相容更保守。v2rayN 與 v2rayNG 預設使用 Xray 核心,同時保留核心切換入口,方便對照驗證。
三款用戶端都以開源授權發布,原始碼公開可查,使用與散布不收取費用。v2rayN 與 v2rayNG 採用 GPL-3.0 授權,V2Fly 核心使用 MIT 授權,Xray 核心使用 MPL-2.0 授權,都允許在保留著作權聲明的前提下自由再散布。日常維護由社群完成:問題回報、版本發布與文件更新不依賴商業實體,這也是同類工具能夠長期存在的原因之一。
站內下載入口透過版本清單動態解析到目前發布的檔案,清單由部署層維護,頁面本身不快取安裝包。用戶端側的更新由各自的內建檢查或發布管道完成,核心與用戶端版本相互獨立,可以分別升級。訂閱內容的更新則是另一條鏈路:服務提供方在伺服器端增刪節點,用戶端按訂閱設定的間隔拉取,本機不需要手動改動設定。
站內教學按先結論後步驟的結構組織,設定片段取自用戶端的實際設定項,術語統一收斂到名詞解釋頁的條目上。由於圖形化用戶端的介面會隨版本調整,文件描述的是設定路徑而不是按鈕的絕對位置;遇到介面與描述不一致時,以用戶端目前版本的設定項為準。問題診斷頁按症狀分章,可以先定位現象再看對應章節。
桌面端 · Windows / macOS / Linux
桌面端圖形化用戶端,涵蓋 Windows、macOS 與 Linux;預設搭配 Xray 核心,訂閱管理、路由分流與日誌查看都在同一介面完成。
行動端 · Android
Android 端用戶端,基於 Xray 核心;支援訂閱匯入、依應用程式分流與本機 DNS 設定,介面按觸控操作設計。
行動端 · Android
Android 端的 V2Fly 核心版本,介面與 v2rayNG 保持一致;適合需要舊設定相容、或想對照核心差異的情境。
四條高頻問題的簡短回答,完整分類問答見常見問題頁,系統化排查見問題診斷頁。
按平台安裝、協定科普與故障排查整理的近期文章,都附可對照的設定片段。
Windows 上 v2rayN 兩種介面版本怎麼選、從安裝到連線的分步流程,以及系統匣、權限、開機自動啟動等常見陷阱。
閱讀全文 →從 TLS 握手與傳輸層加密切入,說明 REALITY 與 XTLS Vision 各自解決的問題、付出的代價與適用條件。
閱讀全文 →以中國大陸與境外分流為例,拆解路由規則的比對順序、網域與 IP 規則寫法、代理與直連邊界,附可直接改用的規則骨架。
閱讀全文 →