v2rayN
在桌面集中管理訂閱群組、目前使用的設定與路由規則。系統代理適合會遵循系統設定的應用程式;需要接管更多程式時,再了解 TUN 模式。初次使用建議先保留預設設定,確認單一連線可用後再逐項調整。
下載v2rayN先依裝置選擇介面,再按設定需求選擇核心。客戶端負責管理設定,核心負責處理連線。
在桌面集中管理訂閱群組、目前使用的設定與路由規則。系統代理適合會遵循系統設定的應用程式;需要接管更多程式時,再了解 TUN 模式。初次使用建議先保留預設設定,確認單一連線可用後再逐項調整。
下載v2rayNAndroid 裝置建議先了解採用 Xray 核心的 v2rayNG;若有 V2Fly 設定需求,可選擇 v2flyNG。透過訂閱群組管理設定,首次啟動連線時須確認系統 VPN 授權。介面相似,不代表協定與設定欄位完全相同。
查看 Android 下載分清不同層級的設定,排查時就能少動到無關選項。
訂閱網址是取得遠端設定清單的入口,不是可直接連線的伺服器網址。先新增群組、填寫備註與網址,再執行更新,才會看到可選設定。群組適合依來源或用途分類,備註只影響本機辨識。相較於逐筆手動輸入,訂閱方便同步伺服器參數,但更新也可能覆寫遠端管理的項目。若要自行修改,請先複製成獨立設定。訂閱網址中的權杖屬於存取憑證,分享截圖與記錄前應先遮蔽;更新失敗時,可先檢查網址是否完整、訂閱是否有效,以及連線路徑是否正常。
https://example.com/sub?token=xxxx
閱讀訂閱管理章節 →
路由決定已送進核心的請求要從哪個出口離開,不會讓應用程式自動使用代理。日常可先使用預設模式,再為少數網域新增例外。規則通常依序比對,特定網域應排在範圍較廣的分類之前,避免後續規則沒有機會生效。相較於讓所有流量都走同一出口,分流更適合兼顧本地服務與遠端存取。以下僅展示規則片段,直連出口標籤必須存在於完整設定中,地區分類也仰賴對應的規則資料。修改後請用目標應用程式驗證,不要只憑模式名稱判斷效果。
{
"type": "field",
"domain": ["geosite:cn", "domain:example.com"],
"outboundTag": "direct"
}
查看規則語法與優先順序 →
DNS 會將網域名稱轉換為 IP 位址,解析請求的路徑與實際連線路徑都需要一併考量。若網域無法開啟,但直接輸入 IP 位址卻正常,應先檢查解析結果,再確認路由。圖形客戶端的本機 DNS、遠端 DNS 與核心 DNS 不一定屬於同一層設定,不宜直接拼湊不同教學中的欄位。比起只更換公共 DNS,先確認解析請求如何送出,更有助於找出問題。以下是核心 DNS 物件的局部範例,並非完整設定;是否使用加密解析,以及如何避免循環依賴,應依目前的客戶端與網路環境決定。
{
"dns": {
"servers": ["https://dns.example.com/dns-query"],
"queryStrategy": "UseIPv4"
}
}
範例網域僅用於說明欄位,實際設定請填入可用且可信任的 DNS 服務。
閱讀 DNS 設定章節 →圖形客戶端與代理核心是兩個不同層級的軟體:前者儲存訂閱與操作偏好,後者讀取設定並建立連線。Xray 與 V2Fly 有部分共同技術背景,但協定擴充、傳輸支援與欄位意義並不完全相同。與其看到核心名稱就直接切換,不如先確認伺服器需求;設定涉及 REALITY 時,尤其要確認 Xray 支援狀況與參數是否相符。以下列出常見傳輸安全欄位所在層級,僅供局部參考。切換前請保留原設定,切換後查看啟動記錄;若欄位不相容,請改參照對應核心的設定說明。
{
"streamSettings": {
"network": "tcp",
"security": "reality"
}
}
比較 Xray 與 V2Fly 的差異 →
TUN 透過虛擬網路介面接收流量,可涵蓋部分不遵循系統代理設定的程式,但不代表所有請求都一定會經由代理出口。相較於系統代理,TUN 更仰賴裝置權限、網路路由與 DNS 的協同設定。建議先確認一般代理連線可正常使用,再啟用 TUN,避免同時排查伺服器連線與網路接管兩類問題。不同客戶端使用的接管元件不盡相同,不能將某種核心的欄位直接套用到另一種核心。以下是通用的路由排除概念片段,不是 TUN 開關設定;私有 IP 位址是否直連,仍須依區域網路與遠端內網需求判斷。
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
閱讀 TUN 模式章節 →
平台決定安裝套件格式,處理器架構則決定套件能否執行。請先在系統資訊中確認裝置類型,再前往下載頁選擇相應版本。首頁介紹如何選擇,不列出個別版本資訊;安裝需求與客戶端細節集中於下載頁,方便下載前一併確認。
選擇 v2rayN。桌面版採用跨平台介面,經典 WPF 版則適合已習慣原有操作方式的使用者。下載前請確認系統架構與執行需求;兩種介面的選單位置可能不同,跟著教學操作時應以功能名稱為準,而非只比對按鈕位置。
前往下載 Windows 客戶端 →選擇 v2rayN,並在「關於這台 Mac」中確認使用的是 Apple Silicon 還是 Intel 處理器。兩種晶片需要不同安裝套件。首次開啟時請留意系統權限提示;更換系統代理或啟用網路接管後,也應檢查原有網路設定是否被其他工具覆寫。
前往下載 macOS 客戶端 →優先選擇採用 Xray 核心的 v2rayNG;需要相容 V2Fly 設定時,再考慮 v2flyNG。主流裝置通常採用 arm64 架構;無法確認架構時,請參閱通用版說明。首次連線須授予 VPN 權限;若已有其他 VPN 連線,請先確認系統的連線限制。
前往下載 Android 客戶端 →選擇 v2rayN 圖形客戶端,依發行版的套件管理方式選擇 deb 或 rpm,再確認 x64 或 arm64 架構。桌面環境、權限管理與系統代理支援都會影響實際使用情況。啟動客戶端不代表所有終端機程式都會自動使用代理,請分別檢查各應用程式的設定。
前往下載 Linux 客戶端 →訂閱更新成功、選取設定,以及應用程式實際使用代理,是三種不同狀態。依照這個順序操作,可避免把「清單已經出現」誤當成「連線已經建立」。桌面端與 Android 端的選單名稱可能略有不同,主要流程相同。
從現有服務取得訂閱網址,在客戶端的訂閱群組設定中填入備註與完整網址,儲存後執行更新。請勿將單一分享連結誤填到訂閱網址欄,也不要複製多餘的空格、引號或換行。更新完成後,確認項目已歸入預期群組;若清單空白,請先檢查更新提示與訂閱是否有效,再嘗試重新匯入。
選取要使用的伺服器設定。桌面端先使用系統代理,並從符合需求的路由預設模式開始;Android 端則啟動連線並確認 VPN 授權。系統代理決定請求是否交由客戶端處理,路由規則決定請求進入後如何送出,兩者不能互相取代。初次連線先不要加入自訂 DNS、TUN 與複雜規則,方便保留清楚的排查基準。
開啟要存取的網站或應用程式,確認實際請求是否成功,再搭配客戶端記錄判斷連線過程。測試失敗不一定是伺服器問題,也可能是應用程式未使用系統代理、DNS 解析異常,或本機連接埠遭占用。先記下錯誤時間與訊息,每次只調整一項設定。確認連線正常後,再逐步新增分流例外,並保留一份可正常運作的設定備份。
從介面到連線
選單相似,不代表設定相同。協定支援情況應以所選核心與個別版本說明為準。
Project V 是一系列以網路代理為核心的開源技術與工具,V2Ray 是其中的重要組成部分。它將入站、出站、路由與傳輸等職責拆分,讓同一套核心功能能配合不同使用環境。對圖形客戶端使用者來說,不必一開始就撰寫完整設定;不過,理解這些層級有助於釐清許多狀況:介面能儲存設定,不代表核心一定接受所有欄位;核心能啟動,也不代表目標應用程式已將請求交給它。
V2Fly 社群延續 V2Ray 相關開發,Xray 則在共同技術背景下發展出自己的擴充方向。兩者在部分協定與設定上有所交集,但並非只要更換名稱就能互換。VLESS、傳輸安全與 REALITY 等主題,應依據各核心的實際支援情況理解。若遇到「同一份訂閱在兩個客戶端的表現不同」,先比對協定、傳輸、TLS 與核心記錄,比反覆更換介面主題或重裝軟體更能接近問題根源。
v2rayN、v2rayNG 與 v2flyNG 都是開源圖形客戶端,客戶端與核心的授權條款應分別查閱。開源授權規範程式碼使用、修改與散布的條件,不代表不同專案會採用相同的發行時程。本網站整理這三款客戶端的資料,不會將客戶端名稱當成訂閱服務名稱,也不會把圖形介面的功能清單視為所有核心都支援的功能。選擇時更值得留意的是裝置平台、設定相容性,以及是否有清楚的維護與發行紀錄。
客戶端程式、代理核心、地區規則資料與訂閱內容各有不同的更新來源。更新訂閱通常只會更新遠端提供的伺服器項目,不等於升級客戶端;升級客戶端也不保證規則資料已同步更新。調整前請備份自訂路由與獨立設定,更新後檢查啟動記錄與常用應用程式。若更新後立即出現異常,先記錄變更的項目並逐一還原,比一次更新所有元件更容易找出原因。下載頁集中提供安裝入口,教學與進階用法則說明各項設定之間的關係。
完成首次連線後,再依問題選擇進階主題。代理模式、伺服器逾時與旁路由部署屬於不同層級,不宜套用同一套排查步驟。以下筆記分別討論應用程式接管、連線過程與網路拓撲,可搭配進階用法中的設定章節閱讀。
依由近到遠的順序逐項排查節點逾時:系統時間、訂閱是否過期、本機連接埠占用、防火牆、傳輸與 TLS 參數,協助快速找出問題所在。
閱讀技術筆記 →說明系統代理開關與路由模式是兩回事,分別比較全域、繞過中國大陸、黑名單三種預設的流量走向與適用情境,並提供日常使用建議。
閱讀技術筆記 →介紹主路由與旁路由兩種部署拓撲,以及直接執行核心時的閘道設定、透明代理、DNS 接管等關鍵環節,並整理常見設定陷阱。
閱讀技術筆記 →不確定術語意思時,可先查閱概念速查;若已能重現連線問題,可直接前往連線排查章節。分享排查資料時,請保留錯誤類型、操作順序與發生時間,並遮蔽訂閱權杖、帳戶資訊及完整服務網址。