Windows
優先推薦 v2rayNv2rayN 提供桌面版與經典 WPF 版下載入口。桌面版採用跨平台介面,WPF 版則保留經典桌面操作方式;請依系統需求與使用習慣選擇,無須同時執行兩套客戶端。
安裝前請確認處理器架構與執行環境。使用免安裝版時,請將程式解壓縮至可寫入且路徑明確的資料夾,不要直接在壓縮檔內執行。首次測試先選擇系統代理,確認瀏覽器可以連線後,再考慮 TUN 與其他進階選項。
桌面使用 v2rayN,Android 可選 v2rayNG / v2flyNG;從下載到匯入訂閱與設定路由,依步驟完成。
設定管理 · 介面示意
客戶端負責管理設定並呼叫核心,不會自動提供伺服器或訂閱。請先準備可信來源提供的訂閱連結,再更新設定、選取項目,最後啟用適合目前平台的流量接入方式。
介面上的「更新訂閱」與「啟動服務」是兩個不同操作。前者取得遠端設定,後者則執行本機核心;更新成功不代表已建立連線。
設定工作區
先分清設定來源、規則判斷與流量入口,再調整個別參數。以下僅為設定項目示意,並非可操作的客戶端視窗;實際選單位置請以使用中的客戶端為準。
訂閱群組可將不同來源的設定分開管理。先在客戶端新增群組,填入方便辨識的備註與訂閱網址,儲存後執行更新,再從對應群組選取項目。群組備註僅供辨識,不會變更伺服器參數。與逐筆貼上設定相比,訂閱可在來源調整參數後集中更新,但也可能覆寫由遠端管理的欄位。需要長期保留的手動修改應另行備份;訂閱連結通常含有存取憑證,不宜放進公開截圖或交給線上轉換網站。
路由規則決定連線請求要直接連線、走代理或封鎖,但不負責將應用程式流量送進客戶端。一般可先保留客戶端預設設定,再依網域或位址新增少量明確規則。多條規則同時符合時,優先順序與排列方式會影響結果,應先了解目前核心的比對方式。相較於將所有請求一律交由代理,分流能保留區域網路服務的正常存取,也更容易找出個別網站異常的原因。修改後請以相同目標重新測試,並留意 DNS 解析出的位址是否改變比對結果。
系統代理適合會讀取系統代理設定的瀏覽器與桌面應用程式;不遵循此設定的程式仍可能直接連線。TUN 透過虛擬網路介面接收流量,涵蓋範圍較廣,但需要平台權限,也可能與其他虛擬網卡或網路工具衝突。初次設定時先用系統代理驗證,再依應用程式需求嘗試 TUN,不必把兩個開關都視為必要選項。Android 客戶端通常透過系統 VPN 授權建立連線。無論採用哪種入口,最後的直連與代理行為仍由路由規則決定。
核心負責解析設定並建立實際連線,圖形客戶端則提供匯入、選取與執行入口。Xray 與 V2Fly 有共同的生態背景,但支援的協定擴充與設定欄位並不完全相同。需要 REALITY 的設定,應確認使用支援此功能的 Xray 核心;不要只憑客戶端名稱判斷相容性。桌面版可在客戶端支援時選擇對應核心,Android 版則可依此選擇 v2rayNG 或 v2flyNG。切換後先檢查啟動記錄;若出現未知欄位,請核對設定來源與核心需求,而非反覆重新安裝。
訂閱可以更新,但網頁無法開啟時,通常應繼續確認流量是否進入本機客戶端,而不是立刻更換訂閱。先確認核心已成功啟動,再核對系統代理指向的本機連接埠,接著檢查路由與 DNS。每次只變更一個條件,並保留修改前的設定,才能確認是哪個步驟造成差異。多個客戶端同時接管系統代理、瀏覽器另設代理擴充功能,或其他程式占用監聽連接埠,都可能導致介面狀態與實際連線情況不一致。
遇到「全域代理」選項時,先確認它位於哪裡:系統代理的全域設定、客戶端路由的全域模式,以及 TUN 流量接入並不是同一個概念。前者影響應用程式如何進入代理,路由模式則決定進入後請求的去向。不確定術語含義時,請先查閱術語表;需要逐步操作時,再依照設定教學完成基本可用設定。
平台入口
先確認作業系統,再確認處理器架構。桌面版統一查看 v2rayN,Android 版則依核心需求選擇 v2rayNG 或 v2flyNG。安裝檔下載入口集中在下載中心,首頁不顯示版本號。
v2rayN 提供桌面版與經典 WPF 版下載入口。桌面版採用跨平台介面,WPF 版則保留經典桌面操作方式;請依系統需求與使用習慣選擇,無須同時執行兩套客戶端。
安裝前請確認處理器架構與執行環境。使用免安裝版時,請將程式解壓縮至可寫入且路徑明確的資料夾,不要直接在壓縮檔內執行。首次測試先選擇系統代理,確認瀏覽器可以連線後,再考慮 TUN 與其他進階選項。
v2rayN 依 Apple Silicon 與 Intel 處理器分別提供下載入口。先透過「關於這台 Mac」確認晶片,再選擇相應安裝檔;處理器架構與訂閱協定是兩回事,更換安裝檔不會自動轉換設定。
安裝後依系統提示處理應用程式權限;啟用系統代理時,請確認目前網路服務的代理設定已同步。若只有部分應用程式無法連線,先檢查它是否會讀取系統代理;需要 TUN 時,再依教學確認權限與虛擬介面狀態。
v2rayNG 使用 Xray 核心,適合需要相應協定支援的設定;v2flyNG 使用 V2Fly 核心,可作為依設定需求選擇的替代方案。多數新型裝置可選 arm64;不確定架構時,請查看裝置資訊或選擇通用版。
首次啟動連線時,需確認系統 VPN 授權。系統通常只允許一個應用程式使用該 VPN 介面,測試前請停止其他同類連線。若切換至背景後中斷,請再檢查電池最佳化與背景執行限制,不要只是不斷匯入同一份訂閱。
v2rayN 提供 deb 與 rpm 套件,並區分 x64、arm64 架構。安裝套件格式取決於發行版的套件管理系統;處理器架構則取決於裝置,兩者都必須相符,不能只看副檔名判斷是否適用。
桌面環境、瀏覽器與應用程式讀取系統代理的方式可能不同。先用圖形客戶端完成訂閱與本機監聽設定,再檢查目標應用程式的代理設定入口。TUN 需要額外權限並配合網路環境;若已有虛擬網路介面,請逐項確認。
流量入口 ≠ 路由規則
應用程式先透過系統代理或虛擬介面將請求交給客戶端,核心再依路由規則決定連線去向。啟用 TUN 不代表所有請求都會經由遠端代理,啟用分流也不代表所有應用程式都會自動進入客戶端。
驗證時請選定一個明確目標,觀察記錄中是否出現對應請求。完全沒有請求記錄時,優先檢查流量入口;有記錄但連線失敗時,再檢查伺服器參數、解析結果與出站規則。是否記錄請求也取決於目前的記錄層級。
快速入門
首次設定分成三個階段。先建立可用的基本設定,再加入規則、自動更新或 TUN 等選項。詳細選單位置與平台差異請參閱完整教學。
確認作業系統與架構後,安裝相應客戶端,並準備可信來源提供的訂閱連結或單筆設定。訂閱網址並非一般介紹頁網址,複製時請勿混入空格、換行或說明文字。若已有舊設定,請先匯出備份,並確認備份是否包含訂閱群組、路由與應用程式設定,避免將僅含節點的檔案誤當成完整移轉檔。
客戶端可以管理設定,但無法代替設定提供者產生有效的伺服器參數。位址、連接埠、使用者識別碼與傳輸選項應來自同一份完整設定;請勿拼湊不同教學中的欄位使用。
在訂閱管理中新增群組並儲存網址,執行更新後確認是否出現設定項目。單筆分享連結則使用客戶端的匯入功能。選擇要使用的項目後,再確認其協定與目前核心相容。更新失敗時,先確認訂閱網址是否仍有效,以及目前網路能否取得訂閱內容;不要立刻刪除所有設定。
若無法辨識訂閱格式,請先向來源確認相容的輸出格式。轉換工具只能處理其支援的格式,無法補回缺少的參數,也無法提供核心尚未支援的協定功能。含有憑證的網址不宜交給來源不明的線上轉換服務。
桌面版先啟用系統代理,Android 版則確認 VPN 授權,再前往明確的測試目標。客戶端顯示正在執行,只代表本機服務已啟動;仍須檢查目標連線結果與記錄。發生問題時,依序檢查「核心啟動、本機連接埠、應用程式入口、DNS、路由、伺服器設定」,逐步縮小範圍,不要一次切換多組設定。
測試結束後,使用客戶端提供的停止與清除系統代理功能離開。若瀏覽器仍指向已停止的本機連接埠,一般網頁也可能無法開啟。需要還原時,先確認系統網路設定,再決定是否重新啟動客戶端。
Project V · V2Fly · Xray
客戶端名稱、核心名稱與協定名稱各自屬於不同層次。選擇時先看平台,再確認設定所需的協定與核心能力,不必把所有名稱都當成不同的連線服務。
Project V 是以網路代理工具為核心的開源生態背景,V2Ray 是其中的重要專案。V2Fly 延續 V2Ray 相關開發,Xray 則在共同基礎上發展出自己的協定擴充與實作方向。兩條路線各自演進,名稱相近不代表設定欄位始終相同,也不宜簡化成「新版取代舊版」的關係。
對使用者而言,差異最終體現在具體功能:某份設定採用哪些協定、傳輸與安全機制,以及目前核心是否接受這些參數。以 REALITY 為例,請確認使用的 Xray 核心及客戶端支援匯入方式。若記錄提示未知協定或欄位,應先確認相容性,而不是將問題歸因於網路不穩。更詳細的差異請參閱選型指南。
v2rayN 面向桌面環境,將設定清單、訂閱群組、路由與系統代理入口集中在圖形介面中。v2rayNG 面向 Android,使用 Xray 核心,並透過系統 VPN 介面接收應用程式流量。v2flyNG 同樣面向 Android,提供採用 V2Fly 核心的選擇。三者都是開源客戶端,但介面配置、選單名稱與設定備份格式不一定能直接互通。
桌面優先選擇 v2rayN,是因為本頁的桌面教學以它為主;Android 則建議先查看 v2rayNG,再依核心需求考慮 v2flyNG。選用替代客戶端應有明確理由,例如既有設定需要相應的核心行為,而不是同時啟動多個客戶端以求疊加效果。多個代理入口同時爭用系統代理設定或 VPN 介面,反而會增加排查變數。
開源表示專案程式碼依照相應授權條款提供檢視、使用或再散布的條件;具體權利義務應以各專案附帶的授權條款為準。客戶端介面、核心與附加元件可能採用不同授權;單一元件的授權不能直接代表整個發行套件的授權說明。使用開源客戶端也不代表自動取得訂閱或伺服器服務。
訂閱提供者負責提供設定內容,客戶端負責讀取與執行,網站文件則負責說明操作與概念,三者的職責應分開理解。含有使用者識別碼的訂閱連結、QR Code 與匯出檔案,都應視為敏感設定妥善保存。排查時若要分享記錄,只保留必要的錯誤資訊,並先移除伺服器位址、使用者識別碼與訂閱憑證,避免將完整存取資料貼到公開討論區。
客戶端更新可能調整介面、設定產生方式或系統整合;核心更新則可能改變協定支援與參數處理。升級前請記錄目前可用的模式並備份設定,升級後先用原有設定測試;確認基本功能正常後,再嘗試新增功能。若出現異常,比較啟動記錄與設定變化,通常比反覆重新安裝更容易找出原因。
更新訂閱、更新規則資料與更新程式是不同操作。更新訂閱會刷新遠端設定;更新規則資料會影響比對範圍;更新程式則會替換客戶端或相關執行元件。下載入口集中在下載中心;安裝、移轉與平台專屬問題則集中於全平台安裝與設定指南。遇到已有明確症狀的問題,也可先查看常見問題再決定下一步。
設定文章
先完成基本設定,再閱讀與目前問題相關的專題。平台教學說明安裝與設定順序,核心比較協助判斷相容性,原理文章則用來理解進階選項的作用範圍。
說明 v2rayN 桌面版與 WPF 版的差異及選擇方式,涵蓋解壓縮路徑、執行階段、匯入訂閱、系統代理與 TUN 設定,以及 Windows 常見錯誤。
閱讀安裝流程 →整理 Project V 生態系中 V2Fly 與 Xray 分歧的由來,比較 VLESS、REALITY 等協定支援差異,並說明 v2rayNG 與 v2flyNG 各自適合哪些使用情境。
閱讀核心比較 →從 DNS 查詢遭攔截並回傳虛擬 IP 談起,說明 FakeDNS 如何搭配網域分流與 TUN 模式運作,以及哪些情況不適合啟用。
閱讀 FakeDNS 原理 →