Windows
v2rayN / Desktop · WPF
下載頁提供桌面版與經典 WPF 版入口。桌面版採用跨平台介面,WPF 版則保留經典桌面操作方式。請依系統環境與使用習慣選擇,不必讓兩個用戶端同時使用同一組設定。安裝前請先關閉舊版程式,避免本機監聽連接埠被占用。
首次啟動後,先匯入設定並確認本機服務已啟動,再設定系統代理。如果瀏覽器仍使用自己的代理擴充功能或手動設定,請另外檢查其連線入口。變更監聽連接埠後,也要同步修改依賴該連接埠的應用程式設定。
前往下載 Windows 用戶端CLIENT SETTINGS / 用戶端設定
先釐清用戶端介面與代理核心各自負責的部分,再逐項設定。用戶端負責儲存伺服器資訊、更新訂閱並產生執行設定;核心負責接收連線、比對路由並轉送流量。以下五個入口依實際操作順序排列,畫面僅用來說明選單與設定之間的關係,不代表目前裝置的執行狀態。
更新完成後,請在伺服器清單中選取要使用的設定。
訂閱網址用於批次取得及更新伺服器設定;分享連結通常只包含一筆設定。v2rayN 可在訂閱群組設定中儲存網址,再執行更新;v2rayNG 則可從訂閱群組入口新增。匯入前請確認複製的是完整連結,而不是網頁標題或登入頁面的網址。首次更新建議先使用直連;只有訂閱服務明確要求透過代理連線時,再嘗試使用代理更新。網址可能包含存取憑證,請勿放在公開截圖中。匯入成功後仍須選取要使用的設定;清單中出現項目不代表已建立連線。
查看設定參考 →應用程式是否使用系統代理,取決於該應用程式本身的網路實作方式。
自動設定系統代理會將系統支援的代理入口指向本機用戶端,適合遵循該設定的瀏覽器等應用程式。清除系統代理可還原系統設定;不變更系統代理則會保留原有狀態。這三個選項控制流量如何進入用戶端;進入後要直連還是走代理,仍由路由規則決定。部分應用程式使用獨立的代理設定,需手動填入用戶端實際監聽的位址與連接埠。關閉用戶端前,請先確認系統代理是否已還原,避免系統仍指向已關閉的本機連接埠。請勿以系統代理開關作為伺服器連線成功與否的判斷依據。
查看設定參考 →{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}
路由分流會將不同目標交由不同出站處理。常見條件包括網域、目標位址、連接埠與入站標籤;規則通常由上而下檢查,第一條符合的規則會決定流量去向。範例會將指定網域集合交給 direct 出站處理,前提是設定中有同名出站,且相關規則資源可用。修改時,先新增一條範圍明確的規則,再查看記錄確認結果,不要一次調整整組規則。網域規則與位址規則的結果也可能受 DNS 策略影響,因此排查時應一併記錄存取目標與解析方式,不能只根據網頁是否開啟來判斷分流是否正確。
查看設定參考 →Xrayv2fly協定、傳輸方式與安全層必須彼此相符。
核心決定協定與傳輸功能的執行方式;圖形介面中的名稱相近,不代表設定可以完全互換。遇到不支援的欄位或功能時,應先確認伺服器所需的協定、安全層與傳輸組合,再核對用戶端核心支援狀況。v2rayN 提供相關核心設定,實際可選項目依安裝套件與介面而異;Android 裝置可依需求選用 Xray 核心的 v2rayNG,或 V2Fly 核心的 v2flyNG。切換前請保留可用設定,切換後重新啟動相關服務並查看啟動記錄。連線逾時不一定是核心造成的,反覆切換並非通用的修復方式。
查看設定參考 →是否可用取決於平台、執行權限及隨附元件。
TUN 模式透過虛擬網路介面接收流量,適合不遵循系統代理設定的應用程式,但需要額外設定權限、路由與 DNS。啟用前,請先用一般代理方式確認伺服器可用,再檢查系統授權,以及其他網路工具是否占用相同功能。v2rayN 的 TUN 功能取決於平台與隨附元件,不能直接照搬原始 V2Ray 入站設定。啟用後若網路異常,請先關閉 TUN、恢復原本狀態,再逐項檢查路由與解析設定。系統代理、TUN 與應用程式的獨立代理並非設定越多越好;重複接管可能讓問題更難排查。
查看設定參考 →準備好可用的伺服器設定或訂閱網址,匯入後選取一筆設定,再啟用合適的代理入口。先用瀏覽器連線至已知可存取的目標,並查看用戶端記錄是否出現相應連線。這個步驟只用來確認目前設定與目前應用程式是否正常,不必立刻啟用複雜路由、虛擬介面或自訂 DNS。基本連線正常後,再逐項新增其他設定;每次修改都應保留可還原的狀態。
測試結果也要分開解讀。伺服器項目存在,表示用戶端已接受其格式;連接埠測試有回應,表示某一層連線可能可達;實際網頁能夠開啟,才進一步涉及網域解析、傳輸交握與應用程式請求。不同測試測量的對象並不相同。結果不一致時,記錄測試方式與記錄內容,比只比較單一延遲數字更有幫助。
理解 JSON 時,可以依序查看入站、路由與出站。入站說明本機連線從何處進入;路由說明如何選擇處理路徑;出站則說明最後要轉送到哪裡。DNS 負責相關解析,策略項目則用來調整連線管理行為。教學中的連接埠與規則僅為語法範例,實際使用時應以用戶端設定為準,尤其不要假設所有用戶端都使用相同的預設連接埠。
圖形化用戶端可能在啟動時重新產生設定檔,因此直接修改產生的檔案未必能永久保留。請優先使用介面提供的自訂路由或設定入口,並在修改前匯出備份。若要核對欄位型別、陣列結構與標籤對應,請繼續閱讀V2Ray 設定檔參考;不熟悉入站、出站與傳輸等名稱時,可先查閱術語表。
DOWNLOAD / 平台與安裝套件
桌面平台可選擇 v2rayN,Android 可先參考 v2rayNG,也可依 V2Fly 設定需求了解 v2flyNG。先確認作業系統、處理器架構與安裝套件格式,再前往下載頁選擇適用檔案。用戶端與訂閱是兩回事:安裝用戶端不會自動取得伺服器設定;匯入訂閱也不能取代系統所需的安裝與授權步驟。
v2rayN / Desktop · WPF
下載頁提供桌面版與經典 WPF 版入口。桌面版採用跨平台介面,WPF 版則保留經典桌面操作方式。請依系統環境與使用習慣選擇,不必讓兩個用戶端同時使用同一組設定。安裝前請先關閉舊版程式,避免本機監聽連接埠被占用。
首次啟動後,先匯入設定並確認本機服務已啟動,再設定系統代理。如果瀏覽器仍使用自己的代理擴充功能或手動設定,請另外檢查其連線入口。變更監聽連接埠後,也要同步修改依賴該連接埠的應用程式設定。
前往下載 Windows 用戶端v2rayN / Apple Silicon · Intel
先在系統的「關於這台 Mac」中確認晶片類型,再選擇 Apple Silicon 或 Intel 安裝套件。架構選擇與伺服器協定無關,不能根據訂閱名稱判斷。依照安裝提示完成應用程式安裝,首次執行時請留意系統顯示的權限與安全性提示。
系統代理與 TUN 模式的授權範圍不同,建議先用一般代理確認連線。如果只有特定應用程式無法存取,請先確認該應用程式是否遵循系統代理,不要直接擴大為全裝置流量接管。下載頁整理了各種架構的下載入口,以及安裝前需要確認的事項。
前往下載 macOS 用戶端v2rayNG / v2flyNG
v2rayNG 使用 Xray 核心;v2flyNG 使用 V2Fly 核心,可依設定需求作為替代選擇。多數較新的裝置可先查看 arm64 安裝套件;若不確定架構,再了解通用套件。能否安裝仍取決於系統與應用程式需求,不宜只依裝置購買年份判斷。
匯入後選取設定並啟動連線;首次啟動通常需要確認系統的網路連線要求。背景省電限制可能影響持續執行,若裝置鎖定後連線中斷,請檢查應用程式的背景執行權限。訂閱網址與 QR Code 都可能包含存取憑證,分享操作截圖前請遮蔽相關內容。
前往下載 Android 用戶端v2rayN / deb · rpm
依發行版的套件管理系統選擇 deb 或 rpm,再確認裝置使用 x64 或 arm64 架構。套件格式與處理器架構是兩項獨立條件,下載檔案不代表能在目前環境中安裝。桌面環境與相關執行相依項目也必須符合用戶端需求。
不同桌面環境支援系統代理的方式可能不同,終端機程式也未必會讀取桌面代理設定。測試時應分別確認瀏覽器與命令列連線使用的代理入口。先確保圖形化用戶端與本機監聽正常,再考慮虛擬介面權限和系統路由設定。
前往下載 Linux 用戶端若裝置已安裝用戶端,更新前請先儲存訂閱群組、自訂規則與必要的應用程式設定。未確認設定相容性前,不要覆寫唯一可用的環境。安裝套件處理的是程式部署問題;連線問題仍應依序檢查設定、代理入口、路由與記錄。
查看所有用戶端 →PROJECT V / 核心與圖形化用戶端
V2Ray 既是常見的搜尋關鍵字,也與 Project V 生態系中的特定軟體及設定架構相關。日常操作主要在圖形化用戶端中進行,實際轉送流量則由所使用的核心負責。了解兩者的關係,才能判斷教學、JSON 設定與目前安裝的用戶端是否適用。
Project V
V2Fly / Xray
v2rayN / v2rayNG / v2flyNG
Project V 以模組化網路代理功能為基礎,V2Ray 設定涵蓋入站、出站、路由、DNS 與連線策略等部分。模組化表示同一種本機入口可以搭配不同出站,也表示單一協定名稱不足以描述完整連線。閱讀設定時,必須同時查看驗證資訊、傳輸方式與安全層,而不只是確認某個名稱是否相同。
V2Fly 社群延續 V2Ray 相關實作與維護;Xray 則以相關技術為基礎,發展成獨立演進的核心專案。兩者共用部分概念與設定慣例,但功能、欄位與更新時程並不完全相同。在另一個核心中使用原本可運作的設定時,仍須確認支援狀況,尤其要留意特定傳輸方式與安全機制的欄位。
v2rayN、v2rayNG 與 v2flyNG 都是開源圖形化用戶端專案。開源讓實作方式、修改紀錄與授權條款得以公開討論,但不代表任何第三方設定都適合直接匯入。用戶端主要提供設定管理、呼叫核心與顯示記錄等便利功能;伺服器參數是否有效、訂閱內容是否可信,仍須依來源判斷。
桌面版 v2rayN 方便集中管理訂閱、系統代理與路由。Android 版 v2rayNG 與 v2flyNG 則依行動作業系統的連線授權及背景執行需求設計介面。三者並非同一程式的不同名稱,選單與設定也不一定完全相同。選擇時先考量裝置與設定需求,再閱讀相應的用戶端教學,避免直接把桌面選單套用到行動裝置。
開源授權規定程式碼使用、修改與散布的條件,並不等同於訂閱服務的使用條款。核心、圖形化用戶端與隨附相依元件可能採用不同授權,應以各專案隨附說明為準。V2Ray 相關核心實作採用的 MIT 授權,以及 Xray-core 採用的 MPL 2.0,分別說明各自程式碼的授權規則,不能據此推斷所有元件都使用相同授權。
網站名稱不等同於專案身分。本頁是用戶端與設定的中文閱讀入口,介紹 Project V、V2Fly 與 Xray 的技術關係,不會將教學網站與核心專案混為一談。判斷某項功能是否存在,應以已安裝用戶端的介面、隨附說明與實際執行記錄為準,而非只看搜尋結果中的產品簡稱。
用戶端更新、核心更新、訂閱更新與路由資源更新,分別處理不同問題。更新用戶端可能變更介面或設定產生邏輯;更新訂閱會重新取得伺服器項目;更新路由資源則會影響網域或位址集合的比對。更新訂閱通常不會替換用戶端程式,安裝新版用戶端也不代表訂閱中的伺服器參數會自動修復。
發生問題時,先記下最近的變更,再檢查記錄。設定解析失敗,優先檢查欄位、格式與核心相容性;本機連接埠遭占用,優先檢查是否有重複執行的程式;交握失敗則核對時間、目標位址與安全層參數。公開記錄前,請移除訂閱網址、使用者識別資訊與驗證內容。分層排查比同時重新安裝、切換核心與重寫路由更能保留線索。
READING NOTES / 設定專題
建立基本連線後,再依實際問題補充相關知識。匯入失敗可先閱讀格式說明;選擇設定可參考協定比較;連線異常則從執行記錄著手。各篇專題分別處理一項問題,方便與設定參考中的欄位說明交叉查閱。
分別示範桌面版與 Android 版新增、更新訂閱的選單位置,並說明 Base64 訂閱、vmess:// 與 vless:// 分享連結的結構,以及匯入失敗的常見原因。
閱讀訂閱匯入說明 →比較四種代理協定的驗證方式、加密層、傳輸組合與用戶端支援狀況,並依桌面日常使用、行動裝置省電、自架服務等情境提供選擇參考。
閱讀協定比較 →說明記錄層級設定與記錄結構,逐一解析連線逾時、連接埠占用、設定解析失敗、TLS 交握錯誤等常見訊息的意義與排查步驟。
閱讀記錄排查方法 →