v2rayN · v2rayNG · v2flyNG 使用指南

V2Ray幫助中心客戶端下載與設定手冊

下載v2rayN 查看教學

依作業系統選擇客戶端，查找安裝設定、訂閱匯入與路由分流的設定位置及操作順序。

開源客戶端圖形介面設定中文設定教學

v2rayN 使用教學

設定位置與用途安裝、訂閱與代理模式對照

先確認伺服器連線正常，再調整分流與 TUN。下表以桌面介面為例；不同版本的選單名稱可能略有差異，請以目前介面及記錄檔為準。

設定項目用途說明v2rayN 桌面版
解壓縮目錄 → 執行 v2rayN.exe請將壓縮檔完整解壓縮至可寫入的目錄，再從該目錄啟動程式。不要只將主程式拖出壓縮檔，也不要直接從壓縮軟體執行，否則隨附的核心、相依元件與資料目錄可能無法正常讀取。從完整目錄執行
設定 → 參數設定 → Core 基礎設定先保留預設的監聽設定，確認核心能正常啟動後，再匯入可用的伺服器。若記錄檔顯示連接埠遭占用，先檢查是否有其他代理程式正在執行，再變更連接埠；若出現相依元件錯誤，請依所選安裝套件的要求補齊執行環境。分別檢查介面與核心

初次設定不必一次調整所有選項。依照「啟動核心 → 匯入伺服器 → 設定使用中的伺服器 → 設定系統代理 → 送出請求」的順序測試，便能分辨問題出在資料匯入、本機監聽或遠端連線。伺服器測試結果只反映特定測試條件，不能取代實際應用程式的連線測試。

查看 v2rayN 安裝設定完整步驟 →

客戶端與作業系統選擇

V2Ray 客戶端下載入口

桌上型裝置先看 v2rayN，Android 裝置先看 v2rayNG。下載前請確認作業系統、處理器架構與安裝套件格式；同一客戶端的不同安裝套件不一定能互換。下載頁整理了各版本的下載入口與系統需求。

Windows

建議優先選用 v2rayN 桌面版；若已習慣傳統介面，可比較 WPF 版。桌面版採用跨平台介面，WPF 版則專為 Windows 設計，兩者的選單配置與執行相依元件可能不同。若教學截圖與畫面不符，請先確認使用的介面版本，再尋找同名設定。

先將壓縮檔完整解壓縮至有寫入權限的位置。首次執行若出現相依元件提示，請依安裝套件說明補齊執行環境；不要從其他目錄拼湊執行檔。升級前先備份設定，關閉舊版程式後再處理檔案，避免兩個執行個體爭用監聽連接埠。

前往下載 Windows 客戶端

macOS

使用 v2rayN 桌面版，依處理器選擇 Apple Silicon 或 Intel 安裝套件。可先開啟「關於這台 Mac」查看晶片資訊，再對照下載入口；不要只憑電腦外觀或購買年份判斷架構。介面與桌面版教學相近，但權限確認仍應以系統實際提示為準。

安裝後先匯入一組伺服器，確認核心能正常運作，且瀏覽器請求也能成功。若要使用 TUN，再另外處理相關授權。系統代理、應用程式內建代理與虛擬網卡流量接管屬於不同層級；排查時請先確認目前使用哪種連線方式，避免多種方式互相干擾。

前往下載 macOS 客戶端

Android

建議優先選用採用 Xray 核心的 v2rayNG；若需要 V2Fly 核心生態，再考慮 v2flyNG。多數近年的主流手機適用 arm64 套件；無法確認架構時，可參考通用套件說明。安裝前仍須確認裝置條件，通用套件也無法解決所有系統相容性問題。

首次連線時，須確認系統的 VPN 連線授權。匯入訂閱後，仍要選取伺服器並啟動連線；清單中出現項目不代表服務已啟用。若切換至背景後連線中斷，請再檢查電池最佳化與背景執行限制，不要先反覆刪除並重建仍有效的訂閱。

前往下載 Android 客戶端

Linux

使用 v2rayN 桌面版，依發行版的套件管理系統選擇 deb 或 rpm，再確認 x64 或 arm64 架構。套件格式決定安裝管理方式，架構則決定程式能否在處理器上執行，兩者都必須符合需求；只改副檔名無法轉換安裝格式。

安裝後先確認桌面工作階段中的一般代理連線正常，再考慮 TUN 所需權限。部分應用程式不會自動讀取桌面環境的代理設定，須在應用程式內另行指定連線入口。若只有部分應用程式無法連線，先檢查代理設定的沿用方式，不要直接修改整個系統的路由。

前往下載 Linux 客戶端

客戶端負責讀取設定並建立連線，訂閱則由相應來源提供。下載並安裝客戶端不會自動建立伺服器，也無法自動恢復已到期的訂閱。若已有訂閱，請保留原始網址並確認仍可使用；若只有單一分享連結，應使用匯入伺服器的功能，不要將它當作訂閱網址填入。

