開源用戶端與設定指南

V2Fly官網v2rayN 用戶端

依作業系統選擇開源用戶端,先匯入訂閱,再設定路由分流並測試連線。

協定
  • VMess
  • VLESS
  • Trojan
  • Shadowsocks

依裝置選擇安裝套件

桌上型電腦建議使用 v2rayN,手機和平板則可選擇 v2rayNG 或 v2flyNG。先確認作業系統,再核對處理器架構;同一款用戶端在不同系統上的安裝方式可能不同。換裝置時,保留原訂閱網址即可重新匯入,不必照搬舊裝置的連接埠、代理模式和規則。

Windows

安裝 v2rayN 時,可選擇桌面版或經典 WPF 版。桌面版採用跨平台介面;依照舊教學尋找選單時,先確認截圖使用的是哪種介面,再找訂閱分組和系統代理的設定入口。

從可攜式目錄搬移前,請先結束正在執行的程式、備份設定,並記下原本的本機監聽連接埠。若新舊版本同時執行,第二個程式可能無法綁定相同連接埠;切換版本前請先排除這類衝突。

前往下載

macOS

開啟「關於這台 Mac」確認晶片,再選擇適用的 v2rayN 安裝套件:顯示 Apple 晶片就選 Apple Silicon,顯示 Intel 處理器就選 Intel。安裝後請從「應用程式」資料夾啟動,避免一直在磁碟映像檔中執行。

若瀏覽器沒有使用用戶端連線,請檢查目前網路服務的代理設定,以及瀏覽器是否另有代理設定。結束用戶端後若網路存取異常,先還原原本的網路設定,再重新開啟同一個網頁測試。

前往下載

Android

建議先查看採用 Xray 核心的 v2rayNG;若設定明確要求使用 v2fly 核心,再選擇 v2flyNG。近年多數手機適用 arm64 套件;不確定裝置架構時,可查看通用套件和系統需求。

首次連線時,請留意系統跳出的 VPN 授權提示。同一個使用者環境中,既有的 VPN App 可能會與新連線互相切換。若只是鎖定螢幕後斷線,先檢查背景執行和電池最佳化設定,再判斷是否需要更換設定。

前往下載

Linux

依 Linux 發行版選擇 v2rayN 套件格式。Debian、Ubuntu 通常選 deb,Fedora 等系統通常選 rpm。套件格式和處理器架構需分別確認:相同格式也可能提供 x64 與 arm64 兩種版本。

安裝完成不代表所有應用程式都會使用桌面代理。圖形介面程式和從終端機啟動的工具可能各有設定;若只有單一程式無法連線,先檢查該程式的代理設定,不必一開始就重裝用戶端。

前往下載

v2rayN 設定項目

訂閱負責更新設定清單,路由決定請求的連線路徑,系統代理和 TUN 則決定哪些請求會進入用戶端。分開檢查這幾項,比一次修改多個設定更容易找出問題。

為每個訂閱來源建立獨立分組,並使用容易辨識來源的別名。貼上網址後,先手動更新目前分組,確認清單確實匯入,再決定是否啟用定期更新。比起逐一匯入連結,分組更新更容易確認是哪個來源有變動;但更新成功只代表用戶端讀取到設定,不代表清單中的每個項目都能連線。若清單是空的,先確認目前選取的分組,再檢查訂閱網址是否過期,以及回傳內容能否由用戶端辨識。分享截圖時,請遮住完整網址。

Project V、核心與用戶端

設定說明常把用戶端、核心和協定簡稱為 V2Ray。排查時請分清這三個層次:介面負責管理設定,核心負責解析設定並建立連線,協定則定義通訊雙方如何交換資料。先找出問題所在的層次,再決定要修改什麼。

比較三款用戶端 →

Project V 與 V2Fly

Project V 是認識這個生態系的起點,V2Ray 是其中負責處理代理連線和路由的核心程式。V2Fly 社群持續維護相關核心與文件,桌面和行動圖形介面用戶端則由各自專案維護。閱讀核心相關說明時,不必在圖形介面中逐字尋找同名欄位:同一項設定可能在用戶端的訂閱、路由或傳輸設定中,也可能沒有獨立的操作項目。

判斷文件是否適用,先確認內容描述的是圖形介面還是核心設定,再確認作業系統和核心系列是否相符。例如,核心文件提到的入站連接埠,是用戶端在本機接收請求的入口,不是訂閱設定中遠端伺服器的連接埠。兩者填錯都可能導致網頁無法開啟,但記錄的位置不同。前者應先檢查本機監聽,後者則應回頭核對連線參數。

V2Fly 與 Xray 的相容性界線

