桌面與 Android · 首次設定

v2rayN 下載與訂閱匯入

下載v2rayN 查看教學

依序完成訂閱匯入、系統代理與路由分流，從安裝用戶端開始，逐項確認連線設定。

開源用戶端 圖形化設定 中文操作指南
選擇平台，查看對應的安裝入口
Windows Android macOS Linux
用戶端下載入口

依系統選擇安裝套件

先確認作業系統與處理器架構，再選擇安裝格式。桌面端使用 v2rayN，Android 裝置可優先查看 v2rayNG；若有 V2Fly 核心需求，再考慮 v2flyNG。

Windows

v2rayN · 桌面首選

桌面版採用跨平台介面，經典 WPF 版則保留熟悉的 Windows 操作方式。兩種版本都可管理伺服器設定、訂閱群組與路由規則，不必同時安裝。首次設定建議先選一種介面，完成連線後再決定是否移轉。

安裝前先查看系統需求；若用戶端一啟動就關閉，請先檢查該版本所需的執行環境及目錄寫入權限。避免將設定資料夾放在暫存的解壓縮位置，以免更新或清理檔案時遺失設定。若已有設定，請先備份再升級。

前往下載

macOS

v2rayN · 依晶片選擇套件

在「關於這台 Mac」查看晶片資訊：Apple Silicon 選擇 arm64，Intel 處理器選擇 x64。兩種安裝套件對應不同架構，訂閱設定的基本流程相同。安裝完成後，先開啟用戶端，再新增訂閱；安裝完成不代表已建立連線。

首次啟動時請留意系統提示，確認 App 來源後，依系統允許的方式處理。若瀏覽器仍使用原本的連線方式，請檢查目前網路服務的代理設定及瀏覽器擴充功能；系統代理、用戶端路由與應用程式自有代理屬於不同層級，需分別確認。

前往下載

Android

v2rayNG · Xray 核心

Android 裝置可優先選擇 v2rayNG；若需要 V2Fly 核心，可查看替代用戶端 v2flyNG。較新的主流手機通常使用 arm64；不確定架構時，請查看裝置資訊，或選擇下載頁提供的通用套件。不要只看 App 名稱，就認定兩款用戶端支援的協定完全相同。

匯入訂閱後，還要更新群組、選取設定並啟動服務。首次啟動時需確認系統 VPN 授權；此授權用於在本機接管流量，不代表用戶端提供遠端伺服器。若連線在背景中斷，請再檢查電池最佳化及背景執行限制，避免一開始就反覆修改協定參數。

前往下載

Linux

v2rayN · 區分發行版

依發行版的套件管理系統選擇 deb 或 rpm，再確認裝置是 x64 還是 arm64。套件格式與處理器架構必須同時相符。不同桌面環境的系統代理設定入口可能不同；安裝後應先確認用戶端能正常啟動並讀取設定。

瀏覽器通常可以使用桌面環境提供的代理設定，終端機程式則不一定會自動套用。若瀏覽器能連線、命令列卻失敗，請先確認程式是否支援代理及其環境變數，而非直接更換伺服器。若要接管更多應用程式，再閱讀 TUN 模式的權限與路由說明。

前往下載

用戶端下載、遠端服務與訂閱是三個不同環節。安裝套件只提供本機工具；連線所需的伺服器位址、驗證資訊與傳輸參數，須由使用者合法取得並妥善保管。

查看所有用戶端
設定順序與核心功能

從訂閱管理到路由分流

先讓一份設定順利連線，再逐步調整代理範圍。以下介面僅供設定參考，選單名稱及選項位置可能因用戶端與核心版本而異，請以實際介面為準。

訂閱群組設定 · 示意
群組備註
日常設定
訂閱網址
貼上服務提供者給的完整網址
更新方式
更新目前訂閱（不透過代理）
儲存網址後仍需更新訂閱

訂閱可集中取得及更新伺服器設定，適合需要定期同步參數的情況。在 v2rayN 中新增訂閱群組，填寫備註並貼上完整網址，儲存後再更新目前訂閱；Android 端也要區分訂閱群組與單一連結匯入。群組網址不會自動成為可用伺服器，必須成功取得內容。首次設定可先嘗試不透過代理更新；若失敗，請核對網址、網路與記錄檔。更新前保留手動設定，分享畫面截圖時請遮住網址中的憑證。

查看訂閱匯入步驟

連線測試：每次只變更一項設定

完成訂閱更新後，先選取一筆設定並啟動核心，確認記錄中沒有設定解析或連接埠占用錯誤，再開啟系統代理。使用支援代理的瀏覽器連線至明確的測試目標，同時確認原本可直連的網站及區域網路裝置是否正常。測試結果須配合實際情境判讀：訂閱能更新，只代表訂閱網址可連線；核心能啟動，只代表設定可載入；瀏覽器能連線，也不代表所有應用程式都已透過代理。

若連線失敗，記下剛才變更的項目與對應錯誤，先復原最近一步。不要同時更換核心、啟用 TUN、修改 DNS 並重寫路由，否則很難判斷是哪個變更造成影響。若要接管不讀取系統代理的程式，再閱讀完整手冊中的 TUN 說明；一般瀏覽器使用情境可先從系統代理開始。

