Windows
Windows 使用者可選擇 v2rayN 桌面版或經典 WPF 版。前者採用跨平台介面架構，後者適合希望延續傳統 Windows 操作習慣的情境。下載頁也會說明安裝選擇、系統代理入口與兩條發行線的定位差異。
前往下載
READING ORDER / 01
從用戶端選擇開始理解設定結構
V2Ray 用戶端負責介面、訂閱與系統代理管理，Xray 或 V2Fly 核心則負責協定處理、傳輸與路由。將兩者分開理解，可以減少把介面選項、核心欄位與伺服器參數混為一談。
首頁依照「選擇平台—匯入設定—確認路由—檢查連線」的閱讀順序整理資料。需要直接安裝時前往用戶端頁面，需要逐步操作時進入入門指南，需要核對欄位時查看完整設定。
FEATURE LEDGER / 02
用戶端能力與設定邊界
以下項目將常見介面功能對應到核心概念。選擇項目後，可閱讀其操作順序、欄位邊界與排查重點。
規則順序、比對範圍與出站標籤
路由排查應從輸入條件開始：先確認流量進入哪個 inbound，再核對網域、IP、連接埠或程序條件是否能夠命中，最後檢查目標 outbound 的標籤與定義。規則陣列通常依序比對，因此寬泛條件放在前面可能遮蔽後續細分規則。用戶端提供的「全域」「規則」或「直連」等模式，本質上是對一組入站、路由與出站關係的介面化管理，而不是彼此獨立的協定。
匯入、更新與作用中設定
匯入訂閱後，先確認項目是否進入預期群組，再手動更新一次並閱讀用戶端顯示的狀態資訊。更新只負責取得與解析內容，不會自動證明其中每個設定都能連線。切換節點後，還要確認該項目已設為作用中設定，並依平台檢查系統代理或行動端連線開關。轉移裝置時，建議先記錄自訂路由與 DNS 設定，因為這些本機規則未必包含在訂閱內容中。
解析入口、查詢策略與規則聯動
設定 DNS 前應先釐清解析鏈路：應用程式是將網域交給系統，還是由用戶端的入站接收後交給核心。核心設定中的伺服器清單、hosts 靜態對映、查詢策略與依網域選擇伺服器各自負責不同工作。若啟用依網域或 IP 分流，也需留意解析結果是否會進入路由判斷。故障排查時可先恢復較簡單的單一路徑，確認基本查詢正常後，再逐項加入分流條件。
連線欄位與傳輸欄位分層核對
VMess、VLESS 等協定名稱描述的是連線語意，WebSocket、gRPC、mKCP 等名稱描述的是傳輸承載方式。匯入連結或 JSON 後，應分層檢查伺服器位址、連接埠、使用者參數、加密或安全選項，再核對路徑、服務名稱、主機名稱等傳輸欄位。不要透過切換系統代理模式來修正協定參數；接入層只能決定哪些流量進入用戶端，無法取代兩端參數一致性的檢查。
系統代理、虛擬介面與應用程式範圍
桌面系統代理主要涵蓋遵循系統設定的應用程式，部分軟體可能保留自己的網路設定。行動端連線由系統 VPN 服務承載，並可透過分應用代理控制納入範圍。遇到「瀏覽器可用但其他應用程式沒有回應」時，優先確認目標應用程式是否讀取系統代理、是否被分應用規則排除，以及用戶端是否啟用了符合目前情境的接入方式，再繼續檢查核心記錄與路由。
PLATFORM INDEX / 03
四大平台的用戶端入口
桌面平台統一以 v2rayN 為主要入口，Android 可在 v2rayNG 與 v2flyNG 之間依核心需求選擇。安裝套件與處理器架構說明集中放在下載頁。
macOS
macOS 使用 v2rayN 桌面版，並依 Apple Silicon 與 Intel 處理器選擇對應安裝檔案。若不確定晶片類型，可先在系統資訊中查看處理器或晶片名稱，再前往下載頁選擇，避免將架構問題誤判為應用程式啟動故障。
前往下載Android
Android 可使用採用 Xray 核心的 v2rayNG，也可依設定與核心偏好選擇採用 V2Fly 核心的 v2flyNG。下載頁分別提供 arm64 與通用安裝檔案，並說明 VPN 服務、背景執行與分應用代理的基本關係。
前往下載Linux
Linux 桌面可使用 v2rayN，並依 Debian、Ubuntu、Fedora 等發行版的套件體系選擇 deb 或 rpm 檔案。下載頁同時列出 x64 與 arm64 入口；安裝後可繼續參考教學完成桌面整合、訂閱匯入與登入工作階段自動啟動設定。
前往下載
QUICKSTART / 04
三步完成基本設定
快速開始只處理最短路徑。首次連線穩定後，再逐步加入自訂 DNS、複雜路由與分應用規則，方便在發生問題時定位變更來源。
-
01
安裝與平台確認
依作業系統、處理器架構與桌面環境選擇用戶端。Windows 與 Linux 還需區分發行形式，macOS 需要辨認晶片架構，Android 則在 arm64 與通用安裝檔案之間選擇。首次啟動後先確認介面能正常開啟、核心能夠載入，再繼續匯入設定，避免在同一個排查步驟中混淆安裝問題與連線參數。
-
02
匯入訂閱或單筆設定
訂閱適合集中管理多個項目，單筆連結或手動 JSON 適合核對具體參數。匯入後檢查群組、協定、位址、連接埠與傳輸類型是否如預期顯示，然後手動選擇作用中設定。若用戶端提示解析失敗，應優先確認內容格式與複製範圍，不要透過反覆切換代理模式掩蓋匯入階段的問題。
-
03
連線、接入系統與驗證
啟動用戶端連線後，依平台啟用系統代理或行動端 VPN 服務。驗證時先使用一個遵循系統網路設定的應用程式，再觀察用戶端記錄是否出現對應請求。確認基本鏈路後，才加入繞行規則、DNS 分流與分應用範圍。依照這個順序，可以區分連線參數、系統接入與路由條件分別位於哪一層。
ECOSYSTEM NOTES / 05
Project V、V2Fly 與 Xray 核心家族
圖形化用戶端、核心與設定格式屬於彼此協作但職責不同的層次。理解專案關係，有助於判斷某個選項來自介面、核心能力還是協定本身。
生態來源與設定模型
Project V 建立了以入站、出站、路由、DNS、策略與傳輸設定為核心的設定模型。它不是單一圖形程式名稱，而是由協定實作、核心分支、用戶端介面與文件實務共同構成的技術生態。許多用戶端會將 JSON 欄位轉換成表單、選單與模式選擇，使日常操作更直觀，但底層邏輯仍可回到 inbounds、outbounds、routing 與 dns 等結構加以解釋。
閱讀設定檔時，適合先從資料流向建立整體認識：應用程式流量透過本機入站進入核心，路由規則決定採用哪個出站，出站再依據協定與傳輸欄位建立連線。DNS 與 policy 等部分則為解析、資源策略及特定行為補充條件。按照這條鏈路閱讀，比逐一記憶孤立欄位更容易發現引用標籤錯誤或規則範圍衝突。
持續維護的核心分支
V2Fly 延續 Project V 相關技術體系，並持續維護協定、路由、傳輸與平台適配。v2flyNG 採用 V2Fly 核心，為 Android 情境提供另一套圖形化用戶端組合。選擇它時，應關注訂閱內容與目標核心的支援範圍，並以用戶端實際呈現的設定項目為準，而不是只依相似的連結外觀判斷相容性。
核心更新通常涉及協定實作、依賴元件、傳輸行為與問題修正。用戶端更新則還包含介面、訂閱解析、系統接入與平台打包。兩者的發佈節奏可能不同，因此排查某項能力時，需要同時辨認用戶端名稱與其搭配的核心家族，避免把介面未公開的選項誤認為核心完全不具備相應能力。
協定與傳輸能力的另一分支
Xray 是同一技術生態中的核心分支之一，圍繞協定、傳輸與路由能力形成獨立維護路徑。v2rayNG 通常與 Xray 核心組合，v2rayN 也可在其支援範圍內管理相應核心。遷移設定時應核對具體欄位，而不是假設不同核心的所有擴充項目都具有完全相同的名稱、預設值與可用範圍。
涉及 VLESS、Reality、gRPC 或精細路由時，核心差異會比基本系統代理操作更重要。較穩妥的處理方式是先保留可運作的最小設定，再依目前核心文件逐項加入傳輸安全、嗅探、DNS 與路由條件。若一次同時變更多個欄位，即使最後失敗，也難以判斷問題來自協定參數、傳輸設定還是本機接入。
用戶端、授權與更新機制
v2rayN、v2rayNG 與 v2flyNG 都屬於程式碼公開維護的用戶端專案。程式碼開放使介面行為、設定轉換與核心呼叫方式能被技術社群討論與複查，也讓不同平台能圍繞相同設定概念形成各自的操作介面。開源屬性是一種開發與協作方式，不應被延伸為對任意設定來源或網路環境的籠統判斷。
更新時應區分用戶端程式、核心元件與訂閱內容三個對象。用戶端程式更新可能改變介面與解析邏輯，核心更新可能改變協定或傳輸實作，訂閱更新則只會替換設定項目。記錄變更對象與時間順序，能在異常出現後縮小回溯範圍。本網站的下載頁負責平台與安裝檔案選擇，完整設定負責欄位含義，部落格則追蹤架構差異與常見維護問題。
SELECTED QUESTIONS / 06
常見問題精選
以下問題依排查順序提供簡要判斷。涉及具體按鈕與欄位位置時，可繼續進入入門指南或完整設定。
v2rayN 桌面版與 WPF 版該如何選擇
桌面版採用 Avalonia 跨平台架構，可用於 Windows、macOS 與 Linux；WPF 版僅面向 Windows，並延續經典介面與操作流程。新安裝可先從桌面版開始，已形成固定 Windows 使用流程的使用者，則可比較兩版介面、依賴項目與遷移方式後再決定。下載頁分別保留兩個入口。
為什麼訂閱匯入成功後仍然無法連線
匯入成功只表示用戶端已讀取訂閱內容。還需要選擇作用中設定、啟動連線，並依平台啟用系統代理或 VPN 服務。若仍無回應，應依序查看位址與連接埠、協定與傳輸欄位、系統時間、接入範圍及用戶端記錄，不宜直接將所有問題歸因於訂閱網址。
全域模式、規則模式與系統代理有什麼差別
系統代理描述應用程式流量如何進入用戶端，全域或規則模式則描述進入核心後的流量如何選擇出站。前者屬於系統接入層，後者屬於路由層。某個應用程式若不讀取系統代理，即使路由設為全域，也可能沒有流量進入用戶端；反之，流量進入後仍會受到所選路由模式影響。
V2Ray DNS 設定應從哪裡開始檢查
先確認網域由系統解析，還是交給核心處理，再檢查 DNS 伺服器、查詢策略與靜態對映。若同時啟用了多種接管方式，可先縮減為單一路徑，確認基本解析後再恢復分流。使用網域與 IP 組合規則時，還要核對解析結果是否參與路由比對。
LATEST PAPERS / 07
用戶端與設定研究筆記
文章區記錄發行線差異、平台執行策略與代理模式邊界，作為下載頁與設定文件之外的專題補充。
v2rayN 桌面版與 WPF 版怎麼選：Avalonia 跨平台架構差異逐項比較
整理 v2rayN 兩條發行線的定位，比較平台範圍、介面渲染、系統依賴、更新節奏與設定遷移注意事項。
閱讀全文 →v2rayNG 耗電異常排查：Android 背景常駐設定與省電策略整理
從 VPN 服務常駐、廠商背景限制與分應用代理範圍三個方向解釋耗電變化，並整理可逐項複查的背景設定。
閱讀全文 →系統代理、全域模式與繞過中國大陸模式差異詳解：三種模式如何選擇
區分系統接入與核心路由兩個層次，說明三種常見選項的流量範圍、適用邊界與切換判斷方法。
閱讀全文 →