Project V · 用戶端與設定參考

V2Ray入門指南 v2rayN 下載與設定

從匯入訂閱到路由分流,對照用戶端選單與 JSON 欄位,檢查本機連接埠、系統代理和 DNS。

  • VLESS / VMess
  • Trojan / REALITY
  • Xray · V2Fly
選擇平台
先找出選單,再修改欄位

用戶端設定
與設定入口

先分清三個層次:訂閱用來保存遠端連線參數;系統代理決定應用程式是否將請求交給用戶端;路由則決定已進入核心的連線要從哪裡出去。匯入成功只代表參數已讀取,不表示瀏覽器已使用代理。

右側依常用選單整理六類設定。先建立一個訂閱群組並確認有可用連線,再調整路由與 DNS。每次只修改一項,並保留修改前的值;發生錯誤時,才能將記錄變化對應到特定操作。

查看設定欄位 →

選單名稱可能因介面調整而異

找不到相同按鈕時,請依功能尋找「訂閱群組」、「參數設定」或「路由設定」。圖示用來說明設定項目之間的關係,不代表連線狀態。程式碼中的 direct 必須對應已定義的出站標籤,不能只複製一條規則就期待完整設定正常運作。

訂閱連結與群組更新

訂閱適合集中管理多條連線。在 v2rayN 開啟「訂閱群組設定」,新增群組並貼上完整網址,儲存後執行「更新訂閱」。Android 版則在「訂閱群組設定」填入網址,再返回首頁更新。相較於逐條匯入分享連結,訂閱可在之後依群組重新整理。更新失敗時,先檢查網址是否有效、系統時間是否正確,以及網路連線路徑;不要反覆刪除原有群組。訂閱網址可能包含存取憑證,分享截圖或求助記錄時,請遮蔽完整連結。

  • 訂閱群組設定 → 地址(Url)
  • 更新訂閱 → 不透過代理 / 透過代理
  • 自動更新間隔 → 依需求設定
先選系統,再選架構

V2Ray 用戶端下載入口

桌面版選 v2rayN,Android 裝置可優先查看 v2rayNG。安裝套件的架構取決於裝置處理器,與訂閱使用的協定無關。以下入口會開啟下載頁中的平台區塊,再依裝置選擇安裝套件。

Windows

v2rayN · 桌面用戶端

下載頁提供 Desktop 桌面版與經典 WPF 版。前者採用跨平台介面,後者保留熟悉的經典操作版面。選擇前請先確認系統需求;已有設定的裝置應先匯出備份,不要直接覆寫唯一一份可用設定。

首次啟動後,先匯入訂閱並選擇使用中的連線,再設定系統代理。如果瀏覽器仍無法連線,請檢查本機連接埠是否遭其他程式占用,以及安全性軟體是否阻止用戶端啟動核心。先查看記錄中的具體錯誤,再考慮重新安裝。

前往下載

macOS

v2rayN · 依處理器選擇

在系統選單中開啟「關於這台 Mac」,查看顯示的是晶片名稱還是 Intel 處理器。Apple Silicon 裝置選擇 arm64,Intel 裝置選擇 x64。先確認架構,再前往下載頁選擇對應的安裝項目,不要只憑裝置年份判斷。

安裝後請確認系統代理已套用至目前的網路服務。無線與有線網路可能保留不同設定;切換網路後若連線異常,請重新查看目前服務使用的代理位址和連接埠。自行設定代理的應用程式,也要在應用程式內檢查設定。

前往下載

Android

v2rayNG · v2flyNG

可優先查看使用 Xray 核心的 v2rayNG;需要 V2Fly 核心環境時,再了解 v2flyNG。較新的主流裝置通常選擇 arm64,不確定架構時請查看通用套件說明。兩款用戶端分別管理設定,安裝其中一款不會自動遷移另一款的訂閱。

首次連線時需確認系統 VPN 授權。同一時間執行的其他 VPN 類應用程式可能影響連線,應先確認目前是哪個應用程式在接管流量。啟用「依應用程式代理」後,請確認選的是允許清單還是排除清單,避免測試用的瀏覽器被排除。

前往下載

Linux

v2rayN · deb / rpm

先依發行版的套件管理系統選擇 deb 或 rpm,再確認 x64 或 arm64。桌面用戶端適合在圖形介面中管理訂閱和路由;套件格式相同不代表系統相依套件也相同,安裝前請閱讀下載頁上的系統需求。

不同桌面環境與應用程式處理系統代理的方式可能不同。瀏覽器可以連線、其他程式卻失敗時,先確認該程式是否會讀取桌面代理設定,再查看程式本身的 HTTP 或 SOCKS 代理設定。不要把單一應用程式未使用代理,誤判為整份訂閱無法使用。

前往下載