Xray 源自 V2Ray 生態系,之後依自己的方向持續維護。兩種核心支援部分相同的協定與設定概念,也各自實作不同的傳輸和安全功能。只看設定名稱無法判斷相容性:即使使用相同協定,兩份設定仍可能採用不同傳輸方式,或需要不同的安全層欄位。請優先保留訂閱提供的原始參數,依提供者註明的組合選擇核心,不要混用其他連線的參數。

更換核心後若應用程式仍未開始連線,請先檢查啟動記錄中最早出現的異常。欄位無法辨識通常是相容性問題;本機位址無法綁定,則應先檢查連接埠是否被占用。確認核心正常啟動且請求確實經過核心後,再繼續排查遠端連線和交握問題。這樣可避免把不同階段的故障都歸咎於訂閱失效。

協定名稱與實際連線條件

開源用戶端和核心讓設定欄位及協定實作都能公開檢視。VMess、VLESS、Trojan 和 Shadowsocks 是協定名稱,不是可以在任意設定中互換的選項。能否連線,取決於通訊兩端使用的協定、傳輸方式和必要安全參數是否一致。尤其不要把 VLESS 當成加密方式;實際使用的安全層仍須依具體設定判斷。

首次連線時,先使用設定提供者給的原始組合作為基準。若出現交握錯誤,請先確認位址、連接埠、傳輸方式和安全參數,再檢查裝置時間。切換協定需要對端也提供相應設定;只在用戶端單方面改選項,無法將原連線轉換成另一種協定。想了解哪些組合適合現有裝置,先比較核心支援範圍,再考量網路與裝置條件。

三款開源用戶端各有分工

v2rayN 將桌面端的訂閱、路由和代理設定集中在圖形介面。v2rayNG 是以 Xray 為主的行動用戶端,透過系統 VPN 介面接入流量;v2flyNG 則為明確使用 v2fly 核心的設定提供另一個開源圖形介面入口。選擇用戶端時,先確認裝置支援哪一款,再查看現有設定對核心的要求,不必因圖示或名稱相似而安裝多款。

在不同裝置上使用同一份訂閱時,建議重新匯入,再依平台檢查流量接入方式。桌面端的系統代理設定不會隨訂閱轉移到手機,手機上的 VPN 授權和個別 App 設定也不會帶到桌面端。若只有其中一台裝置能連線,先在兩邊選取相同設定,並比對目前的核心和網路環境;別只因分組名稱相同,就認定兩邊使用的是同一條連線。

用戶端、核心與訂閱各自更新

介面版本更新、核心更新和訂閱重新整理是三件不同的事。介面更新可能改變選單位置或安裝需求;核心更新可能影響可辨識的欄位;重新整理訂閱則會從原網址重新讀取設定清單。更換安裝套件前,請先備份分組、路由和其他設定。更新後一次只驗證一項變更:先確認程式能啟動,再用一份已知可用的設定測試,最後還原自訂分流。

如果問題是在更新後才出現,請記下變更時間、使用平台和發生異常的操作,再收集相關記錄。截取記錄時保留第一筆錯誤及附近幾行,移除訂閱網址、身分參數和不打算公開的目標位址。若只有一個訂閱分組受影響,先檢查該分組的更新結果,不必因此刪除其他可正常使用的分組。前往說明中心 →

技術筆記

挑選用戶端、排除故障和安裝程式,各自有不同的檢查順序。若連線已建立但個別應用程式異常,先查看記錄;若尚未安裝用戶端,請從首次安裝檢查清單開始。確認設定和用戶端都支援同一組協定參數後,再比較協定選擇。

選型建議

VMess、VLESS、Trojan、Shadowsocks 差異比較與使用情境選擇

從加密方式、交握負擔、傳輸層搭配和用戶端相容性四個面向比較四種代理協定,並針對日常瀏覽、行動網路和低規格裝置等情境提供選型建議。

閱讀重點:先依可用的用戶端與伺服器組合縮小範圍,再觀察網路變動時的連線表現。

故障排查

V2Ray 執行記錄怎麼看:常見錯誤含意與逐步排查方法

教你開啟用戶端記錄、調整記錄層級,並逐項解讀交握失敗、連線逾時、連接埠占用、時間不同步等常見錯誤,附上由近到遠的排查順序。

閱讀重點:依時間找出首次失敗的位置,區分啟動、解析和交握階段,別只看最後一筆錯誤。

入門指南

v2rayN 首次安裝設定清單:Windows 與 macOS 通用步驟及常見問題

依序整理解壓縮目錄、執行環境、核心類型、本機連接埠、系統代理和首次匯入訂閱等 v2rayN 入門必查設定,並列出新手常遇到的幾個問題。

閱讀重點:第一次先建立一條可用連線,確認實際使用的連接埠和代理模式,再加入自訂規則。