桌面版與經典 WPF 版
初次安裝可先試用桌面版,其介面支援跨平台;習慣傳統選單與視窗配置的使用者,則可選擇經典 WPF 版。兩者都須依使用的核心確認協定支援狀況,不能只看介面外觀判斷設定是否能正常運作。安裝前請在系統設定中確認裝置架構,並依下載頁說明選擇相應入口。
若已有設定,請先備份訂閱群組、自訂路由與 DNS 設定,再移轉至新的程式目錄。首次執行時只匯入一組可信的訂閱,選取設定後啟用系統代理,再用瀏覽器測試連線;暫時不要同時啟用 TUN,方便分別確認安裝問題與流量接管方式。
先確認作業系統、處理器架構與安裝格式,再選擇客戶端。桌面端可從 v2rayN 開始,Android 端建議先了解 v2rayNG;若需要 V2Fly 核心環境,再考慮 v2flyNG。下載頁集中說明安裝入口與系統需求,本頁不另行提供安裝檔。
初次安裝可先試用桌面版,其介面支援跨平台;習慣傳統選單與視窗配置的使用者,則可選擇經典 WPF 版。兩者都須依使用的核心確認協定支援狀況,不能只看介面外觀判斷設定是否能正常運作。安裝前請在系統設定中確認裝置架構,並依下載頁說明選擇相應入口。
若已有設定,請先備份訂閱群組、自訂路由與 DNS 設定,再移轉至新的程式目錄。首次執行時只匯入一組可信的訂閱,選取設定後啟用系統代理,再用瀏覽器測試連線;暫時不要同時啟用 TUN,方便分別確認安裝問題與流量接管方式。
在「關於這台 Mac」查看處理器資訊:Apple Silicon 選擇 arm64,Intel 選擇 x64。安裝檔格式相同,不代表處理器架構也相同;選錯可能無法啟動,或需要額外的相容環境。請先確認系統需求,再安裝應用程式並首次開啟,以免把系統權限提示誤認為訂閱問題。
桌面端的設定概念與 Windows 相近,但系統網路設定與權限的位置不同。啟用系統代理後,仍須確認目標應用程式是否會讀取系統代理;若某個程式仍直接連線,請先檢查該程式本身的設定。確實需要接管更多應用程式時,再查看 TUN 的權限、路由與還原方式。
v2rayNG 使用 Xray 核心,適合作為 Android 端的入門選擇;v2flyNG 使用 V2Fly 核心,適合有特定核心需求的情況。多數較新的手機採用 arm64,但仍應以裝置實際支援的架構為準;若不確定,可查看下載頁的通用版說明,不要只依手機的上市年份判斷。
匯入訂閱後首次連線時,系統會要求允許建立 VPN 連線;這與客戶端中的節點設定是兩回事。依應用程式設定代理可進一步限制哪些應用程式納入處理範圍。若背景連線容易中斷,請檢查電池最佳化與背景執行限制;不必一開始就調整所有省電選項。
先確認發行版使用的套件管理格式,再選擇 deb 或 rpm;同時確認架構是 x64 或 arm64。桌面圖形客戶端需要相應的圖形環境,不能與僅透過設定檔執行的伺服器程式混為一談。下載頁將常用格式列為主要入口,並另列 arm64 的對應選項。
安裝後,先在一般桌面工作階段完成訂閱匯入與基本連線測試。不同桌面環境讀取系統代理的方式可能不同,應用程式也可能有自己的代理設定。需要使用 TUN 時,再依發行版與客戶端說明處理權限;發生異常時,先儲存記錄並還原原本的網路設定,避免反覆疊加權限變更。
客戶端只提供設定與連線介面,不會自動建立可用的遠端服務。訂閱網址、分享連結與手動輸入的參數,都應來自可信且獲授權使用的來源。訂閱通常包含連線憑證,截圖、匯出設定或尋求協助時,請遮蔽完整網址、使用者識別資訊與相關金鑰。
查看所有客戶端 →同一組連線參數,在桌面與 Android 上的設定入口並不相同。先釐清流量如何進入客戶端,再決定套用哪一條規則。以下依設定目的說明;介面截圖僅供尋找選項,實際名稱請以安裝的客戶端版本為準。
系統代理會通知支援讀取系統設定的應用程式,將連線交給本機代理連接埠。在 v2rayN 中選擇自動設定系統代理後,通常可直接用瀏覽器測試;有獨立網路設定的程式仍須另外確認。這不代表所有流量都會進入客戶端,也不代表路由已切換為全域模式。相較於 Android 常見的 VPN 接管方式,系統代理適合先驗證桌面端的基本連線。結束使用或切換客戶端前,請清除系統代理,以免應用程式繼續使用已關閉的連接埠。
10808在 v2rayN 中選擇自動設定系統代理,再用瀏覽器測試;其他應用程式是否會使用代理,取決於各自的設定。使用完畢後可清除系統代理。
路由分流會決定已進入客戶端的連線要直連、走代理或封鎖,前提是流量已由客戶端接管。日常使用可從預設規則開始,再依需求選擇繞過中國大陸或全域模式;此處的全域通常指路由策略,不會自動擴大系統代理的接管範圍。v2rayN 和 v2rayNG 都有相應設定入口,但規則的組織方式不完全相同。修改前先記下原本模式,測試時一次只改一項;若網域與 IP 的比對結果不同,再檢查 DNS 和嗅探設定,不要不斷切換遠端設定。
IPIfNonMatch先選擇預設路由,再測試常用網站。全域是路由選項,不代表應用程式一定會走代理;發生異常時先還原原本模式,再繼續排查。
訂閱網址是取得一組連線設定的入口,不是可直接填入伺服器位址欄的主機名稱。v2rayN 可透過訂閱群組區分不同來源,v2rayNG 也有訂閱管理功能;先新增網址,再執行更新,最後選取實際要使用的設定。分組方便管理,但不會讓連線自動變快。更新失敗時,先確認網址是否完整且仍有效,再檢查目前網路能否連線至訂閱服務。手動修改的項目可能在更新時遭到覆蓋,長期保留的自訂內容應另行備份,並避免在公開討論區貼出完整訂閱網址。
新增可信的訂閱後執行更新,再選取要使用的設定。更新會重新取得遠端內容,自訂項目應與訂閱項目分開管理。
TUN 透過虛擬網路介面,讓更多應用程式的流量進入處理流程,適合不讀取系統代理的程式,但須配合權限、路由與 DNS 設定。桌面端先確認一般代理可正常運作,再依客戶端要求啟用 TUN;Android 端則須區分系統 VPN 接管與桌面端的 TUN 開關,操作方式不可直接照搬。相較於系統代理,TUN 通常會接管更多流量,排查時也要留意其他虛擬網卡與網路工具。啟用後若無法正常存取區域網路,請先停用並還原網路設定,再檢查排除規則,不要直接重新安裝客戶端。
確認基本連線正常後再啟用 TUN,並依系統要求設定權限。無法正常連線時,先停用 TUN,再檢查 DNS、路由與其他虛擬網路介面。
客戶端負責儲存設定、整理選單並啟動連線;核心則負責解析協定、執行路由與轉送資料。v2rayN 可管理多種核心,v2rayNG 與 v2flyNG 則分別以 Xray 和 V2Fly 為基礎打造 Android 操作介面。支援多種核心不代表所有協定與欄位都能互換:匯入包含 VLESS、REALITY 等參數的設定前,應先確認目標核心具備相應功能。切換時請保留原有設定,並查看啟動記錄中的具體錯誤;若欄位無法辨識,應確認設定與核心的相容性,而不是只修改介面顯示的名稱。
先確認設定所需的協定與安全機制,再選擇核心。介面能匯入設定,不代表啟動時一定支援所有欄位。
建議依序操作:「匯入訂閱 → 確認系統代理或 VPN 連線正常 → 選擇路由 → 視需要啟用進階流量接管」。完整流程請見設定教學;若想了解網域解析、規則優先順序與日常維護,請繼續閱讀完整手冊。
閱讀協定說明前,先區分專案、核心與圖形客戶端。三者解決的問題不同:專案構成技術生態系,核心提供連線功能,客戶端則將設定操作整合至桌面或手機介面。
V2Ray 是 Project V 生態系中的代理工具,V2Fly 延續 V2Ray 的社群維護;Xray 則從這個生態系發展出自己的實作與功能。閱讀教學時會看到這些名稱,但它們不是必須依序安裝的三套軟體。圖形客戶端使用者應著重確認目前設定最後交由哪個核心執行,以及該核心是否支援所需的協定、傳輸方式與安全選項。
VMess、VLESS 是代理協定名稱;REALITY 則是必須配合具體設定理解的安全機制,不能把它們與客戶端平台混為一談。看到訂閱包含某個名稱時,應檢查完整參數與相容需求,而不是只憑名稱猜測速度或穩定性。不同實作支援的欄位會隨維護進度而變動,舊教學中的預設值也未必適用於目前環境。
v2rayN、v2rayNG、v2flyNG 都是開源圖形客戶端,但支援的平台與核心組合各不相同。v2rayN 適用於桌面操作,方便管理訂閱群組、切換系統代理及編輯路由;v2rayNG 依 Android 系統的 VPN 連線與應用程式管理方式安排設定;v2flyNG 則提供另一種適合需要 V2Fly 核心的 Android 選擇。挑選時先確認平台與設定相容性,再考量個人使用習慣,不必因名稱相似而全部安裝。
圖形介面能減少手動編輯設定的工作,但無法取代遠端服務,也無法解決服務本身的可用性問題。訂閱成功匯入,只表示客戶端已讀取內容;核心成功啟動,表示本機設定已獲接受;目標網頁能正常開啟,才是完整連線流程驗證的一部分。將這幾個階段分開檢查,可避免誤以為「匯入成功就代表連線正常」。
開源表示相關程式碼依適用的授權條款公開,使用者可在條款允許的範圍內閱讀、使用與修改。客戶端、核心及隨附元件可能採用不同授權,不能把單一專案的授權說明套用至所有元件。若要重新散布或修改程式,應分別閱讀軟體隨附的授權文字,並保留要求的著作權與授權聲明;一般使用者也可透過這些資訊了解專案來源與維護方式。
由社群維護,不代表所有功能都會同步出現在不同客戶端。桌面介面的選項位置、Android 端的權限處理,以及核心對新欄位的支援情況,都可能各自變動。本頁依功能用途整理說明,不將特定按鈕位置視為固定標準;若介面不同,先對照「系統代理、路由、訂閱、DNS、TUN」等概念,再尋找目前版本中的相應選項。
客戶端更新、核心更新與訂閱更新是三種不同的維護方式。客戶端更新主要影響介面、整合方式與系統相容性;核心更新會影響協定實作與執行行為;訂閱更新則只會重新取得服務提供者的設定。每次只處理一種變更,並在更新後進行基本測試,較容易判斷問題出在哪一層。長期使用的自訂路由、DNS 與應用程式分流設定應另行記錄,避免移轉時遺漏。
日常檢查可從常用應用程式開始:確認客戶端仍在執行、目前設定可用,且系統代理或 VPN 狀態符合預期,再檢查路由與 DNS。記錄中的解析失敗、連線遭拒與交握錯誤,代表不同的處理階段,應依錯誤發生時間判斷。分享記錄前,請移除訂閱網址與連線憑證;進行速度測試時,也應了解測試目標與方法,不要把單次結果當成實際下載體驗的保證。
更完整的設定流程請見從入門到熟練的完整手冊;網域解析問題可直接閱讀DNS 設定章節,速度測試與更新方式則整理於日常維護章節。基本連線穩定後,再逐項嘗試嗅探、FakeDNS 或更細緻的路由規則,比一次啟用所有進階選項更容易維護。
教學依操作順序編排,文章則補充特定問題。剛完成安裝可先閱讀新手十問;已能連線但使用不穩定時,可依序檢查節點、線路與本機設定;比較協定時,應著重參數與安全機制,而不只是名稱。
整理新手最常遇到的十個問題,包括如何匯入訂閱、系統代理與 TUN 有何不同,以及連線後仍無法開啟網頁等,逐一簡要解答。先分清本機流量接管、路由選擇與遠端設定,再判斷該修改哪個步驟。
閱讀文章 →依序從節點負載、跨境線路品質、本機路由與 DNS 設定三個層面排查,找出速度變慢的環節。固定相同網路、測試目標與測試方式,避免在條件不斷變動時比較結果。
閱讀文章 →以一般使用者容易理解的方式,說明 VMess 與 VLESS 在加密方式、額外負擔、時間驗證與客戶端欄位上的差異。搭配傳輸層設定理解實際連線,避免把協定名稱當成效能排名。
閱讀文章 →