用戶端是本機連線工具,訂閱與遠端服務需另外設定。更換平台時可以沿用相容的訂閱,但每台裝置的系統代理、應用程式範圍和本機連接埠都應分別確認。

查看所有用戶端 →
分別了解介面、核心與協定

Project V 與開源核心生態

「V2Ray」常用來泛指一系列工具與設定慣例。實際排查時,仍需明確寫出用戶端名稱、核心類型和連線協定。同一個介面可以匯入連結,不代表底層核心支援連結中的每一項參數。

Project V

設定與代理工具生態

從本機入站接收請求,再依規則選擇出站;圖形用戶端則在這套架構上提供選單與設定管理功能。

  • V2Fly → 由社群接續維護的 V2Ray 專案
  • Xray → 從 V2Ray 發展而來的獨立核心專案
  • v2rayN / v2rayNG / v2flyNG → 圖形管理介面

Project V:先了解設定結構

Project V 是由網路代理工具組成的開源專案體系,V2Ray 是其中廣泛使用的實作。其設定通常將監聽入口、遠端連線、路由比對和解析行為拆分為不同模組。這樣的架構有助於逐步定位問題:應用程式沒有請求記錄時,先檢查入口;有記錄但目標被送往錯誤出口時,再檢查路由;網域無法開啟但 IP 位址可連線時,則繼續檢查解析環節。不要在同一次測試中同時更換訂閱、核心和 DNS,否則很難判斷是哪項變更產生效果。

V2Fly 與 Xray:背景相近,欄位不一定通用

V2Fly 由社群接續維護 V2Ray 專案;Xray 則從 V2Ray 發展而來,之後走上獨立的功能演進路線。兩者共享部分概念與設定慣例,但協定支援、安全參數和欄位細節會因實作而異。遇到「未知欄位」或「不支援此協定」時,應先確認目前使用哪個核心,再對照相應說明。REALITY 屬於傳輸安全相關設定,不能只憑連結標題判斷是否相容,也不能把它當成可套用於所有協定的獨立節點類型。

三款用戶端:以圖形介面管理連線參數

v2rayN、v2rayNG 和 v2flyNG 都是開源圖形用戶端。v2rayN 可在桌面環境管理訂閱、路由和核心;v2rayNG 主要用於 Android,搭配 Xray 核心運作;v2flyNG 則提供 Android 上選用 V2Fly 核心的方式。各自的開源授權依各專案聲明而定,不能將某個核心的授權直接套用到所有用戶端。選擇時先確認作業系統與所需功能,再檢查現有設定是否相容,不要只憑名稱相似就判斷能否替換。

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

這三種更新的對象不同。用戶端更新會改變介面和產生設定檔的邏輯;核心更新會改變實際的連線實作;訂閱更新主要用來更新服務提供者發布的連線參數。用於網域與位址比對的規則檔則是另一類資源。訂閱更新成功不會自動解決系統代理未啟用的問題,也不保證規則資料庫已更新。維護前先備份訂閱群組和自訂規則,閱讀更新說明後逐項操作;發生問題時記下完整錯誤訊息,不要只寫「不能用」。

從現象找出對應設定

匯入成功了,為什麼瀏覽器還是沒走代理?

匯入只會儲存連線參數。接著選擇使用中的連線、確認系統代理已啟用,再檢查瀏覽器是否遵循系統設定。如果記錄中沒有對應請求,請先檢查入口,不要立刻修改遠端連接埠。操作順序請參閱系統代理設定。

全域代理會接管所有程式嗎?

路由中的全域模式通常只會影響進入核心後的出站選擇,不會強制所有程式接入代理。終端機、遊戲或獨立網路元件可能需要自行設定代理。先確認應用程式的請求從哪裡進入,再決定是否需要分流,請參閱連線驗證方法。

分享連結和完整設定檔有什麼不同?

分享連結通常描述單一遠端連線,完整設定還包含本機監聽、DNS 和規則。匯入分享連結後,用戶端會結合本機設定產生執行用的設定檔。請勿將設定檔直接填入訂閱網址欄,先閱讀JSON 結構總覽。

節點測速結果能代表實際連線狀況嗎?

單項測試只能反映特定測試目標與請求方式。測試有回應,不代表每個應用程式、網域或協定都正常。選擇連線後,仍應透過實際應用程式連線並比對記錄;需要調整連線參數時,請先查看協定參數說明。

閱讀設定欄位時,建議從 inbounds 入站到 outbounds 出站建立連線路徑,再檢查 routing、dns 與 policy。設定範例用來說明欄位之間的關係;實際連接埠、標籤與伺服器參數,應以裝置上的設定為準。

依操作情境繼續查閱

近期設定指南

完成首次連線後,再處理分享、遷移與解析策略。每篇指南聚焦一種操作情境,先確認適用條件,再修改用戶端設定;截取包含憑證或位址的畫面前,請先遮蔽敏感資訊。