Windows
v2rayN 提供桌面版與傳統 WPF 版。桌面版採用跨平台介面,WPF 版則保留熟悉的 Windows 操作配置。初次安裝可先了解桌面版;已習慣既有操作方式的使用者,則可比較兩種介面的選單位置再決定。匯入訂閱的基本流程相同,不必為了更換介面重新申請訂閱。
安裝前請先確認系統架構並閱讀安裝說明。啟動後先更新訂閱,再選擇伺服器並設定系統代理。若關閉用戶端後瀏覽器仍顯示代理連線失敗,先確認系統代理是否已還原,不要直接認定是伺服器的問題。
前往下載從挑選開源用戶端開始,分別說明匯入訂閱與路由設定。
成功匯入設定,不代表瀏覽器已開始使用代理。先確認各設定項目負責的環節,再調整參數,能避免許多重複操作。
訂閱群組設定
別名:日常訂閱
網址:https://example.com/sub?token=xxxx
啟用更新:開啟
訂閱是一份可更新的伺服器設定清單,網址通常由服務提供者提供。將完整網址填入訂閱群組並儲存,再執行更新,用戶端才會讀取其中的設定。訂閱和單一伺服器的分享連結不同,也不是登入網頁的網址。更新失敗時,先確認連結是否完整、是否已過期,再檢查取得訂閱時使用的網路路徑。不要反覆刪除現有群組,也不要把含有個人權杖的網址貼到公開截圖。訂閱只負責取得設定,之後仍須另外設定系統代理與路由。
系統代理
○ 清除系統代理
● 自動設定系統代理
○ 不變更系統代理
系統代理會在作業系統中登記用戶端的本機代理入口,主要影響會讀取這項設定的應用程式。新手可以先選擇自動設定系統代理,再用瀏覽器測試基本連線。某個程式沒有變化,不一定是伺服器失效,也可能是它使用獨立的網路設定。TUN 則透過虛擬網路介面接收流量,涵蓋範圍和權限需求都不同。先讓一般系統代理正常運作,再判斷是否需要 TUN;同時啟用多個接管網路的工具,反而容易讓連線走錯入口。
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
路由會在連線進入用戶端後,決定要直連還是透過代理。上方規則表示將私有位址交由名為 direct 的出口處理,實際設定中也必須有對應的出口。用戶端的預設路由會把常見規則整理成選單,適合用來建立基本設定。分流異常時,請檢查規則順序、網域比對方式與規則資料檔,而不是只切換伺服器。系統代理負責將連線送進來,路由負責決定送往何處,兩者不能互相取代。
圖形介面 → 產生設定 → 代理核心
v2rayNG → Xray
v2flyNG → V2Fly
v2rayN → 依設定選擇支援的核心
用戶端介面負責管理設定,核心則負責實際處理協定與網路連線。名稱相似不代表功能完全相同,挑選時應確認伺服器要求的協定、傳輸方式與安全參數。例如設定使用 REALITY 時,須確認所用核心和用戶端匯入功能是否支援,不能只看有沒有 VLESS 選單。現有設定若能穩定運作,就不必只為了名稱更換核心。遇到不支援的欄位時,先查閱協定說明與用戶端更新紀錄,再決定更換用戶端或調整設定。
排查順序
本機入口 → DNS → 遠端連線 → 交握
記錄:操作時間、目標網域、錯誤原文
分享前:隱藏網址權杖與驗證資訊
記錄的用途是指出連線在哪個環節中斷,而不是替用戶端評分。先記下觸發故障的操作,再查看相近時間的錯誤訊息。連線遭拒、逾時與交握失敗可能有不同原因,不能套用同一組參數處理。每次只修改一項,並保留修改前的設定,測試後再比較結果。向他人求助時,提供用戶端名稱、系統類型及已去識別化的錯誤原文,比只說無法連線更有幫助,也能避免洩露訂閱與驗證資訊。
桌面平台可選 v2rayN,Android 則建議先了解 v2rayNG。下載前先確認作業系統與處理器架構,再挑選安裝套件;名稱相似的軟體,安裝套件不能跨平台使用。
v2rayN 提供桌面版與傳統 WPF 版。桌面版採用跨平台介面,WPF 版則保留熟悉的 Windows 操作配置。初次安裝可先了解桌面版;已習慣既有操作方式的使用者,則可比較兩種介面的選單位置再決定。匯入訂閱的基本流程相同,不必為了更換介面重新申請訂閱。
安裝前請先確認系統架構並閱讀安裝說明。啟動後先更新訂閱,再選擇伺服器並設定系統代理。若關閉用戶端後瀏覽器仍顯示代理連線失敗,先確認系統代理是否已還原,不要直接認定是伺服器的問題。
前往下載v2rayN 的 macOS 安裝套件分為 Apple Silicon 與 Intel 晶片版本。可以在系統的「關於本機」查看晶片或處理器資訊,再選擇相符的架構。下載安裝套件不代表系統一定允許應用程式啟動,首次開啟時也可能需要處理系統安全性提示。
系統代理與 TUN 所需的授權不同。先使用一般代理方式確認訂閱與伺服器可正常使用,再依需求授予額外的網路權限。若啟動遭到阻擋,請閱讀具體提示,依照系統設定中的允許流程操作,不要任意關閉整套安全防護。
前往下載v2rayNG 使用 Xray 核心,是本文優先推薦的 Android 選擇;v2flyNG 使用 V2Fly 核心,則是另一種設定方案。兩者都提供 arm64 與通用安裝套件,較新的主流裝置通常可先查看 arm64 版本;不確定架構時,再參考下載頁的選擇說明。
首次連線時出現系統 VPN 授權提示,是建立本機網路介面的步驟。允許後仍需選擇有效的伺服器設定。若鎖定螢幕後經常中斷,可檢查系統對背景執行與電池用量的限制;不要把手機的省電策略誤認為訂閱失效。
前往下載v2rayN 的 Linux 安裝套件依 deb、rpm 格式及處理器架構區分。先確認發行版使用哪種套件管理格式,再確認 x64 或 arm64。不要只因檔案能開啟就繼續安裝,套件格式、架構與桌面環境的相依項目都必須符合。
不同桌面環境讀取系統代理的方式可能不同,終端機程式也未必會沿用桌面代理設定。測試時先選擇一個確定會遵循代理設定的應用程式,再逐步檢查其他程式。若需要 TUN,請繼續參閱平台指南中的權限與網路接管說明。
前往下載用戶端本身不包含可用的遠端服務。開始前須準備有效的訂閱網址或分享連結,並確認適用於所選用戶端與核心。
在 v2rayN 中開啟訂閱群組設定,填入方便辨識的別名與完整訂閱網址,儲存後執行訂閱更新。在 v2rayNG 中,透過訂閱設定新增網址,再返回主畫面更新訂閱。貼上前後請留意空格、換行與內容是否遭截斷,尤其不要將服務提供者的管理頁面網址誤當成訂閱網址。
更新完成後,確認是否出現預期的伺服器設定。若清單仍是空的,先查看更新結果與記錄;若已有舊設定,請保留作為比對。訂閱權杖相當於存取設定的憑證,整理截圖或尋求協助時應隱藏完整網址,不要只遮住網域卻留下查詢參數。
桌面端先選擇要使用的伺服器,再將系統代理設為自動設定,並從內建路由預設開始。Android 端選好設定後點選連線,依系統提示允許建立 VPN 介面。選單名稱可能隨介面調整,但「選擇設定」和「讓應用程式連線進入用戶端」始終是兩件事;缺少後者時,瀏覽器可能仍會直接連線。
一開始不要同時啟用多種網路接管方式。系統代理適合先測試常見瀏覽器;TUN 則適合進一步處理不讀取系統代理設定的應用程式,但也會增加權限、DNS 與路由的排查難度。區域網路裝置無法正常連線時,也應先檢查略過區域網路的設定,而不是盲目更換協定。
先開啟一個日常使用、結果容易判斷的網頁,再測試目標應用程式。用戶端內建的連線測試只能反映該測試條件下的結果,不能保證所有網站與應用程式都能正常運作。有些網站可能有自己的存取限制,單一網頁無法開啟,不應直接推斷整份訂閱都無法使用。
發生異常時,記錄時間、應用程式與錯誤現象,再開啟記錄檢查同一時段的資訊。先確認用戶端仍在執行、本機入口正常,再檢查 DNS、遠端連線與交握。每次修改後重做相同測試,才能比較前後結果。完整步驟與平台差異請參閱教學;首頁僅保留最精簡的操作順序。
先分清專案、核心與圖形化用戶端,再比較協定支援。這些名稱彼此有歷史淵源,但並非同一套軟體的三種介面主題。
V2Ray 是 Project V 生態系中的核心專案,提供可設定的網路代理協定、傳輸與路由能力。使用者平常操作的圖形介面,通常是在這些能力之上提供伺服器管理、訂閱更新與設定入口。搜尋「V2Ray 用戶端」時,真正需要的往往是這類圖形化程式,而不是直接編輯核心設定檔。
分清這幾個層次很實用:介面中的選項可能影響用戶端行為,也可能轉換成核心設定。訂閱管理、視窗配置與系統代理開關主要屬於用戶端層;協定交握、出口連線與規則比對則由相應核心執行。遇到問題時先判斷屬於哪個層次,才能找到適用的文件,也能避免照著另一款用戶端的選單名稱搜尋。
V2Fly 社群延續 V2Ray 相關開發,Xray 則以相關程式碼為基礎,發展成另一條核心路線。兩者共用部分概念與設定習慣,但功能演進、協定細節和欄位支援並不同步。不能因為兩邊都支援 VLESS,就認為所有相關設定都能直接通用,更不能只憑檔名判斷相容性。
挑選核心時,應優先確認伺服器端的需求:使用哪種協定與傳輸方式、是否需要特定安全機制,以及用戶端能否完整匯入這些欄位。REALITY 等功能須逐項確認支援情況。若訂閱已提供適用用戶端的匯入方式,請優先依照相關設定說明;不確定的參數可先查詢協定與傳輸術語,不要只憑名稱猜測。
v2rayN 適用於桌面平台,提供訂閱管理、伺服器選擇及代理相關設定;v2rayNG 適用於 Android,使用 Xray 核心;v2flyNG 同樣適用於 Android,使用 V2Fly 核心。三者的原始碼皆依各自的開源授權提供,實際使用與再散布條件請以專案授權為準。開源代表程式碼及其授權條件公開,不代表遠端服務的品質有所保證。
用戶端可以免費取得,但訂閱背後的遠端服務是另一回事;服務提供者的帳戶、費用與可用範圍,不會因安裝用戶端而自動取得。也不應將訂閱網址交給無關網站代為解析。本網站提供用戶端下載與設定說明;閱讀教學時,請務必區分「工具如何運作」與「服務由誰提供」,兩者的更新與故障來源並不相同。
用戶端更新通常涉及介面、匯入邏輯與平台相容性;核心更新會影響協定實作和執行行為;GeoIP、GeoSite 資料檔更新則會改變部分路由規則所依賴的資料。更新訂閱只能取得服務提供者提供的設定,無法取代這三類更新。路由異常時反覆更新訂閱,通常不會更新已過期的規則資料。
調整前先保留可還原的設定紀錄,更新後再用原本的應用程式與網址重新測試。若新版介面變更了選單位置,請依功能名稱尋找,不必繼續比對舊截圖的位置。需要了解更多平台差異時,請參閱全平台指南;遇到明確錯誤時,先儲存已去識別化的錯誤原文,再依本機到遠端的順序排查。
完成基本連線後,再依實際問題繼續閱讀。以下三篇分別介紹如何尋找選單、處理首次啟動權限及維護分流資料,不必一次修改所有設定。
帶你逐區認識 v2rayN 主視窗,說明伺服器清單、訂閱群組、底部記錄、系統代理切換與參數設定各自的用途,新手看完就能找到常用功能。
說明 macOS 首次開啟 v2rayN 遭到阻擋時,如何在「隱私權與安全性」中允許開啟、授予網路與系統代理權限,以及 TUN 模式所需的額外授權。
說明 GeoIP、GeoSite 兩種資料檔在分流中的用途,示範如何在 v2rayN 與 v2rayNG 更新規則檔,並解釋 geosite:cn 這類寫法的意思。
查看所有文章 →