v2rayN · v2rayNG · v2flyNG

V2Ray全平台下載用戶端與設定指南

下載v2rayN 查看教學

整理四大平台用戶端下載入口，從訂閱匯入到路由與 DNS 設定，依操作順序說明各項設定的適用範圍。

  • VMess
  • VLESS
  • Trojan
  • REALITY

CONFIGURATION LAYERS

V2Ray 設定分層

先確認設定屬於哪一層，再從對應入口進行修改。用戶端的訂閱管理、系統代理開關與核心設定各有不同用途，不能只憑「已連線」狀態判斷整條連線路徑正常。

讓應用程式透過本機代理連線

入站決定用戶端從哪裡接收連線。常見做法是在本機監聽 SOCKS 或 HTTP 連接埠，再讓應用程式或系統代理指向該連接埠。匯入伺服器不代表應用程式已經使用代理；排查時請先確認監聽位址、連接埠與應用程式設定一致。僅供本機使用時，通常會繫結至迴圈位址；若要開放給區域網路使用，則須另外檢查存取控制與防火牆。相較於逐一手動設定應用程式，系統代理更方便集中管理；不過應用程式是否遵循系統設定，仍取決於應用程式本身。

{
  "inbounds": [
    {
      "tag": "local-socks",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": { "udp": true }
    }
  ]
}
查看入站與流量接管方式 →

設定範例僅供辨認結構，並非完整的連線設定。實際執行還需要有效的伺服器資訊，以及彼此相符的標籤。不同核心支援的欄位與協定功能可能有所差異，修改前請先確認用戶端目前選用的核心。建議先備份一份可正常使用的設定，每次只調整一個層次，再使用相同的應用程式與目標位址驗證結果。若訂閱更新會重新產生設定，請透過用戶端提供的規則或自訂設定入口修改，避免直接編輯暫存檔案。

CLIENT SHELF

四大平台下載入口

桌面端以 v2rayN 為主，Android 端建議先了解 v2rayNG，再依 V2Fly 核心需求考慮 v2flyNG。先選擇作業系統，再確認處理器架構與安裝套件格式；用戶端名稱相近，不代表安裝檔可以互換。

Windows

選擇 v2rayN。下載中心提供採用跨平台介面的桌面版，以及保留經典介面的 WPF 版，兩者都可用來管理伺服器、訂閱與路由。初次安裝時，請依作業系統需求選擇一種版本，不必為了匯入同一份訂閱而同時執行兩套用戶端。

安裝後先確認本機代理連接埠，再設定系統代理。若應用程式未遵循系統代理，可另外設定應用程式代理，或進一步了解 TUN 模式。同時執行兩套會接管系統設定的用戶端，可能造成連接埠占用或代理指向混淆；排查時建議只保留一套執行環境。

前往下載 Windows 用戶端安裝後的操作步驟

macOS

選擇 v2rayN 桌面用戶端，並依電腦晶片選擇 Apple Silicon 或 Intel 版本。可在系統的「關於這台 Mac」查看晶片或處理器資訊，再選擇相符的架構，不必靠反覆安裝來判斷。

首次執行時請留意系統權限提示，並確認網路代理已指向用戶端的監聽連接埠。若關閉用戶端後仍無法正常連線，請先檢查系統是否保留了代理設定。TUN 涉及更深層的流量接管，啟用前應先閱讀權限與路由說明，不應把它當成解決所有連線問題的通用開關。

前往下載 macOS 用戶端了解 TUN 設定

Android

優先選用採用 Xray 核心的 v2rayNG；若現有設定依賴 V2Fly 功能，再考慮 v2flyNG。下載中心分別提供 arm64 與通用版本。較新的主流裝置通常採用 arm64；若不確定架構，請先查看裝置資訊與對應安裝套件的需求。

首次啟動並連線時，須確認已授予系統 VPN 權限。分應用程式設定會決定哪些應用程式使用代理通道，與伺服器路由規則屬於不同層次。若連線在背景執行時中斷，可檢查系統的電池管理與背景執行限制；也請確認其他使用 VPN 通道的應用程式是否已占用接管位置，再判斷是否需要調整用戶端設定。

前往下載 Android 用戶端比較兩款 Android 用戶端

Linux

選擇 v2rayN，並依發行版的套件系統選擇 deb 或 rpm，再確認 x64 或 arm64 架構。此處提供圖形化用戶端下載入口；是否能直接執行，仍取決於桌面環境、執行相依項目與套件需求，不能只看發行版名稱判斷。

不同桌面環境與應用程式讀取代理設定的方式可能不同。先使用可明確填入代理位址的應用程式測試本機連接埠，再檢查桌面環境的系統代理。若需要使用 TUN，請另行處理權限與路由，避免同時執行多個會修改網路介面的工具。更新前先備份訂閱分組與自訂規則，以便比對行為變化。

前往下載 Linux 用戶端閱讀進階設定
查看所有用戶端

下載前先確認設定來源

