用戶端下載資訊/安裝與設定

V2Ray教學站v2rayN 下載與設定

依作業系統選擇開源用戶端,從匯入訂閱到路由分流,依照選單完成設定。

協定與傳輸
  • VMess
  • VLESS
  • Trojan
  • REALITY

介面示意:訂閱群組用來管理網址,路由規則則用來選擇流量的出口。圖中的元件堆疊僅用於說明設定關係,並非用戶端的拖放操作。

設定面板對照

訂閱、路由與代理模式

先讓用戶端取得伺服器設定,再決定應用程式的流量如何進入用戶端,以及要從哪個出口送出。訂閱更新成功只代表已取得設定,不代表系統代理已啟用;切換代理模式也無法修復失效的訂閱網址。以下四項分別對應設定來源、比對規則、應用程式入口與虛擬網卡。排查時逐層檢查,不必一次更改所有設定。

訂閱網址與伺服器清單分開管理

在 v2rayN 的「訂閱群組設定」中新增群組,填入方便辨識的別名,再貼上完整網址。儲存後執行「更新訂閱」,確認清單中出現伺服器,再選取要使用的項目。自動更新間隔以分鐘計,設定前先確認手動更新能順利完成。訂閱網址用於取得設定;單一分享連結則用於匯入一筆設定,兩者不要混用。相較於逐筆手動輸入,使用群組更新更適合持續同步伺服器異動;不過更新不能取代連線測試,也不會自動修正伺服器端參數。

查看教學 →

依平台選擇

用戶端下載資訊

桌面端選擇 v2rayN,Android 端可先了解 v2rayNG;若已有 V2Fly 設定需求,再參考 v2flyNG。進入下載頁後,先確認處理器架構與安裝檔格式,再閱讀相應平台的說明。安裝用戶端後,仍需有效的訂閱或伺服器設定;安裝檔本身不包含可直接使用的遠端服務。

Windows

v2rayN 優先推薦

適合透過桌面圖形介面管理訂閱、切換伺服器與設定路由。下載頁提供桌面版和經典 WPF 版:桌面版採用跨平台介面,WPF 版則保留經典桌面操作方式。選擇時應考量系統需求、執行環境與既有使用習慣,避免混用兩種介面的設定步驟。

首次啟動時,先查看記錄是否提示缺少相依元件或連接埠遭占用,再匯入訂閱。設定檔應存放在可正常寫入的位置;升級前請先關閉用戶端並備份現有設定。若關閉用戶端後,瀏覽器仍顯示代理連線失敗,請檢查系統代理是否仍指向已停止監聽的本機連接埠,不要立刻刪除所有伺服器。

macOS

v2rayN

適合在桌面上集中管理訂閱群組與代理設定。先開啟「關於這台 Mac」查看晶片資訊:Apple 晶片請選 Apple Silicon 版本,Intel 處理器則選 Intel 版本。兩種安裝檔適用的架構不同,不要只憑檔案大小選擇,也不要直接套用其他作業系統的安裝步驟。

安裝後先確認一般代理連線正常,再考慮啟用 TUN。系統代理是否生效,也取決於目前的網路服務與應用程式本身的設定;終端機程式不一定會自動使用桌面代理。遇到系統安全性提示時,請依安裝章節確認來源與處理方式,不要為了略過問題而任意關閉整套系統防護。切換網路後,請重新檢查 DNS 與代理入口。

Android

v2rayNG 優先推薦

v2rayNG 使用 Xray 核心,v2flyNG 使用 V2Fly 核心,下載頁依此順序列出兩款用戶端。多數近年的手機可選擇 arm64 版本;若不確定裝置架構,請先查看系統資訊,再判斷是否使用通用版。協定與傳輸能力須符合伺服器端參數,不能只因用戶端名稱相近,就認定設定完全通用。

匯入訂閱並更新後,選取伺服器、啟動連線,再確認系統 VPN 權限授權。若切換至背景後連線中斷,請檢查電池最佳化與背景活動限制;若只有部分應用程式未經代理,請檢查應用程式分流設定。系統通常只允許一項 VPN 服務運作,同時啟用其他同類工具可能會取代目前的連線,建議先只保留一個用戶端進行測試。

Linux

v2rayN

適合在具備圖形桌面的 Linux 發行版上管理訂閱與路由。依發行版選擇 deb 或 rpm,再確認 x64 或 arm64 架構。套件格式代表安裝方式,處理器架構則代表支援的硬體,兩者都必須符合。桌面環境、系統元件與權限政策各有差異;即使安裝成功,也不代表所有程式都會自動讀取系統代理。

先確認用戶端能啟動核心,且本機監聽連接埠可正常使用,再透過瀏覽器測試連線。終端機程式、沙箱應用程式與桌面程式可能使用不同的代理來源,須分別檢查。啟用 TUN 前請閱讀權限說明,避免與現有虛擬網卡規則衝突。更新後若出現異常,請記下發行版、桌面環境與記錄中的錯誤,再依平台章節逐項還原最近的變更。

同一份訂閱可以包含不同協定的設定。能否使用,取決於用戶端實際呼叫的核心及其功能,而非安裝檔名稱。更換裝置後,請重新確認系統權限、代理入口與本機連接埠;匯入相同訂閱並不會自動同步這些本機設定。

