Windows
v2rayN 提供桌面版與經典 WPF 版下載入口。桌面版採用跨平台介面，WPF 版則保留經典桌面操作方式；若已習慣其中一種介面，可先閱讀兩者的說明，再決定要安裝哪個版本。
首次啟動後，先確認核心能正常啟動，再匯入設定。若本機監聽連接埠已被其他應用程式占用，請變更連接埠並同步調整應用程式的代理設定，不要反覆重新安裝。兩種介面入口不代表需要同時執行兩份用戶端。
前往下載v2rayN · 設定匯入示意
分享連結
vmess:// · vless://其他協定
trojan:// · ss://匯入方式從剪貼簿批次匯入 URL
匯入後檢查傳輸類型 / TLS / SNI
分享連結包含單筆設定參數；訂閱網址則用於取得一組設定。
v2rayN 可從剪貼簿批次匯入分享連結，v2rayNG 也提供剪貼簿與 QR Code 匯入入口。匯入後，先核對協定、位址、連接埠與傳輸類型，再檢查 TLS、SNI 等欄位。VMess、VLESS、Trojan 與 Shadowsocks 的欄位並不通用，不能只更改協定名稱就沿用設定。不同用戶端對新傳輸選項的支援程度，取決於內附的核心；若遇到無法辨識的參數，應查看相容性說明，而非刪除欄位後強行儲存。訂閱網址則應新增至訂閱分組，再執行更新。
v2rayN · 路由設定示意
網域策略
IPIfNonMatch廣告網域
geosite:category-ads-all → block本機網路
geoip:private → direct比對方式依規則順序選擇出口
比對結果由規則順序與規則集內容共同決定。
路由分流可讓不同目的地使用直連、代理或阻擋等出口。v2rayN 的路由設定可依網域、IP 與連接埠編排規則；使用 geosite、geoip 項目時，還需要有對應的規則資料。通常應先放明確的例外，再放涵蓋範圍較大的規則，避免前面的廣泛比對影響後續設定。網域策略決定何時解析網域，並不等於 DNS 伺服器位址。v2rayNG 的預設路由與自訂規則入口有所不同，移轉設定時應檢查實際產生的規則，不能只憑模式名稱就認定兩者行為相同。
v2rayN · 流量接入示意
系統代理自動設定系統代理
本機 SOCKS
127.0.0.1:10808本機 HTTP
127.0.0.1:10809TUN 模式檢查權限與虛擬網卡元件
系統代理適用於遵循系統設定的應用程式；TUN 的流量接入範圍則不同。
系統代理會變更作業系統的代理設定，但應用程式是否使用這個入口，仍取決於應用程式本身。v2rayN 的 TUN 模式透過虛擬網路介面接入流量，實際功能取決於平台、權限與搭配元件，並非單純的全域代理開關。建議先用系統代理確認基本連線，再視需要啟用 TUN，避免同時變更路由與 DNS，讓問題更難查明。在 Android 上，v2rayNG 通常透過系統 VPN 授權接入；其選單、權限與應用程式分流設定都不同於桌面版 TUN，不宜逐項照搬。
v2rayN · 訂閱分組示意
分組備註依設定來源命名
訂閱網址填入現有訂閱 URL
更新操作更新目前訂閱
本機設定與訂閱分組分開儲存
更新前，先區分訂閱設定與手動儲存的設定。
訂閱分組可區分設定來源，也方便個別更新與篩選。v2rayN 可在訂閱分組設定中填入網址與備註；更新後，請再次確認目前使用的設定是否仍有效。訂閱內容由網址提供者決定，更新時可能取代分組內的項目，因此長期修改的設定建議另存為本機項目。v2rayNG、v2flyNG 的分組介面與支援的訂閱格式可能不同，匯入前應確認內容是逐行排列的分享連結，還是原生 JSON。訂閱網址可能含有存取憑證，請勿將它放進截圖、公開記錄或線上轉換工具。
v2rayN · 核心選擇示意
核心類型
Xray / v2fly選擇依據協定與傳輸功能支援度
行動端 Xray
v2rayNG行動端 V2Fly
v2flyNG介面負責管理，核心負責執行設定並建立連線。
圖形用戶端與代理核心是兩個不同的元件層。v2rayN 可選的核心類型取決於目前的發行套件與協定支援；切換前應確認目標核心能完整讀取設定。Xray 與 V2Fly 有共同的技術源流，但後續功能與設定欄位各自發展，不能視為完全相容。在 Android 上，v2rayNG 著重 Xray 生態系，v2flyNG 則可作為 V2Fly 核心的替代選項。使用 REALITY 等功能時，應以用戶端實際整合的核心能力為準；若現有設定運作穩定，也不必只因核心名稱不同就移轉。
DOWNLOAD BY PLATFORM
V2Ray 下載
依作業系統選擇用戶端
桌面版使用 v2rayN；Android 可優先考慮 v2rayNG，也可依核心需求選用 v2flyNG。下載頁集中列出安裝套件格式與處理器架構。
macOS
v2rayN 依 Apple Silicon 與 Intel 提供不同的安裝入口。請在系統的「關於這台 Mac」查看晶片或處理器資訊，再選擇相符的架構，避免只憑檔名中的陌生縮寫判斷。
安裝後先確認應用程式能正常開啟，再授予所需的網路設定權限。系統代理與 TUN 的接入機制不同，需要的額外權限也可能不同；若瀏覽器能連線、其他應用程式卻不行，請先確認該應用程式是否遵循系統代理設定。
前往下載Android
v2rayNG 使用 Xray 核心，v2flyNG 則是 V2Fly 核心的替代選項。多數較新的手機適用 arm64；若不確定裝置架構，可查看裝置資訊或選擇通用套件，並以安裝頁列出的系統需求為準。
連線時需要確認已授予系統 VPN 權限。若切換到背景後連線中斷，請檢查電池最佳化、背景活動與廠商的省電策略；應用程式分流可控制哪些應用程式使用代理通道，設定後需重新連線並確認實際效果。
前往下載Linux
v2rayN 提供 deb 與 rpm 格式，並分為 x64、arm64 架構。安裝格式取決於發行版使用的套件管理系統，處理器架構則應從系統資訊確認；兩者都必須相符。
圖形桌面的系統代理不一定涵蓋終端機程式。若要替特定應用程式設定代理，請確認本機監聽位址與連接埠；啟用 TUN 前，先閱讀目前發行套件對權限與元件的要求。發生問題時，可先從核心記錄與連接埠占用情況著手排查。
前往下載
查看所有用戶端 →
下載頁提供目前的安裝入口與系統需求；首頁不固定顯示發行版本，避免過時資訊影響安裝選擇。
QUICK START
v2rayN 設定教學
先建立一條連線
用戶端負責讀取並執行設定。安裝完成不代表已有可用連線，還需要有效的分享連結、訂閱網址或完整設定。先確認基本流程正常，再加入分流與自動化設定。
-
匯入分享連結或訂閱
複製完整的分享連結，在 v2rayN 選擇從剪貼簿匯入；如果拿到的是訂閱網址，則前往訂閱分組設定，填入網址與備註後執行更新。兩種入口不能混用：訂閱網址會傳回一組設定，分享連結則描述單筆設定。匯入成功後，請檢查協定、伺服器位址、連接埠、傳輸類型與 TLS 相關選項；清單中出現項目，不代表設定內容一定完整。
v2rayNG 的對應入口通常位於新增設定或訂閱設定中。先確認複製的內容沒有夾帶說明文字，也沒有因換行而遭截斷；透過 QR Code 匯入後，也應開啟編輯頁重新核對欄位。分享連結與訂閱網址可能包含連線憑證，排查時只顯示必要欄位，並隱藏敏感資訊。
-
選擇設定與流量接入方式
將準備使用的設定設為目前使用的設定，再啟動連線。桌面端可先選擇自動設定系統代理，並用遵循系統代理的瀏覽器測試；Android 端則依提示允許建立 VPN 連線。路由規則決定流量要走哪個出口；系統代理或 TUN 則決定流量如何進入用戶端，兩者屬於不同層級的設定。
初次測試時，盡量保留基本預設值，不要同時啟用多個代理程式。確實需要 TUN、應用程式分流或自訂 DNS 時，每次只調整一類選項並記錄結果。這樣較容易分辨問題來自設定本身還是流量接入方式，也方便失敗時還原至已知可用的狀態。
-
確認連線並查看記錄
開啟需要使用代理的目標應用程式，確認網頁或服務確實可連線，同時查看用戶端記錄。清單中的測試結果只代表特定測試方式，不表示所有應用程式都能連線；瀏覽器測試成功，也無法證明終端機或其他程式使用了相同代理。請分別測試日常需要使用的應用程式。
遇到 TLS 握手錯誤時，優先檢查裝置時間、SNI 與憑證相關設定；若解析失敗，先核對 DNS 與路由策略；完全沒有連線記錄，則檢查系統代理、本機連接埠，以及應用程式本身的代理選項。請保持憑證驗證開啟，不要長期以略過驗證作為解決方式。完整步驟與判斷流程請參閱完整教學。
PROJECT V ECOSYSTEM
Project V 生態系
用戶端與核心的關係
先分清介面、核心與協定，再比較功能。用戶端名稱相近，不代表設定可以直接互換；選擇時應以實際使用的協定、傳輸方式與系統環境為準。
TECHNICAL ORIGIN
Project V · V2Ray
協定、傳輸、路由與出口的模組化設計
V2Fly
延續 V2Ray 核心的社群維護。v2flyNG 提供 Android 圖形介面；v2rayN 可選用的核心則以實際發行套件與功能支援為準。
Xray
以共同的技術基礎發展出各自的功能與設定能力。v2rayNG 使用 Xray 核心；若使用 REALITY 等功能，需先確認核心是否支援。
從 Project V 到圖形用戶端
Project V 的技術架構將入站、路由與出站分開管理。V2Ray 核心負責接收本機流量、執行規則並連線至遠端；圖形用戶端則提供可操作的介面，用於編輯設定、管理訂閱、查看記錄與整合系統。因此，下載 v2rayN 或 v2rayNG，取得的不只是協定名稱，而是一套以核心為基礎的管理工具。
排查時也應分別檢查這兩個層面：介面能正常開啟，不代表核心已啟動；核心啟動成功，也不代表目標應用程式已將流量交給它。先查看記錄有無啟動錯誤，再檢查代理接入方式與目前使用的設定，比反覆切換協定更容易找出原因。本網站的術語手冊會分別說明這些概念，遇到陌生欄位時可供查閱。
V2Fly 與 Xray 的相容性界線
V2Fly 與 Xray 有共同的歷史源流，也共用部分協定與設定概念，但目前由各自的團隊維護。協定支援、傳輸選項、DNS 行為與新增欄位都可能有所差異。不能只因兩者都使用 JSON，就認定原生設定檔可以跨核心直接使用；圖形用戶端轉換匯入參數的能力，也受自身實作方式限制。
VMess、VLESS、Trojan 與 Shadowsocks 是協定層級的選擇；TLS、REALITY 與特定傳輸方式則屬於其他層面。REALITY 不是可任意取代 VMess 的獨立代理協定，通常需要搭配相應協定與支援它的核心。伺服器提供哪些設定，用戶端就必須具備相應功能；選擇時不宜只看名稱的新舊。
三款用戶端的開源特性
v2rayN、v2rayNG 與 v2flyNG 都是開源圖形用戶端，原始碼與授權條款是協作與使用的基礎。v2rayN 面向桌面使用，著重設定管理與系統整合；v2rayNG 在 Android 上整合 Xray 核心與系統 VPN 介面；v2flyNG 則為希望使用 V2Fly 核心的 Android 使用者提供另一種選擇。
開源不代表三款用戶端的功能完全相同，也不代表其中一款能讀取另一款的所有本機資料。移轉時，優先使用雙方都支援的分享連結或訂閱格式，再重新檢查路由、DNS、應用程式分流與背景權限。若要重新散布或修改，應分別閱讀用戶端與內含元件的授權條款，不能將整個生態系視為採用同一種授權。
更新時分別檢查三類變更
用戶端介面、核心與規則資料可能各自更新。介面更新可能調整選單位置與匯入方式；核心更新可能新增協定功能或變更設定要求；geosite、geoip 等規則資料更新，則可能改變同一條規則的比對範圍。更新前後行為不同時，先確認變更發生在哪個層面，再決定是否調整設定。
更新前請備份必要的本機設定與自訂規則，並閱讀發行說明中的系統需求與相容性提示。訂閱更新只會更新設定來源提供的內容，不代表用戶端或核心也已更新。對於運作穩定的設定，應有計畫地維護，不要同時更換用戶端、核心、訂閱與路由，再回頭追查原因。更完整的協定比較請參閱協定與核心技術參考。
CONFIGURATION NOTES
V2Ray 設定文章
訂閱、DNS 與 TLS
從具體錯誤訊息與設定問題開始查找。文章會區分協定欄位、用戶端選項與系統行為，避免用單一開關解釋所有連線問題。
V2Ray 訂閱連結格式詳解：Base64 訂閱、原生 JSON 與分享連結互轉
介紹常見訂閱格式的結構與適用用戶端，說明如何將 Base64 訂閱解碼為逐行分享連結、分享連結與原生 JSON 設定的對應方式，以及匯入失敗的格式原因。
閱讀文章 →V2Ray DNS 洩漏檢測方法與 v2rayN 防洩漏設定步驟
說明 DNS 洩漏的成因與檢測方式，逐步設定 v2rayN 的遠端 DNS、網域策略與 TUN 模式，並提供 v2rayNG 對應設定的檢查清單。
閱讀文章 →V2Ray TLS 握手失敗排查：系統時間偏差、SNI 填寫與 allowInsecure 常見誤區
整理 TLS 與憑證錯誤的常見原因：裝置時間不同步、SNI 與偽裝網域不一致、指紋設定不符，並說明為何不建議長期略過憑證驗證。
閱讀文章 →