v2rayN · v2rayNG · v2flyNG

V2Ray 客戶端
下載與設定

下載v2rayN 查看教學

開源客戶端下載與中文設定說明，從匯入訂閱到路由分流，依平台逐步設定。

協定
  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
平台

客戶端下載

依作業系統選擇安裝方式

先確認作業系統與處理器架構，再選擇安裝套件。桌面版使用 v2rayN；Android 版可先了解 v2rayNG；若有 V2Fly 設定需求，也可查看 v2flyNG。

Windows

v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面，經典版則適合習慣原有操作方式的使用者。初次安裝請先閱讀執行環境說明，不必同時安裝兩種介面。

將程式與設定檔放在方便管理的位置，更新前先備份訂閱群組與路由設定。啟動後先匯入伺服器，再設定系統代理。

前往 Windows 下載

macOS

v2rayN 提供 Apple Silicon 與 Intel 兩種安裝版本。請在系統的「關於這台 Mac」查看晶片資訊，依實際硬體選擇，不要只憑電腦外觀或購買年份判斷。

首次開啟時請留意系統權限提示。系統代理或虛擬網路介面的設定，需依目前的系統權限及客戶端說明操作。

前往 macOS 下載

Android

v2rayNG 使用 Xray 核心，v2flyNG 則以 V2Fly 核心為基礎。近年多數主流手機可選擇 arm64；若不確定處理器架構，請先閱讀下載頁面的通用版說明。

建立連線時，系統會要求授予 VPN 權限。若手機上已有其他 VPN 應用程式正在執行，請先中止衝突的連線；若背景連線中斷，也請檢查電池最佳化設定。

前往 Android 下載

Linux

v2rayN 依 Linux 發行版的套件格式提供 deb 與 rpm 下載，並區分 x64 和 arm64。請先確認發行版與裝置架構，再透過系統套件安裝程式完成安裝。

不同桌面環境處理系統代理的方式可能不同。若應用程式未使用系統代理，請先檢查該應用程式本身的網路設定，而非反覆更換伺服器。

前往 Linux 下載
查看所有客戶端

設定重點

訂閱、路由與網路模式

客戶端負責管理設定，核心則負責處理連線。分清這兩個層次，遇到問題時就更容易找到需要檢查的項目。

匯入訂閱與群組管理

訂閱是用來更新一組伺服器設定的方式，不是客戶端本身提供的連線服務。取得有效的訂閱網址後，建立獨立群組並執行更新，之後就能依來源整理伺服器，不必一再手動輸入參數。

  • 依來源建立群組。為群組取一個容易辨識用途的名稱，避免混合不同來源的伺服器。更新前確認操作中的群組；刪除時也更容易判斷影響範圍。
  • 匯入後確認內容。成功儲存訂閱網址，不代表伺服器已載入。更新後請確認清單中已有項目，並檢查目前選取的伺服器是否來自剛匯入的群組。
  • 分辨訂閱與分享連結。單一分享連結通常只包含一份伺服器設定；訂閱網址則用來取得一組設定。選擇相符的匯入方式，可減少格式辨識失敗的情況。

路由分流與出口選擇

路由決定連線要直連還是經由代理。這和選擇伺服器是兩回事：即使已選取代理伺服器，符合直連規則的連線仍會直接連線。請先了解規則比對順序，再新增自己的網域或位址規則。

  • 明確的規則放前面。將指定網域、區域網路位址等規則與較廣泛的規則分開管理。規則重疊時，請優先檢查比對順序，而不只是確認清單中是否有目標網域。
  • 用全域代理進行比對。若要判斷問題是否出在分流規則，可暫時切換至代理出口進行測試。測試後請恢復原本模式，不要將單次排查結果當成長期設定依據。
  • 同時檢查路由與 DNS。網域解析結果會影響位址規則的比對。部分網站異常時，請一併檢查網域規則、解析方式與執行記錄，逐步縮小問題範圍。
閱讀路由規則實例

跨平台設定與網路接管

桌面版與 Android 版可以使用相同來源的伺服器資訊，但介面選項、權限與網路接管方式各有不同。轉移設定時，請著重核對協定參數與路由需求，不要直接以某平台的整個設定資料夾覆蓋另一平台的資料夾。

  • 先用系統代理驗證。桌面瀏覽器通常適合先透過系統代理測試。此方式仰賴應用程式遵循系統設定，不能據此推斷裝置上的所有程式都已使用代理。
  • 有需要再啟用 TUN。TUN 透過虛擬網路介面接管流量，可能牽涉管理員權限、DNS 與路由衝突。請先確認基本連線正常，再逐步擴大接管範圍。
  • 各裝置設定分開保留。本機監聽連接埠、啟動方式與電池管理策略都與裝置環境有關。共用訂閱時，也應逐台檢查這些選項，避免將環境問題誤認為訂閱問題。

依目前問題查看設定步驟

