v2rayN 桌面版與 WPF 版
桌面版採用新一代跨平台介面，WPF 版則保留經典桌面操作方式。初次使用可先透過桌面版熟悉伺服器清單、訂閱群組與日誌面板；已有使用習慣的話，也可選擇 WPF 版。兩者只是介面形式不同，不代表不同購買方案，也不保證匯入訂閱後一定能連線。
安裝前，先在系統設定確認處理器架構，並閱讀下載頁的執行需求。啟動後先新增訂閱群組並更新，再選取一筆設定進行實際連線測速。啟用系統代理只會影響遵循系統代理設定的程式；瀏覽器能連線，不代表所有應用程式都使用相同出口。
前往下載V2RAY · V2RAYN · V2RAYNG
V2Ray 教學與v2rayN 用戶端下載.
從匯入訂閱到路由分流，逐步設定 v2rayN / v2rayNG，並參考核心日誌找出連線問題。
CLIENT SELECTION
依作業系統挑選用戶端
桌面版可從 v2rayN 開始，Android 則建議先了解 v2rayNG。安裝套件的架構須符合裝置處理器，檔案格式則視作業系統與發行版而定。先選好用戶端，再匯入現有伺服器設定，就能分開處理安裝與連線問題。
v2rayN 處理器架構選擇
在「關於這台 Mac」查看晶片資訊：若顯示 Apple Silicon 系列晶片，請選 arm64；若顯示 Intel 處理器，請選 x64。兩個安裝入口分別對應不同架構，不必同時安裝。安裝時若出現系統權限提示，先確認提示對象與安裝來源，再依照系統提供的流程處理。
桌面用戶端負責儲存設定、切換伺服器及產生核心執行參數，實際連線仍由核心負責。成功匯入設定後，先確認目前使用的伺服器，再檢查代理方式。更換用戶端時，不建議直接覆寫整個資料目錄；先保留原有設定，再逐項移轉訂閱與規則，方便找出路徑及權限差異。
前往下載v2rayNG 與 v2flyNG
v2rayNG 使用 Xray 核心，是 Android 用戶端的優先選擇；v2flyNG 使用 V2Fly 核心，可依核心需求作為替代方案。多數較新的手機可先查看 arm64 安裝套件；無法確認架構時，再參考通用版說明。請以裝置的實際架構與系統需求為準，不要只依手機購買年份判斷。
首次啟動連線時，系統會要求授權建立 VPN 連線，這是用戶端接管所選流量的系統介面。授權後還要檢查分應用程式代理、路由模式與背景執行限制。若切換至背景一段時間後連線中斷，先查看電池最佳化與處理程序狀態，不要立刻認定是訂閱網址或伺服器參數有問題。
前往下載v2rayN 發行版安裝套件
Debian、Ubuntu 及其衍生發行版通常選擇 deb；Fedora 等採用 RPM 套件管理系統的發行版則選擇 rpm。此外，還要區分 x64 與 arm64。套件格式與處理器架構是兩項獨立條件：格式正確但架構不符，仍可能無法安裝或啟動。
圖形用戶端啟動後，先以一般權限管理訂閱並測試基本連線，再考慮需要額外權限的網路接管方式。不同桌面環境對系統代理的支援不盡相同，部分程式也需要個別設定。遇到連線狀況不一致時，記下應用程式是否遵循桌面代理、使用哪種 DNS，再決定是否啟用 TUN。
前往下載用戶端安裝套件不包含可直接使用的伺服器服務。連線位址、連接埠、身分參數與訂閱連結，須由有權使用的服務或自行架設的環境提供；安裝、匯入、測速與驗證應依序分別完成。
查看所有用戶端 →CONFIGURATION INDEX
訂閱、路由與日誌
可依「設定來源、流量入口、匹配的出口、網域解析方式」逐步拆解設定問題。以下索引涵蓋五個常用項目；範例僅展示相關欄位，並非可獨立執行的完整設定。實際欄位也須符合所選核心及用戶端產生的設定。
匯入訂閱與本機監聽
訂閱可用來批次取得伺服器設定，但不代表已建立連線。在 v2rayN 的訂閱群組中儲存完整網址並執行更新；Android 端也應先新增群組，再更新設定。清單出現項目後，選取要使用的伺服器並測試連線。下方是本機 SOCKS 入站片段，與訂閱內容屬於不同層級；監聽回送位址只接受本機連線。更新失敗時，先查看訂閱請求日誌，不要試圖修改入站連接埠來修復遠端位址。
{
"inbounds": [
{
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": true
}
}
]
}路由規則依序比對
分流規則決定一次請求要使用哪個出站，無法修復伺服器本身的問題。先為代理與直連出站設定清楚的標籤，再從具體規則開始撰寫，最後設定預設出口。下方範例將私有位址導向名為 direct 的出站；此標籤必須存在於完整設定中，引用的規則資料也必須可用。排查分流錯誤時，先檢查較前面的命中規則，再確認網域是否已解析為 IP；不要只看規則名稱推斷結果，也不要一次修改多條規則。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}區分系統解析與核心 DNS
網頁無法開啟不一定是伺服器無法使用，也可能是網域解析沒有依預期路徑進行。先區分系統 DNS、應用程式自有的加密 DNS 與核心內建 DNS，再檢查路由是否觸發解析。下方是核心 DNS 伺服器的簡化欄位，不代表所有應用程式的查詢都會由核心接管。比較修改前後的日誌與存取結果，每次只調整一個解析環節；使用遠端解析時，也要確認能連上解析伺服器，避免形成依賴循環。
{
"dns": {
"servers": [
"1.1.1.1",
"8.8.8.8"
]
}
}TUN 接管與回送風險
TUN 透過虛擬網卡處理流量，適合需要涵蓋更多應用程式的情境，但權限、路由與 DNS 必須搭配設定。先確認一般代理連線正常，再於用戶端啟用 TUN，並觀察虛擬網卡與系統路由的變化。下方是用於本機連線測試的 SOCKS 入站，並非 TUN 開關；TUN 的實作與設定格式取決於用戶端使用的元件，不能直接將這段 JSON 當成虛擬網卡設定。若發生斷網，先關閉 TUN，保留日誌後再找出原因。
{
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "udp": true }
}
]
}從第一筆錯誤判斷問題範圍
核心無法啟動與建立連線後逾時，屬於不同階段的問題，應分開處理。先找出同一次啟動中最早出現的錯誤，再檢查設定語法、連接埠占用與欄位相容性，接著查看遠端連線及 TLS 交握。暫時提高日誌層級有助於重現問題，完成後應恢復常用層級，以減少多餘輸出。下方的 warning 設定可用來留意警告與錯誤；分享日誌前，還要移除訂閱連結、身分參數與真實位址，只保留錯誤類型及前後文。
{
"log": {
"loglevel": "warning"
}
}初次設定建議先保留預設路由，使用一筆已確認參數完整的伺服器設定建立連線，再逐步加入分流與 DNS 設定。一次開啟多個選項會增加排查範圍；每次只修改一個變數，並記下修改前的值，之後才能還原與比較。
依完整步驟設定首次連線 →PROJECT V ECOSYSTEM
用戶端與核心的分工
V2Ray 是了解這套代理工具生態系的起點，但用戶端名稱、核心名稱與協定名稱並不相同。釐清各自的職責，比單純比較軟體名稱更有助於選擇，也能避免照抄設定時產生誤解。
生態系背景Project V
設定結構與代理元件
核心系列V2Fly / Xray
協定處理與連線執行
圖形用戶端v2rayN / v2rayNG / v2flyNG
設定管理與操作介面
BACKGROUND
Project V 與設定結構
Project V 將代理功能拆分為彼此協作的元件，V2Ray 是其中廣泛使用的實作。理解設定時，可將入站視為應用程式流量的入口，出站視為連線目標的方式，路由則是兩者之間的選擇規則。DNS、日誌與策略則提供解析、監控及資源管理功能。這種拆分讓同一份設定能描述多個入口與出口，也說明為什麼只修改伺服器位址往往無法解決所有連線問題。
圖形用戶端將這些結構轉換為清單、群組、開關與表單，降低日常管理的負擔。它不是遠端伺服器，也不能取代伺服器端設定。匯入連結通常只是將一組參數轉換為本機記錄；實際啟動時，用戶端還可能依照目前的路由模式、監聽連接埠與使用者設定，重新產生執行設定。因此，閱讀教學時要分清「匯入時儲存的記錄」與「目前核心實際讀取的設定」，不要將兩個檔案或介面視為完全相同。
CORE FAMILIES
V2Fly 與 Xray 的關係
V2Fly 延續 V2Ray 的社群維護，Xray 則從相關程式碼分支發展而來。兩者共用部分設定概念，但協定功能、欄位支援與後續發展並不完全相同。看到 JSON 結構相似，不代表所有欄位都能互換；某個核心支援的傳輸參數，另一個核心也不一定會以相同方式解讀。判斷相容性時，應先確認用戶端實際啟用的核心，再核對協定、傳輸層與安全層的組合。
VMess、VLESS、Trojan 與 Shadowsocks 是協定名稱；WebSocket、gRPC 等描述傳輸方式；TLS 則涉及另一層連線安全設定。這些名稱可能同時出現在一筆伺服器設定中，但各自負責的工作不同。排查時可依序核對位址與連接埠、身分參數、傳輸路徑及伺服器名稱，不要反覆切換核心碰運氣。只有在明確需要某項功能時，才應將核心選擇納入設定方案。
OPEN SOURCE CLIENTS
三款用戶端的開源特性
v2rayN、v2rayNG 與 v2flyNG 都是開源圖形用戶端，相關原始碼由社群專案維護。v2rayN 適用於桌面平台，提供伺服器管理、訂閱群組及路由等常用功能；Android 版 v2rayNG 使用 Xray 核心，v2flyNG 使用 V2Fly 核心。選擇時應優先確認裝置、系統需求與伺服器端參數是否相符，再考量介面使用習慣。名稱相似不代表是同一個安裝套件，也不表示資料目錄可以直接共用。
開源授權說明軟體程式碼的使用、修改與再散布條件，並不代表遠端服務一定可用。V2Ray 與 Xray 的核心程式碼採用 MPL 2.0；個別用戶端與隨附元件仍須分別查看其授權及聲明。用戶端可以免費使用，但遠端伺服器、網路連線與訂閱服務可能由不同業者提供。區分軟體工具與服務來源，才能判斷故障應由哪一方處理，也能避免將服務費誤認為用戶端的授權要求。
UPDATE & DIAGNOSIS
更新、回復舊版與保留設定
用戶端更新與核心更新不一定是同一項操作。介面調整可能改變設定入口，核心變更則可能影響欄位相容性與協定行為。更新前應備份訂閱群組、自訂路由及必要的個人設定，並閱讀相關變更說明。更新後先確認現有設定能否啟動，再測試常用的存取情境；基本連線正常後，再恢復實驗性的路由或流量接管設定。如此可將更新造成的變化控制在容易比較的範圍內。
若更新後出現問題，先記下用戶端類型、目前使用的核心、作業系統及錯誤發生階段，不要立刻刪除所有設定並重新安裝。核心啟動失敗時，查看第一筆設定錯誤；只有部分網域無法連線時，檢查 DNS 與規則命中情況；瀏覽器可用但其他程式無法使用時，檢查代理涵蓋範圍。日誌中涉及真實伺服器、訂閱網址與身分資訊的內容應先隱藏，再整理成可重現的步驟。欄位說明與最小範例可參考設定文件；實際操作順序則適合從使用指南開始。
TECHNICAL NOTES
近期技術筆記
使用指南依照完整流程編排，技術筆記則聚焦於特定問題。已完成安裝但不知道接下來該檢查什麼，可先閱讀首次連線指南；想了解按鈕與面板的對應關係，可從主介面快速導覽開始；準備調整分流時，再查看規則語法與命中順序。
v2rayN 主介面功能速覽：伺服器清單、訂閱群組、日誌面板與參數設定
分區介紹 v2rayN 主視窗：伺服器清單的右鍵選單、訂閱群組切換、底部日誌面板的閱讀方式，以及參數設定中最常用的幾個選項。
閱讀筆記 →v2rayN 首次連線指南：選擇節點、實際連線測速與確認代理是否生效
匯入訂閱後，先透過實際連線測速找出可用節點，再啟用系統代理，最後使用瀏覽器瀏覽網頁並查詢出口 IP，確認流量確實經過代理。
閱讀筆記 →V2Ray 自訂路由規則寫法：domain、ip、geosite 比對語法與優先順序
詳解 domain 前綴、full 與 regexp 比對方式、ip 與 geoip 寫法、geosite 分類引用，以及規則由上而下的命中順序與 domainStrategy 的影響。
閱讀筆記 →閱讀疑難排解文章時，先確認問題發生在訂閱更新、核心啟動、建立連線或應用程式存取階段。相同的「逾時」提示可能來自不同環節，根據出現位置與前一筆日誌判斷，通常比反覆重試更容易縮小問題範圍。
查看所有文章 →