查看所有客戶端 →

Project V · V2Fly · Xray

V2Ray 開源生態與客戶端關係

先分清核心、客戶端與訂閱，再決定要更新或修改哪個部分。名稱相近不代表功能完全相同，成功匯入設定也不代表所有連線條件都已具備。

Project V 與核心家族

Project V 是認識 V2Ray 生態的起點，其中的代理核心負責處理協定、傳輸、路由與連線建立。V2Fly 社群持續維護 V2Ray 相關專案，Xray 則以相關技術為基礎，發展出自己的核心與功能方向。日常交流常以 V2Ray 泛稱整個生態，但個別功能是否可用，仍須確認客戶端實際呼叫的核心，以及該核心是否支援相應選項。

VMess、VLESS 和 Trojan 是協定名稱；WebSocket、gRPC 等是傳輸方式；TLS 與 REALITY 則涉及連線安全與交握設定。這些名稱分屬不同層級，不能只憑其中一個詞判斷設定是否完整。連線參數必須與伺服器端一致；手動修改時，請確認要調整的是協定、傳輸方式還是安全選項，不要任意拼湊不同教學中的欄位。

圖形化客戶端與代理核心

v2rayN、v2rayNG 與 v2flyNG 都是開源圖形化客戶端。圖形介面讓使用者管理伺服器、訂閱網址與常用選項，再將這些資料轉換為核心可讀取的設定。它們不是同一個程式的三種外觀：v2rayN 適用於桌面環境，v2rayNG 主要以 Xray 核心提供 Android 設定介面，v2flyNG 則是採用 V2Fly 核心的 Android 替代選擇。

這種分層也決定了排查順序。程式視窗無法開啟，先檢查安裝與執行環境；介面正常但核心啟動失敗，則檢查記錄檔、監聽連接埠與產生的設定；核心正在運作但某個伺服器連不上，再確認遠端參數與網路條件。若把介面成功啟動當成連線成功，容易略過真正需要檢查的環節。跨核心移轉時，也要確認目標客戶端能否設定相同的協定與進階選項。

開源授權與設定隱私

開源表示軟體程式碼依相應授權條款公開，並可在條款規定下使用、修改與散布。生態中的不同專案可能採用不同授權；以 V2Fly 的 V2Ray 核心和 Xray 核心為例，兩者採用 MPL 2.0。各客戶端專案也有自己的授權說明，不能將某個核心的授權直接套用至所有介面程式、相依元件與附帶資源。若要重新散布或修改，請分別閱讀相關專案的授權檔案。

開源與訂閱服務品質是兩回事。訂閱網址、伺服器憑證與本機設定仍須妥善保管；分享截圖時應遮蔽完整訂閱連結，匯出的設定檔也不適合公開傳送。使用訂閱轉換服務前，請先了解服務方可能會讀取完整設定。優先確認客戶端能否直接匯入原始格式；確實需要轉換時，再評估資料處理範圍，不要一遇到匯入失敗就先做格式轉換。

更新方式與日常維護

客戶端更新、核心更新、訂閱更新與路由資源更新，各自解決不同問題。客戶端更新通常影響介面與設定產生方式；核心更新會影響協定實作與執行行為；訂閱更新則會重新整理來源提供的伺服器；規則與網域資源更新可能改變分流結果。遇到異常時先記下最近的變更，不要同時更新所有元件，否則難以判斷是哪項變更造成影響。

日常維護可從備份設定開始。升級前記錄目前的系統代理、監聽連接埠與路由選擇；備份若包含訂閱網址與憑證，應存放在安全的位置。升級後先用原有設定確認核心能啟動，再實際送出請求，最後檢查自訂分流。若只有特定應用程式異常，優先比較該應用程式與瀏覽器使用的代理入口；若所有請求都失敗，再檢查本機服務與目前使用的伺服器。

系統代理、路由與 TUN 的適用範圍

系統代理負責決定「哪些應用程式將請求交給客戶端」，路由規則決定「請求進入核心後使用哪個出口」，TUN 則透過虛擬網路介面接管流量。這三個概念常出現在同一篇教學中，但不能互相取代。啟用系統代理後仍有應用程式直連，可能只是該程式未讀取系統設定；啟用 TUN 後連線異常，也可能與網域解析、網卡路由或其他網路工具有關。

建議先使用系統代理完成基本測試，再視需求調整路由，最後評估是否啟用 TUN。每次修改後，使用相同的應用程式存取相同目標，並查看相應時間的記錄檔，這樣比較結果才有參考價值。記錄檔可能包含伺服器資訊，向他人求助前請先清除敏感內容，同時保留錯誤類型、發生順序與設定背景，方便進一步排查。

安裝與故障排除文章

v2rayN 設定問題與排查步驟

依照實際症狀選擇文章。記錄操作前後的變化、目前使用的介面版本，以及記錄檔中的錯誤訊息，比反覆匯入相同設定更能協助找出問題。

查看所有文章 →