desktop client / configuration guide

V2Ray for Linux v2rayN 用戶端下載與設定

從匯入訂閱開始,依序設定系統代理與路由分流。

protocols
  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
核心
Xray / V2Fly
用戶端
3
平台
4

download

選擇平台,下載用戶端

桌面端使用 v2rayN,Android 裝置建議優先選擇 v2rayNG。先確認作業系統與處理器架構,再前往下載頁選擇相應安裝套件;用戶端名稱相近,不代表安裝格式與核心功能完全相同。

Windows

v2rayN / Desktop · WPF

桌面版提供跨平台介面,經典 WPF 版則保留熟悉的 Windows 桌面操作方式。兩種版本都能管理訂閱、選擇使用中的節點及設定代理;依系統需求與介面使用習慣選擇即可,不必為了匯入同一份訂閱而同時安裝兩個版本。

首次啟動後,先確認節點清單與記錄是否正常,再啟用系統代理。若瀏覽器可以連線,但開發工具仍連不上,請檢查該工具本身的代理設定。程式能啟動、核心正在執行,以及應用程式流量確實經過代理,是三個需要分別確認的環節。

前往下載 →

macOS

v2rayN / Apple Silicon · Intel

先在「關於這台 Mac」查看晶片資訊。Apple Silicon 對應 arm64,Intel 對應 x64;依處理器選擇磁碟映像檔,比只看電腦外觀判斷更可靠。安裝完成後,從「應用程式」資料夾啟動,並依系統提示處理首次開啟所需的權限。

匯入訂閱後,先透過系統代理測試瀏覽器連線,再考慮其他流量接管方式。終端機工具不一定會讀取桌面網路代理設定,可能需要另外指定代理位址。變更系統網路選項前請先記下原設定;退出用戶端時,也要確認代理設定已還原。

前往下載 →

Android

v2rayNG / Xray · v2flyNG / V2Fly

Android 裝置建議優先使用 v2rayNG;需要 V2Fly 核心時,可選擇 v2flyNG。多數較新的手機可選 arm64;不確定裝置架構時,先查看下載頁的套件說明。兩款應用程式的核心與選項並不完全相同,不能只因為分享連結可以匯入,就認定設定相容。

首次連線時,請確認已授予系統 VPN 權限。節點設定負責連線參數,應用程式分流則決定哪些應用程式納入接管範圍,兩者不是同一個開關。若切換至背景後連線中斷,請檢查電池最佳化與背景執行限制,再查看記錄是否有實際的連線錯誤。

前往下載 →

Linux

v2rayN / deb · rpm

Debian、Ubuntu 等發行版通常選擇 deb,Fedora 等發行版通常選擇 rpm,並確認架構是 x64 或 arm64。安裝套件格式符合需求只是第一步,還要確認目前發行版的桌面環境與執行相依項目符合要求。圖形化用戶端必須在可用的桌面工作階段中啟動。

Linux 桌面的系統代理設定與終端機環境變數彼此獨立。建議先透過本機 SOCKS 連接埠測試連線,再設定桌面網路代理;需要使用 TUN 時,再檢查權限、路由與 DNS。逐層驗證可避免把桌面設定問題誤判為節點故障。

前往下載 →

下載頁集中列出各平台的套件類型與適用說明。選好安裝套件後,回到快速入門教學繼續匯入設定,不必在首頁尋找特定檔案。

查看所有用戶端 →

features

設定入口,五項核心設定

訂閱提供設定來源,代理模式決定流量入口,路由則決定流量出口。先釐清這三個層次,再視需求啟用 TUN 或切換核心。下方為設定項目示意,實際名稱與可用功能請以使用中的用戶端為準。

訂閱分組與節點更新

訂閱連結可批次取得節點設定,適合需要定期同步連線參數的情況。在 v2rayN 中先建立訂閱分組,填入網址並儲存,再執行更新,接著選擇使用中的節點。相較於逐一貼上分享連結,分組更方便區分來源,也能個別更新或停用。更新通常只會處理節點清單,不代表所有本機路由規則也會同步;刪除或覆寫前,請先保留需要的設定。訂閱網址可能含有存取權限資訊,請勿放進公開截圖、記錄或共用文件。

  • 訂閱分組:備註與網址
  • 更新訂閱:確認清單已重新整理
  • 使用中的節點:連線前個別選擇
查看匯入訂閱步驟 →
v2rayN訂閱分組設定
訂閱分組基本設定
備註日常使用
自動更新間隔依需求設定
啟用更新
取消確定

設定示意:先儲存分組,再從訂閱選單執行更新。

quickstart

首次連線,三個操作階段

安裝完成不代表設定也完成。依照「匯入設定、選擇入口、驗證連線」的順序操作,每個階段只處理一類問題。即使某個步驟失敗,也能保留已確認正常的部分。

01 / import

匯入訂閱,確認使用中的節點

先準備有效的訂閱網址或分享連結。v2rayN 從訂閱分組開始,儲存網址後執行更新;v2rayNG 則在訂閱設定中新增來源,再更新設定。只把網址貼進輸入欄還不算完成匯入,請返回清單確認設定確實出現,並手動選擇要使用的節點。

確認協定類型、伺服器連接埠、傳輸方式與安全層符合設定來源的說明。不要把網頁網址當成訂閱網址,也不要在更新失敗時一再刪除所有分組。先判斷提示是網址無法連線、內容無法解析,還是匯入後清單為空,再決定要調整更新方式或確認設定來源。

訂閱與單一節點分享連結的差別在於管理範圍:前者通常用來批次更新,後者則用來匯入單一設定。用戶端不提供遠端伺服器帳號,安裝軟體本身也不會建立可連線的服務。必須先有設定,才能繼續下一步。

