CLIENT / CONFIG / ROUTING

V2Ray代理用戶端 v2rayN 下載與設定

聚焦開源用戶端、訂閱匯入與路由分流,整理四大平台安裝入口、核心選擇及設定欄位指南。

NET
{VMess} {VLESS} {Trojan} {Shadowsocks}

01 / CLIENT SHELF

V2Ray 用戶端平台入口

先確認作業系統與處理器架構,再選擇安裝套件。桌面端使用 v2rayN;Android 建議先查看 v2rayNG,如需 V2Fly 核心再比較 v2flyNG。安裝套件與連線參數須分開確認;安裝用戶端後,仍需匯入可用的設定。

Windows

v2rayN / Desktop · WPF

桌面版採用跨平台介面,WPF 版則保留經典桌面操作方式。下載前先確認套件類型,兩個下載入口並不代表使用不同協定。已有設定的使用者,遷移前應備份訂閱群組、路由設定與本機監聽連接埠記錄。

初次使用可先匯入一筆設定、選擇作用中的伺服器,再設定系統代理。若瀏覽器能連線、其他程式卻不行,先確認程式是否會讀取系統代理,不要一再更換伺服器。兩個版本的介面細節可能不同,請以目前顯示的選單名稱為準。

前往下載 Windows 用戶端

macOS

v2rayN / Apple Silicon · Intel

在系統的「關於這台 Mac」查看晶片資訊。Apple Silicon 與 Intel 使用不同安裝套件,不能只靠副檔名判斷。將 App 移至「應用程式」資料夾後,再依系統提示確認是否開啟及授予網路權限,避免從暫存位置反覆啟動。

分別檢查系統代理與流量接管權限。若升級後連線行為有所改變,先確認用戶端是否已啟動核心,再查看系統代理是否指向目前的監聽連接埠。若遇到開發者提示,請依系統設定中的安全性提示處理,不建議為了啟動 App 而全面關閉系統安全機制。

前往下載 macOS 用戶端

Android

v2rayNG / v2flyNG

v2rayNG 主要使用 Xray 核心,v2flyNG 則提供 V2Fly 核心選項。兩款 App 名稱相近,但支援的協定欄位不一定相同。選擇前請確認設定是否包含 REALITY、特定傳輸方式或其他與核心相關的參數。

依裝置架構選擇 arm64 或通用套件,安裝後匯入訂閱,並確認系統 VPN 授權。此授權是讓 App 接管裝置流量,並不表示用戶端附帶遠端服務。若 App 切換至背景後連線中斷,請檢查電池最佳化、背景活動限制,以及是否與其他 VPN 類 App 衝突。

前往下載 Android 用戶端

Linux

v2rayN / deb · rpm

先確認 Linux 發行版使用的套件管理系統,再選擇 x64 或 arm64。deb 與 rpm 是安裝套件格式,不是連線協定;選錯通常會在安裝階段出問題,而非路由階段。圖形桌面環境也可能影響代理設定,不能假設所有 App 都會自動沿用。

安裝後確認本機監聽連接埠及核心執行狀態,再設定瀏覽器或桌面系統代理。終端機程式可能需要另外設定代理參數。若只有特定程式無法連線,先確認該程式的代理設定;如需接管更多流量,再評估目前用戶端的 TUN 功能與權限需求。

前往下載 Linux 用戶端

02 / CONFIG INSPECTOR

訂閱、路由與核心設定

用戶端負責管理介面設定,核心則負責執行連線與分流。以下分別說明兩層設定:訂閱群組屬於用戶端管理資料;入站、出站、路由與 DNS 則是常見的核心設定。程式碼均為局部範例,請勿直接覆蓋整份執行設定。

config.json / outbounds 節錄

訂閱可用來批次取得連線設定,群組則方便在用戶端中區分來源。先建立群組,再填入訂閱網址並更新,確認回傳內容能由目前的用戶端解析。更新後檢查節點名稱、協定與傳輸欄位,不要只看清單中是否出現項目。群組名稱與自動更新間隔屬於用戶端設定,並非通用核心欄位。下方僅示範匯入後可能產生的出站結構;範例未包含遠端認證資料,無法據此建立代理連線。若要整理多個來源,可再設定篩選條件並保留原始群組。

{
  "outbounds": [
    { "tag": "direct", "protocol": "freedom" },
    { "tag": "block", "protocol": "blackhole" }
  ]
}

03 / OPEN-SOURCE ECOSYSTEM

Project V、V2Fly 與 Xray

用戶端、核心、協定與遠端服務屬於不同層次。了解這些界線,有助於釐清為何同一份訂閱在不同 App 中的表現不一,也能避免排查時把權限、解析與伺服器參數問題混為一談。

ORIGIN / PROJECT V

生態系名稱與執行核心

Project V 是認識 V2Ray 生態系的起點。V2Ray 透過入站、出站、傳輸、路由與網域解析組織代理功能,並以設定檔串連這些模組。日常搜尋所說的「V2Ray 用戶端」,通常是指管理這些功能的圖形化 App,不一定代表某個特定核心。下載用戶端前,請先分清楚選擇的是管理介面,還是負責執行連線的程式。

