Windows
v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面,WPF 版保留經典視窗配置。請先依下載頁列出的系統需求選擇,不要把介面差異當成節點效能差異。
安裝前先關閉正在執行的舊版本,避免兩個程序爭用本機監聽連接埠。若需要移轉,先備份訂閱群組和路由設定,保留一份可正常運作的設定,再測試新環境。涉及 TUN 的權限問題,應在系統代理連線成功後再個別處理。
前往下載 Windows 用戶端設定索引 / 從連線入口到流量路徑
先讓一個節點成功連線,再逐步加入分流與流量接管功能。以下片段用於說明設定與核心組態的對應關係,並非可直接取代的完整設定;不同核心的欄位不可混用,介面名稱也可能隨用戶端更新略有不同。
訂閱群組 › 訂閱群組設定 › 新增
在「訂閱群組設定」中新增名稱和訂閱網址,儲存後再到「訂閱群組」執行更新。先嘗試不透過代理更新,只有在網址確實需要代理才能存取時,才切換更新方式。管理訂閱比逐一匯入連結更適合批次維護;不過,更新成功只代表已取得內容,不代表每個節點都能連線。匯入後,選擇一個節點設為作用中伺服器,再實際測試連線。訂閱網址通常含有存取憑證,請勿放進公開截圖,也不要交給來路不明的轉換網站。
{
"outbounds": [
{ "tag": "proxy", "protocol": "vmess" }
]
}
此片段僅展示 Xray 的出站結構;伺服器位址、使用者資訊與傳輸參數會由匯入的內容產生。
查看訂閱匯入步驟 →設定 › 路由設定 › 預設規則
先從「路由設定」中的預設規則開始,確認中國大陸網域、私人位址及其他流量分別使用哪個出站,再新增自訂規則。規則通常由上而下比對,範圍較廣的規則若排在前面,可能會遮蔽後續的精確規則。相較於只切換全域代理,路由分流能保留區域網路服務原有的連線路徑,但也仰賴網域分類資料與解析結果。排查特定網站時,先查看命中的出站,不要同時修改節點、DNS 和規則。片段中的出站標籤必須存在於實際設定中。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{ "type": "field", "ip": ["geoip:private"], "outboundTag": "direct" },
{ "type": "field", "domain": ["geosite:cn"], "outboundTag": "direct" }
]
}
}
查看 geosite 與 geoip 規則指南 →
主視窗 › 系統代理 › 自動設定系統代理
選擇作用中伺服器後,在主視窗將「系統代理」設為「自動設定系統代理」。這會修改系統代理設定,但不會強制接管所有應用程式;有內建代理設定的程式仍需個別檢查。前往「參數設定」中的「Core:基本設定」,確認本機混合監聽連接埠,再讓應用程式連線至同一個連接埠。相較於 TUN,這種方式較容易檢查瀏覽器流量,也更適合首次測試。離開用戶端前,請清除系統代理,避免系統繼續連到已停止監聽的本機位址。
{
"inbounds": [
{
"tag": "http",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "http"
}
]
}
此處以 Xray 的 HTTP 入站說明本機代理入口,不代表圖形介面產生的所有監聽設定。
查看系統代理測試步驟 →設定 › 參數設定 › TUN 模式設定
TUN 透過虛擬網路介面接管流量,適合無法手動設定代理的應用程式。先用系統代理確認節點可正常使用,再檢查「TUN 模式設定」,依平台要求授予網路設定權限後啟用。相較於系統代理,TUN 影響範圍更廣,也較容易與其他虛擬網卡或企業網路軟體發生路由衝突。首次測試時保留預設參數,確認直連網站和區域網路服務是否正常。若發生斷線,先關閉 TUN 還原基準狀態,再分別檢查路由與 DNS,避免連續疊加多種流量接管工具。
{
"inbounds": [
{
"type": "tun",
"tag": "tun-in",
"address": ["172.19.0.1/30"],
"auto_route": true
}
]
}
這是 sing-box 的 TUN 入站片段,不可貼入 Xray 設定。
查看 TUN 連線問題診斷 →設定 › DNS 設定
DNS 決定網域名稱會先解析成哪個位址,路由則決定連線交由哪個出站處理。進入「DNS 設定」時,先確認目前設定的是哪個核心,不要直接拼接不同核心的欄位。依網域選擇解析伺服器,可減少所有網域共用單一解析路徑造成的誤判,但解析伺服器本身也必須能連線。啟用加密 DNS 不代表解析請求一定會經過代理,也要檢查它的連線路由。若網域無法存取但直接連線位址正常,先查看解析記錄與快取,再調整遠端 DNS。
{
"dns": {
"servers": [
{
"address": "223.5.5.5",
"domains": ["geosite:cn"],
"expectIPs": ["geoip:cn"]
},
"https://dns.google/dns-query"
]
}
}
Xray DNS 結構範例。實際解析伺服器與存取路由應依目前的網路環境測試。
查看 DNS 分流設定指南 →設定 › 參數設定 › 核心類型設定
圖形用戶端負責管理節點,實際建立連線的是核心。進入「核心類型設定」時,先確認節點使用的協定、傳輸方式與安全參數,再選擇對應的核心;不要只因名稱相似,就認定設定欄位完全相容。使用多個核心是為了支援不同設定,不代表切換後一定會更快。變更後重新啟動連線,並檢查記錄是否出現不支援的欄位或協定。保留原本可正常運作的設定,每次只測試一項變更,比一次換掉所有設定更容易找出問題。
{
"log": {
"loglevel": "warning"
},
"outbounds": [
{ "tag": "direct", "protocol": "freedom" }
]
}
Xray 的記錄與直連出站片段;其他核心應使用各自對應的設定語法。
查看核心啟動與設定錯誤排除 →先備份原有設定,再匯入訂閱、選擇作用中伺服器、實際測試連線,最後啟用系統代理。每完成一步就確認結果,避免把訂閱下載失敗、節點連線失敗和瀏覽器未使用代理混為一談。如果已經修改過多項參數,可先退出其他代理工具、關閉 TUN,回到單一節點搭配系統代理的基本測試環境。
實際連線測試會嘗試透過節點連線至測試目標;Tcping 主要反映伺服器連接埠的連線狀況。兩者測試的對象不同,連接埠可連通不代表協定交握成功;測試目標暫時無法連線,也不一定表示節點完全失效。比較結果時,請保持網路、目標和測試方式一致,再開啟實際要使用的網站確認,不要只靠單一數字評估整體體驗。
依完整教學完成首次連線 →用戶端選擇 / 作業系統與處理器
桌面系統使用 v2rayN;Android 裝置優先選擇 v2rayNG,需要 V2Fly 核心時再考慮 v2flyNG。下載頁依作業系統和處理器整理安裝選項;安裝用戶端後仍需要有效的節點資訊,安裝套件不會提供可用伺服器,也不會自動建立訂閱。
v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面,WPF 版保留經典視窗配置。請先依下載頁列出的系統需求選擇,不要把介面差異當成節點效能差異。
安裝前先關閉正在執行的舊版本,避免兩個程序爭用本機監聽連接埠。若需要移轉,先備份訂閱群組和路由設定,保留一份可正常運作的設定,再測試新環境。涉及 TUN 的權限問題,應在系統代理連線成功後再個別處理。
前往下載 Windows 用戶端v2rayN 提供 Apple Silicon 與 Intel 版本。請在系統的「關於這台 Mac」查看晶片或處理器,再選擇對應的安裝套件;不要依電腦外觀或購買年份猜測架構。
首次開啟時,依照系統安全提示確認應用程式來源與所需權限。連線測試先從瀏覽器開始,再檢查系統代理設定;如需啟用 TUN,請另外確認網路權限及其他網路延伸功能。切換 Wi-Fi 後若連線異常,請重新檢查預設網路路徑。
前往下載 macOS 用戶端優先使用採用 Xray 核心的 v2rayNG,v2flyNG 則是 V2Fly 核心的替代選擇。主流裝置通常選擇 arm64;若不確定裝置架構或遇到安裝相容性問題,再查看下載頁的通用版說明。
匯入節點後,需同意系統的 VPN 連線要求。系統通常只允許一個此類連線保持作用中,啟用其他網路接管應用程式可能會中斷目前的連線。若前景使用正常、鎖定螢幕後失效,請優先檢查電池最佳化和背景執行限制,再排查節點本身。
前往下載 Android 用戶端v2rayN 提供 deb 與 rpm 安裝套件,並區分 x64 和 arm64。請先確認發行版使用的套件管理方式,再核對處理器架構;套件格式與處理器架構是兩項獨立條件。
圖形桌面的系統代理設定不一定會套用到終端機程式。即使瀏覽器連線成功,仍應確認目標應用程式是否使用桌面代理,或是否需要設定獨立的代理入口。TUN 也涉及網路權限與路由;在遠端維護環境中,請先準備還原原有網路設定的方法。
前往下載 Linux 用戶端同一份訂閱可能包含多種協定,但用戶端與核心不一定全部支援。安裝後若部分節點無法匯入,請先查看錯誤訊息中的協定或傳輸欄位,再判斷是否需要調整用戶端或核心。不要為了解決單一節點的問題而反覆重裝整個系統,也不要覆寫尚未備份的路由設定。
移轉設定時只保留必要資料。訂閱網址、節點連結與匯出的設定檔可能包含帳號資訊,分享記錄前請先刪除這些內容。首頁用於選擇用戶端與瀏覽操作方式;具體安裝套件和更新資訊則集中在下載頁,方便依目前的系統重新選擇。
查看所有用戶端 →開源生態系 / 用戶端與核心的分工
圖形介面
v2rayN / v2rayNG / v2flyNG
連線核心
Xray / V2Fly
設定內容
入站 / 出站 / 路由 / DNS
V2Ray 源自 Project V 的模組化網路工具體系。日常搜尋中所說的「V2Ray 用戶端」,常同時指圖形介面和連線核心;實際使用時應分開理解這兩個層次:圖形介面負責儲存訂閱、管理節點並產生設定,核心則讀取設定並處理入站、路由與出站。瀏覽器能否連線,也取決於作業系統和應用程式是否將要求送到這個入口。
這種分層可以解釋一個常見現象:主視窗能正常開啟,訂閱清單也有顯示,但核心可能因連接埠被占用或設定錯誤而無法啟動。因此,「程式已開啟」並不代表「代理已生效」。排查時先確認核心記錄,再核對本機監聽與系統代理,最後檢查網站是否能連線,就能避免反覆重裝。
V2Fly 延續 V2Ray 的社群維護路線;Xray 則是從 V2Ray 發展而來的另一條核心路線。兩者有共同的技術背景,也各自演進協定支援、傳輸能力與設定細節。了解共通概念有助於閱讀設定,但不能因此假定所有新欄位都能互換。遇到協定功能、流量探測或 DNS 行為差異時,應以目前實際執行的核心為準。
v2rayN 的多核心管理功能可在圖形介面中集中管理不同設定,但實際可用的組合仍受用戶端實作方式與核心支援範圍限制。選擇核心時,先確認節點所需的協定與傳輸參數,再考慮既有路由規則是否相容。如果原本能正常連線,切換核心後卻失敗,應先檢查設定相容性,不要直接認定伺服器無法使用。
v2rayN、v2rayNG 與 v2flyNG 都是開源圖形用戶端。v2rayN 和 v2rayNG 採用 GPL-3.0 授權,v2flyNG 也採用 GPL-3.0 授權;V2Fly 與 Xray 核心則採用 MPL-2.0 授權。用戶端與核心是不同專案,應分別確認授權適用範圍。開源表示程式碼及相關授權條件可供研究與檢視,不代表任何來源的重新打包版本都有相同的維護品質。
桌面版的重點在於訂閱管理、系統代理和多核心設定;Android 版還需配合系統 VPN 介面與背景執行策略。v2rayNG 適用於 Xray 核心設定,v2flyNG 則提供 V2Fly 核心方案。選擇時應考量裝置、協定和既有設定,不要把用戶端名稱當成速度排名;同一款用戶端在不同節點與網路環境下,表現也會有所不同。
用戶端更新、核心更新和路由分類資料更新,解決的是不同問題。介面更新可能調整設定入口;核心更新可能影響協定行為;分類資料更新則可能改變網域或位址的比對結果。更新前記錄目前的作用中伺服器、系統代理狀態和路由預設,並備份必要設定;更新後先確認原有連線正常,再啟用新增功能。
不建議在同一次排查中同時更換訂閱、核心、DNS 和整套路由。保留可正常運作的基準設定,每次只變更一類設定,結果才有比較價值。若更新後只有特定網域異常,請檢查規則比對結果與 DNS;若核心無法啟動,請查看記錄中的欄位錯誤與連接埠占用。問題持續時,可依症狀前往問題診斷頁逐章檢查。
前往 v2rayN 問題診斷 →設定指南 / 最新文章
先分辨「節點尚未建立連線」和「連線後要求走錯路徑」。最新三篇指南分別說明 DNS 洩漏、解析分流與網頁無法瀏覽,依序檢查記錄、系統代理和路由結果,避免只憑用戶端狀態列下結論。
使用線上檢測頁確認 DNS 查詢是否繞過代理,再透過 TUN 模式、遠端 DNS 和流量探測設定,檢查用戶端內的解析路徑。
閱讀檢測與設定指南 →解析 dns 模組中的 servers、domains 與 expectIPs 欄位,說明中國大陸網域與境外網域的 DNS 分流,以及 DoH 伺服器的連線路徑。
閱讀 DNS 設定指南 →依序檢查系統代理、監聽連接埠、節點狀態、系統時間、路由規則與防火牆,找出已連線卻仍無法上網的原因。
閱讀連線排查清單 →