設定管理 · 介面示意

先匯入設定,再啟用代理

客戶端負責管理設定並呼叫核心,不會自動提供伺服器或訂閱。請先準備可信來源提供的訂閱連結,再更新設定、選取項目,最後啟用適合目前平台的流量接入方式。

介面上的「更新訂閱」與「啟動服務」是兩個不同操作。前者取得遠端設定,後者則執行本機核心;更新成功不代表已建立連線。

訂閱群組路由設定系統代理
設定來源訂閱群組設定
匯入方式從剪貼簿匯入
訂閱操作更新目前訂閱
桌面流量接入自動設定系統代理

設定工作區

訂閱、路由與核心設定

先分清設定來源、規則判斷與流量入口,再調整個別參數。以下僅為設定項目示意,並非可操作的客戶端視窗;實際選單位置請以使用中的客戶端為準。

訂閱群組可將不同來源的設定分開管理。先在客戶端新增群組,填入方便辨識的備註與訂閱網址,儲存後執行更新,再從對應群組選取項目。群組備註僅供辨識,不會變更伺服器參數。與逐筆貼上設定相比,訂閱可在來源調整參數後集中更新,但也可能覆寫由遠端管理的欄位。需要長期保留的手動修改應另行備份;訂閱連結通常含有存取憑證,不宜放進公開截圖或交給線上轉換網站。

分層排查設定問題

訂閱可以更新,但網頁無法開啟時,通常應繼續確認流量是否進入本機客戶端,而不是立刻更換訂閱。先確認核心已成功啟動,再核對系統代理指向的本機連接埠,接著檢查路由與 DNS。每次只變更一個條件,並保留修改前的設定,才能確認是哪個步驟造成差異。多個客戶端同時接管系統代理、瀏覽器另設代理擴充功能,或其他程式占用監聽連接埠,都可能導致介面狀態與實際連線情況不一致。

遇到「全域代理」選項時,先確認它位於哪裡:系統代理的全域設定、客戶端路由的全域模式,以及 TUN 流量接入並不是同一個概念。前者影響應用程式如何進入代理,路由模式則決定進入後請求的去向。不確定術語含義時,請先查閱術語表;需要逐步操作時,再依照設定教學完成基本可用設定。

平台入口

V2Ray 客戶端平台下載

先確認作業系統,再確認處理器架構。桌面版統一查看 v2rayN,Android 版則依核心需求選擇 v2rayNG 或 v2flyNG。安裝檔下載入口集中在下載中心,首頁不顯示版本號。

Windows

優先推薦 v2rayN

v2rayN 提供桌面版與經典 WPF 版下載入口。桌面版採用跨平台介面,WPF 版則保留經典桌面操作方式;請依系統需求與使用習慣選擇,無須同時執行兩套客戶端。

安裝前請確認處理器架構與執行環境。使用免安裝版時,請將程式解壓縮至可寫入且路徑明確的資料夾,不要直接在壓縮檔內執行。首次測試先選擇系統代理,確認瀏覽器可以連線後,再考慮 TUN 與其他進階選項。

macOS

v2rayN

v2rayN 依 Apple Silicon 與 Intel 處理器分別提供下載入口。先透過「關於這台 Mac」確認晶片,再選擇相應安裝檔;處理器架構與訂閱協定是兩回事,更換安裝檔不會自動轉換設定。

安裝後依系統提示處理應用程式權限;啟用系統代理時,請確認目前網路服務的代理設定已同步。若只有部分應用程式無法連線,先檢查它是否會讀取系統代理;需要 TUN 時,再依教學確認權限與虛擬介面狀態。

Android

優先推薦 v2rayNG

v2rayNG 使用 Xray 核心,適合需要相應協定支援的設定;v2flyNG 使用 V2Fly 核心,可作為依設定需求選擇的替代方案。多數新型裝置可選 arm64;不確定架構時,請查看裝置資訊或選擇通用版。

首次啟動連線時,需確認系統 VPN 授權。系統通常只允許一個應用程式使用該 VPN 介面,測試前請停止其他同類連線。若切換至背景後中斷,請再檢查電池最佳化與背景執行限制,不要只是不斷匯入同一份訂閱。

Linux

v2rayN

v2rayN 提供 deb 與 rpm 套件,並區分 x64、arm64 架構。安裝套件格式取決於發行版的套件管理系統;處理器架構則取決於裝置,兩者都必須相符,不能只看副檔名判斷是否適用。

桌面環境、瀏覽器與應用程式讀取系統代理的方式可能不同。先用圖形客戶端完成訂閱與本機監聽設定,再檢查目標應用程式的代理設定入口。TUN 需要額外權限並配合網路環境;若已有虛擬網路介面,請逐項確認。

查看所有客戶端 →

流量入口 ≠ 路由規則

分兩層理解代理模式

應用程式先透過系統代理或虛擬介面將請求交給客戶端,核心再依路由規則決定連線去向。啟用 TUN 不代表所有請求都會經由遠端代理,啟用分流也不代表所有應用程式都會自動進入客戶端。

驗證時請選定一個明確目標,觀察記錄中是否出現對應請求。完全沒有請求記錄時,優先檢查流量入口;有記錄但連線失敗時,再檢查伺服器參數、解析結果與出站規則。是否記錄請求也取決於目前的記錄層級。

設定檢查順序
  1. 01
    應用程式流量系統代理 / TUN / VPN 模式
  2. 02
    核心路由網域規則 / 位址規則 / 預設出站
  3. 03
    連線去向直連 / 代理 / 封鎖

快速入門

從匯入訂閱到驗證連線

