開源用戶端 · 中文設定指南

V2Ray開源社群 v2rayN 下載

從用戶端選擇到訂閱匯入與路由分流,依作業系統找到安裝入口,再依相同步驟確認流量走向。

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks

01 設定項目

V2Ray 用戶端核心功能

訂閱提供設定,系統代理或 TUN 決定流量如何進入用戶端,路由則決定流量要前往何處。以下依各項設定分別說明。

訂閱網址與單一分享連結

訂閱網址由服務提供者提供,用來取得及更新一組設定;單一分享連結通常只包含一筆連線設定。在 v2rayN 中,先替訂閱分組取個容易辨識的名稱,儲存網址後再更新該分組。比起逐筆貼上,透過分組更新更容易辨認各項設定的來源,也能避免把臨時測試用的連線和常用清單混在一起。更新後先確認清單中是否出現項目,再選擇一筆連線;匯入成功不代表連線正常。

  • 更換訂閱網址前,先確認要修改的是哪個分組。
  • 分享螢幕截圖時,請遮住完整網址;網址路徑本身也可能用於驗證身分。
訂閱網址示意 · 網域保留,無法使用
https://example.invalid/list

如果收到的是以 vmess:// 或 vless:// 開頭的單一連結,請使用分享連結匯入功能。

02 安裝檔選擇

依作業系統下載用戶端

先確認作業系統,再確認處理器或套件格式。即使應用程式名稱相同,不同裝置也不一定能使用同一個安裝檔。

Windows

桌面版與經典 WPF 版都叫 v2rayN。第一次安裝可先試用桌面版;如果手邊的教學使用經典介面,或你已熟悉舊版選單,再選擇 WPF 版。選擇安裝檔前,請到系統的「關於」頁面確認系統類型,不要只憑作業系統名稱判斷架構。

如果下載的是壓縮檔,請先完整解壓縮至目前帳戶可寫入的資料夾,再從該資料夾啟動。在壓縮軟體的預覽畫面直接執行,可能只啟動主程式,卻缺少其他必要檔案。已有設定時,請先備份,再換個資料夾測試;確認訂閱與路由都還在後,才清理舊資料夾。

前往下載

macOS

從 Apple 選單開啟「關於這台 Mac」。顯示 Apple 晶片就選 Apple Silicon 套件;顯示 Intel 處理器就選 Intel 套件。下載 v2rayN 後,依映像檔中的指示安裝,再從「應用程式」資料夾開啟;不要將掛載中的映像檔當成長期執行位置。

如果系統阻止程式啟動,先確認提示內容是關於系統相容性、來源還是權限,不要為了單一應用程式關閉整台裝置的保護功能。在系統匣看到應用程式,也不代表系統代理已生效;從用戶端切換設定後,請用一款會遵循系統代理設定的應用程式測試,再決定是否需要另外設定終端機。

前往下載

Android

需要 Xray 核心時選擇 v2rayNG;明確依賴 V2Fly 實作時,再考慮 v2flyNG。多數近期裝置可選 arm64;不確定裝置支援哪種架構時,可選通用套件。通用套件能解決安裝架構問題,但無法讓其他核心支援原本不支援的協定組合。

從瀏覽器或檔案管理工具開啟安裝檔時,系統通常只會將安裝權限授予目前來源,安裝完成後即可收回。首次連線時,系統可能會要求授予 VPN 權限;若有其他應用程式正在使用該連線,請先中斷連線再測試。匯入時也要分清楚整組訂閱與單一分享連結。

前往下載

Linux

選擇 v2rayN 時,先依發行版常用的套件格式挑選:Debian、Ubuntu 系統通常選 deb,Fedora 系統通常選 rpm;接著再確認 x64 或 arm64。兩項都符合再安裝,別把架構不相容與缺少執行相依套件當成同一種問題。

桌面環境的代理設定不一定會套用到終端機或背景服務。若瀏覽器正常、命令列卻逾時,請先確認本機監聽位址與連接埠、命令列工具支援的代理類型,以及代理環境變數是否傳入目前的程序。確認這一層後,再檢查用戶端的路由與出站設定。

前往下載

03 專案與核心

Project V 開源生態系

教學談的是用戶端、核心還是伺服器端?先釐清這三個層次,再判斷操作建議是否適用於目前的裝置。

