Windows
v2rayN · 桌面首選提供 Desktop 與經典 WPF 版本。Desktop 採用新一代跨平台介面,WPF 則保留傳統桌面操作方式;請依使用習慣和執行環境選擇。
前往下載 →先確認作業系統,再核對處理器架構。桌面端使用 v2rayN;Android 端則依核心需求,在 v2rayNG 與 v2flyNG 之間選擇。
提供 Desktop 與經典 WPF 版本。Desktop 採用新一代跨平台介面,WPF 則保留傳統桌面操作方式;請依使用習慣和執行環境選擇。
前往下載 →Apple Silicon 與 Intel 請分別下載對應安裝套件。在「關於這台 Mac」查看晶片資訊;首次開啟時,依系統提示允許執行應用程式並授予網路權限。
前往下載 →v2rayNG 採用 Xray 核心,v2flyNG 則是 V2Fly 核心的替代選擇。大多數新款裝置選 arm64 即可;若不確定裝置架構,請查看系統資訊或選擇通用版本。
前往下載 →Debian、Ubuntu 系統建議選 deb 套件,Fedora 等發行版則選 rpm。除了套件格式,也要確認 x64 或 arm64 架構,以及桌面工作階段與系統匣支援情況。
前往下載 →客戶端、核心與訂閱是三個不同部分。安裝客戶端只是取得操作介面和本機代理功能,不會自動提供可用伺服器。開始前,請準備有權使用的訂閱網址或伺服器設定,並確認伺服器端採用的協定、傳輸方式與安全參數。只有伺服器名稱或地區標籤,無法建立連線。
同一份訂閱可能包含多種協定,但客戶端能否匯入,仍取決於訂閱格式與核心相容性。不要只看副檔名判斷:分享連結、聚合訂閱與完整 JSON 的匯入位置各不相同。初次使用建議先匯入來源明確的訂閱,選定一筆設定後,再確認本機代理是否已啟動,避免一次加入多個不確定因素。
安裝後先使用預設網路設定完成一次連線。桌面端確認系統代理已接管瀏覽器流量;Android 端確認已授予 VPN 權限。若要處理遊戲、命令列或特定應用程式,再評估 TUN 模式或依應用程式設定代理。先建立可重現的基本連線,再調整分流規則,更容易找出問題來源。
已設定完成的裝置,升級前請保留訂閱分組、路由規則與自訂 DNS 設定。不要直接覆蓋其他客戶端的整個資料目錄:介面設定、核心設定與規則檔案的結構各不相同。需要遷移時,建議重新匯入訂閱,再逐項搬移確實用到的自訂設定。
從客戶端實際提供的設定項目了解功能。先確認設定來源,再決定流量如何進入代理、由哪個出口處理,以及網域名稱在哪裡解析。
訂閱分組適合用來分類管理不同來源的伺服器。在 v2rayN 的「訂閱分組」中新增備註與訂閱網址,儲存後更新該分組,再回到伺服器清單選擇設定。v2rayNG 也能透過訂閱分組管理來源。相較於逐筆貼上分享連結,訂閱可以集中同步網址與參數,但更新時可能會取代原有項目。需要長期保留的手動設定,請另外整理;篩選條件先用少量項目測試,避免把需要的伺服器一併隱藏。
路由規則決定流量要直連、代理還是阻擋,並不決定應用程式是否會進入客戶端。在 v2rayN 中,系統代理與路由模式需要分別檢查;「繞過中國大陸」也不代表所有應用程式都會遵循系統代理。規則通常依序比對,區域網路位址等明確例外應放在適當位置,再處理網域名稱與位址集合。下方是 Xray 風格的規則片段,須放入相應的設定結構,且必須存在 direct 出站。完整設定不能只靠一條規則取代。
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
TUN 模式適合不讀取系統代理設定的應用程式,透過虛擬網卡讓更多流量進入客戶端。它和「全域路由」不是同一個開關:前者處理流量入口,後者決定流量進入後的出口。桌面端啟用前,先確認權限、相關元件與系統支援情況,避免同時執行其他會接管網路的工具。Android 端通常透過系統 VPN 介面運作,不要直接照搬桌面端的開關設定。啟用後若區域網路存取異常,請檢查私有位址排除規則與 DNS,而不是反覆更換伺服器。
DNS 會將網域名稱解析為位址,解析路徑需要與路由目標搭配。網頁無法開啟時,先查看記錄是否出現解析逾時,再檢查伺服器能否建立連線。不要把公共 DNS 位址直接填入所有欄位:本機解析、遠端解析與引導解析的用途不同。下方呈現核心 DNS 的基本結構,並非完整的分流方案。v2rayNG 的「啟用本機 DNS」也必須依具體設定理解;使用 FakeDNS 時,還要確認流量入口與路由支援相應的運作方式。
{
"dns": {
"servers": ["localhost"]
}
}
Xray 與 V2Fly 是相關但各自獨立發展的核心專案,支援的協定細節與設定欄位並不完全相同。v2rayN 的核心選擇應以目前發行版本及設定選項為準,不要假設所有設定都能直接切換。Android 端可比較 v2rayNG 與 v2flyNG 的不同核心路線。切換前請備份設定,確認傳輸方式、安全參數與規則資源相容,再使用同一筆伺服器設定測試。某個核心能匯入連結,不代表另一個核心也支援所有擴充參數。
遇到「客戶端顯示已啟動,但應用程式仍無法連線」時,先確認應用程式流量是否進入本機代理。瀏覽器、命令列工具與背景服務不一定使用相同的代理設定;瀏覽器能連線,只能代表該瀏覽器目前的連線路徑可用。接著檢查選取的伺服器設定、路由比對結果與連線記錄,最後再排查網域解析。把三個環節分開檢查,比同時修改連接埠、DNS 和路由更有效。
延遲測試也要分清楚測試對象。位址探測成功,不代表目標網站一定能正常使用;實際連線測試更接近真實代理路徑,但結果仍會受到測試目標、網路負載與時間影響。選擇伺服器時應搭配實際用途驗證,不要以單次測試取代持續觀察。想了解相關名詞,可先閱讀術語表;需要調整規則,則依照進階設定逐項操作。
客戶端負責操作,核心負責連線。了解兩者的關係,才能判斷設定能否遷移、協定是否相容,以及更新後應檢查哪些項目。
V2Ray 專案的技術背景
各自發展的核心專案
圖形化客戶端
Project V 是了解 V2Ray 生態系的起點。V2Ray 將協定處理、傳輸與路由等功能整合在可設定的代理核心中;圖形化客戶端則將常用操作整理成伺服器清單、訂閱分組與設定介面。日常所說的「安裝 V2Ray」,實際上通常是安裝客戶端及其配套元件,而非直接編輯所有核心設定。
因此,介面上名稱相同的選項,內部實作不一定完全相同。某個客戶端可能把多項底層參數整合為一個開關,也可能只開放部分設定。排查問題時,應先記下客戶端名稱、使用的核心與執行模式,再查閱對應文件。混淆客戶端與核心,容易把介面操作問題誤判為協定問題。
V2Fly 社群持續維護 V2Ray 相關實作;Xray 則源自相關技術路線,之後獨立發展。兩者共用部分概念,但協定支援、傳輸擴充與設定需求會隨各自發展而變化。遇到 VLESS、VMess、Trojan 或 REALITY 等設定時,應逐項核對核心功能與伺服器端參數,而非只看客戶端是否顯示相應名稱。
分享連結通常只包含建立單一伺服器連線所需的資訊;完整 JSON 還可能包含入口、出站、路由與 DNS。兩者不能直接視為可互換的檔案。將完整設定遷移到另一個核心時,請檢查欄位意義、出站標記與規則資源;將連結匯入另一個客戶端時,也要確認擴充參數沒有遭到忽略。
v2rayN、v2rayNG 與 v2flyNG 均以開源方式發布,客戶端專案採用 GPL-3.0 授權;核心及隨附元件各有其授權,散布或修改時應分別查閱。開源代表程式碼可依授權條件閱讀、研究與修改,不代表每個發行版本都經過獨立稽核,也不能取代對訂閱來源和伺服器營運者的評估。
桌面端優先考慮 v2rayN,主要是因為伺服器管理、訂閱分組與路由設定都整合在桌面操作流程中。Android 端先看 v2rayNG;有明確的 V2Fly 相容需求時,再考慮 v2flyNG。選擇依據是平台與設定需求,不是沒有根據的效能排名。詳細差異請參閱客戶端選擇指南。
客戶端更新可能改變介面、設定產生方式或隨附核心。更新前記錄目前可用的伺服器設定、系統代理狀態與自訂規則,並備份設定;更新後先在原有網路環境測試基本連線,再檢查訂閱更新、DNS 與 TUN。不要在升級時一併重寫所有路由,否則很難判斷變化來自哪個環節。
維護狀態與實際相容範圍,請以專案發布說明和發行版本為準。本網站首頁僅提供穩定的選擇原則,安裝套件資訊集中在下載頁。若更新後設定選項的位置有所變動,先確認目前使用的客戶端與平台,再參考相應教學,避免照著舊截圖盲目尋找。
訂閱網址可能包含存取憑證,應視為敏感資訊妥善保管。截圖、記錄與求助內容中,不應公開完整訂閱網址、使用者識別資訊或伺服器驗證參數。說明問題時,可以保留協定類型、欄位名稱與錯誤訊息,並移除可識別帳戶的內容。匯出的伺服器清單檔案也可能包含相同資訊。
客戶端提供本機連線與管理功能,服務品質仍取決於網路環境和伺服器。更換應用程式無法修復失效的訂閱,也不會自動改變伺服器端限制。先確認設定來源有效、帳戶狀態正常,再檢查本機設定,可避免重複安裝和反覆匯入造成混亂。
從安裝套件部署、訂閱格式到伺服器選擇,依照實際問題閱讀。操作前先確認客戶端與平台,避免混用不同核心的設定片段。
在 Ubuntu、Debian、Fedora 等發行版上使用 deb 或 rpm 套件安裝 v2rayN,排除相依套件與系統匣圖示問題,並設定桌面自動啟動,讓程式在登入後自動執行。
閱讀桌面部署說明 →說明 Base64 訂閱、完整 JSON 設定與 vmess:// / vless:// 分享連結各自的結構,以及在 v2rayN 和 v2rayNG 中匯入、匯出與互相轉換的方法。
閱讀訂閱格式說明 →訂閱中的節點很多時,先測試實際連線延遲,再依流量倍率、地理位置與 VLESS/VMess/Trojan 協定差異挑選,為日常瀏覽、影音和遠端工作選擇合適的節點。
閱讀伺服器選擇說明 →