桌面與 Android · 客戶端設定筆記

V2Ray 客戶端
v2rayN 下載與設定

依平台整理 開源客戶端,從訂閱匯入到路由分流,對照桌面與 Android 的設定位置逐項操作。

中文設定說明 Xray · V2Fly 生態系
協定與安全機制
  • VMess
  • VLESS
  • Trojan
  • REALITY
核心生態系
  • Xray
  • V2Fly

依平台選擇客戶端

先確認作業系統、處理器架構與安裝格式,再選擇客戶端。桌面端可從 v2rayN 開始,Android 端建議先了解 v2rayNG;若需要 V2Fly 核心環境,再考慮 v2flyNG。下載頁集中說明安裝入口與系統需求,本頁不另行提供安裝檔。

Windows v2rayN · 優先推薦

桌面版與經典 WPF 版

初次安裝可先試用桌面版,其介面支援跨平台;習慣傳統選單與視窗配置的使用者,則可選擇經典 WPF 版。兩者都須依使用的核心確認協定支援狀況,不能只看介面外觀判斷設定是否能正常運作。安裝前請在系統設定中確認裝置架構,並依下載頁說明選擇相應入口。

若已有設定,請先備份訂閱群組、自訂路由與 DNS 設定,再移轉至新的程式目錄。首次執行時只匯入一組可信的訂閱,選取設定後啟用系統代理,再用瀏覽器測試連線;暫時不要同時啟用 TUN,方便分別確認安裝問題與流量接管方式。

macOS v2rayN

依處理器選擇安裝入口

在「關於這台 Mac」查看處理器資訊:Apple Silicon 選擇 arm64,Intel 選擇 x64。安裝檔格式相同,不代表處理器架構也相同;選錯可能無法啟動,或需要額外的相容環境。請先確認系統需求,再安裝應用程式並首次開啟,以免把系統權限提示誤認為訂閱問題。

桌面端的設定概念與 Windows 相近,但系統網路設定與權限的位置不同。啟用系統代理後,仍須確認目標應用程式是否會讀取系統代理;若某個程式仍直接連線,請先檢查該程式本身的設定。確實需要接管更多應用程式時,再查看 TUN 的權限、路由與還原方式。

Android v2rayNG · 優先推薦

v2rayNG 與 v2flyNG

v2rayNG 使用 Xray 核心,適合作為 Android 端的入門選擇;v2flyNG 使用 V2Fly 核心,適合有特定核心需求的情況。多數較新的手機採用 arm64,但仍應以裝置實際支援的架構為準;若不確定,可查看下載頁的通用版說明,不要只依手機的上市年份判斷。

匯入訂閱後首次連線時,系統會要求允許建立 VPN 連線;這與客戶端中的節點設定是兩回事。依應用程式設定代理可進一步限制哪些應用程式納入處理範圍。若背景連線容易中斷,請檢查電池最佳化與背景執行限制;不必一開始就調整所有省電選項。

Linux v2rayN

依發行版選擇 deb 或 rpm

先確認發行版使用的套件管理格式,再選擇 deb 或 rpm;同時確認架構是 x64 或 arm64。桌面圖形客戶端需要相應的圖形環境,不能與僅透過設定檔執行的伺服器程式混為一談。下載頁將常用格式列為主要入口,並另列 arm64 的對應選項。

安裝後,先在一般桌面工作階段完成訂閱匯入與基本連線測試。不同桌面環境讀取系統代理的方式可能不同,應用程式也可能有自己的代理設定。需要使用 TUN 時,再依發行版與客戶端說明處理權限;發生異常時,先儲存記錄並還原原本的網路設定,避免反覆疊加權限變更。

客戶端只提供設定與連線介面,不會自動建立可用的遠端服務。訂閱網址、分享連結與手動輸入的參數,都應來自可信且獲授權使用的來源。訂閱通常包含連線憑證,截圖、匯出設定或尋求協助時,請遮蔽完整網址、使用者識別資訊與相關金鑰。

查看所有客戶端 →

系統代理、分流與訂閱設定

同一組連線參數,在桌面與 Android 上的設定入口並不相同。先釐清流量如何進入客戶端,再決定套用哪一條規則。以下依設定目的說明;介面截圖僅供尋找選項,實際名稱請以安裝的客戶端版本為準。

系統代理的接管範圍

系統代理會通知支援讀取系統設定的應用程式,將連線交給本機代理連接埠。在 v2rayN 中選擇自動設定系統代理後,通常可直接用瀏覽器測試;有獨立網路設定的程式仍須另外確認。這不代表所有流量都會進入客戶端,也不代表路由已切換為全域模式。相較於 Android 常見的 VPN 接管方式,系統代理適合先驗證桌面端的基本連線。結束使用或切換客戶端前,請清除系統代理,以免應用程式繼續使用已關閉的連接埠。

v2rayN · 系統代理

自動設定系統代理清除系統代理
本機監聽連接埠10808

建議依序操作:「匯入訂閱 → 確認系統代理或 VPN 連線正常 → 選擇路由 → 視需要啟用進階流量接管」。完整流程請見設定教學;若想了解網域解析、規則優先順序與日常維護,請繼續閱讀完整手冊。

Project V、V2Fly 與 Xray

閱讀協定說明前,先區分專案、核心與圖形客戶端。三者解決的問題不同:專案構成技術生態系,核心提供連線功能,客戶端則將設定操作整合至桌面或手機介面。

生態系關係:不是三個安裝步驟

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 或更細緻的路由規則,比一次啟用所有進階選項更容易維護。

V2Ray 設定與疑難排解文章

教學依操作順序編排,文章則補充特定問題。剛完成安裝可先閱讀新手十問;已能連線但使用不穩定時,可依序檢查節點、線路與本機設定;比較協定時,應著重參數與安全機制,而不只是名稱。