跳至正文
客戶端選擇 · 訂閱設定 · 連線排查

V2Ray 客戶端下載 v2rayN 設定教學

從訂閱匯入開始,依序設定路由分流與TUN 模式。

  • VMess
  • VLESS
  • Trojan
  • REALITY

CLIENT WORKFLOW

訂閱、分流與代理接管

先將節點匯入客戶端,再決定哪些流量要交由核心處理。介面負責管理設定,核心負責建立連線;系統代理與 TUN 則決定應用程式的流量如何送到核心。將這三個層次分開檢查,比同時切換多個選項更容易找出問題。

訂閱網址用來取得一組節點設定,不等同於單一節點的分享連結。在「訂閱群組設定」新增群組,填入備註與網址並儲存,再執行「更新訂閱(不透過代理)」。若目前網路無法連上訂閱網址,而你已有可用連線,再試著透過代理更新。不同來源建議分開建立群組,方便個別更新與排查。相較於逐筆手動輸入,訂閱可集中管理節點欄位;但更新是否成功,仍應以日誌與節點清單為準。

路由會依網域、目標位址等條件,選擇直連或代理出站。先在「路由設定」選擇符合目前網路環境的規則,再檢查預設出站;別把開啟系統代理誤認為所有流量都會走同一個出口。若需要連線至本機設備,應保留私有位址直連規則。相較於所有流量共用單一出口,分流可依目標分別處理,但規則順序與網域解析結果都會影響比對結果。修改後用同一個應用程式重新測試,並查看日誌確認實際選用的出站。

系統代理主要適用於遵循系統代理設定的應用程式,適合先用來測試瀏覽器連線。TUN 透過虛擬網路介面接管流量,適用於不讀取系統代理設定的程式,但需要相應權限與路由支援。先確認一般代理連線正常,再啟用「TUN 模式」,避免把節點故障與虛擬網卡故障混為一談。相較於只設定系統代理,TUN 的涵蓋範圍更廣,也更容易受到其他虛擬網卡、DNS 設定與網路工具影響。結束使用後,請確認系統網路已恢復正常。

核心負責解析設定並執行連線;圖形介面中名稱相同的欄位,不代表所有核心都支援相同組合。在 v2rayN 的「設定」中檢查相應設定類型的核心選項,依節點協定與傳輸需求選擇 Xray 或 sing-box。切換前先記下原本的選項,切換後查看啟動日誌。相較於只能使用固定核心的客戶端,多核心提供更多相容性選擇,但切換核心無法修復錯誤憑證或失效節點。若設定涉及特定安全機制,也要確認客戶端與核心支援相關欄位。

v2rayN · 訂閱管理

訂閱群組設定

備註依來源命名
訂閱網址填入完整 URL
首次取得更新訂閱(不透過代理)
完成後查看更新日誌
群組 → 更新 → 選取使用中的節點

初次設定:一次確認一個層次

匯入完成後,先選取一個節點並設為使用中的伺服器,再確認核心是否啟動。節點出現在清單中,只能表示設定已讀入,無法證明遠端服務一定連得上。測試時保留日誌面板,記下錯誤是在啟動時出現,還是存取目標時逾時;兩種情況的排查方向不同。

接著開啟系統代理,用瀏覽器連線至明確的測試目標。若瀏覽器正常、其他程式卻失敗,先確認該程式是否使用系統代理,不要立刻重新安裝客戶端。若要擴大流量接管範圍,再參閱 TUN 權限與 DNS 相關說明。不同系統或介面版本的選單名稱可能略有差異,請依功能尋找;詳細流程請見快速入門教學。

訂閱網址與節點參數:分開保存

訂閱網址通常含有存取憑證,應妥善保管並視為帳戶資訊。截圖求助前,請遮住網址中的查詢參數與節點身分欄位。訂閱無法更新時,先檢查網址是否完整、是否已過期,以及回傳內容是否為登入頁面;已匯入的節點能否連線,則需另外檢查節點狀態。兩條連線流程可能各自失敗,不能用其中一方的結果代替另一方。

PLATFORM SELECTOR

依作業系統選擇客戶端

桌面平台可先從 v2rayN 開始;Android 建議優先了解 v2rayNG,再依核心需求考慮 v2flyNG。下載頁整理了架構選擇與安裝說明。客戶端只負責讀取並執行設定,安裝完成後仍須準備可用的訂閱網址或節點參數。

Windows

首選 v2rayN

下載頁提供桌面版與經典 WPF 版。桌面版採用跨平台介面,WPF 版則保留經典操作配置;依個人使用習慣選擇即可,不需要為同一份訂閱同時安裝兩種介面。安裝前確認作業系統與處理器需求,首次啟動後先找到「訂閱群組設定」,再匯入設定。

需要使用 TUN 時,請依客戶端提示檢查系統管理員權限。啟用後若網路中斷,先關閉 TUN,確認系統代理路徑可正常連線,再檢查虛擬網卡與其他網路工具。正常結束客戶端後,也請確認系統代理設定已依預期還原。

前往下載 Windows 客戶端 →

macOS

v2rayN

先從系統選單的「關於這台 Mac」查看晶片資訊,再選擇 Apple Silicon 或 Intel 的下載項目。架構選擇會影響程式能否正常執行,但不會改變訂閱網址的格式。將應用程式移至「應用程式」資料夾後啟動,再匯入訂閱並選取使用中的節點。