查看所有用戶端 →

開源生態系與設定界線

Project V、V2Fly 與 Xray

圖形用戶端、代理核心與遠端伺服器是三個不同層次。用戶端提供選單與設定管理,核心負責處理協定與轉送流量,伺服器則提供遠端連線端點。分清這三層,才能判斷問題出在安裝、參數相容性、應用程式接管,還是遠端連線。

專案關係:源自共同歷史,各自發展

Project V 以網路通訊工具為核心建立專案體系,V2Ray 是其中的核心專案。V2Fly 延續社群對 V2Ray 的維護與開發;Xray 則從 V2Ray 發展而來,之後走出獨立的功能發展路線。日常所說的「V2Ray 用戶端」通常泛指這個生態系中的圖形工具,不代表它們都使用相同核心,或支援完全相同的設定欄位。

閱讀教學時,先確認用戶端名稱,再確認實際使用的核心。伺服器端要求特定協定、傳輸方式或安全設定時,應依照核心實際支援的功能填寫。尤其是 VLESS 與 REALITY 設定,務必先確認核心能力與伺服器端參數;不能任意更改欄位名稱來達成相容。匯入訂閱只是將參數交由用戶端解析,最終仍須由核心支援這些參數。

三款用戶端:介面管理與核心執行各司其職

v2rayN 是適用於桌面平台的開源圖形用戶端,提供伺服器管理、訂閱更新、路由與代理設定;可用核心與具體功能則取決於安裝檔和目前設定。v2rayNG 是適用於 Android 裝置的開源用戶端,使用 Xray 核心;v2flyNG 同樣適用於 Android 裝置,使用 V2Fly 核心,適合已有相關設定需求的情境。選擇時應以裝置平台和參數相容性為準。

這三款工具都不是訂閱服務本身。用戶端下載、取得訂閱網址與遠端服務是否可用,是不同的事情;更換用戶端不會自動延長訂閱期限,也不會改變伺服器端的流量或連線限制。若訂閱更新後沒有伺服器,先檢查群組網址與更新結果;若清單中已有伺服器但連線失敗,再檢查選取的設定、協定參數與記錄。先釐清問題所在的層次,比反覆匯入相同網址更有效。

開源授權:分清介面與核心

開源代表程式碼依相應授權條款公開;使用、修改與散布仍須遵守專案授權規定。V2Fly 的 V2Ray 核心採用 MIT 授權,Xray-core 採用 MPL-2.0;用戶端也有各自的授權說明,不能只用核心授權概括整個安裝檔及其相依元件。若要重新散布或修改,應分別閱讀用戶端、核心與附帶元件的授權條款。

社群維護有助於持續修正問題與發展功能,但開源並不能取代實際設定檢查。訂閱網址通常含有存取憑證,分享截圖前應遮蔽完整網址、使用者識別資訊及其他敏感參數。回報問題時,優先提供選單位置、錯誤類型和已嘗試的操作,不要直接公開含有憑證的完整設定檔。網站上的示意網址僅用於說明欄位格式,不能作為實際服務使用。

更新方式:分別處理訂閱、用戶端與規則資料

更新訂閱會重新取得伺服器設定;更新用戶端會變更圖形介面及隨附元件;更新路由資料則會影響網域或位址集合的比對。這三種操作處理的對象不同。連線異常時,不要一次全部更新,否則難以判斷問題來自遠端設定、核心行為,還是分流結果。先保留現有設定並記下錯誤,再選擇與問題相符的更新方式。

升級用戶端前,請確認所有執行中的程式都已關閉,並備份訂閱群組與自訂路由。升級後先測試原本可用的伺服器,再試用新增功能。訂閱自動更新間隔應符合實際使用頻率與服務提供者的要求;頻繁傳送請求不一定能提高可用性,還可能觸發請求限制。若訂閱網址已失效,調整更新間隔也無法修復,應先處理網址本身。

連線測試:分辨測試結果與應用程式行為

伺服器測試有結果,不代表每個應用程式都已透過代理連線。先用瀏覽器測試目標網站,再查看用戶端記錄是否出現對應連線,最後確認路由選擇是否符合預期。真實連線測試、TCPing 與實際網頁載入所檢查的環節不同,不應只憑單一測試數字判斷整條連線。切換網路、DNS 快取與目標網站狀態也可能影響結果。

若只有一個應用程式連線失敗,優先檢查該應用程式的代理選項與接管範圍;若所有應用程式都失敗,請檢查核心是否已啟動、是否已選取伺服器,以及本機連接埠是否正在監聽。需要全域代理時,也要分清「讓應用程式的流量進入代理」和「將已進入的連線交由代理出口傳送」:前者通常由系統代理或 TUN 決定,後者則由路由規則決定。詳細操作順序可參考入門指南;平台權限差異請查閱使用文件。

設定主題

匯入訂閱與首次安裝

依照遇到的問題繼續閱讀。尚未看到伺服器清單,先查看如何匯入訂閱;用戶端無法正常啟動,先查看首次安裝;已能連線,再了解節點測試與選擇。每次設定都先訂出明確的檢查目標,避免同時切換伺服器、代理模式與路由規則。