Windows
v2rayN · 桌面版 / 經典 WPF 版
桌面版採用跨平台介面,經典 WPF 版則保留熟悉的操作配置。首次安裝前,先確認作業系統與處理器需求,再選擇介面版本;請勿同時啟動兩套用戶端並監聽相同的本機連接埠。
使用系統代理時,瀏覽器通常會讀取系統設定,但終端與部分開發工具可能需要另外指定代理。若結束用戶端後網頁仍無法瀏覽,請檢查系統代理是否已清除,不必反覆重新安裝。
前往下載CONFIGURATION / 設定入口
先釐清訂閱、流量入口與出站規則,再調整個別參數。選擇右側的設定主題,左側示意畫面會同步標示相關位置;示意圖僅說明設定關係,實際選單請以使用中的用戶端介面為準。
介面示意,並非目前連線狀態。請先匯入訂閱,再確認代理與路由設定。
訂閱網址用於集中取得節點設定,群組則可分開管理不同來源。在 v2rayN 中新增訂閱群組,填入名稱與網址並儲存,接著更新該群組,再從清單選擇要使用的節點。v2rayNG 也應先新增訂閱,再執行更新。更新既有群組和重複新增是兩回事;若節點重複出現,請先確認群組來源。訂閱連結可能含有存取憑證,請勿公開貼在截圖或輸入不明的轉換網站。圖形用戶端會解析設定,但有連結不代表已成功連線。
了解更多系統代理決定應用程式是否將連線交給本機用戶端;路由模式則決定用戶端收到連線後如何選擇出站,兩者不可混為一談。桌面端可先選擇「自動設定系統代理」,再用瀏覽器測試。結束用戶端前,可清除系統代理設定,避免應用程式繼續連到已關閉的本機連接埠。部分終端工具與內建代理設定的應用程式不會讀取系統設定,需個別設定。若瀏覽器可用、命令列卻失敗,請先檢查流量入口,不要立刻更換節點或啟用全面接管。
了解更多路由分流會依網域、目的位址等條件比對連線,再交由代理、直連或阻擋的出站處理。初次設定可從用戶端內建規則開始,例如「繞過中國大陸」,再依據記錄少量新增自訂規則。規則通常由上而下比對,特定網域的例外應排在較廣泛的規則之前。網域策略與 DNS 解析會影響位址比對結果,不能只看規則名稱判斷流量去向。分流不只是切換單一代理開關,還需要理解流量入口、比對條件與出站標籤;修改後請逐項測試。
了解更多TUN 模式透過虛擬網路介面處理流量,適合不遵循系統代理設定的應用程式;實際接管範圍仍會受到路由、權限與應用程式排除設定影響。建議先確認一般代理連線正常,再開啟 TUN,並依畫面提示授予必要權限。若同時使用其他網路工具,請檢查預設路由、DNS 接管及虛擬網卡是否衝突。啟用 TUN 不代表所有連線都會走代理,分流規則仍可指定直連。排除問題時,先關閉 TUN 比較結果、保留區域網路連線,並記下原有網路設定以便還原。
了解更多用戶端提供圖形介面,核心負責連線與路由;介面能匯入某種連結,不代表目前使用的核心支援所有參數。v2rayNG 使用 Xray 核心;v2flyNG 則是 Android 上採用 V2Fly 核心的另一種選擇。v2rayN 支援哪些功能,需依所選核心判斷。VMess、VLESS、Trojan 是協定名稱;REALITY 則屬於安全層相關設定,不能任意視為同一層級並互相替換。若遇到欄位不支援或啟動失敗,請先核對節點所需的協定、傳輸與安全層組合,再查看核心輸出。
了解更多CLIENTS / 平台選擇
桌面裝置可優先查看 v2rayN,Android 裝置則可先看 v2rayNG。安裝檔須符合作業系統、處理器架構及封裝格式;請勿將手機節點設定、桌面安裝檔與核心檔案混為一談。
v2rayN · 桌面版 / 經典 WPF 版
桌面版採用跨平台介面,經典 WPF 版則保留熟悉的操作配置。首次安裝前,先確認作業系統與處理器需求,再選擇介面版本;請勿同時啟動兩套用戶端並監聽相同的本機連接埠。
使用系統代理時,瀏覽器通常會讀取系統設定,但終端與部分開發工具可能需要另外指定代理。若結束用戶端後網頁仍無法瀏覽,請檢查系統代理是否已清除,不必反覆重新安裝。
前往下載v2rayN · Apple Silicon / Intel
在系統「關於這台 Mac」中確認晶片類型。Apple Silicon 對應 arm64,Intel 對應 x64;下載頁會分別列出兩種版本。安裝後先啟動用戶端,再依系統提示處理應用程式的執行權限。
系統代理與 TUN 所需權限不同。初次使用時,先確認系統代理可正常運作;確定有應用程式無法接入後,再考慮使用 TUN。切換有線、無線網路或其他網路工具後,重新檢查代理狀態與路由,比重複匯入訂閱更能找出問題。
前往下載優先選擇 v2rayNG · v2flyNG 為備選
v2rayNG 使用 Xray 核心,適合透過訂閱管理節點;v2flyNG 則提供另一種採用 V2Fly 核心的選擇。多數較新的裝置可先查看 arm64 安裝檔;若不確定裝置架構,再確認通用版說明。
匯入後選擇節點、啟動連線,並確認系統顯示的 VPN 權限提示。出現連線圖示只代表服務已建立,不表示所有目標都能存取;還需要確認節點、DNS 與分流設定。若背景執行中斷,請檢查電池限制,不要以重複新增訂閱取代權限檢查。
前往下載v2rayN · deb / rpm
依發行版的套件管理系統選擇 deb 或 rpm,再確認 x64 或 arm64 架構。本文介紹圖形用戶端的日常設定,不混用桌面啟動方式與系統層級背景服務,以免產生重複程序或連接埠衝突。
桌面環境的代理設定不一定會套用到所有應用程式。請分別測試終端、套件管理工具與瀏覽器;TUN 也涉及網路權限及路由。遇到問題時先保留原有網路設定,使用系統代理確認基本連線,再逐步擴大流量接管範圍。
前往下載QUICK START / 設定順序
每次只調整一個環節。先讓用戶端取得可用設定,再決定哪些應用程式要接入,最後確認規則是否符合預期。以下三個步驟適合初次設定,也適合換新裝置後重新建立基本環境。
安裝並開啟用戶端後,先準備好訂閱網址。在 v2rayN 的訂閱群組設定中新增群組,填入方便辨識的名稱與網址,儲存後執行更新;v2rayNG 則從訂閱相關選單新增網址,再更新該訂閱。名稱僅供本機管理,不能取代完整網址。教學範例 https://example.com/sub?token=xxxx 並非可用訂閱,無須照著填寫。
更新完成後,確認節點清單是否顯示協定、位址與連接埠等資訊。若清單空白,先查看更新結果,並確認網址是否完整、是否已失效,以及目前網路能否連上訂閱網址。請勿連續新增相同網址,以免產生重複群組。若訂閱含有個人存取憑證,分享截圖前請遮蔽完整連結;安裝用戶端與訂閱服務是兩個獨立環節,安裝軟體不會自動產生可用節點。
從已匯入的清單選擇一個節點,再設定應用程式如何將流量交給用戶端。桌面端可先選擇「自動設定系統代理」;Android 裝置啟動連線時,請依系統提示允許 VPN 服務。接著選擇既有的路由方案,先了解直連、代理與阻擋的差異,不必一開始就同時修改 DNS、自訂規則和 TUN。選單名稱可能因介面版本而異,但「選節點、接入流量、決定出站」的順序不變。
系統代理無法統一接管所有程式。瀏覽器擴充功能、開發工具的獨立代理設定及終端環境變數,都可能覆蓋或略過系統設定。若只有特定應用程式失敗,先檢查該應用程式的流量入口。確實需要處理不遵循系統代理的程式時,再閱讀 TUN 章節並確認權限。全域路由與 TUN 也不是同一回事:前者影響出站選擇,後者主要負責讓流量進入用戶端。
啟動後開啟要存取的目標,查看用戶端連線記錄是否出現相應請求。再前往預期應直連的目標,確認路由結果;若涉及區域網路裝置,也要測試本機位址是否仍可存取。連線成功、訂閱更新成功與目標網頁可用是三種不同結果,不能互相取代。每次測試盡量保持節點和規則不變,避免同時改動多個變數而無法判斷原因。
若連線失敗,依序檢查核心是否啟動、本機監聽連接埠是否可用、請求是否進入用戶端,以及最後套用哪個出站。逾時可能發生在遠端連線;若網域解析失敗,應優先檢查 DNS;若核心立即結束,先查看啟動輸出。記錄錯誤訊息時,請隱藏訂閱、認證欄位及個人位址。確認連線正常後,再逐項新增分流例外,並保留一份可還原的設定,日後更新也能沿用相同的排查順序。
PROJECT V / 開源生態系
圖形用戶端、連線核心與節點協定各屬不同層級。了解彼此的關係,才能判斷需要更新的是介面、核心還是遠端設定。
生態系關係 · 非執行狀態
開源網路工具生態系
用戶端管理設定,核心負責連線。支援範圍以實際選用的核心及參數組合為準。
查看專案介紹 →Project V 是由網路代理工具及相關元件構成的開源生態系,V2Ray 是其中廣泛使用的核心專案。V2Fly 延續 V2Ray 的發展方向,由社群持續維護;Xray 則以相關程式碼為基礎,發展出另一條核心路線。它們共享部分概念與設定習慣,但支援的功能和參數並不完全相同。閱讀舊教學時,請先確認文章討論的是哪一種核心,不能只憑「V2Ray」這個統稱套用所有設定。
節點能否使用,取決於用戶端是否能正確產生設定、核心是否能解析相關欄位,以及遠端服務是否採用相同的協定組合。成功匯入連結只代表完成部分解析程序。遇到 REALITY、安全層或傳輸設定錯誤時,請先確認核心支援情況與遠端參數;盲目切換介面主題或反覆更新訂閱,通常無法解決協定層不相容的問題。
v2rayN 適用於桌面環境,可管理節點清單、訂閱群組、系統代理與路由,桌面裝置可優先從它開始。v2rayNG 適用於 Android,採用 Xray 核心,可匯入節點並管理連線;v2flyNG 同樣適用於 Android,是採用 V2Fly 核心的另一種選擇。請依裝置與節點需求選擇,不必將三款應用程式都安裝在同一台裝置上。
用戶端名稱相近,不代表選單、權限或備份格式完全一致。更換裝置時,先確認訂閱來源仍可使用,再重新設定用戶端;路由例外、應用程式排除項目與 DNS 選項也要個別確認。桌面端與 Android 的流量入口不同,不能直接將系統代理的操作步驟套用到手機。本文將下載選擇與設定教學分開整理,方便依操作流程查找所需說明。
v2rayN、v2rayNG 和 v2flyNG 都是開源用戶端,公開程式碼方便社群檢視、討論並持續改進。開源授權規範程式碼的使用、修改與散布條件;不同專案及所包含的元件可能採用不同授權,重新散布前應分別閱讀相關聲明。開源描述的是軟體協作方式,不代表任何節點服務的品質或資料處理方式,也不能取代對訂閱來源的判斷。
用戶端負責本機設定與連線,訂閱來源提供節點參數,遠端服務則負責實際轉送。三者的維護者與更新週期可能不同。回報問題時,請區分「軟體無法啟動」、「訂閱無法更新」與「特定節點無法連線」,才能找出問題所在。本站提供用戶端選擇與設定文件,不提供訂閱網址;閱讀教學時,請使用既有且有權使用的設定,並遵守所在地適用法規。
更新訂閱會變更群組中的節點設定;更新用戶端會變更介面與整合功能;更新核心則可能影響協定支援及設定欄位。這三種更新不可混為一談。日常維護時,先保留可還原的設定,再閱讀更新說明,確認所用核心、路由資源與現有節點是否相容。重要設定變更後,請重新確認「請求是否進入用戶端、是否套用預期規則、目標是否實際可達」這三件事。
長期使用時,定期清除失效群組與重複節點,並註明自訂規則的用途。排查問題時可暫時提高記錄詳細程度,但不應公開含有存取目標或憑證的記錄。更新後若出現異常,先比對啟動輸出與設定差異,避免同時調整多項網路選項。基本概念、安裝、訂閱、分流、TUN 與維護的完整步驟,可依章節閱讀完整手冊。
閱讀從入門到精通的完整手冊 →READING / 設定與排查
完成基本連線後,再依實際問題深入閱讀。以下三篇依序介紹自訂規則、系統代理入口與記錄排查,協助你從「連得上」進一步了解「每次連線的流量去向」。
說明 domain 的 full/domain/keyword/regexp 前綴、ip 與 geoip 寫法、geosite 分類引用,以及規則由上而下比對的順序和 domainStrategy 的影響。
閱讀規則語法 →系統代理已啟用,但網頁或命令列仍直接連線?分別檢查瀏覽器擴充功能與系統設定、終端 http_proxy 環境變數,並說明各平台查看目前代理狀態的方法。
檢查代理入口 →說明各級 loglevel 的用途,逐一解析連線逾時、握手失敗、DNS 解析失敗等常見記錄,並提供從記錄反推問題環節的排查方法。
查看記錄說明 →