Windows
v2rayN · 桌面版 / WPF 版桌面版採用跨平台介面，WPF 版則保留經典桌面操作方式。初次安裝可先了解介面差異與系統需求，不必為了同一組訂閱同時安裝兩個版本。兩種介面的設定位置可能不同，操作時請依功能名稱尋找入口。
下載前先在系統資訊中確認處理器類型，安裝後將設定檔放在方便管理且具有寫入權限的位置。若程式提示缺少執行環境，請依安裝說明補齊所需元件，再匯入訂閱。
前往下載 Windows 用戶端 →- 圖形介面v2rayN · v2rayNG · v2flyNG
- 核心生態系Xray · V2Fly
- 設定匯入方式訂閱網址 / 分享連結
- 使用順序匯入 → 代理 → 分流
用戶端的五個設定入口
先匯入連線資訊，再決定哪些應用程式要透過代理連線。以下設定畫面僅用來說明各入口，並非網頁上的可操作用戶端。
訂閱網址，儲存後再更新
訂閱適合管理一組會變動的連線設定。在 v2rayN 的訂閱群組設定中填入備註與完整網址，儲存後再執行更新訂閱。用戶端會讀取網址回傳的內容，並建立對應的伺服器項目。相較於逐筆貼上分享連結，訂閱可保留後續更新功能；但網址本身不是連線參數，光是儲存網址也無法建立連線。更新後，先確認群組中出現有效項目，再選擇要使用的設定。若清單為空，請檢查網址是否過期、回傳內容是否為設定文字，以及更新請求是否受到目前代理狀態影響。
- 備註僅供辨識來源，建議依用途命名。
- 截圖或尋求協助前，請遮蔽完整網址與驗證參數。
- 更新失敗時先保留原有設定，再檢查請求的連線路徑。
訂閱群組設定
備註日常訂閱
網址 (URL)
https://example.com/your-sub範例網址僅用於說明格式，請使用已取得且有效的訂閱。
更新訂閱（不透過代理）系統代理與 TUN，依應用程式需求選擇
系統代理會將本機代理網址登錄至作業系統，適用於會讀取這項設定的瀏覽器與應用程式。TUN 則透過虛擬網卡接收流量，適合需要涵蓋更多應用程式的情況。並非同時啟用越多功能越好：初次使用時，先選擇自動設定系統代理，確認瀏覽器運作正常後，再判斷目標應用程式是否需要 TUN。啟用 TUN 前，請確認系統權限、虛擬網卡元件及其他網路工具的運作狀況。若已有其他代理或 VPN 工具接管路由，請先關閉重複功能，避免將設定衝突誤認為訂閱無效。
- 開啟系統代理，不代表所有程式都會使用。
- TUN 是否可用，取決於平台與本機權限。
- 結束用戶端前，請留意系統代理是否已還原。
連線方式示意
系統代理自動設定系統代理
優先驗證啟用 TUN 模式確認權限後視需要開啟
設定項目名稱可能因介面實作而異，請以目前使用的用戶端為準。
路由規則，決定流量的下一站
流量進入核心後，路由會根據網域、目標位址等條件選擇出口。初次設定可先使用用戶端提供的預設規則，確認基本連線正常後，再新增自訂規則。規則通常依序比對，範圍過廣的項目若排在前面，可能會讓後續較精確的條件失效。右側片段示範將指定網域集合交由 direct 出口處理，並非可直接取代完整設定的檔案。實際使用時，還需確認規則資源包含對應集合，且設定中存在名稱相同的出口。網站流量走錯路徑時，先檢查規則比對順序，再確認網域解析策略。
- 先了解預設規則，再修改例外網域。
- 規則資源必須與核心設定相互對應。
- 修改前先儲存原有設定，方便逐項還原。
路由規則片段
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}片段需合併至現有路由規則；集合內容取決於本機的規則資源。
分別確認介面與核心
圖形化用戶端負責儲存設定及啟動服務，核心則負責處理協定、傳輸與路由。v2rayN 提供多核心相關設定入口，但實際選項取決於安裝套件與用戶端的實作。切換前，先確認連線所需的協定、傳輸方式與安全參數，不能只因名稱相似就認定相容。Android 端的選擇較為直接：v2rayNG 使用 Xray 核心，v2flyNG 則是 V2Fly 核心的替代選擇。與其反覆更換整套用戶端，不如先確認目前的核心是否支援目標設定，較容易找出問題。更新介面程式後，也應確認實際執行的核心是否符合預期。
- 用戶端介面版本與核心能力是不同概念。
- 伺服器端參數必須與所選核心相符。
- 先備份設定，再移轉核心或用戶端。
選擇前確認三項設定
協定
VMess / VLESS傳輸方式須與伺服器端一致
安全參數逐項確認 TLS 等參數
依作業系統選擇用戶端
桌面系統可選擇 v2rayN，Android 裝置則建議先了解 v2rayNG。下載頁會進一步區分處理器架構與安裝套件類型。
macOS
v2rayN · 桌面版先在「關於這台 Mac」查看晶片資訊，再選擇適用於 Apple Silicon 或 Intel 的安裝套件。架構會影響程式能否直接執行，與訂閱使用哪種協定是兩回事，請勿混為一談。
首次啟動時，依系統提示授予應用程式所需權限。確認系統代理可用後，再視需求考慮 TUN；若涉及網路擴充功能或管理者授權，請先閱讀平台說明，不要直接套用其他桌面系統的操作方式。
前往下載 macOS 用戶端 →Android
優先推薦 v2rayNG · v2flyNG 為替代選擇v2rayNG 使用 Xray 核心，v2flyNG 則提供 V2Fly 核心選項。主流裝置通常可選擇 arm64 安裝套件；若不確定架構，請先查看下載頁說明，再決定是否使用通用版。安裝套件架構與核心系列需分開考量。
匯入訂閱後選擇要使用的設定，連線時確認已授予系統 VPN 權限。若切換至背景後連線中斷，請檢查電池管理與背景執行限制；若有其他網路工具正在連線，先排除系統連線遭占用的情況。
前往下載 Android 用戶端 →Linux
v2rayN · deb / rpm依發行版的套件管理方式選擇 deb 或 rpm，再確認裝置使用 x64 或 arm64 架構。圖形介面相似不代表桌面環境完全相同；系統代理是否會被應用程式讀取，也取決於應用程式本身與桌面工作階段的實作。
先在一般使用者環境下啟動程式並匯入訂閱，再處理 TUN 所需的額外權限。若瀏覽器與其他程式的連線狀況不同，請檢查各自使用的代理來源，避免誤以為桌面代理設定會套用至所有程序。
前往下載 Linux 用戶端 →下載用戶端不會自動取得連線設定。開始前請準備有效的訂閱網址或分享連結，並確認其來源與使用範圍。更換裝置時可以移轉設定，但本機代理開關、系統授權與背景執行權限仍需重新確認。
查看所有用戶端 →首次設定的三步驟
先確認設定已匯入，再確認應用程式已使用代理，最後檢查路由。每個步驟都要有可供確認的結果。
-
匯入訂閱或分享連結
先辨別收到的文字類型。訂閱網址通常要先新增至訂閱群組，再執行更新；單筆分享連結則應使用剪貼簿或掃描 QR Code 匯入。不要把說明網頁的網址當成訂閱，也不要將整段聊天紀錄貼到網址欄位。
更新完成後，確認群組中已新增設定、備註符合預期，再選擇要使用的項目。暫時不要更動傳輸與安全參數，先保留來源提供的完整設定。若沒有新增項目，應優先檢查網址與內容格式，而不是開啟更多代理功能。
-
選擇連線方式
桌面端先使用自動設定系統代理來測試瀏覽器；Android 端在啟動連線時確認已授予系統權限。若目標應用程式有自己的代理設定，需另外確認它是沿用系統設定、採用手動設定，還是完全不使用系統代理。
只有在確有需求時，才將 TUN 作為下一步，而非匯入訂閱後的必選項。啟用前請確認權限，並暫停其他可能接管流量的工具。區域網路分享是另一項獨立功能，個人裝置自行使用時通常不需為了連線而開啟。
-
確認連線與路由分流
先用常用瀏覽器造訪已知可連線的網站，再測試確實需要代理的目標應用程式。若兩者結果不同，先檢查應用程式的連線方式；若都無法使用，再確認目前選用的設定、系統時間，以及用戶端記錄中的錯誤類型。
連線正常後再套用路由預設規則，並逐項新增例外。出現異常時，先還原最近一次變更，不要同時更換訂閱、核心與路由設定。停止使用時，請還原不再需要的系統代理設定，避免用戶端關閉後，應用程式仍連向本機連接埠。
卡在某個步驟時，先保留最基本的設定。「訂閱可更新」、「核心可啟動」和「瀏覽器可連線」是三種不同的檢查結果。記下問題發生在哪一層，後續排查會更有效率。分享記錄前，請遮蔽伺服器位址、使用者識別資訊與訂閱參數，只保留必要的錯誤訊息。
查看完整教學 →Project V 與開源核心生態系
先了解專案、核心與圖形化用戶端的差異，再認識更新與相容性。名稱相似，不代表負責相同的工作。
Project V：從工具集合到用戶端生態系
Project V 是認識 V2Ray 背景的起點之一，重點在於模組化的網路代理功能：入站負責接收流量，出站負責建立連線，路由規則則決定流量交由哪個出站處理。日常所說的「V2Ray 用戶端」，通常是指具備圖形介面的管理程式，而非單指其中某個可執行核心。圖形介面將原本需手動編輯的參數整理成表單、選單與訂閱群組，降低日常設定的操作門檻。
這種分層也說明了為何同一份連線資訊能出現在不同用戶端中：分享格式用於交換設定，核心負責建立連線，介面則負責管理。參數能否互通，仍須視雙方對協定與擴充欄位的支援情況而定。了解這層關係後，遇到匯入失敗可先檢查格式，遇到啟動失敗則檢查核心參數，不必只憑用戶端名稱判斷原因。
V2Fly 與 Xray：相關但各自演進
V2Fly 社群延續 V2Ray 相關開發，Xray 則是以相關技術為基礎演進而來的另一條核心路線。兩者共享部分概念與協定基礎，也在各自發展過程中形成不同的功能與相容範圍。訂閱提供者列出的協定名稱只是檢查起點，傳輸方式、安全參數與具體實作需求同樣重要。某個欄位在一種核心中有效，不代表另一種核心也會完全接受。
選擇時應先查看伺服器端提供的設定需求，再選用能正確處理這些需求的用戶端與核心組合。不要把核心名稱當成籠統的效能排名，也不要只為了排查一次逾時就頻繁更換工具。先確認系統時間、連線方式與目前使用的設定，再檢查協定支援情況，通常更容易保留可供比較的檢查結果。
開源授權：了解程式碼與使用範圍
v2rayN、v2rayNG 與 v2flyNG 都是開源用戶端。開源表示程式碼可依各自授權條款供人檢視、使用與參與改進，不代表所有專案採用同一種授權。用戶端、呼叫的核心及隨附元件可能分別受到不同條款規範；若要重新散布或修改，應閱讀各專案隨附的授權說明，而非只憑介面名稱判斷。
用戶端免費提供，也不代表用戶端會提供連線資源。訂閱網址、伺服器與帳號各自來自不同設定來源，其可用性與用戶端程式碼是否開源是兩回事。本網站整理下載選擇與設定方式，不提供可公開分享的訂閱憑證。使用前請確認設定來源可信，並遵守所在地適用法規與網路服務條款。
社群維護：更新前先保留可用設定
開源生態系透過社群持續修正相容性問題、調整介面並新增功能。用戶端、核心與規則資源可能各自更新，因此「更新完成」需先確認更新的是哪個項目。安裝新版介面後，舊設定能否移轉、原有核心是否仍在使用、規則資源是否相符，都值得依更新說明逐項確認。介面看起來相同，不代表可以略過移轉檢查。
更新前記下目前的連線方式與路由選擇，並備份必要設定；更新後先測試原本正常的使用情境，再啟用新選項。設定備份可能含有訂閱與驗證資訊，請以敏感檔案方式妥善保存。若行為有所變化，先比對設定與錯誤訊息，再決定是否還原。平台權限、設定移轉與常見衝突等資訊，可繼續參閱全平台使用說明。
近期技術筆記
聚焦容易混淆的設定入口、版本類型與錯誤狀況。先依遇到的問題選讀文章，再回到用戶端逐項確認。
V2Ray 訂閱更新失敗或解析結果為空？檢查網址、編碼與網路三大原因
訂閱更新失敗，不一定代表用戶端無法連線。先確認網址是否仍有效、回傳內容是否為可識別的格式，再檢查 Base64 編碼與更新請求使用的網路路徑。分別處理「請求失敗」與「解析結果為空」，才能採取正確的修正步驟。
閱讀筆記 →Windows 安裝與設定 v2rayN 完整流程：從解壓縮、匯入訂閱到系統代理的常見問題
從選擇桌面版或 WPF 版開始，檢查安裝目錄與執行環境，再完成訂閱匯入和系統代理設定。依啟動、匯入、連線三個階段整理常見問題，並說明何時才需要進一步嘗試 TUN。
閱讀筆記 →v2rayN 桌面版與 WPF 版有何差異？依作業系統與使用習慣選擇
桌面版採用 Avalonia 跨平台介面，WPF 版則適合習慣經典桌面操作的使用者。文章比較支援平台、外觀與相依元件，協助桌面使用者依作業系統選擇，也說明介面不同不代表訂閱概念有所改變。
閱讀筆記 →