Linux / Windows / macOS 桌面用戶端

V2Ray for Linux: v2rayN 用戶端

從桌面安裝、匯入訂閱到連線測試,依實際設定項目設定 v2rayN;Android 裝置可選用 v2rayNG。

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
  • REALITY

依裝置選擇下載項目

桌面用戶端v2rayN Android 用戶端v2rayNG / v2flyNG 核心生態系Xray · V2Fly 設定方式訂閱 / 分享連結 / JSON

用戶端功能與設定入口

從選擇用戶端到代理模式

先確認裝置與核心,再設定訂閱、分流及流量接管。畫面僅供設定參考,實際名稱可能隨用戶端更新而異。

v2rayN 桌面版,集中管理連線設定

v2rayN 在同一個桌面介面中整合訂閱、伺服器設定、路由規則與執行記錄。安裝後先確認本機監聽連接埠,再匯入服務商提供的連結,選取要使用的設定並啟動核心。系統代理適合遵循系統設定的瀏覽器與應用程式;終端機工具則可另外指定代理位址。桌面版方便在不同系統間沿用操作習慣,但檔案路徑、網路權限與 TUN 授權仍須依各系統分別處理,不能直接套用另一台裝置的執行環境。

查看桌面版設定步驟 →
v2rayN · 本機代理
監聽位址127.0.0.1
本機監聽連接埠10808
記錄等級warning
參數設定

用戶端下載與安裝

依作業系統與架構選擇安裝套件

桌面裝置可使用 v2rayN,Android 裝置建議先了解 v2rayNG。安裝套件類型、處理器架構與用戶端核心是三種不同的選擇條件。

v2rayN 提供採用新一代跨平台介面的桌面版,以及經典 WPF 版。首次安裝可先試用桌面版;若已習慣 WPF 介面,可依執行環境選擇。介面不同不代表訂閱服務有所差異,連線仍取決於設定內容與核心相容性。

若啟動異常,先檢查執行環境、目錄寫入權限與安全軟體提示,不要反覆覆蓋設定目錄。更新前先備份個人設定,並確認新介面中的監聽連接埠與原設定一致。

v2rayN 安裝套件分為 Apple Silicon 與 Intel 架構。先在「關於這台 Mac」查看晶片資訊,再選擇相符的版本。首次開啟應用程式時,系統可能會要求確認開發者相關提示;網路與代理設定權限也須依實際提示授權。

安裝完成不代表系統代理已啟用。先啟動用戶端核心,再檢查代理模式與瀏覽器要求;遇到權限提示時,依教學逐項處理,不建議直接關閉系統安全機制。

Android

優先選用 v2rayNG

v2rayNG 採用 Xray 核心,v2flyNG 則是 V2Fly 核心的備選方案。較新的主流手機通常選擇 arm64 套件;不確定裝置架構時,可先查看通用版說明。不要只因兩款用戶端名稱相似,就認定它們支援完全相同的通訊協定欄位。

首次連線時須確認系統 VPN 授權。若切換至背景後中斷,請檢查電池最佳化與背景執行限制;同時執行其他占用 VPN 介面的應用程式,也可能導致連線被取代。

v2rayN 的 deb 套件適用於採用相應套件管理系統的發行版,rpm 套件則適用於另一類發行版;此外還須區分 x64 與 arm64。選擇前先確認發行版、處理器架構與桌面環境,避免混淆套件格式與處理器架構。

Linux 上不同應用程式讀取代理設定的方式不盡相同。桌面代理、終端機環境變數與應用程式本身的代理設定應分別檢查;只有確實需要更全面地接管流量時,再考慮 TUN 模式與相關網路權限。

查看所有用戶端 →

首次連線流程

匯入、連線、測試

用戶端負責讀取設定並啟動代理,不會自動提供可用的伺服器。請先準備有權使用的訂閱網址或分享連結,再依序操作。

首次測試時,設定盡量保持簡單:一個啟用中的設定、一種代理連線方式,以及一個明確的測試要求。連線穩定後再新增複雜的分流與自動更新;若發生問題,也更容易找出變更來源。

