Windows
v2rayN / Desktop · WPF
適合以瀏覽器、辦公軟體為主的桌面使用情境。下載頁提供新一代跨平台介面的桌面版與經典 WPF 版，可依介面習慣和執行環境選擇。首次設定建議先使用系統代理，待訂閱、連線與路由都正常後，再評估是否需要 TUN。
安裝或解壓縮後，請保留可寫入的設定資料夾；更換電腦時應備份訂閱群組與自訂規則，而不只是複製程式捷徑。
前往下載 →
routing.domainStrategy
IPIfNonMatch
MANUAL / 章節
- 核心概念
- 訂閱群組
- 代理模式
- 路由分流
- TUN 模式
- DNS 設定
比對條件
出站標籤
備註
geosite:category-ads-all
→block
廣告網域
geoip:private
→direct
私人位址
geosite:cn
→direct
網域集合
geoip:cn
→direct
位址集合
final
→proxy
預設出站
依序比對；final 是預設出站的示意名稱。
命中說明rules[2]
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}網域符合 geosite:cn 後，會使用 direct 標籤指定的直連出站。
範例需搭配相應的規則資料與出站設定；實際結果以執行記錄為準。
SETTINGS / 設定索引
用戶端設定與規則註解
先釐清接入方式與出站規則，再調整核心和解析行為。左側目錄依日常設定順序編排，程式碼僅展示相關欄位，並非可直接匯入的完整設定。
訂閱網址與設定群組
訂閱群組 → 新增
群組名稱：日常設定
訂閱網址：由設定提供者提供
訂閱群組 → 更新目前訂閱訂閱用來批次管理連線設定，不等同於用戶端帳號。先在訂閱群組中新增網址並儲存，再更新目前群組，確認清單中出現可選設定。群組名稱用來區分來源，之後更新會覆寫該群組的內容，手動修改前建議先備份。相較於逐筆貼上分享連結，訂閱更方便集中更新；若清單為空，先確認網址是否完整、是否過期，以及這台裝置能否連上訂閱服務，不要反覆切換路由模式。不同介面的選單名稱可能略有差異。
延伸閱讀 → 使用手冊：訂閱匯入系統代理與路由模式
系統代理 → 設定系統代理
路由模式 → 繞過中國大陸
用戶端接入 → 比對路由 → 選擇出站系統代理決定遵循系統設定的應用程式是否將流量送入用戶端；路由模式則決定接入後的請求要直連或走代理。全域模式通常會讓已接入的請求使用代理出站，但不代表所有應用程式都會自動接入。日常瀏覽可先使用系統代理搭配分流模式；排查規則問題時，再暫時切換全域模式進行比對。相較於接管系統網路的 TUN，這種方式影響範圍較小，也較容易還原。若某個應用程式沒有生效，先確認它是否會讀取系統代理設定，不要立即修改節點參數。
延伸閱讀 → 使用手冊：代理模式網域規則與出站標籤
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}路由分流會依條件選擇出站，規則順序與欄位內容同樣重要。先保留私人位址直連，再加入明確的網域規則，最後確認未符合規則的請求會送往何處。上方片段表示網域符合集合條件後使用直連標籤，前提是核心已載入相應資料檔，且存在同名出站。相較於只切換全域模式，規則能更細緻地控制應用程式連線的目標，但也會增加維護成本。修改時一次只調整一類條件，並透過記錄確認比對結果；不要把網域解析失敗誤判為規則未生效。
延伸閱讀 → 使用手冊：路由分流虛擬網卡與接管範圍
TUN 模式 → 啟用前確認權限
檢查項目：虛擬網卡 / 路由 / DNS
還原順序：關閉 TUN → 恢復原有網路設定TUN 透過虛擬網卡接收系統網路流量，適合不會讀取系統代理設定的應用程式，但能否使用取決於用戶端實作、系統權限與驅動程式環境。先在一般代理模式下確認設定正常，再啟用 TUN，觀察本機網路、網域解析及目標應用程式是否運作正常。相較於系統代理，TUN 的涵蓋範圍更廣，也更容易與其他虛擬網卡或網路工具衝突。若發生網路中斷，先關閉 TUN 並還原原有設定，再逐一檢查權限、路由與 DNS，避免同時啟用多套網路接管工具。
延伸閱讀 → 使用手冊：TUN 模式協定支援與核心選擇
用戶端介面 → 設定管理
代理核心 → 協定與傳輸執行
選擇依據 → 伺服器參數與核心支援範圍圖形用戶端負責管理設定，核心負責建立連線，兩者並非同一個元件。部分 v2rayN 版本支援選擇不同核心，實際功能請以目前版本的設定選項為準；v2rayNG 與 v2flyNG 則分別面向不同的核心生態。切換前先確認協定、傳輸方式與安全參數是否相容，並保留原設定以便還原。與其一味追逐核心名稱，不如逐項確認伺服器端的要求。若某項參數無法匯入，先確認用戶端與核心的支援範圍，不要直接刪除該參數。
延伸閱讀 → 使用手冊：核心選擇解析路徑與網域策略
{
"routing": {
"domainStrategy": "IPIfNonMatch"
}
}DNS 負責將網域解析為位址，網域策略則會影響路由何時使用解析結果，兩者需要一起檢查。範例中的策略會在網域規則未符合時嘗試解析，以便繼續比對位址條件，並不代表所有請求都固定使用某個 DNS 服務。相較於只填入一個解析位址，完整排查還需確認查詢經由哪個出站、是否涉及系統快取，以及如何處理 IPv6。調整時保留可用的原設定，分別測試網域存取與位址連線，避免解析請求依賴尚未建立的代理而形成循環。
延伸閱讀 → 使用手冊：DNS 設定CLIENT SHELF / 平台入口
依作業系統選擇 V2Ray 用戶端
桌面版可從 v2rayN 開始，Android 裝置則可優先了解 v2rayNG。下載前先確認作業系統與處理器架構，再選擇安裝形式；用戶端安裝完成後，仍需取得來自可信來源的有效連線設定。
macOS
v2rayN / Apple Silicon · Intel
先從系統選單開啟「關於這台 Mac」，查看顯示的是晶片還是處理器型號。Apple Silicon 與 Intel 使用不同架構的安裝入口，不應只憑檔名相近就判斷是否適用。安裝後再檢查用戶端的執行權限與系統代理狀態。
若瀏覽器可以連線，其他應用程式卻不行，先確認應用程式的代理設定。虛擬網卡權限與一般系統代理是兩種不同的排查方向。
前往下載 →Android
v2rayNG / v2flyNG
v2rayNG 適用於 Xray 核心設定，v2flyNG 則可作為 V2Fly 核心生態的替代選擇。較新的主流裝置通常選擇 arm64；若不確定裝置架構，再查看通用套件的說明。首次連線時需確認系統的 VPN 連線授權；此授權僅用於本機網路接入，不代表已取得可用的遠端設定。
若背景執行時斷線，也要檢查省電限制與背景執行權限。若需要設定個別應用程式代理，先確認名單模式的意義，再決定要讓哪些應用程式接入。
前往下載 →Linux
v2rayN / deb · rpm
依發行版的套件格式選擇 deb 或 rpm，再確認裝置架構為 x64 或 arm64。圖形用戶端適合在桌面工作階段管理訂閱與調整規則；應用程式能否讀取系統代理，也會受到桌面環境與應用程式本身設定影響。
使用 TUN 或系統路由時，還需留意權限與其他網路服務。先確認一般代理運作正常，再擴大接管範圍，可減少多項設定交疊而增加排查難度。
前往下載 →FIRST CONNECTION / 操作順序
從匯入訂閱到確認連線
第一次使用時，先建立一套可重複驗證的連線流程。不要同時修改代理模式、DNS 與核心，否則連線結果改變時，很難確認是哪項設定造成影響。
-
新增訂閱，確認設定已匯入
桌面版可在訂閱群組中儲存網址，再更新目前群組；Android 版則透過訂閱設定新增並重新整理。訂閱網址可能包含個人存取識別資訊，不宜放在公開截圖或聊天紀錄中。匯入後請確認設定名稱、協定類型與群組來源；若清單為空，先排查訂閱取得流程。
若只有單筆分享連結，請使用用戶端提供的剪貼簿匯入功能。更新訂閱與手動匯入是不同操作，不要將分享連結填入訂閱網址欄位。若選單名稱因介面而異，可依「新增來源、儲存、更新」的順序尋找對應功能。
-
選擇設定，設定接入方式與分流
將一筆有效設定設為使用中，再選擇接入方式。桌面版先試用系統代理；Android 版確認連線授權後再啟動服務。路由從用戶端提供的基本分流模式開始，先記下目前選項，避免未經驗證就新增大量自訂規則。
系統代理與全域路由位於不同層級：前者負責將請求送進用戶端，後者負責選擇出站。若目標應用程式不會讀取系統設定，就需要另外設定代理，或在確認影響範圍後考慮使用 TUN。切換路由模式無法補上缺少的伺服器參數。
-
查看記錄，分別測試解析與連線
啟動後查看是否出現設定解析、建立連線或網域解析錯誤，再透過目標應用程式送出實際請求。單次測試結果只能反映特定路徑，不能代表所有協定與應用程式都運作正常。也應確認常用直連服務與需要代理的目標是否符合預期。
發生問題時，先回到最簡單且可運作的設定：關閉新加入的網路接管功能，還原基本路由，再逐項重新啟用。測試結束後若暫時不使用用戶端，也要確認系統代理已還原；只關閉視窗不一定代表背景服務已停止或系統設定已清除。
PROJECT V / 生態說明
Project V、核心與圖形用戶端
「V2Ray」在日常討論中可能指專案、核心或某類設定工具。先釐清各層的職責，才能判斷某項功能是由用戶端介面提供，還是取決於核心與伺服器。
Project V 的模組化設計
Project V 生態以模組化網路代理功能為基礎，將入站、路由與出站等職責分開。請求先從入站進入處理流程，再依路由條件選擇出站。理解這個順序，比記住某個按鈕的位置更實用：即使介面改版，接入範圍、比對條件與連線參數仍需分別確認。V2Ray 相關討論中常見的「設定」，也可能只是一筆遠端連線資訊，而非包含所有本機行為的完整設定檔。
V2Fly 與 Xray 的功能範圍
V2Fly 延續 V2Ray 相關開源專案的開發與維護，Xray 則發展為獨立演進的核心分支。兩者沿用部分歷史與概念，但協定、安全參數及設定行為並非始終一致。VLESS、VMess、Trojan 是連線協定層面的概念，傳輸與安全設定仍需另外確認；不能只因協定名稱相同，就假設設定可以在所有核心之間原封不動地移轉。遇到無法辨識的欄位，先查明支援範圍，再考慮轉換設定。
三款用戶端的開源特性
v2rayN、v2rayNG 與 v2flyNG 都是開源圖形用戶端，能降低管理設定的操作成本。v2rayN 適用於桌面平台，v2rayNG 主要使用 Xray 核心，v2flyNG 則適用於 V2Fly 核心。它們本身不是遠端服務，安裝程式也不會自動產生可用訂閱。開源代表可依相應授權檢視及使用原始碼，並不代表對任何訂閱來源或遠端服務提供保證。用戶端、核心及其相依項目可能採用不同授權，使用與散布時應以各專案實際授權條款為準。
更新與日常維護
用戶端更新、核心更新與規則資料更新是三件不同的事。用戶端更新可能調整介面或設定產生邏輯；核心更新會影響協定實作與執行行為；規則資料更新則會改變網域與位址集合的比對結果。更新前請備份訂閱群組、自訂路由與重要設定；更新後先測試原本正常的使用情境，再啟用新功能。排查時記下作業系統、用戶端類型、使用的核心與錯誤發生階段，比只說「無法連線」更能縮小問題範圍。分享記錄前，也應移除訂閱網址與個人連線資訊。
本站文件範圍
V2Ray知識庫整理下載入口、圖形用戶端操作與設定概念，並非用戶端的官方發布者，也不提供節點或訂閱服務。本文以功能職責與排查順序為主，實際選單與可用選項請以已安裝的版本為準。初次使用可從入門文件開始；需要了解參數之間的關係時，請閱讀使用手冊；遇到單一術語或重複錯誤時，再查閱術語手冊與常見問題，避免只為了解決局部問題，就全面替換已可正常使用的設定。
TECHNICAL NOTES / 近期筆記
部署、Android 設定與速度排查
依照實際問題逐步檢查設定，不將所有連線失敗都歸因於同一個原因。以下三篇筆記分別涵蓋本機用戶端、閘道器部署與 Android 背景執行，適合在完成基本連線測試後接續閱讀。
V2Ray 速度慢如何排查：節點、線路與本機設定的分層檢查方法
從節點品質、傳輸線路與本機用戶端設定三個層面，逐一排查速度變慢的原因，並提供可執行的檢查項目與調整方向。先在相同條件下進行比較，再判斷是否需要調整設定。
閱讀筆記 →在路由器與旁路由執行 V2Ray 核心：部署方式、透明代理與硬體資源評估
概述在主路由器與旁路由上直接執行 Xray 或 V2Fly 核心的方式，涵蓋透明代理原理、閘道器指向與硬體資源評估要點。部署位置改變後，網路接管範圍與故障影響也會隨之改變。
閱讀筆記 →v2rayNG Android 設定重點：VpnService 授權、省電白名單與個別應用程式代理
整理 v2rayNG 在 Android 上的三項重要設定：VpnService 連線授權、系統省電白名單防止中斷，以及個別應用程式代理的名單設定方式。將服務啟動問題與背景持續執行問題分開處理。
閱讀筆記 →