Windows
v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面，WPF 版則保留經典操作方式；請先確認系統需求，再依使用習慣選擇。
前往下載 →CLIENT SELECTION
下載用戶端與平台選擇
先確認作業系統與處理器架構，再選擇安裝套件。桌面版可使用 v2rayN，Android 優先選擇 v2rayNG；若已有 V2Fly 設定，也可了解 v2flyNG。用戶端負責管理設定，實際連線仍需要有效的伺服器資訊。
macOS
選擇 v2rayN 桌面版。先在「關於這台 Mac」確認晶片類型，Apple Silicon 與 Intel 對應不同安裝套件，請勿只憑裝置外觀判斷。
前往下載 →Android
優先選用採用 Xray 核心的 v2rayNG，v2flyNG 則是 V2Fly 核心的替代選擇。通常先查看 arm64 安裝套件；不確定架構時，再參閱通用版說明。
前往下載 →Linux
使用 v2rayN 桌面版，依發行版選擇 deb 或 rpm，再確認 x64 或 arm64 架構。套件格式與處理器架構是兩項獨立條件，都必須符合。
前往下載 →安裝套件只決定用戶端能否在目前裝置上執行，並不決定伺服器採用哪種協定。若已有訂閱，請先確認訂閱說明要求的核心與協定，再選擇安裝套件。不要把其他桌面架構的套件安裝失敗，誤認為訂閱失效。
查看所有用戶端 →CONFIGURATION WORKSPACE
用戶端功能與設定層次
訂閱決定伺服器來源，路由決定流量去向，核心則決定設定能否執行。先釐清這些層次，再調整個別設定。下方片段用於說明欄位，並非可直接取代現有設定的完整檔案；圖形介面的選單名稱也可能隨用戶端版本調整。
匯入訂閱與管理分組
訂閱連結用來取得伺服器設定，不等同於單一伺服器的分享連結。在用戶端依來源新增分組，填入訂閱網址後執行更新，再檢查結果。與逐筆手動新增相比，訂閱更便於集中管理連線參數；但本機修改的項目可能在下次更新時被重設。建議以清楚的分組備註區分來源，先手動更新一次，再設定自動更新。訂閱內容包含連線憑證，排查問題時請遮蔽完整網址，也不要放進公開截圖。
local-inbounds.json
{
"inbounds": [
{
"tag": "socks-in",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "udp": true }
},
{
"tag": "http-in",
"listen": "127.0.0.1",
"port": 10809,
"protocol": "http",
"settings": {}
}
]
}訂閱由用戶端管理，並非通用核心欄位。此處展示匯入設定後可使用的本機入站結構，連接埠需與實際設定一致。
查看訂閱匯入步驟 →路由規則與比對順序
路由規則會依序比對，符合後交由指定出口處理。先加入區域網路與特定網域規則，再加入範圍較大的規則，最後處理其他流量。相較於只切換全域模式，分流可分別安排直連、代理與封鎖，減少彼此影響。設定時請先確認出口標籤確實存在，再檢查網域規則集與位址規則集是否可用。同一條規則中的不同條件通常必須同時符合，請勿把希望分別觸發的條件寫在一起。調整後可透過記錄確認命中的規則。
routing.json
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
},
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
},
{
"type": "field",
"network": "tcp,udp",
"outboundTag": "proxy"
}
]
}
}此片段依賴既有的 direct、proxy 出口與對應規則資料。兜底規則必須放在具體規則之後。
查看路由分流指南 →Xray 與 V2Fly 設定相容性
核心負責處理協定與執行連線，用戶端則負責介面與設定管理。選擇核心時，應依據伺服器的協定與傳輸需求，而非只看名稱。使用 REALITY 與 XTLS Vision 時，需要支援相應功能的 Xray 設定鏈；若已有 V2Fly 設定，則應核對目標核心的欄位說明。兩者共享部分設定概念，但不代表所有欄位都能互換。切換前請先備份原設定，切換後檢查啟動記錄與實際連線，避免把欄位不相容誤判為伺服器故障。
outbound-tags.json
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
},
{
"tag": "block",
"protocol": "blackhole",
"settings": {}
}
]
}這是兩類核心常見的基本出口結構，不是切換核心的指令，也不包含代理伺服器出口。
閱讀核心差異比較 →系統代理與虛擬網卡
系統代理適用於會遵循系統代理設定的應用程式；Tun 模式則透過虛擬網卡接管流量，可涵蓋部分不讀取系統代理的程式。Tun 並非路由規則的替代方案，流量接管後仍須決定要直連或走代理。啟用前請先確認一般代理連線正常，再授予必要權限，並檢查是否有其他虛擬網卡或代理程式同時執行。Android 用戶端通常透過系統 VPN 介面建立流量接管通道，與桌面版的實作方式不能直接畫上等號。若發生異常，請先關閉流量接管，恢復基本連線後再逐項排查。
routing-by-inbound.json
{
"routing": {
"rules": [
{
"type": "field",
"inboundTag": ["socks-in", "http-in"],
"network": "tcp,udp",
"outboundTag": "proxy"
}
]
}
}此片段說明流量接管層與路由層的差異，不會建立虛擬網卡。Tun 的具體設定取決於用戶端及其配套元件。
了解代理模式選擇 →DNS 解析與出口配合
網域解析會將網域名稱轉換為位址，解析路徑與連線路徑需要一併考量。直連網域可使用目前網路可連線的解析服務；代理網域則需確認遠端解析路徑是否暢通。不要只更換 DNS 位址，就認定所有應用程式都採用相同的解析方式；瀏覽器安全 DNS、系統快取與用戶端內建 DNS 可能各自生效。建議先保留可正常運作的基本設定，再分別測試網域解析與目標連線。使用加密解析時，也要留意首次解析解析伺服器自身網域的問題。
dns.json
{
"dns": {
"servers": [
{
"address": "223.5.5.5",
"domains": ["geosite:cn"]
},
"https://1.1.1.1/dns-query"
]
}
}解析服務位址僅供示例。此片段不會單獨指定 DNS 請求的出口路徑，需配合路由與目前核心的行為檢查。
查看 DNS 設定說明 →FIRST CONNECTION
初次設定的三個步驟
先建立一條可供驗證的基本連線，再新增分流與流量接管設定。桌面版主要使用 v2rayN，Android 主要使用 v2rayNG；兩種介面的按鈕位置不同，但匯入、選擇、連線與驗證的順序相同。
STEP 01
匯入訂閱並更新
在訂閱管理中建立分組，貼上完整訂閱網址，儲存後手動更新。若取得的是單一分享連結，請使用剪貼簿匯入或相應的分享匯入功能，不要填入訂閱網址欄位。
更新完成後，先確認清單中是否出現可選設定，再檢查協定類型、連接埠與傳輸欄位是否完整。若清單為空，請優先確認網址是否複製完整、訂閱是否有效，以及目前網路能否連上訂閱服務。反覆重新安裝用戶端通常無法解決來源網址的問題。
STEP 02
選擇設定與代理模式
選取要使用的伺服器設定，並確認目前核心支援該協定。初次使用桌面版可先啟用系統代理，再選擇符合需求的路由模式；Android 則依系統提示授予 VPN 連線權限。
系統代理開關決定哪些應用程式會將要求交給用戶端；路由模式則決定用戶端收到要求後如何轉送，兩者不能互相取代。先使用容易理解的預設設定，確認連線正常後，再新增自訂網域規則，避免同時調整多個選項而難以排查。
STEP 03
驗證連線並還原設定
啟動連線後，分別造訪預期直連與預期走代理的網站，並搭配用戶端記錄判斷實際出口。單次連線測試只能證明該次測試成功，不能代表瀏覽器、下載程式與其他應用程式都使用相同路徑。
若瀏覽器可正常使用、其他應用程式卻連不上，請先檢查該程式是否遵循系統代理。停止使用時，先關閉系統代理或虛擬網卡接管，再結束用戶端；若結束後網路異常，請檢查系統代理是否仍指向已停止的本機連接埠，而非立即修改所有網路設定。
初次排查順序：來源 → 設定 → 流量接管 → 路由
查看完整教學 →
訂閱更新失敗、核心啟動失敗與應用程式連線失敗，分屬不同階段。記下問題發生的階段，每次只修改該階段相關的一項設定，再重複相同測試。如此可保留有效設定，也能避免把 DNS、權限與伺服器參數問題混為一談。
PROJECT V ECOSYSTEM
開源生態系與核心界線
V2Ray 是常見的生態系稱呼，並非介面完全相同的單一應用程式。了解用戶端、核心與協定之間的關係，才能判斷該更換安裝套件、修改設定，還是檢查伺服器端需求。
Project V 與核心家族
Project V 以模組化網路代理工具為核心，設定通常包含入站、出口、路由與 DNS 等部分。V2Fly 延續 V2Ray 相關核心的社群開發，Xray 則以相關程式碼為基礎，發展出自己的協定與傳輸特性。兩條路線背景相近，也各自持續演進設定，不能視為始終相同的可執行程式。
實際選擇應以伺服器需求為依據：先確認協定，再確認傳輸方式與安全層，最後核對核心支援情況。例如 VLESS、REALITY 與 Vision 分別涉及不同設定概念，不能只看到其中一個名稱，就推斷整套連線都相容。用戶端顯示某個選項，也不代表伺服器已啟用相應功能。
核心名稱也不代表速度排名。連線表現還會受到伺服器線路、目標網站、解析結果與本機網路影響。遇到問題時，請保留原本可用的方案，並在相同條件下比較設定變更，比直接更換所有元件更容易得到可靠結論。
圖形化用戶端與連線執行
v2rayN 提供桌面設定管理介面，將伺服器資料、訂閱分組與路由選項整理後，再交由配套核心執行。v2rayNG 適用於 Android，採用 Xray 核心；v2flyNG 適用於 Android，採用 V2Fly 核心。這三款用戶端都是開源專案，但介面功能、核心組合與平台整合方式並不完全相同。
桌面介面支援多平台，不代表各系統的權限與流量接管方式完全一致。不同系統的代理設定、虛擬網卡權限與套件格式都需分別處理。遷移設定時，建議優先移轉明確的伺服器參數或訂閱來源，再核對本機連接埠、檔案路徑與系統相關選項。
用戶端不等同於伺服器服務。安裝完成後仍需匯入有效資料，訂閱有效期限、伺服器連線狀態與用戶端本身的執行狀態應分開判斷。本網站的文件聚焦於用戶端安裝與設定，下載入口與入門步驟則分別整理在對應頁面。
開源授權與使用範圍
開源代表原始碼依授權條件公開，方便社群閱讀、研究與參與維護。V2Fly 核心採用 MIT 授權，Xray-core 採用 MPL 2.0 授權；圖形化用戶端及其相依元件也各有授權要求。使用、修改或重新散布時，應分別閱讀目標專案與相依元件的授權條款，不能用單一生態系名稱概括所有授權條件。
開源與伺服器服務費用也是兩回事。用戶端可以免費使用，外部服務的計費方式、連線限制與使用期限則由服務提供者決定。不要因為用戶端安裝成功，就認定訂閱一定可用；也不要把訂閱服務的限制誤認為用戶端的功能限制。
連線資料屬於敏感設定。分享記錄時，請移除完整訂閱網址、使用者識別資訊與驗證資料，只保留錯誤類型、涉及的設定層次及重現步驟即可。清楚描述問題，比公開整份設定更有助於找出原因。
用戶端更新與設定維護
介面更新、核心更新、規則資料更新與訂閱更新是四種不同操作。介面更新可能改變選單與預設行為；核心更新涉及協定實作與欄位相容性；規則資料更新會影響網域或位址集合；訂閱更新則會重新取得伺服器資料。排查問題時，請先回想最近變動的是哪一層。
更新前請備份訂閱分組、必要的自訂規則與可用設定；更新後先確認原有基本連線正常，再啟用新增功能。自動產生的執行設定可能在重新啟動或儲存時遭覆寫，因此長期使用的規則應透過用戶端提供的持久化設定入口管理，而非只修改暫存檔案。
建議簡單記錄目前使用的核心家族、代理接管方式、DNS 策略與自訂出口標籤。記錄不必包含連線憑證，卻能協助區分「設定遭覆寫」、「規則未命中」與「伺服器無法連線」，也方便依照進階指南逐章調整。
設定閱讀順序
先看入站如何接收應用程式要求，再看路由如何選擇出口，最後檢查出口協定與解析路徑。閱讀範例時，請區分完整設定與局部片段；只複製一段路由規則，卻沒有對應的出口標籤，無法組成可執行的連線設定。
前往協定與進階設定 →CONFIGURATION NOTES
設定主題與用戶端選擇
完成第一次連線後，再依遇到的問題深入閱讀。模式選擇、桌面介面差異與伺服器設定選擇分別對應不同決策，適合分開理解，不必在初次安裝時就掌握所有細節。
v2rayN 系統代理與路由模式詳解：全域、繞過中國大陸、Tun 各適用於哪些情境
釐清系統代理開關與路由模式是兩層不同設定，逐一說明全域與繞過中國大陸的分流邏輯，以及何時需要改用 Tun 模式接管所有流量。
適合排查「瀏覽器已能正常使用，其他應用程式卻沒有變化」這類問題。先確認流量是否進入用戶端，再檢查進入後符合哪條規則，避免只是不斷切換模式名稱。
閱讀文章 →v2rayN 桌面版（Avalonia）與 WPF 版差異：介面框架、平台支援與選擇建議
比較採用兩種介面框架的 v2rayN 在不同桌面系統上的可用性、外觀與相依性差異，並依作業系統提供版本下載建議。
適合在下載前確認安裝版本。介面框架會影響操作體驗與平台支援，但不應直接視為協定名稱；選好介面後，仍需確認配套核心與目標伺服器的需求。
閱讀文章 →V2Ray 節點怎麼選：延遲測試、流量倍率、地區與協定類型四步判斷
說明用戶端延遲測試的意義與限制、流量倍率的計算方式，並依用途提供地區與協定類型的選擇順序，幫助新手減少試錯。
適合已匯入訂閱、但不確定如何選擇設定的階段。測試結果只反映特定測試條件，應搭配實際目標網站、連線穩定度與服務說明判斷，不要只依賴單一測試結果。
閱讀文章 →專題文章用來說明特定設定決策，連續操作步驟仍建議從入門指南開始。需要管理多組訂閱、自訂出口或更複雜的解析策略時，再參閱進階設定指南，逐項驗證後儲存設定。
查看所有文章 →