V2Fly 延續 V2Ray 的社群開發路線;Xray 則發展成另一個核心分支,並加入自有的協定與傳輸擴充功能。兩者背景相近,部分基礎設定概念也相似,但不代表所有欄位都相容。參照說明時,除了檢查欄位名稱,也要確認範例適用於哪個核心,以及用戶端實際呼叫的核心是否相符。

CLIENT / THREE APPLICATIONS

三款開源用戶端的分工

v2rayN 適用於桌面系統,可管理訂閱、選擇伺服器、編輯路由及設定本機代理等。跨平台介面讓桌面使用者能沿用相近的操作方式,但作業系統權限、安裝方式與系統代理機制仍有差異。移轉至其他裝置時,應先轉移必要設定,再確認監聽連接埠與接管模式,不要直接套用另一台電腦的全部環境設定。

v2rayNG 與 v2flyNG 適用於 Android,常見使用方向分別對應 Xray 與 V2Fly。兩者都是開源用戶端,主要差異應從核心能力、可識別欄位與 App 設定來判斷。能匯入訂閱不代表每筆連線都能正常運作;解析成功後,還需確認協定、安全層、傳輸參數與系統授權。桌面與手機共用同一來源時,也應分別測試。

LICENSE / SOURCE CODE

開源協定與使用範圍

V2Fly 核心採用 MIT 授權,Xray-core 採用 MPL-2.0 授權;用戶端、核心與附加元件各自適用的授權條款應分別閱讀。開源說明的是程式碼使用與散布的條件,不等於遠端服務的收費資訊,也不代表在所有網路環境中都有相同表現。用戶端可免費使用,連線所需的伺服器與訂閱則由使用者自行準備。

開源生態系的價值,在於實作方式可以被討論、檢視與改進,也能依據具體模組定位問題。不過,程式碼公開不代表使用者可以免於判斷設定來源、網路權限與資料處理方式。匯入設定前,應先了解伺服器由誰提供;分享故障資訊時,請移除訂閱網址、身分識別資訊與認證參數,只保留重現問題所需的欄位結構。

UPDATE / COMPATIBILITY

App 更新與設定移轉

用戶端更新、核心更新與訂閱更新會變更不同內容。用戶端更新可能調整介面、設定產生方式或系統整合;核心更新可能變更協定支援及欄位處理;訂閱更新則主要替換遠端連線資訊。因此,發現變化時,先記錄是哪一層有所變動,再決定要查看記錄、還原設定或重新匯入訂閱,避免同時執行多項操作而無法判斷原因。

升級前請備份可還原的用戶端設定與自訂規則,升級後先測試一筆原本可用的連線。基本連線正常後,再檢查分流、網域解析與區域網路分享。不要只以介面顯示「執行中」作為驗證結果:核心啟動成功只代表程序已在運作;實際請求是否走向預期的出站,還須搭配 App 代理設定與記錄中的路由結果判斷。

READING / CONFIGURATION PATH

從連線參數到路由規則

首次設定建議依固定順序進行:先確認遠端位址、連接埠與認證參數,再核對協定、傳輸與安全層;接著啟動本機入站,選擇一筆連線進行測試。基本連線可用後,再加入複雜路由。如此可區分「連線本身失敗」與「請求被規則導向錯誤出站」,也能避免把錯誤的 DNS 解析結果誤判為協定不相容。

閱讀 JSON 時,先找出入站與出站標籤,再沿著路由規則查看它們如何連結。規則中的網域清單與位址清單也可能需要外部資料檔案;檔案缺失與規則寫法錯誤是兩種不同問題。需要逐欄比對時,請查看完整設定指南;只需完成首次匯入與連線時,先依快速入門操作,不必一次啟用所有進階功能。

設定前常見的四個問題

訂閱網址和單筆連線有什麼不同?
訂閱可取得一組能定期更新的連線;單筆分享連結則描述一組連線參數。匯入後先確認來源群組,再選擇要使用的項目,避免更新時與手動新增的記錄混淆。查看常見問題 →
VMess、VLESS 和 REALITY 是同一層的設定嗎?
VMess、VLESS 是代理協定,REALITY 則是與安全傳輸相關的技術。選擇用戶端不能只看其中一個名稱,還要一併確認協定、傳輸方式與安全參數的組合。查看術語手冊 →
開啟系統代理後,為什麼部分 App 還是直接連線?
部分 App 不會讀取系統代理,需要手動填入代理,或採用其他流量接管方式。先確認 App 的請求有進入本機監聽連接埠,再檢查出站與分流;不能只看開關狀態就推斷所有流量的路徑。查看連線檢查步驟 →
核心啟動失敗時,應該先檢查哪裡?
先查看第一筆明確錯誤,判斷是 JSON 語法、連接埠占用、未知欄位,還是缺少資料檔案。記錄中後續的連線錯誤可能只是啟動失敗的結果,排查時應從最早出現的原因著手。查看故障排查說明 →

04 / FIELD NOTES

用戶端設定文章

依照操作情境補充說明。修改前先確認問題與監聽、權限、設定產生方式或遠端連線哪一項有關,再查看相應文章。文章中的局部範例用於說明設定之間的關係,實際參數仍須符合使用環境。