查看完整教學 →
  1. 匯入訂閱或分享連結

    在訂閱群組中輸入完整網址,儲存後更新訂閱;單一分享連結則透過相應的匯入入口新增。看到設定項目後,請核對通訊協定、伺服器位址與傳輸設定。訂閱更新失敗與設定連線失敗發生在不同階段,應分別查看記錄,反覆更新訂閱並不能解決所有問題。

  2. 選擇設定與代理模式

    將要測試的設定設為啟用項目,再啟動連線。桌面裝置先使用系統代理或為應用程式指定代理;Android 裝置則須確認 VPN 授權。實際連線測試有助判斷目前設定是否可用,但結果會受到測試目標與網路狀態影響,不應只憑一次測試就刪除整組設定。

  3. 分別測試瀏覽器與命令列

    先用瀏覽器開啟測試頁面,再透過明確指定代理位址的命令測試要求。若瀏覽器可用、終端機不可用,通常應先檢查終端機是否已設定代理;若兩者都無法使用,再檢查核心記錄、本機連接埠與遠端連線。每次只變更一項設定,並保留可重現問題的操作順序。

Project V 開源生態系

用戶端、核心與設定欄位

介面負責管理,核心負責執行。了解兩者的分工,比只記住用戶端名稱更有助於選擇與排除問題。

Project V 生態系

圖形化用戶端

v2rayN · v2rayNG · v2flyNG

代理核心系列

Xray · V2Fly

實際功能取決於用戶端呼叫的核心及其設定支援。

Project V 與 V2Ray 的關係

Project V 是以網路代理功能為核心發展而成的開源專案生態系,V2Ray 則是其中常見的核心名稱。日常所說的「安裝 V2Ray」,實際上往往是安裝圖形化用戶端,再由用戶端管理代理核心。訂閱管理、系統匣選單與設定編輯屬於介面層功能;接收本機連線、建立對外連線與執行路由則由核心負責。釐清這兩個層次,才能判斷問題出在介面設定還是核心執行。

V2Fly 與 Xray 核心系列

V2Fly 延續 V2Ray 相關開發,Xray 則是從 V2Ray 衍生並獨立發展的核心專案。兩者在部分通訊協定與設定概念上相近,但功能、欄位與更新步調不盡相同。尤其是 VLESS、REALITY 或部分傳輸選項,應確認目前使用的核心是否支援。REALITY 是與連線安全相關的技術,不能因為它經常與通訊協定名稱一起出現,就將它視為可任意互換的獨立代理通訊協定。

三款用戶端的開源特性與分工

v2rayN、v2rayNG 與 v2flyNG 都是開源用戶端專案。桌面端的設定管理需求可優先考慮 v2rayN;Android 端則依 Xray 或 V2Fly 的相容需求,選擇另外兩款。開源代表程式碼與相關授權資訊可供查閱,不代表任何來源的訂閱都值得信任。用戶端、核心及隨附元件可能採用不同的開源授權;若涉及修改、再散布或重新打包,應分別閱讀對應的授權條款與發布說明,不能只憑用戶端名稱推斷所有相依項目的授權條件。

程式更新與訂閱更新是兩回事

更新程式是更換用戶端元件;更新訂閱則是重新取得伺服器設定。前者不會自動延長服務期限,後者也不會補上核心缺少的功能。升級前記下原有的代理模式、連接埠、路由與 DNS 設定;升級後先測試基本連線,再逐步恢復進階選項。設定檔可能包含驗證資訊與訂閱網址,請妥善保管;提供記錄時先移除敏感內容,同時保留足以判斷問題的錯誤類型、發生時間與操作步驟。

需要手動編輯 JSON 時

先確認要編輯的是用戶端本身的設定,還是交由核心執行的設定。核心 JSON 中,inbounds 定義本機入口,outbounds 定義流量出口,routing 將規則指向出口標籤,dns 負責解析設定。欄位名稱相似,不代表不同核心之間可以完全互換。手動修改前請先備份原始檔案,再檢查 JSON 語法,並逐段測試功能;由用戶端自動產生的檔案,也可能在下次啟動時遭到覆寫。

開啟完整設定檔參考 →

設定與問題排除文章

首次連線與桌面版問題排除

遇到問題時,先確認故障階段:程式能否啟動、訂閱能否更新、核心能否連線,以及應用程式是否確實使用代理。

查看所有文章 →