依階段閱讀完整手冊
Project V 生態系與維護依據

區分用戶端、核心與服務

了解這三者的關係，比只記住某個軟體名稱更有幫助。下載用戶端是取得本機操作介面，選擇核心是確認設定相容性，而遠端服務則決定連線參數的來源。

Project V V2Fly Xray

Project V：先了解生態背景

Project V 是以網路代理工具為核心發展的開源生態系，V2Ray 是其中廣為人知的專案。日常搜尋中的「V2Ray」有時指核心，有時泛指相容設定或整套使用方式，因此不能只憑這個詞判斷該下載哪個安裝套件。圖形用戶端將底層設定整理成選單、群組與開關，讓使用者不必每次手動撰寫完整設定；但協定、傳輸方式與驗證資訊仍須與遠端設定正確對應。

本網站將安裝與連線分開說明：先依裝置選擇圖形用戶端，再介紹訂閱提供哪些參數，最後說明系統代理與路由如何影響應用程式流量。依此順序更容易將問題定位到特定環節，也能避免把「用戶端已開啟」誤認為「所有網路請求都已依預期轉送」。

V2Fly 與 Xray：彼此相關但並不相同

V2Fly 社群延續 V2Ray 的維護與開發；Xray 則從相關程式碼發展而來，並持續演進自身功能。兩者有部分共同的技術背景，但協定擴充、設定欄位及更新週期仍有差異。VMess、VLESS、Trojan 是需要分別了解的協定類型；REALITY 則涉及連線安全層的特定機制，不應將這些名稱視為可以任意互換的選項。

選擇設定時，先確認服務提供者要求的協定、傳輸方式與核心支援，再檢查 TLS 伺服器名稱等欄位。某項功能在一種核心中可用，不代表另一種核心也會自動相容。舊教學中的預設值也不一定適用於目前版本；遇到不熟悉的參數，保留原始設定並查閱對應說明，比只因名稱相似就手動改寫更穩妥。

三款開源用戶端：各有不同操作重點

v2rayN 適用於桌面系統，提供伺服器管理、訂閱群組、系統代理與路由設定等圖形介面。跨平台版本與經典介面的操作位置可能不同，但都是先匯入設定，再確認核心與代理範圍。桌面端尤其要留意本機監聽連接埠，以及結束用戶端後的系統代理狀態；變更連接埠時，也要同步調整使用該連接埠的應用程式。

v2rayNG 適用於 Android 裝置，採用 Xray 核心，常見匯入方式包括剪貼簿、QR Code 及訂閱群組設定。Android 端透過系統 VPN 介面接管流量，因此授權提示、依應用程式設定代理及背景執行設定都可能影響使用結果。QR Code 只是承載設定內容的一種方式；成功掃描不代表遠端設定一定有效，也不代表訂閱已完成更新。

v2flyNG 是採用 V2Fly 核心的 Android 替代用戶端，適合需要特定核心行為或設定相容性的情境。選用它應依據實際設定需求，而不是同時啟動多個用戶端來排除問題。系統通常只允許一個 VPN 服務處於啟用狀態；切換用戶端前，先停止原有連線，再於新用戶端重新確認匯入內容與代理範圍。

開源授權：了解程式碼與授權的界線

這三款用戶端都以開源專案形式提供程式碼。v2rayN 採用 GPL-3.0 授權，v2rayNG 與 v2flyNG 採用 GPL-3.0 系列授權；V2Fly 與 Xray 核心採用 MPL-2.0 授權。實際使用、修改與再散布義務，應以所用版本隨附的授權條款及相依套件說明為準；用戶端、核心與隨附元件不能一概視為採用相同授權。

程式碼開源代表實作內容可以閱讀與討論，不代表每個遠端服務都值得信任。訂閱中的網址可能包含驗證憑證，記錄檔也可能洩露伺服器資訊；尋求協助時只保留必要的錯誤資訊，並遮蔽驗證憑證、訂閱網址及個人資料。用戶端是否開源與服務提供者的營運方式是兩個不同問題，應分別判斷。

更新機制：先備份，再留意變更

用戶端、核心、路由資源與訂閱內容各有不同的更新來源及週期。更新訂閱主要是同步遠端設定，不能取代用戶端升級；升級用戶端也不保證訂閱網址仍然有效。遇到連線異常時，先確認最近變更的是哪個環節，再決定是否更新。升級前記錄目前的代理模式、路由選擇及自訂連接埠，並備份設定，避免同時升級和大量修改設定。

社群維護會帶來功能調整與問題修正，也可能更改選單名稱或預設行為。因此，本教學著重操作目的，而非要求每個按鈕都固定在特定位置。更新後先確認能否正常啟動，再測試日常使用的應用程式及直連目標；確認新設定穩定後，再清除舊備份。若問題持續發生，可依記錄中的設定解析、DNS、建立連線及 TLS 錯誤逐項排查。

了解本站內容定位
技術筆記 · 最近更新

依現象查找疑難排解步驟

完成基本設定後若遇到特定問題，可依照相應現象查看筆記。先保存錯誤訊息，再由本機到遠端逐步縮小範圍，避免將所有連線失敗都歸因於同一項設定。

查看所有文章 繼續依常見問題排查