Windows · v2rayN
Windows 使用者可在新一代桌面介面與經典 WPF 介面之間選擇。完成安裝後，先匯入訂閱並選擇節點，再設定系統代理。若啟動時提示本機連接埠已被佔用，應先找出佔用程序，或修改監聽連接埠後同步更新代理設定。下載頁也會列出兩種介面的用途差異，方便依目前的系統環境選擇。
前往下載
下載 · 設定 · 分流 · 排查
V2Ray配置教學
從客戶端安裝開始，依序說明訂閱匯入、路由分流與故障定位，涵蓋桌面版與 Android 的常見操作流程。
中文文件
程式碼開源
Xray · V2Fly
圖形客戶端
從訂閱入口到出口驗證的設定流程
客戶端設定不是一組彼此孤立的開關。訂閱負責提供節點資訊，路由決定流量去向，系統代理或 TUN 模式負責接管應用程式請求，日誌與連線測試則用來確認每個環節是否按照預期運作。
訂閱連結匯入、更新與節點確認
訂閱連結是客戶端取得節點設定的入口。桌面版通常在訂閱群組中新增網址，再執行更新；Android 客戶端則可透過剪貼簿匯入，或掃描受信任來源提供的 QR Code。匯入完成不代表連線已經可用，第一步應確認節點清單是否出現、名稱是否正常，以及群組是否符合預期來源。如果清單為空，應先檢查網址是否完整、網路請求是否成功，以及客戶端日誌中的回應狀態，而不是反覆切換系統代理。
更新訂閱時，客戶端會重新讀取遠端內容，並可能覆寫同一群組中的舊節點。需要長期保留的手動設定應放在獨立群組，避免與訂閱更新混在一起。節點出現後再進行一次連線測試，區分「訂閱讀取成功」與「特定節點可連線」這兩個結果。按照這個順序檢查，可以將問題限定在輸入、解析或連線階段，減少無目的地修改 DNS、連接埠與路由規則。
網域、IP 與程序規則的比對順序
路由分流決定請求經由代理出口、直接連線，還是遭到阻擋。規則通常會讀取網域、目標 IP、連接埠、網路類型或程序資訊，並依照客戶端目前設定的順序進行比對。排查分流結果時，應先確認請求是否已由客戶端接管，再查看命中的規則與最終出站；只觀察網頁能否開啟，無法判斷請求實際經過哪條路徑。規則越多，越需要明確的優先順序；範圍較小且目的明確的規則，通常應放在寬泛規則之前。
網域規則適合處理名稱穩定的服務，IP 規則適合已知的位址範圍，程序規則則可用於桌面應用程式的指定處理。啟用新的規則集後，建議選擇幾個具代表性的目標，分別驗證直連、代理與阻擋結果，並查看日誌中的路由記錄。若結果與預期不符，先暫時停用最近新增的規則，再逐條恢復；不要同時更換節點、DNS 與代理模式，否則很難確認是哪項設定改變了路徑。
系統代理與 TUN 模式的接管範圍
系統代理適合遵循作業系統代理設定的瀏覽器與一般桌面應用程式，設定清楚，停用後也容易復原。部分程式會繞過系統代理，或直接建立網路連線，此時可以考慮使用 TUN 模式。TUN 透過虛擬網卡接收更廣泛的流量，再交由核心執行路由與出站處理，因此會涉及網路權限、路由表、DNS 解析與本機防火牆等更多環節。選擇接管方式時，應根據應用程式行為決定，而不是預設同時開啟所有選項。
從系統代理切換到 TUN 前，先記錄目前的本機監聽連接埠與代理狀態，並退出其他可能建立虛擬網卡的網路工具。開啟後分別驗證瀏覽器、目標應用程式與網域解析；如果客戶端退出後網路沒有恢復，優先檢查系統代理殘留、虛擬網卡狀態與 DNS 設定。桌面版首次啟用 TUN 可能需要提升權限，行動裝置則會顯示系統層級的網路連線確認。完整步驟與復原方式可在使用文件中依平台查看。
依連線層級讀取狀態與日誌
故障定位應按照「客戶端程序、本機入口、節點連線、遠端出口、網域解析」的順序進行。客戶端無法啟動時，先查看連接埠佔用與權限；客戶端已啟動但應用程式無法連線時，檢查系統代理與接管範圍；節點測試逾時時，再檢查節點參數、網路環境與傳輸設定；只有在網域存取異常而直接存取 IP 正常時，才將重點轉向 DNS。將症狀對應到連線層級，比持續更換節點或重新安裝客戶端更有效。
閱讀日誌中的時間、層級與錯誤位置時，需要結合實際操作。執行一次更新訂閱、啟動連線或開啟目標應用程式後，立即查看新增日誌，可以減少歷史記錄的干擾。連接埠衝突通常指向本機監聽階段，連線逾時多發生在節點或傳輸階段，解析失敗則應檢查 DNS 請求的流向。修復後應重現原本的觸發步驟，確認錯誤記錄不再出現，並檢查系統代理是否恢復到預期狀態。
Windows、macOS、Android 與 Linux 下載入口
桌面平台統一使用 v2rayN，Android 可依核心需求在 v2rayNG 與 v2flyNG 之間選擇。平台入口會跳轉至下載頁的對應標籤，安裝檔類型、系統需求與晶片選擇說明集中在同一處。
macOS · v2rayN
macOS 下載前需要先確認處理器架構，Apple Silicon 與 Intel 對應不同的安裝檔。首次執行時也可能遇到系統安全性確認與網路存取權限要求，應透過系統設定完成授權，再返回客戶端匯入訂閱。連線後先檢查選單列狀態與系統代理，再進行應用程式存取測試，避免將權限問題誤判為節點異常。
前往下載Android · v2rayNG / v2flyNG
Android 的主要入口是採用 Xray 核心的 v2rayNG，偏好 V2Fly 核心時則可選擇 v2flyNG。多數較新的裝置使用 arm64 架構；無法確認架構時，可在下載頁查看通用安裝檔。匯入訂閱後需要選擇節點並啟動系統網路連線，接著分別檢查連線狀態、分應用程式設定與電池背景限制，避免客戶端在鎖定螢幕後被系統提前停止。
前往下載Linux · v2rayN
Linux 桌面版應依發行版選擇 deb 或 rpm 安裝檔，同時確認 x64 與 arm64 架構。安裝後可透過圖形介面管理訂閱、節點與路由規則。若系統代理未影響目標應用程式，應檢查桌面環境的代理設定，以及應用程式是否自行管理網路設定；需要更廣泛的接管範圍時，再評估 TUN 權限與虛擬網卡狀態。
前往下載Project V、V2Fly 與 Xray 核心的關係
了解客戶端、核心與協議之間的分工，有助於判斷設定問題發生在哪一層，也能避免將圖形介面名稱、訂閱格式與傳輸協議混為一談。
從 V2Ray 專案到核心家族
V2Ray 源自 Project V 生態，核心理念是將入站、路由、出站與底層傳輸拆分為可組合的設定模組。隨著社群維護方向演進，V2Fly 延續了 v2ray-core 體系，Xray 則在相近的設定理念上發展出另一個核心分支。兩者都能處理多種代理協議與傳輸方式，但具體欄位、功能支援與預設行為可能不同。因此，匯入設定前需要確認客戶端採用的核心，以及訂閱內容是否包含該核心能識別的參數。
圖形客戶端位於核心之上，負責訂閱管理、節點選擇、系統代理、日誌檢視與更新設定。v2rayN 面向桌面平台，可依軟體提供的選項呼叫對應核心；v2rayNG 主要採用 Xray 核心；v2flyNG 則面向 V2Fly 核心路線。客戶端名稱不等於協議名稱，選擇某個客戶端也不代表所有節點都使用相同協議。實際連線由節點設定、傳輸層、TLS 設定、路由規則與客戶端接管方式共同決定。
開源授權與程式碼界線
V2Fly 核心、Xray 核心與三款圖形客戶端各自維護自己的程式碼與授權檔案。核心專案與客戶端可能採用不同的開源授權，發布套件也會包含各自的相依元件。查看授權時，應以對應軟體發布內容所附的說明為準，而不是將整個生態視為單一專案。開放的程式碼與設定格式便於社群審閱實作、討論相容性並持續修復問題。
客戶端與核心獨立更新
圖形介面與網路核心有不同的發布節奏。客戶端更新可能調整訂閱管理、介面互動或系統整合，核心更新則更著重於協議實作、傳輸能力、路由與網路行為。遇到升級後的異常時，需要先分辨變化來自客戶端還是核心，再配合日誌與設定遷移說明處理。下載頁集中提供目前的安裝入口，首頁不固定展示可能快速變動的發布資訊。
協議、傳輸與路由分層
VMess、VLESS、Trojan 等名稱描述的是協議層設定；WebSocket、gRPC 等屬於傳輸方式；TLS 與 REALITY 涉及連線驗證與安全傳輸；路由規則則決定請求選擇哪個出站。排查時應依層級逐一核對，不應因網域解析失敗就直接修改協議參數，也不應在應用程式尚未進入本機代理時反覆調整遠端節點。
桌面圖形客戶端
涵蓋 Windows、macOS 與 Linux，集中管理訂閱、節點、路由、系統代理與 TUN 設定。適合需要在桌面環境檢視日誌、管理多個訂閱群組並細緻調整接管方式的使用者。
Android · Xray 路線
以行動裝置操作為核心，提供訂閱匯入、節點選擇、分應用程式代理、路由與系統網路連線管理。遇到背景斷線時，還需要配合裝置的電池策略與背景執行權限進行檢查。
Android · V2Fly 路線
面向需要 V2Fly 核心實作的行動裝置設定，可作為 Android 平台的另一種核心選擇。匯入前應核對訂閱參數與核心支援範圍，避免將核心差異誤判為訂閱網址失效。
進階設定與故障排查文章
文章圍繞具體症狀與設定環節展開，說明原理、操作流程、結果判斷與復原方式。建議先完成基本安裝與訂閱匯入，再依實際問題閱讀對應專題。
TUN 模式開啟方法詳解：虛擬網卡接管全域流量的原理與設定步驟
說明 TUN 模式與系統代理的本質差異，整理虛擬網卡、路由表、DNS 與應用程式流量之間的關係，並提供 v2rayN 與 v2rayNG 的開啟步驟。文章同時列出權限不足、網路未恢復及其他虛擬網卡衝突時的檢查流程。
閱讀全文連接埠被佔用怎麼辦：找出佔用程序並修改 V2Ray 本機監聽連接埠
客戶端啟動時出現連接埠衝突，需要先確認監聽連接埠與佔用程序，再決定終止舊程序或修改設定。文章分別說明常見桌面系統的定位方法，以及連接埠變更後為何必須同步更新系統代理與應用程式代理設定。
閱讀全文DNS 洩漏檢測與修復實作：讓網域解析與流量經過同一條連線
從網域解析路徑著手，說明客戶端已連線時，解析請求為何仍可能流向其他網路介面。文章提供檢測方法、v2rayN 與 v2rayNG 的 DNS 設定檢查項目，並透過修改前後的請求路徑驗證修復是否生效。
閱讀全文