Windows
v2rayN / Desktop · WPF
適合在桌面集中管理訂閱群組、節點選擇與系統代理。下載頁提供桌面版與經典 WPF 版：前者採用新一代跨平台介面，後者保留傳統桌面操作方式。挑選時先確認系統相容性，再依介面偏好決定；同一台電腦不必同時安裝兩個版本。
首次啟動後，先確認核心可正常執行，且本機監聽連接埠沒有衝突，再匯入節點。更新前請保留訂閱群組與自訂路由；需要搬移設定時，請使用用戶端支援的匯出方式，不要直接覆蓋執行目錄。
前往下載 Windows 用戶端 →CLIENT / PLATFORM
依平台選擇用戶端
桌面電腦建議優先查看 v2rayN，Android 裝置則可先看 v2rayNG。請先確認作業系統與處理器架構，再選擇安裝套件。同一個訂閱可用於不同用戶端，但介面選項、本機連接埠與路由預設不一定相同。下載頁整理了各平台的安裝入口與套件類型，首頁不列出個別版本。
macOS
v2rayN / Apple Silicon · Intel
桌面訂閱與路由管理也可使用 v2rayN。請先在系統的「關於這台 Mac」查看晶片資訊：Apple Silicon 選擇 arm64，Intel 選擇 x64。處理器架構決定安裝套件類型，不能只憑電腦外觀或購買年份判斷。
安裝後請留意系統對應用程式啟動與網路權限的提示。系統代理只會影響遵循該設定的應用程式；終端機工具或內建代理選項的軟體可能需要另外設定。排查連線問題時，請先確認目標應用程式實際使用哪一種代理方式。
前往下載 macOS 用戶端 →Android
v2rayNG / v2flyNG
建議優先查看採用 Xray 核心的 v2rayNG；若需要相容 V2Fly 設定，再考慮 v2flyNG。多數較新的裝置使用 arm64；不確定架構時，可參考通用安裝套件說明。兩款用戶端採用的核心不同，名稱相近不代表所有欄位都能通用。
首次連線通常需要確認系統 VPN 授權。若系統已有其他 VPN 連線，請先確認是否發生資源衝突。背景連線中斷也可能與電池最佳化或背景執行限制有關；允許背景執行後，再查看記錄，確認是否仍有節點或解析問題。
前往下載 Android 用戶端 →Linux
v2rayN / deb · rpm
依發行版的套件管理系統選擇 deb 或 rpm，再確認 x64 或 arm64 架構。Debian 系統與採用 RPM 套件管理的發行版，下載入口不同；套件格式不代表功能等級。桌面環境、系統相依套件與網路權限也會影響安裝及啟動結果。
圖形介面用戶端負責管理節點與設定，實際流量仍由核心處理。系統代理是否生效，取決於桌面環境與應用程式的支援情況。若瀏覽器可以連線、命令列工具卻不行，請檢查工具本身的代理設定，不要急著更換節點或重寫整份設定。
前往下載 Linux 用戶端 →CONFIG / FIELD INDEX
用戶端功能與設定欄位
圖形介面負責整理節點與設定，核心讀取設定後執行連線。以下依實際用途說明兩者的分工。程式碼皆為局部範例，用於辨識欄位位置，並非可直接連線的完整節點設定；實際語法仍須符合所用核心。
協定、傳輸與安全層
VMess、VLESS、Trojan 與 Shadowsocks 分別代表不同的出站協定；傳輸方式與安全層則由其他欄位設定。匯入節點後，請一併核對伺服器位址、連接埠、傳輸方式與 TLS 設定。REALITY 是一種安全機制，不應視為獨立的節點協定。v2rayN 與 v2rayNG 能否使用特定組合，取決於實際選用的核心。與其只看協定名稱，更可靠的方式是依伺服器提供的完整參數確認相容性，再查看握手記錄。
查看出站欄位 →{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
}
]
}群組管理與出站標籤
分享連結通常描述單一節點，訂閱網址則用來取得可更新的節點清單。先建立訂閱群組，再更新並選擇節點，可減少手動匯入造成的重複。訂閱群組是用戶端管理資料，並非 config.json 通用的頂層欄位。執行時，用戶端會將選取的節點轉換成核心可辨識的出站物件。範例中的 tag 是路由引用名稱，不是訂閱網址。若要保留自建節點，建議另設獨立群組，避免與訂閱更新混淆。
查看訂閱匯入步驟 →{
"outbounds": [
{
"tag": "local-socks",
"protocol": "socks",
"settings": {
"servers": [
{
"address": "127.0.0.1",
"port": 1080
}
]
}
}
]
}依條件指定出站
路由分流會將請求條件與出站標籤連結。規則可比對網域名稱、IP 或入站標籤，再透過 outboundTag 指定目標出站。規則順序會影響結果，較明確的條件通常應排在較寬泛的條件之前。範例會讓 example.com 及其子網域使用 direct 出站，前提是 outbounds 中已定義該標籤。明確設定小範圍規則，比不斷切換所有流量的出口更容易驗證；每次只修改一條，再查看存取記錄確認實際套用情況。
查看 routing 規則 →{
"routing": {
"rules": [
{
"type": "field",
"domain": [
"domain:example.com"
],
"outboundTag": "direct"
}
]
}
}解析與連線生命週期
DNS 決定網域名稱的解析方式，policy 則控制部分連線行為，兩者並非同一項設定。核心 DNS、系統 DNS 與瀏覽器內建解析可能同時運作，修改其中一處不代表所有請求都會改變。範例以 localhost 表示使用本機解析，並為使用者等級零設定握手逾時。實際部署時，還要確認路由是否需要解析目標網域，以及解析請求採用哪條路徑。若只有網域名稱連線失敗，請先釐清問題出在解析還是連線階段，再調整參數。
查看 DNS 設定 →{
"dns": {
"servers": ["localhost"]
},
"policy": {
"levels": {
"0": {
"handshake": 4
}
}
}
}先確認核心，再搬移設定
v2rayN 可管理不同核心，但切換核心不代表所有欄位都會自動轉換。V2Fly 與 Xray 有共同的生態背景，也各自發展不同的協定與參數；設定涉及 REALITY 時，更應確認支援範圍。v2rayNG 與 v2flyNG 的主要差異也包括核心路線。設定中沒有通用的 core 欄位可用來切換核心，相關操作是在用戶端進行。更換後先查看 warning 記錄確認啟動結果，再測試節點連線，最後還原自訂路由與 DNS 設定。
比較三款用戶端 →{
"log": {
"loglevel": "warning"
}
}START / THREE STEPS
從匯入到連線測試
先分清三種項目
用戶端、節點與訂閱
用戶端是本機管理介面，節點是一組遠端連線參數，訂閱則是取得節點清單的網址。安裝用戶端後，仍需準備可用節點；軟體本身不會附帶通用伺服器帳號。先釐清這三者，才能判斷問題出在安裝、匯入還是連線階段。
分享連結與訂閱網址可能包含存取憑證。請勿將完整網址放進公開截圖，也不要為了測試而交給不熟悉的轉換服務。回報問題時，提供錯誤類型、核心名稱與相關欄位即可，並隱去網址中的身分資訊。
若已有舊版用戶端設定，請先記下目前使用的節點、代理模式與自訂規則。首次搬移時，建議先建立最基本的可用連線，確認正常後再逐項還原其他設定，避免舊設定問題一併帶進新環境。
先看用戶端選擇指南 →-
匯入訂閱或分享連結
在 v2rayN 中開啟訂閱群組設定，新增自己持有的訂閱網址，儲存後更新訂閱；單一節點則可從剪貼簿匯入。v2rayNG 也能透過訂閱群組或分享連結新增節點。選單名稱可能隨介面調整，判斷方式是看輸入內容：遠端節點清單使用訂閱入口，單一協定連結則使用節點匯入入口。
更新後先確認清單中確實出現節點，並檢查名稱、位址與協定是否符合預期。匯入成功只代表用戶端能讀取內容，不代表伺服器一定在線。若清單為空，請先確認訂閱網址是否過期、是否需要授權，以及目前網路能否取得訂閱內容。
-
選擇節點與代理模式
選擇一個節點，再依目前需求設定系統代理與路由模式。系統代理決定「應用程式是否將流量交給用戶端」，路由則決定「收到流量後要送往何處」，兩者不能互相取代。桌面端請先使用支援系統代理的瀏覽器測試；Android 裝置則要確認已完成系統 VPN 授權。
初次使用建議先沿用用戶端提供的基本路由設定。TUN 會新增虛擬網卡並需要額外權限，不是每次連線都必須啟用。一般代理路徑穩定後，再依目標應用程式是否支援代理決定要不要使用 TUN，避免同時修改多個網路層級。
-
測試連線並查看記錄
開啟一個明確需要經由所選路徑存取的頁面，再搭配用戶端記錄檢查連線。延遲測試只能作為參考，無法取代實際應用程式存取；節點測試有結果，也不代表 DNS、TLS 與目標網站連線都正常。可以先測試單一頁面，避免大量並行請求讓記錄難以判讀。
發生逾時時，依序檢查本機入站、系統代理、路由比對與遠端出站。若連線遭拒，通常要核對監聽與目標連接埠；若握手失敗，則檢查系統時間、伺服器名稱與安全層參數。記錄每次修改前後的結果，比一次更換所有設定更容易找出原因。
PROJECT V / CORE / CLIENT
開源生態與核心差異
介面負責管理，核心負責連線
Project V 生態系
V2Ray 是 Project V 生態系中的網路代理工具。理解設定時，可拆成入站、路由與出站三部分：入站接收應用程式請求，路由檢查比對條件，出站負責連線。DNS、策略與記錄則分別處理解析、連線行為與執行狀況。這也是閱讀 config.json 的基本順序。
V2Fly
延續 V2Ray 的社群開發路線，持續維護核心及相關設定功能。
Xray
源自 V2Ray 生態系的另一條核心發展路線，並建立自身的協定與安全機制。
設定外觀相近，不代表語法完全相同。若某個欄位無法辨識，請先確認核心類型與支援範圍，不要直接判定節點失效。尤其是協定擴充、傳輸選項與安全層組合，更需要依各核心的支援能力判斷。
三款圖形介面用戶端的定位
v2rayN 面向桌面使用者，集中管理訂閱、節點、路由與可選核心。v2rayNG 適用於 Android 裝置，採用 Xray 核心；v2flyNG 則提供 V2Fly 路線的 Android 選擇。三款用戶端都是開源專案，但用戶端名稱不等於協定名稱，用戶端更新也不代表核心功能完全相同。
圖形介面將常見操作整理成選項，但執行時仍須產生核心設定。因此，介面上的一個開關可能影響多個 JSON 欄位；反過來說，用戶端也不一定提供所有底層參數的圖形化操作入口。若需要自訂設定，請先了解用戶端如何儲存、產生及覆寫執行檔案，避免編輯內容被介面重新產生的設定取代。
開源授權與社群維護
開源表示原始碼依相關授權提供使用、研究與修改的條件，不代表所有元件都採用相同授權。V2Fly 與 Xray 的核心程式碼主要採用 MPL-2.0；用戶端、相依套件與附加元件則應分別查看各自的授權說明。修改或重新散布時，須遵守相關專案的署名、提供原始碼及其他條款，不能只憑「免費」判斷使用範圍。
社群通常分別推進介面改良、設定相容性與核心更新。閱讀更新說明時，請確認修正屬於哪個層級：介面調整可能只改變操作位置，核心變更則可能影響協定參數、連線行為或規則支援。本站整理下載與設定參考入口，不取代軟體專案本身的授權說明，也不提供節點服務。
更新前後都保留還原方式
更新前先備份訂閱群組、自建節點與自訂規則；更新後查看啟動記錄，再測試常用節點與應用程式。若只有某一類連線異常，可暫時還原相關路由或 DNS 設定，逐項比對，不必清除所有資料。使用執行記錄診斷時，避免長時間開啟過於詳細的記錄，並留意其中可能包含目標網域等瀏覽資訊。
學習設定也適合依照相同順序進行：先建立基本連線，再了解出站標籤與規則比對，最後調整解析與策略。只有清楚每個欄位影響的環節，才能判斷修改是否真正解決問題。欄位類型與範例請參閱設定檔參考。
NOTES / LATEST
設定與故障排除文章
建立基本連線後，再依實際問題閱讀相關主題。協定文章說明欄位背後的機制，節點挑選文章協助解讀測試結果，故障排除清單則幫助縮小問題範圍。閱讀時保留目前可正常運作的設定，每次只驗證一項變更。
V2Ray 顯示已連線卻無法上網？逐項排查清單
依序檢查系統代理狀態、本機連接埠、DNS 解析、路由規則、節點可用性與系統時間，涵蓋 v2rayN 桌面版及 v2rayNG Android 版的常見情況。
閱讀文章 →V2Ray 節點怎麼選？延遲、倍率、地區與協定類型比較指南
從如何正確解讀測速延遲、計算流量倍率，到地區與線路的關係，以及 VMess、VLESS、Trojan 的選擇，整理一套挑選節點的判斷順序。
閱讀文章 →REALITY 與 XTLS Vision 原理解析：VLESS 傳輸為何更快
以淺顯方式說明 XTLS Vision 如何減少重複加密、REALITY 如何改良 TLS 握手，以及在 Xray 核心設定中對應的 flow 與 security 欄位。
閱讀文章 →