用戶端負責執行與管理設定，安裝套件本身不會提供伺服器位址、帳號或訂閱。若已有分享連結，請確認其協定與傳輸特性；若已有訂閱網址，則要確認用戶端能辨識回傳格式。把一般網頁網址誤當成訂閱網址，或將單筆分享連結填入訂閱更新欄位，都可能導致清單空白。匯入失敗時，先確認輸入內容的類型，再檢查網址是否完整，避免一再重新安裝用戶端。

安裝後的驗證分為兩步：先確認用戶端能讀取伺服器設定並啟動核心，再確認目標應用程式的連線確實經過預期路徑。只有伺服器清單、連線開關或單次測試結果，都不足以證明所有應用程式使用相同出口。若要截取訂閱、伺服器記錄或記錄檔畫面，請遮蔽網址中的個人識別資訊與驗證資料，只保留必要的錯誤類別與設定名稱。

PROJECT V ECOSYSTEM

開源生態與核心選擇

分清專案、核心、用戶端與伺服器設定，有助於判斷功能來自哪個環節，也能縮小排查範圍。名稱相似不代表設定能力相同。

PROJECT / CORE / CLIENT

Project V
代理工具與相關元件的專案背景
V2Fly · Xray
技術淵源相近的核心家族
v2rayN · v2rayNG · v2flyNG
面向使用者的圖形化設定與執行入口
查看概念速查 →

Project V 與 V2Ray 的技術背景

Project V 提供代理通訊相關工具與元件，V2Ray 則是這個生態中廣為使用的名稱。實際使用時，通常透過圖形化用戶端匯入伺服器、啟動核心並管理代理設定，而不是直接編輯所有執行參數。核心負責處理協定、傳輸與路由等邏輯；圖形化用戶端則將常用操作整理成介面。了解這項分工，才能明白為什麼更換介面不一定會改變協定支援，而更換核心卻可能影響設定是否能被接受。

日常交流中的「V2Ray 設定」，可能指伺服器分享連結、用戶端儲存的記錄，也可能是核心讀取的 JSON 檔案，這些內容不能直接混用。分享連結通常只描述一台伺服器；訂閱用於批次發送伺服器記錄；核心設定則還包含本機入站與路由。開始排查前，先確認討論的是哪一種內容，避免把用戶端的訂閱選項誤填進核心設定。

V2Fly 與 Xray 的關係

V2Fly 延續 V2Ray 相關核心的社群發展；Xray 則以共同的技術基礎為起點，發展出自己的實作與功能。兩者共享部分概念與設定習慣，但不代表所有欄位、協定組合或傳輸行為都完全相同。選擇時應考量現有伺服器設定需要哪些功能，以及用戶端實際整合了哪個核心，而非只看名稱或介面外觀。

例如，伺服器使用相同的協定名稱，仍可能因傳輸層、安全參數或擴充功能不同，而需要特定核心支援。遇到設定無法解析或核心無法啟動時，先查看錯誤訊息中的欄位與功能名稱，再確認該設定適用的範圍。若只把錯誤歸因於伺服器無法連線，可能會忽略更早發生的設定未被核心接受問題。

三款圖形化用戶端的分工

v2rayN 是桌面端的設定與執行入口，涵蓋本站列出的三種桌面作業系統，實際功能取決於所使用的發行套件與核心設定。v2rayNG 適用於 Android 裝置，本站以 Xray 核心方案介紹一般用法；v2flyNG 則是採用 V2Fly 核心的替代選擇。三者都是開源用戶端，可透過公開的實作與設定行為了解其功能，但它們不是伺服器服務，也不會自動產生可用訂閱。

若現有設定在某款用戶端上運作正常，移轉至其他用戶端時仍須確認匯入格式、路由規則與流量接管方式。匯入伺服器通常不會一併移轉系統代理、分應用程式清單與本機自訂規則。移轉後先測試一台伺服器與一個目標應用程式，再逐步還原分組與分流設定，比一次複製整套環境更容易找出差異。選擇建議請參閱用戶端比較。

開源授權與更新範圍

Project V 生態中的專案、核心與圖形化用戶端可能採用不同的開源授權。例如，V2Fly 的 V2Ray 核心與 Xray 核心採用 MPL 2.0；圖形化用戶端本身及其附帶元件，則應分別查看各自的授權說明。開源授權規範程式碼使用、修改與再散布的條件，不等同於訂閱來源的服務條款，也不代表伺服器的執行狀態。使用者仍須自行管理憑證、存取權限與伺服器設定。

用戶端更新、核心更新與訂閱更新是三種不同操作。用戶端更新可能改變介面與管理方式；核心更新可能影響設定解析與協定行為；訂閱更新則主要更新伺服器記錄。行為出現變化時，先確認變更屬於哪一類，再對照更新前保留的設定。不要同時更換用戶端、核心、DNS 與規則後才開始測試，否則很難找出是哪項變更影響連線路徑。

FIELD NOTES

設定紀錄與故障排查

從訂閱輸入到瀏覽網頁，依問題發生的階段尋找相關文章。匯入階段出問題，先檢查連結與格式；用戶端已啟動卻無法連線時，再檢查系統代理、路由與 DNS。不同階段使用不同檢查清單，避免重複執行無關步驟。

查看所有文章