訂閱匯入操作說明 →

02 / connect

選擇代理入口,再選擇路由模式

桌面端先啟用系統代理,讓遵循系統設定的應用程式連至本機監聽連接埠。Android 裝置啟動連線時,請依系統提示確認 VPN 權限。接著選擇適合目前用途的路由預設;路由預設會改變出口判斷,不會取代應用程式連上代理的步驟。

日常瀏覽可先使用常見的分流預設測試,同時存取本機資源與遠端網站,確認兩類請求是否都正常。開發工具、終端機與部分獨立應用程式可能不會讀取系統代理,請在各自設定中指定代理類型、位址與連接埠。沒有明確需求時,不必一開始就啟用 TUN 或疊加多組自訂規則。

本機監聽位址通常使用迴圈位址。只有確實需要讓同一區域網路中的裝置使用代理時,才評估開放監聽範圍與防火牆設定;「允許區域網路連線」並非一般本機使用的必要選項。

查看模式選擇步驟 →

03 / verify

驗證網頁、DNS 與應用程式流量

先用瀏覽器開啟可供測試的網頁,再確認用戶端記錄中是否出現相應連線。若工具提供連線測試,可作為輔助參考,但測試成功不代表每個應用程式都已使用代理。實際服務存取、網域解析與系統接管範圍仍須分別確認。

網頁無法開啟時,先檢查系統時間、節點設定與本機連接埠,再檢查系統代理、DNS 和路由。瀏覽器正常但終端機失敗,優先檢查終端機的代理設定;網域無法連線但以 IP 連線的測試正常,則應優先檢查解析路徑。每次只變更一項設定,記錄結果後再繼續,避免同時修改多項設定而難以判斷故障來源。

驗證完成後,再整理日常設定:保留可用的訂閱分組、記下常用路由模式,並了解退出用戶端後的系統網路狀態。日後更新或更換網路時,可依相同順序重新檢查,不必從頭重新安裝。

前往故障排除 →

ecosystem

開源生態,用戶端與核心的分工

V2Ray 並非單一圖形化應用程式的名稱。了解 Project V、V2Fly、Xray 與三款用戶端之間的關係,有助於判斷設定應交由哪個程式處理,以及錯誤發生在哪個環節。

Project V:從代理核心到圖形介面

Project V 以模組化代理工具為基礎建立生態系,V2Ray 是其中廣泛使用的核心專案。核心負責組合入站、出站、路由與協定處理,圖形化用戶端則將這些功能整理成訂閱分組、節點清單與設定視窗。使用者按下連線後,實際處理網路請求的通常是用戶端啟動或整合的核心,而不是介面本身。

這也說明了為什麼同樣標示 V2Ray 的設定,在不同用戶端中可能有不同結果:用戶端的匯入解析方式、產生設定的邏輯,以及核心支援的參數都可能影響結果。排查時應分別確認「連結能否匯入」、「核心能否啟動」與「目標請求能否完成」,不要把三個環節混為單一連線狀態。

V2Fly 與 Xray:相關但不同的實作

V2Fly 延續 V2Ray 的社群開發,Xray 則是在相關技術基礎上發展出的核心專案。兩者技術來源相近,也各自演進協定功能與設定行為。VMess、VLESS、Trojan 等名稱代表協定;WebSocket 等名稱代表傳輸方式;TLS、REALITY 等則涉及安全層,這些名稱不能互相替代。

選擇核心應以實際設定需求為準,而非只比較專案名稱。例如使用特定擴充參數時,須確認該核心確實支援相應組合;一般設定也不應為了切換核心而任意改寫安全參數。協定本身無法單獨決定速度,網路路徑、伺服器資源、傳輸方式與用戶端環境都會影響使用體驗。

三款用戶端:桌面管理與 Android 使用

v2rayN 提供桌面圖形化設定介面,支援本頁列出的三種桌面平台。v2rayNG 適用於 Android,採用 Xray 核心;v2flyNG 則提供以 V2Fly 核心為基礎的 Android 版本。這三款用戶端都是開源專案,但介面配置、匯入功能與核心整合方式各不相同,不能直接照搬某一款的選單路徑。

開源表示原始碼可依相應授權條款檢視、使用與參與改進,不代表用戶端內含遠端代理服務,也不表示任何設定都適合匯入。設定來源、應用程式權限與裝置執行環境仍須個別評估。一般使用者選擇符合平台與協定需求的用戶端,比同時安裝多款後混合修改設定更容易維護。

授權與更新:分別檢視介面、核心與規則

用戶端、核心與配套資料可能採用不同的開源授權。使用、修改或重新散布時,應分別閱讀相關專案的授權說明,不能以籠統的「開源」標籤取代具體條款。社群維護讓問題修正與功能持續演進;更新是否適合目前裝置,仍須依系統需求與變更說明判斷。

日常維護也要區分更新對象。更新訂閱通常會變更遠端提供的節點設定;更新用戶端可能改變介面與設定產生邏輯;更新核心則可能影響協定實作。網域與 IP 分類資料又屬於另一個層次。發生變化後,先確認更新的是哪個部分,再對照記錄重新檢查,可減少不必要的回復與重裝。

閱讀建議:如果只有網頁無法開啟,先前往故障排除依序檢查入口、解析與出口;若要統一桌面與手機的節點來源,請閱讀多裝置設定同步方案;準備手動撰寫分流規則,再查看路由章節。依問題選擇文件,比一次開啟所有進階選項更容易找出原因。

journal

專題閱讀,設定與協定說明

完成基本連線後,再處理更具體的設定問題。以下三篇文章分別介紹協定機制、多裝置同步與自訂路由;先確認目前需求屬於哪個層次,再選擇相應的設定方式。