若伺服器清單是空的，請先確認訂閱群組是否已儲存網址，再手動更新該群組。更新失敗時，請分辨是無法連線至網址，還是內容解析失敗：前者檢查網路、網址是否過期及存取權限；後者確認訂閱格式與客戶端支援範圍。請勿在記錄截圖中公開完整訂閱網址，其中可能包含存取憑證。清單載入正常後，選取一台伺服器實際測試連線；訂閱更新成功只代表已取得設定，不保證每台伺服器都能連線。

查看訂閱匯入步驟

v2rayN 常用設定位置示意

先確認目前使用的伺服器，再檢查流量如何進入核心，以及由哪條規則選擇出口。

此處為靜態示意，連接埠僅供說明；實際名稱、位置與連接埠請以客戶端設定為準。

快速入門

從匯入設定到確認連線

已有可用訂閱時，可依照下列步驟完成初次設定。客戶端不包含伺服器，訂閱與伺服器參數需由使用者自行準備。

  1. 匯入訂閱並更新伺服器清單

    安裝並開啟客戶端後，進入訂閱管理介面，新增群組並儲存訂閱網址，再更新該群組。桌面版與 Android 版的選單名稱可能略有不同，重點是完成「儲存來源」與「取得內容」兩個步驟。若使用單一分享連結，請選擇相對應的匯入功能。匯入後，確認伺服器名稱、協定類型與群組都符合預期，切勿將訂閱網址貼到伺服器位址欄位。

  2. 選擇伺服器並確認接管方式

    從清單中選取一台伺服器作為目前的連線目標。桌面版請先依照教學啟用系統代理；Android 版則在啟動連線時確認系統 VPN 權限。首次測試請沿用基本路由設定，不要同時啟用多套代理軟體，也不要一次修改 DNS、TUN 與路由規則。如此一來，發生異常時才能判斷問題出在伺服器連線、應用程式代理設定，還是規則比對。

  3. 實際連線並查看記錄

    開啟要造訪的目標網頁，確認是否載入完成，而不只是觀察客戶端圖示是否變化。清單中的連線測試只涵蓋特定測試目標，不能代表所有網站的連線狀況。若無法連線，請先確認本機網路正常、選取的伺服器正確且系統代理已生效，再查看相同時段的執行記錄。每次只變更一項條件並重新測試，通常比連續修改多項設定更有效。

查看完整教學

開源生態

Project V、核心與圖形化客戶端

「V2Ray」常用來統稱一系列相關工具。選擇客戶端時，應分別確認支援平台、核心與設定功能，不要只憑名稱判斷相容性。

Project V

代理工具與模組化網路處理的專案背景

V2Fly
由社群維護的 V2Ray 核心系統
Xray
與 V2Ray 有歷史淵源的獨立核心分支
圖形化客戶端
管理訂閱、路由與本機執行設定

此圖僅用於區分各自職責，不代表各專案之間有統一的發布或管理關係。

從專案背景認識核心職責

Project V 以模組化代理工具為核心，逐步形成相關生態系。V2Ray 核心負責接收連線、處理協定，並依設定將流量轉送至相應出口。V2Fly 延續由社群維護的 V2Ray 系統；Xray 則在共同歷史基礎上獨立發展。兩者的概念與部分設定格式相近，但功能支援、欄位意義和更新步調並不完全相同，不能因名稱相似就任意互換設定。

客戶端介面與核心分屬不同層級

v2rayN 適用於桌面平台，提供伺服器管理、訂閱更新與路由設定等圖形化操作，並依所選功能呼叫相應核心。v2rayNG 適用於 Android，主要使用 Xray；v2flyNG 則以 V2Fly 為基礎。這三款客戶端都是開源軟體，程式碼與發布版本由各自專案維護。開源代表程式碼以開放方式提供，但仍需自行評估訂閱來源、伺服器營運者與裝置權限。

判斷協定支援時，也要確認傳輸與安全設定

VMess、VLESS、Trojan 與 Shadowsocks 是常見的協定名稱；WebSocket、gRPC 等屬於傳輸選項，TLS 與 REALITY 則涉及不同的安全設定。僅憑協定名稱相同，無法確認設定能否正常運作。客戶端必須能辨識訂閱格式，使用的核心也必須支援設定中的具體功能；憑證名稱、傳輸路徑等參數同樣要與伺服器端一致。

開源授權與更新代表什麼

客戶端及其依賴的核心可能採用不同的開源授權。閱讀、修改或散布程式碼時，請以各專案隨附的授權條款為準，不要將生態系中的某一份授權視為所有專案的共同條款。客戶端介面更新、核心更新與訂閱更新也是不同操作：更新訂閱只會更新伺服器設定，不會自動取得所有新增的協定功能。

更新客戶端前，建議先備份群組、路由規則與必要的本機設定，並閱讀執行環境及設定相容性說明。若問題只出在特定網站，請優先檢查規則與 DNS 解析；若記錄明確顯示無法識別設定欄位，再確認核心的支援範圍。依問題所在層級逐步處理，通常比一味追求更新更容易重現並解決問題。

進階設定手冊：訂閱管理、DNS 與 TUN 設定

技術筆記

客戶端安裝與核心選擇

以下三篇筆記分別介紹核心相容性、初次安裝與專案關係，適合在基本連線建立後接續閱讀。

查看所有文章