Windows
v2rayN · 桌面首選
如果想透過中文圖形介面管理訂閱、切換節點及設定分流,可以先選 v2rayN。下載頁提供桌面版與經典 WPF 版:前者採用跨平台介面,後者保留傳統桌面操作方式。選擇時請考量系統需求與使用習慣,不必因介面不同而同時安裝兩個版本。
安裝後先新增訂閱,確認節點清單能正常更新,再啟用系統代理。如果目標應用程式不遵循系統代理設定,再考慮使用 TUN;一開始不必開啟所有選項。
前往下載v2rayN / v2rayNG / v2flyNG 白話教學
從匯入訂閱到系統代理,透過實際選單說明設定;桌面裝置選 v2rayN,Android 裝置可先看 v2rayNG。
上方為設定示意,點選卡片查看操作說明;選單名稱可能隨介面調整。第一次使用,請先從匯入訂閱開始。
依作業系統選擇
先確認作業系統,再查看處理器架構。安裝套件決定程式能否執行,節點參數則決定連線是否相容,兩者需要分別確認。以下入口會開啟對應平台的下載選項。
v2rayN · 桌面首選
如果想透過中文圖形介面管理訂閱、切換節點及設定分流,可以先選 v2rayN。下載頁提供桌面版與經典 WPF 版:前者採用跨平台介面,後者保留傳統桌面操作方式。選擇時請考量系統需求與使用習慣,不必因介面不同而同時安裝兩個版本。
安裝後先新增訂閱,確認節點清單能正常更新,再啟用系統代理。如果目標應用程式不遵循系統代理設定,再考慮使用 TUN;一開始不必開啟所有選項。
前往下載v2rayN · 依晶片選擇
先在系統選單中開啟「關於這台 Mac」,確認裝置使用 Apple Silicon 還是 Intel 處理器,再選擇相應的安裝套件。兩種架構的檔案適用於不同硬體,不能只看檔案大小決定,也不必因教學截圖中的介面不同而更換核心。
首次執行若出現系統安全性提示,請先確認下載來源,再前往「系統設定 → 隱私權與安全性」查看原因。系統代理會影響遵循系統設定的應用程式;TUN 則需要額外權限,建議基本連線成功後再進行設定。
前往下載優先選 v2rayNG · v2flyNG 為替代選項
一般可先選用 Xray 核心的 v2rayNG;若現有設定明確依賴 V2Fly,再考慮 v2flyNG。多數較新的裝置可選 arm64,不確定架構時請查看裝置資訊或選擇通用套件。通用套件支援更多架構,但不代表連線能力更強。
在「訂閱群組設定」儲存訂閱網址後,還需要執行更新訂閱。首次啟動連線時,系統會要求授權建立 VPN 連線;若同時執行其他占用這個通道的工具,可能會發生衝突,請先停用其中一個。
前往下載v2rayN · 圖形桌面環境
依發行版的套件管理系統選擇 deb 或 rpm,再確認裝置採用 x64 還是 arm64。副檔名對應安裝方式,處理器架構則對應執行環境,兩項都必須符合。這裡介紹的是圖形介面用戶端,適合在桌面環境中管理訂閱與規則。
安裝完成後,先確認程式能否啟動、核心能否執行,再檢查桌面環境的代理設定。不同應用程式對系統代理的支援程度不一;終端機程式未使用代理時,應先檢查該程式的代理設定,而不是反覆匯入同一份訂閱。
前往下載訂閱網址需要自行準備。用戶端負責讀取設定並轉送請求,安裝完成後不會自動產生可用的伺服器。
查看所有用戶端 →設定項目 → 白話說明
設定名稱相似,不代表用途相同。系統代理負責告訴應用程式「入口在哪裡」,路由決定「請求要送往哪裡」,DNS 則負責「網域名稱如何找到位址」。先釐清這些關係,排查時才知道該開啟哪個選單。
可以把 TUN 想成在系統中新增一個虛擬網路入口,讓更多不讀取系統代理設定的應用程式也能交由用戶端處理。它解決的是「請求有沒有進入用戶端」,而不是「節點能不能連線」。建議先使用系統代理確認訂閱與節點可用,再啟用 TUN,並依提示授予權限。如果同時執行其他虛擬網卡或 VPN 工具,路由可能互相影響。各桌面平台的授權方式有所不同,啟用後還要檢查 DNS 與分流結果,不能只看開關是否亮起。
v2rayN 主畫面 → 啟用 Tun
先確認節點可用,再檢查權限與路由。
系統代理就像在系統設定中留下一張地址卡,告訴願意讀取設定的應用程式將請求交給用戶端。這不代表所有程式都會使用代理,也不會決定請求最後是直連還是經由代理出口。在 v2rayN 中選擇「自動設定系統代理」後,可用瀏覽器測試;使用完畢請選擇「清除系統代理」。如果用戶端已關閉,但瀏覽器仍顯示代理連線失敗,請先檢查是否留下舊的入口設定。系統代理與 TUN 的主要差異在於接管方式,不是連線品質的高低之分。
系統代理 → 自動設定系統代理
停止使用 → 清除系統代理
路由是將請求分類:哪些直連、哪些交由代理、哪些需要攔截。規則通常依序比對,因此前面較寬泛的條件可能會涵蓋後面更精確的條件。初次使用可先選擇內建預設,確認運作正常後再新增網域規則。網域策略會控制核心比對時是否需要解析位址,不是「所有請求都走代理」的開關。下方僅展示一個路由欄位,並非完整設定;不同核心支援的欄位可能不同,不應直接用網路上的整段設定覆蓋現有用戶端設定。
"routing": {
"domainStrategy": "IPIfNonMatch"
}
訂閱網址是取得節點清單的入口,訂閱群組則用來記錄來源與更新設定。儲存網址不代表已取得節點,通常還需要手動更新一次。自動更新只是定期重新取得清單,不會延長訂閱期限,也無法修復服務端失效的連結。建議為群組取容易辨認的名稱,先確認手動更新成功,再設定自動更新。更新後若清單為空,請查看記錄中的網路、憑證或解析提示;不要將含有存取憑證的訂閱網址貼到公開討論區。
v2rayNG → 訂閱群組設定 → 新增並儲存
返回主畫面 → 更新訂閱
Mux 會嘗試讓多個邏輯請求共用較少的底層連線,主要影響連線的組織方式,不是通用的加速按鈕。效果取決於傳輸協定、伺服器支援與實際網路狀況,有些組合不需要額外啟用。日常使用時先保留用戶端預設值;只有明確知道設定需求,或正在進行單一變數比較時才修改。遇到連線不穩,請先還原預設值並檢查記錄,而不是持續增加並行數。下方展示的是關閉狀態的欄位片段,僅供理解用途,實際生效位置取決於使用的核心。
"mux": {
"enabled": false
}
DNS 負責將網站網域名稱轉換成可連線的位址,但查詢本身也有出口與路由。節點連線成功但網站無法開啟,可能是解析失敗,不一定代表節點失效。設定時要區分直連請求與代理請求的解析方式,也要考量解析伺服器本身是否能連線。先保留用戶端可用的預設設定,再依明確需求調整遠端 DNS、查詢路由與網域策略。啟用 TUN 也不代表所有 DNS 都已依預期轉送,仍須搭配系統設定、應用程式行為與實際測試確認。
v2rayN → 設定 → DNS 設定
分別檢查解析伺服器與查詢路由。
第一次設定時,先完成「匯入訂閱 → 更新節點 → 選擇節點 → 啟動連線 → 確認能否連線」這條最短流程。每次只調整一項設定,並記錄調整前後的結果。如果同時更換節點、啟用 TUN、更換 DNS 又修改路由,即使問題消失,也很難判斷是哪項設定真正有效;下次出錯時一樣無從判斷。
確認連線時,不只要查看用戶端,也要測試實際使用的應用程式。啟動按鈕顯示正在執行,只能代表程式已開始運作;測試結果正常,也不代表每個網域都符合預期規則。可以先確認一般網站能否開啟,再測試需要經由指定出口的目標,最後查看記錄中的路由結果。完整操作請見入門指南;各平台的權限與安裝問題請見安裝問題大全。
下載用戶端後還需要什麼?還需要有效的節點參數或訂閱網址。用戶端就像控制台,負責儲存設定、啟動核心並顯示狀態;伺服器位址、連接埠與驗證資訊則由所使用的服務提供。只有用戶端而沒有設定,無法建立相應的代理連線。
全域模式和 TUN 是同一回事嗎?不是。全域模式通常描述請求進入用戶端後如何選擇出口,TUN 則描述請求如何被接管。即使啟用 TUN,路由仍可能讓部分請求直連;即使選擇全域模式,未進入用戶端的應用程式請求也不會因此自動被接管。
更新訂閱會覆蓋手動修改嗎?訂閱節點可能在更新時重新建立或取代,因此不適合將臨時修改當成長期儲存方式。需要保留的設定請先另外備份,並確認它是否屬於訂閱群組。更多概念可在術語表逐項查閱,不必在初次使用時記住所有縮寫。
用戶端 / 核心 / 協定
這些名稱所指的層次各不相同。用戶端提供操作介面,核心負責執行網路連線,協定則規範通訊方式;了解三者的關係,比只記住一個下載名稱更有幫助。
Project V 是了解 V2Ray 背景的起點之一,核心概念是將代理連線、路由與傳輸能力組織成可設定的模組。日常討論中的「V2Ray」有時指特定核心,有時泛指採用相關協定的工具集合,因此搜尋相同名稱,找到的下載項目卻可能完全不同。本指南將下載入口明確分為圖形介面用戶端,避免混淆背景執行程式與可直接操作的應用程式。
V2Fly 延續 V2Ray 相關實作與社群維護工作;Xray 則以相關技術為基礎,發展出自己的實作與功能。兩者有共同的技術背景,但設定欄位、功能進度與協定擴充不一定始終一致。閱讀教學時,應同時確認適用的用戶端與核心;選單看起來相似,只代表介面接近,不能證明底層行為完全相同。
v2rayN 是面向桌面裝置的開源圖形介面用戶端,負責管理訂閱、選擇節點、產生參數並啟動核心。它可以搭配不同核心使用,實際支援範圍取決於用戶端整合方式與所選核心。桌面版與經典 WPF 版的差異,主要在介面技術與平台支援,不應簡單認為「新版介面就能讓同一個節點更快」。
v2rayNG 是採用 Xray 核心的開源 Android 用戶端,v2flyNG 則是採用 V2Fly 核心的開源替代選項。兩者的操作方式有不少相似之處,但選擇時應考量節點需求與功能相容性。現有設定若包含特定擴充參數,請先確認核心是否支援,再決定使用哪個用戶端。想比較兩者差異,可閱讀用戶端比較,不必因名稱相似而反覆移轉訂閱。
開源表示原始碼依照相應授權提供,使用者可以在授權範圍內閱讀、使用、修改或散布。不同用戶端、核心及其相依項目可能採用不同授權,詳細條件請以各專案附帶的授權文字為準。程式碼可供檢視,有助於技術審查與社群協作;使用者仍應留意安裝來源、系統權限、設定內容,以及服務端如何處理請求。
用戶端軟體與訂閱服務也是兩回事。開源用戶端可以免費使用,但訂閱是否收費、效期如何計算、節點是否可用,取決於服務提供者。本指南提供下載入口與設定說明,不販售節點,也不代替服務提供者管理帳號。訂閱失效時,請先檢查網址與服務狀態;反覆重新安裝用戶端通常無法解決服務端問題。
「更新」至少可能指三種操作:升級用戶端程式、更新用來建立連線的核心,以及重新整理訂閱中的節點清單。此外,路由可能會用到 GeoIP、GeoSite 等規則資料,這些資料也有各自的更新流程。更新訂閱不會自動升級應用程式,升級應用程式也不會自動修復過期的訂閱網址。先確認要更新的項目,才不會在錯誤的選單中操作。
準備調整環境前,請先備份群組、路由與手動新增的節點,並保留目前仍可運作的設定。更新後逐項確認訂閱、預設節點與代理模式;若出現異常,查看記錄中的具體錯誤,再判斷是參數不相容還是權限變更。排查時不要連續覆寫所有設定。頁面中的選單路徑用於協助找到功能;若實際介面已有調整,請以目前用戶端中相應功能的名稱與說明為準。
訂閱連結可能含有存取憑證,記錄中也可能出現伺服器位址。尋求協助時,請先隱藏這些資訊,只保留錯誤類型、相關設定與重現步驟;並遵守所在地法律及所使用網路的管理規定。
繼續了解協定與核心術語 →設定主題
完成基本連線後,可依實際問題深入了解:DNS 查詢會經過哪條路徑、桌面版該選哪一種,以及訂閱為何無法取得。每篇文章聚焦一項設定,方便對照用戶端操作。
了解 DNS 查詢為何可能繞過代理,再檢查遠端 DNS、TUN 接管與網域解析策略。透過實際檢測結果確認設定,不要只看開關狀態。
閱讀設定說明 →從平台支援、執行需求與操作介面了解兩種桌面版本。切換前先確認設定移轉範圍,再依裝置環境與使用習慣決定。
查看介面與版本選擇差異 →區分請求逾時、連結失效、憑證錯誤與解析結果為空,搭配記錄找出更新失敗的環節,再考慮自動重新整理與透過代理更新。
依錯誤類型排查 →