遇到系統安全性提示時,請閱讀提示內容並確認應用程式來源,再透過系統設定中的相應選項處理,不要直接關閉整套安全機制。初次使用時先測試系統代理;需要使用 TUN 時,再依提示授權並檢查網路延伸功能或虛擬介面的狀態。選單細節請參閱完整安裝指南。

前往下載 macOS 客戶端 →

Android

v2rayNG / v2flyNG

v2rayNG 使用 Xray 核心,可優先選擇;v2flyNG 使用 V2Fly 核心,適合明確需要該核心設定的情況。多數較新的裝置可選 arm64;若不確定裝置架構,再查看通用版說明。不要只因為兩款應用程式名稱相近,就認定它們支援完全相同的協定組合。

新增訂閱後執行更新、選取設定,再點選連線並確認系統的 VPN 授權提示。若切換至背景後常常中斷,請檢查電池最佳化與背景執行限制。連線已建立但部分應用程式仍無法使用時,再檢查應用程式分流設定;排查期間避免同時執行其他占用 VPN 介面的工具。

前往下載 Android 客戶端 →

Linux

v2rayN

依 Linux 發行版的套件管理系統選擇 deb 或 rpm,再確認 x64 或 arm64 架構。套件格式與處理器架構是兩項獨立條件,不能只確認其中一項。安裝後從桌面應用程式選單啟動,先測試一般代理,再處理 TUN 權限與系統服務相關設定。

桌面環境的系統代理設定不一定會套用到所有程式。若瀏覽器能連線、其他應用程式卻失敗,先檢查該應用程式自己的代理選項。啟用 TUN 後若發生解析異常,請檢查系統 DNS 管理方式與其他虛擬網路介面;不要在多個設定入口反覆更改 DNS,以免無法重現測試結果。

前往下載 Linux 客戶端 →

PROJECT V / V2FLY / XRAY

開源生態系與核心的界線

客戶端名稱、協定名稱與核心名稱分別代表不同層次。了解它們之間的關係,有助於避免選擇時判斷錯誤,也能解釋為什麼同一份設定在不同客戶端中可能產生不同結果。

Project V:設定模型與工具生態系

Project V 是由網路代理工具所形成的專案生態系,V2Ray 是其中的重要組成。入站負責接收本機流量,出站負責連線至目標或遠端服務,路由規則則在兩者之間選擇路徑。常見的訂閱管理與圖形客戶端,是建構在這些設定能力之上的操作介面,並非一套與核心無關的連線原理。

因此,匯入訂閱、選擇節點與開啟系統代理並不是同一個動作。訂閱決定設定來源,使用中的節點決定採用哪一組遠端參數,系統代理或 TUN 則決定流量入口。排查時依照這條流程逐層檢查,比把所有異常都說成「客戶端連不上」更能精確定位問題。

V2Fly 與 Xray:源自相同基礎,各自演進

V2Fly 社群延續 V2Ray 的開發與維護,Xray 則從相關程式碼分支出來,沿著自己的方向演進。兩者共享部分概念與協定背景,但設定欄位、傳輸支援與功能進度不能直接互換。VLESS、XTLS Vision、REALITY 等設定需求,應確認所用核心的實際支援情況,而非只看介面是否提供類似的輸入欄位。

需要遷移設定時,先確認原本使用的核心,再檢查目標核心接受哪些欄位。未知欄位錯誤屬於設定相容性問題;連線逾時則可能發生在網路、遠端服務或交握階段。這兩類錯誤不適合用相同方式修復,也不能只憑核心名稱判斷連線品質。

三款客戶端:圖形介面與開源授權

v2rayN、v2rayNG 與 v2flyNG 都以開源專案形式維護,分別提供桌面與 Android 的圖形化設定介面。v2rayN 支援管理多種核心;v2rayNG 以 Xray 核心為基礎;v2flyNG 則搭配 V2Fly 核心。選擇客戶端時,先考量平台與設定需求,再確認是否需要特定介面或核心功能。

開源授權規定程式碼的使用與再散布條件,不代表所有相關元件都採用同一份授權。V2Fly 的主要程式碼採用 MIT 授權,Xray 的主要程式碼採用 MPL 2.0;客戶端及其相依元件也各有授權說明。一般使用時可先確認功能相容性;若要修改、打包或再散布,則應分別閱讀相關授權條款。

更新機制:分別檢視介面、核心與規則

客戶端更新可能改變選單配置與設定產生方式,核心更新可能調整欄位支援,路由資料更新則會影響網域或位址分類。遇到變化時,先確認變動的是哪個層次,再決定是否需要遷移設定。不要把升級客戶端當成解決所有連線問題的固定步驟。

更新前先保留自己的設定紀錄,更新後使用原本可連線的節點與相同目標重新測試。若只有某種協定組合失敗,請查看核心啟動與交握日誌;若只有部分目標走錯出口,則檢查路由規則及其順序。分享日誌時只保留診斷所需資訊,並遮住訂閱網址與身分欄位。本網站提供獨立的中文操作說明,不取代上游專案的授權與功能文件。

查看專案介紹 →

CONFIGURATION NOTES

設定詳解與故障排除

依據日誌中的具體錯誤繼續排查。核心無法啟動,先檢查連接埠與欄位;核心正常但連線失敗,再檢查交握與憑證;若要理解設定之間的關係,則從入站、出站與路由架構開始。每次只修改一項條件,並保留修改前後的結果。