從操作介面到連線處理
  1. 用戶端匯入、編輯並選擇設定
  2. 核心接收入站連線,依規則選擇出站
  3. 連線目標依比對結果直接連線或交由代理出站
  1. Project V:用戶端與核心為何分開

    Project V 是理解這套工具的起點。早期的 V2Ray 著重將入站、出站與路由拆分成可組合的設定:入站負責接收連線,出站負責傳送連線,路由則負責在多個出站之間做選擇。因此,發起連線的應用程式、轉送流量的核心,以及處理設定的圖形介面,不必寫在同一個程式中。社群後來推出的桌面與行動用戶端,正是以這樣的分工為基礎,提供更方便的操作入口。

    了解這段歷史背景有助於排查問題。例如,用戶端中看得到訂閱項目,只能表示介面有資料可用;要確認設定能否載入,必須查看核心的啟動結果;要確認某個應用程式的流量是否經過核心,則要檢查它的流量入口。混淆這三件事,最容易在網路異常時反覆匯入訂閱,卻沒發現應用程式根本沒有使用代理。

  2. V2Fly 與 Xray:從共同基礎到各自發展

    V2Fly 社群延續 V2Ray 核心的開發與維護。Xray 從這套程式碼分支出去,之後各自發展。兩者的設定概念相近,有些協定與欄位看起來也相同,但共同來源不代表一定相容。尤其是涉及新式傳輸或安全層選項時,其中一方能讀取的參數組合,另一方未必會以相同方式處理。判斷時,請優先確認伺服器端的明確要求,再查目前用戶端使用哪個核心。

    更換裝置時,也別預設要把原本整份設定搬過去。單一連線的必要參數、用戶端儲存的訂閱分組,以及本機監聽連接埠和系統代理設定,本來就屬於不同層次。可以先移轉連線項目,在新裝置上測試一筆連線,再逐項補回分流規則。即使連線失敗,也更容易判斷是參數不相容,還是新裝置的本機設定尚未完成。

  3. 開源授權與代理協定並不相同

    VMess、VLESS 描述通訊雙方如何交換資料;開源授權則規範程式碼可以如何使用、修改與再散布。這兩類文件處理的是完全不同的問題。V2Fly 核心採用 MIT 授權,Xray-core 採用 Mozilla Public License 2.0。前者再散布的條件較少,但仍須保留相關著作權與授權聲明;後者的義務主要適用於授權涵蓋的檔案,散布這些檔案的修改版本時,須依條款提供相應的原始碼。

    各元件分別維護,授權條款也應分開查看。圖形用戶端、隨附核心與其他元件,不能只憑安裝檔名稱就認定適用同一套條款。一般使用者不必讀完所有授權文字才能設定用戶端;但若打算重新封裝、修改或發布衍生版本,就應逐一閱讀相關元件附帶的授權條款。代理服務本身的帳號、方案與使用條件則由服務提供者決定,不屬於開源授權的一部分。

  4. 三款用戶端如何配合不同設定需求

    v2rayN 是開源桌面用戶端,可在同一個介面管理訂閱分組、選擇連線、設定路由與系統代理,適合需要管理多組設定,或分別排查不同應用程式的情況。v2rayNG 是使用 Xray 的開源 Android 用戶端;v2flyNG 也採開源方式,使用 V2Fly 核心。手機上不必因為兩款應用程式名稱相似就全部安裝;請先依伺服器端參數與用戶端支援範圍選擇一款,完成基本連線後,再比較設定差異。

    向他人說明問題時,交代應用程式名稱、核心與錯誤發生的步驟,比只貼一張寫著「連線失敗」的截圖更有幫助。例如,是更新訂閱時取不到資料、選取項目後核心回報錯誤,還是只有某個終端機工具沒有經過代理?這三種情況需要檢查的位置都不同。分享記錄時,請保留時間、操作步驟與錯誤類型,並遮住訂閱網址、帳號資訊及不宜公開的伺服器端參數。

  5. 用戶端更新、核心更新與訂閱更新

    用戶端更新可能改變選單配置、安裝方式或設定儲存位置;核心更新可能改變支援的欄位與啟動行為;訂閱更新則只是向提供者取得最新項目,三者不能互相取代。更新前先記下目前選取的項目、核心、路由模式與本機監聽連接埠;需要保留的自訂規則請另外備份。每次只調整一個層次,並使用相同的應用程式與目標重新測試,才能確認是哪項變更造成影響。

    更新後若所有應用程式都同時失效,先確認核心是否啟動、入站是否正在監聽;若只有某一個應用程式失效,先檢查該應用程式本身的入口設定。訂閱更新後項目變少,也要先確認更新的是哪個分組,以及來源是否真的刪除了項目,不要立刻覆蓋本機手動設定。需要逐步操作時,請接著查看全平台指南;若已能連線但流量走向不如預期,可先查看說明中心中的路由與代理問題。

04 技術筆記

系統代理、路由與訂閱排查

依實際狀況找到檢查入口:終端機未接入、流量進入後走錯出站,以及多個訂閱分組難以整理,是三種不同問題。

v2rayN 系統代理未生效怎麼辦:瀏覽器能開啟,終端機卻沒走代理

分開排查瀏覽器與終端機:先確認系統代理是否已設定、瀏覽器擴充功能是否接管,再檢查終端機環境變數與本機連接埠,找出 v2rayN 系統代理失效的真正原因。

先別重新安裝用戶端。瀏覽器擴充功能、系統代理與終端機參數可能分別指向不同入口;確認工具實際連到哪個連接埠後,才需要檢查轉送。如果確認某筆連線沒有進入用戶端,修改出站或路由就無法解決這筆連線的問題。