Windows
v2rayN · 桌面首選桌面版提供跨平台介面，WPF 版則保留經典的桌面操作配置。兩者都需確認系統與執行環境需求，不建議只憑安裝套件名稱判斷相容性。已有設定的使用者，應先備份訂閱群組與自訂路由，再決定是否更換介面版本。
初次使用可從系統代理開始；確認瀏覽器連線與日誌正常後，再評估是否需要 TUN。安裝完成不代表代理已啟用，還應檢查目前設定、本機監聽連接埠，以及應用程式是否遵循系統代理設定。
前往下載 Windows 用戶端
評測項目清單
v2rayN 設定項目與使用限制
設定能否生效，取決於匯入內容、流量入口與出站規則是否相互吻合。先釐清各層的功能，再調整具體參數。
訂閱連結不等於完整的用戶端設定
v2rayN 的訂閱群組適合用來分開管理不同來源的連線設定。先新增群組並填入訂閱網址，再更新該群組，避免將來源不明的內容混入現有清單。訂閱通常只提供伺服器連線參數，不保證包含桌面端的系統代理、TUN 或自訂路由設定。更新後應核對協定、傳輸方式與安全參數，而不只是確認清單中是否出現項目。相較於逐筆貼上分享連結，使用群組訂閱較方便日後更新；但手動修改的項目可能在更新時遭覆蓋，重要調整應另外記錄。
v2rayN · 訂閱群組設定
訂閱網址
https://example.com/subscription更新範圍目前訂閱群組
先確認來源與格式，再更新伺服器清單。
先設定例外，再加入一般規則
路由分流依規則順序決定出站，適用範圍較窄的例外規則通常應排在一般規則之前。區域網路位址直連、指定網域代理與預設出站應分開檢查，不能只看預設名稱就判斷實際行為。網域規則需要保留可供比對的網域資訊；IP 規則則取決於目標位址與網域解析策略。相較於所有流量都交由預設出站，自訂規則更能精確表達需求，也更需要記錄修改原因。排查時先找出第一條符合的規則，再確認其指向的出站是否存在，避免重複新增條件相同的規則。
v2rayN · 路由規則順序
geosite:category-ads-all → block
geoip:private → direct
geosite:cn → direct
geoip:cn → direct
預設規則 → proxy系統代理與 TUN 的作用層級不同
系統代理主要影響遵循作業系統代理設定的應用程式，適合作為初次設定的起點；部分終端工具或自行設定網路的應用程式需要另外指定代理。TUN 透過虛擬網卡接管路由範圍內的流量，涵蓋範圍取決於系統路由、排除規則與權限狀態，啟用後並不代表每個請求都會經過代理。相較於系統代理，TUN 還需處理 DNS、區域網路存取及其他虛擬網卡的協作問題。建議先用系統代理模式確認連線，再啟用 TUN；若遇到問題，請保留可還原的基礎設定。
v2rayN · 參數設定
自動設定系統代理
TUN 模式已關閉啟用前請確認權限與路由範圍
本機監聽連接埠：10808，請以實際設定為準。
協定名稱相同，仍須確認參數支援情況
圖形化用戶端負責管理設定，核心負責解析設定並建立連線。選擇核心時，需一併確認協定、傳輸層、安全設定及路由欄位的支援範圍，不能把更換核心當成通用的修復方式。同一條分享連結在不同核心中可能需要轉換欄位；成功匯入也不代表所有參數都能正常使用。相較於直接修改核心設定，圖形介面更方便日常管理，但進階選項仍應參照目前用戶端的說明。調整前先保留原設定，每次只變更一個項目，再從啟動日誌確認設定是否正確載入。
v2rayN · 核心設定檢查
核心類型Xray
檢查順序：協定 → 傳輸方式 → TLS / REALITY → 路由欄位。
區分啟動失敗與請求失敗
排查日誌時，先確認核心是否成功啟動，再判斷請求在哪一層失敗。連接埠遭占用、設定欄位錯誤與規則資源缺失會影響啟動；解析失敗、交握失敗或連線逾時，則需依目標與時間線進一步分析。相較於反覆切換設定，保留失敗前後連續的日誌更容易縮小範圍。先還原預設日誌層級與基礎設定，必要時短暫提高記錄詳細程度，重現問題後盡快還原。對外提供日誌前，請移除訂閱網址、認證資訊及可識別的連線參數，只保留錯誤類型即可。
v2rayN · 日誌排查順序
啟動設定 → 本機監聽 → DNS 解析
→ 路由比對 → 出站連線
連接埠遭占用：address already in use
解析失敗：failed to lookup
閱讀視窗示意圖時，先分清設定與結果。
上方視窗呈現的是設定關係，不是執行狀態。連接埠、路由預設與核心選擇都只是設定輸入；連線是否正常，還需搭配應用程式請求與日誌判斷。不同桌面環境的選單位置可能有所不同；理解選項的作用，比記住截圖中的位置更有用。初次使用建議先完成訂閱匯入、選擇設定與系統代理，暫時不要加入複雜的分流規則。
平台與安裝套件
V2Ray 用戶端下載
桌面平台使用 v2rayN；Android 優先考慮採用 Xray 核心的 v2rayNG，需要 V2Fly 核心時再選擇 v2flyNG。先選作業系統，再確認處理器架構。
macOS
v2rayN · 依處理器選擇Apple 晶片選 arm64，Intel 處理器選 x64；可先在系統的「關於這台 Mac」確認晶片資訊。選對架構可減少啟動與相依性問題，避免將架構不符造成的異常誤判為訂閱或伺服器連線故障。
首次開啟時，請留意系統安全提示與網路權限。系統代理與 TUN 的授權方式不同，建議先完成基本連線測試，再設定虛擬網卡。遇到系統封鎖時，請確認應用程式來源及系統提示，不要一次變更多項安全設定。
前往下載 macOS 用戶端Android
v2rayNG / v2flyNGv2rayNG 使用 Xray 核心，是 Android 優先選擇；v2flyNG 使用 V2Fly 核心，適合需要相應核心行為的設定。主流 arm64 裝置請選擇對應安裝套件；無法確認架構時，可查看通用套件說明，別只依檔案大小選擇。
Android 通常透過系統 VPN 介面建立本機流量通道，需確認系統授權、個別應用程式設定與背景執行限制。桌面端的路由預設不一定能直接套用到手機；即使共用訂閱網址，兩端的 DNS、分流與流量接管方式也可能不同。
前往下載 Android 用戶端Linux
v2rayN · deb / rpmDebian、Ubuntu 系發行版通常選 deb，Fedora 系通常選 rpm，並同時確認 x64 或 arm64 架構。套件格式與處理器架構是兩項獨立條件，只符合其中一項仍不保證能成功安裝，還需確認發行版的相依性需求。
桌面環境對系統代理的支援程度不一，部分應用程式仍需個別設定。開機自動啟動也不代表 TUN 權限已備妥，建議先測試手動啟動，再設定桌面自動啟動項目，並確認結束用戶端後系統代理是否正確還原。
前往下載 Linux 用戶端
快速入門
從安裝到連線測試的三個步驟
先建立可重現的基本連線，再新增自訂規則。每一步只確認目前這一層的問題，能減少不同設定彼此干擾。
-
安裝用戶端並匯入訂閱群組
依作業系統與架構完成安裝後，先開啟參數設定並記下本機監聽連接埠，再前往訂閱群組新增可信來源的訂閱網址。更新後核對項目的協定、傳輸方式與安全設定，並選擇實際要使用的設定。若訂閱更新失敗，先檢查網址是否完整、授權是否有效，以及連結回傳的是訂閱內容還是網頁錯誤訊息。
分享連結與訂閱連結用途不同：前者通常描述單一連線，後者則便於批次更新。請勿將含有認證資訊的連結貼到公開留言、截圖或轉換服務。需要移轉現有設定時，先保留備份，再執行覆寫或重新匯入；訂閱匯入成功後，還需手動選取設定並確認核心能否啟動。
-
選擇代理模式，保留基本路由
桌面端先啟用自動設定系統代理，使用基本路由預設，暫時關閉 TUN，以便先確認訂閱參數與出站連線正常。Android 端則依系統提示允許建立 VPN 連線，並檢查用戶端的個別應用程式範圍。請勿同時執行多個接管系統流量的工具，否則問題可能源自代理設定彼此覆蓋，而非連線參數本身。
「全域」通常描述用戶端的出站策略，不代表系統中所有應用程式都已將流量送至用戶端。先確認請求有進入代理，再判斷應該直連或經由代理。需要使用 TUN 時，請在基本連線正常後再單獨啟用，並留意管理員權限、DNS 與區域網路排除項目；發生異常時，先還原已驗證可用的系統代理設定。
-
確認應用程式請求，再儲存日常設定
使用需要代理的應用程式發出請求，並搭配日誌確認核心啟動、本機監聽與出站連線狀況。瀏覽器能開啟網頁，只表示目前的存取路徑可用，不能直接推斷終端機、遊戲或其他應用程式也使用相同代理。反之，單次連線逾時也不足以證明整個用戶端故障，應分辨目標服務、網域解析與出站交握問題。
完成基本測試後，再逐項新增自訂路由、啟用 TUN 或調整 DNS。每次都記下變更目的與還原方式，避免同時修改多個參數而失去比較依據。停止使用時，請透過用戶端正常結束，並留意系統代理是否還原；日常維護應著重訂閱來源、設定備份與異常日誌，而非頻繁切換所有開關。
Project V / V2Fly / Xray
用戶端、核心與開源生態系
介面負責管理，核心負責執行。分開理解這兩個層面，才能說明同一份連線設定在不同裝置上的差異。
Project V 是技術生態系，不是單一安裝套件
Project V 以代理通訊與網路設定為核心，發展出一系列工具；V2Ray 是其中的重要專案。隨著社群發展，V2Fly 持續維護 V2Ray 相關實作，Xray 則從相關程式碼與技術背景發展出自己的實作方向。它們共用部分概念，但不是可任意互換的同一套程式。日常搜尋中的「V2Ray 用戶端」常是較廣泛的稱呼，實際下載時仍須確認圖形化用戶端與使用的核心。
了解這層關係，有助於釐清三個問題：介面選項在哪裡、設定語法是否受支援，以及伺服器參數是否相符。介面中的某個開關消失，不一定代表協定已取消；核心支援某個協定，也不保證目前的圖形介面完整提供所有進階欄位。遇到差異時，應依序確認用戶端、核心與連線參數，而非只比較產品名稱。
Xray 與 V2Fly 的差異，取決於具體功能
核心負責處理協定、建立傳輸、比對路由及建立出站連線。選擇核心時，應留意伺服器設定所需的功能，例如 VLESS、VMess 的相關參數，以及 TLS、REALITY 等安全設定的相容性要求。不能因為兩個核心都支援某個協定名稱，就忽略傳輸方式、欄位值與設定轉換上的差異。排查連線失敗時，保留原始參數說明，通常比頻繁更換核心有效。
路由與 DNS 也是需要核對的項目。網域清單、IP 資料資源與解析策略會共同影響規則是否符合；即使路由預設看似相同，資源內容或解析行為改變後也可能產生不同結果。建議先使用用戶端提供的基本設定，了解直連、代理與阻擋出站的意思後，再新增精細規則。清楚標示區域網路例外與預設出站，比一味增加規則數量更容易維護。
三款用戶端皆為開源，適用重點各不相同
v2rayN 面向桌面使用者，提供訂閱管理、路由設定與代理模式等圖形介面，適合需要在桌面集中檢查設定的使用者。v2rayNG 面向 Android，採用 Xray 核心，並整合連線設定與系統 VPN 授權；v2flyNG 則提供採用 V2Fly 核心的 Android 選擇。應依裝置、所需核心功能與操作習慣選擇，不要只用速度排名概括各用戶端的差異。
開源表示可依專案授權檢視、使用與研究程式碼；再散布與修改的具體義務，仍應以各專案的授權條款為準。用戶端、核心與附帶資源可能適用不同條款，不能將整個生態系一概套用同一種授權。開源有助於了解實作與維護方式，但實際連線仍會受到伺服器、網路路徑、設定內容與裝置環境影響，並不保證所有使用情境的效能。
更新前先備份，更新後在相同條件下測試
圖形化用戶端、核心與規則資源各有維護週期。更新可能改變介面配置、設定轉換、協定支援或系統整合方式；行為出現變化時，應確認改變的是哪個層面。升級前保存訂閱群組、自訂路由與必要的參數記錄；升級後先用原本的應用程式與存取目標重現基本連線，再恢復進階選項，避免把環境變化誤認為更新效果。
比較兩份設定時，應盡量維持裝置、網路與目標一致，並記錄系統代理、TUN 與 DNS 狀態。本網站的設定說明旨在建立可供查核的操作順序，不以缺少背景資訊的延遲數字代替結論。遇到新欄位、權限變更或啟動錯誤，可先閱讀完整手冊，再依日誌縮小範圍；需要了解名詞時，術語手冊有助於對照用戶端介面與核心設定。
近期設定筆記
安裝權限與啟動日誌
從平台安裝到設定錯誤，依具體狀況整理操作步驟。先判斷問題屬於系統權限、程式啟動或請求連線，再選擇對應文章。
macOS 安裝 v2rayN：處理未驗證開發者提示與網路權限
解決在 macOS 開啟 v2rayN 時遭遇的「無法驗證開發者」封鎖，說明 Apple 晶片與 Intel 安裝套件的差異，以及系統代理、網路擴充功能的授權方式。
Linux 安裝 v2rayN：部署 deb/rpm 套件與設定開機自動啟動
在 Debian/Ubuntu 與 Fedora 系發行版上使用 deb、rpm 套件安裝 v2rayN，補齊相依套件、設定桌面自動啟動項目，並處理系統代理與 TUN 權限問題。
V2Ray 核心啟動失敗怎麼辦：從 v2rayN 日誌找出設定錯誤
核心啟動失敗時先查看日誌：說明連接埠遭占用、JSON 格式錯誤、未知協定欄位、規則檔案遺失等錯誤特徵，以及逐項修正的順序。