首次設定分成三個階段。先建立可用的基本設定,再加入規則、自動更新或 TUN 等選項。詳細選單位置與平台差異請參閱完整教學。

  1. 安裝客戶端並準備訂閱

    確認作業系統與架構後,安裝相應客戶端,並準備可信來源提供的訂閱連結或單筆設定。訂閱網址並非一般介紹頁網址,複製時請勿混入空格、換行或說明文字。若已有舊設定,請先匯出備份,並確認備份是否包含訂閱群組、路由與應用程式設定,避免將僅含節點的檔案誤當成完整移轉檔。

    客戶端可以管理設定,但無法代替設定提供者產生有效的伺服器參數。位址、連接埠、使用者識別碼與傳輸選項應來自同一份完整設定;請勿拼湊不同教學中的欄位使用。

  2. 匯入訂閱並選擇設定

    在訂閱管理中新增群組並儲存網址,執行更新後確認是否出現設定項目。單筆分享連結則使用客戶端的匯入功能。選擇要使用的項目後,再確認其協定與目前核心相容。更新失敗時,先確認訂閱網址是否仍有效,以及目前網路能否取得訂閱內容;不要立刻刪除所有設定。

    若無法辨識訂閱格式,請先向來源確認相容的輸出格式。轉換工具只能處理其支援的格式,無法補回缺少的參數,也無法提供核心尚未支援的協定功能。含有憑證的網址不宜交給來源不明的線上轉換服務。

  3. 啟用流量接入並逐項驗證

    桌面版先啟用系統代理,Android 版則確認 VPN 授權,再前往明確的測試目標。客戶端顯示正在執行,只代表本機服務已啟動;仍須檢查目標連線結果與記錄。發生問題時,依序檢查「核心啟動、本機連接埠、應用程式入口、DNS、路由、伺服器設定」,逐步縮小範圍,不要一次切換多組設定。

    測試結束後,使用客戶端提供的停止與清除系統代理功能離開。若瀏覽器仍指向已停止的本機連接埠,一般網頁也可能無法開啟。需要還原時,先確認系統網路設定,再決定是否重新啟動客戶端。

查看完整教學 →

Project V · V2Fly · Xray

開源生態系與客戶端分工

客戶端名稱、核心名稱與協定名稱各自屬於不同層次。選擇時先看平台,再確認設定所需的協定與核心能力,不必把所有名稱都當成不同的連線服務。

Project V 與核心家族

Project V 是以網路代理工具為核心的開源生態背景,V2Ray 是其中的重要專案。V2Fly 延續 V2Ray 相關開發,Xray 則在共同基礎上發展出自己的協定擴充與實作方向。兩條路線各自演進,名稱相近不代表設定欄位始終相同,也不宜簡化成「新版取代舊版」的關係。

對使用者而言,差異最終體現在具體功能:某份設定採用哪些協定、傳輸與安全機制,以及目前核心是否接受這些參數。以 REALITY 為例,請確認使用的 Xray 核心及客戶端支援匯入方式。若記錄提示未知協定或欄位,應先確認相容性,而不是將問題歸因於網路不穩。更詳細的差異請參閱選型指南。

三款圖形客戶端的分工

v2rayN 面向桌面環境,將設定清單、訂閱群組、路由與系統代理入口集中在圖形介面中。v2rayNG 面向 Android,使用 Xray 核心,並透過系統 VPN 介面接收應用程式流量。v2flyNG 同樣面向 Android,提供採用 V2Fly 核心的選擇。三者都是開源客戶端,但介面配置、選單名稱與設定備份格式不一定能直接互通。

桌面優先選擇 v2rayN,是因為本頁的桌面教學以它為主;Android 則建議先查看 v2rayNG,再依核心需求考慮 v2flyNG。選用替代客戶端應有明確理由,例如既有設定需要相應的核心行為,而不是同時啟動多個客戶端以求疊加效果。多個代理入口同時爭用系統代理設定或 VPN 介面,反而會增加排查變數。

分清開源授權與設定來源

開源表示專案程式碼依照相應授權條款提供檢視、使用或再散布的條件;具體權利義務應以各專案附帶的授權條款為準。客戶端介面、核心與附加元件可能採用不同授權;單一元件的授權不能直接代表整個發行套件的授權說明。使用開源客戶端也不代表自動取得訂閱或伺服器服務。

訂閱提供者負責提供設定內容,客戶端負責讀取與執行,網站文件則負責說明操作與概念,三者的職責應分開理解。含有使用者識別碼的訂閱連結、QR Code 與匯出檔案,都應視為敏感設定妥善保存。排查時若要分享記錄,只保留必要的錯誤資訊,並先移除伺服器位址、使用者識別碼與訂閱憑證,避免將完整存取資料貼到公開討論區。

更新客戶端,也留意核心變更

客戶端更新可能調整介面、設定產生方式或系統整合;核心更新則可能改變協定支援與參數處理。升級前請記錄目前可用的模式並備份設定,升級後先用原有設定測試;確認基本功能正常後,再嘗試新增功能。若出現異常,比較啟動記錄與設定變化,通常比反覆重新安裝更容易找出原因。

更新訂閱、更新規則資料與更新程式是不同操作。更新訂閱會刷新遠端設定;更新規則資料會影響比對範圍;更新程式則會替換客戶端或相關執行元件。下載入口集中在下載中心;安裝、移轉與平台專屬問題則集中於全平台安裝與設定指南。遇到已有明確症狀的問題,也可先查看常見問題再決定下一步。

設定文章

安裝流程與核心原理

先完成基本設定,再閱讀與目前問題相關的專題。平台教學說明安裝與設定順序,核心比較協助判斷相容性,原理文章則用來理解進階選項的作用範圍。

查看所有文章 →

v2rayN下載