Windows
v2rayN · Desktop / WPF桌面版採用跨平台介面,經典 WPF 版則保留熟悉的操作配置。首次安裝可先選桌面版;使用經典版設定的使用者,可依介面習慣與相容性需求選擇。兩種介面都應先匯入訂閱,再設定系統代理與路由。
安裝前確認系統架構與執行需求。請使用獨立資料夾存放程式與設定,避免從暫存資料夾執行。更換介面或更新程式前,先透過客戶端匯出需要保留的設定,並確認本機連接埠未被其他軟體占用。
前往下載設定入口 / CLIENT CONTROLS
先區分應用程式入口、內核處理與遠端連線。訂閱管理用來整理伺服器參數,系統代理負責導入應用程式流量,路由規則則決定出口;分開檢查,才能找出連線問題。
訂閱網址用來批次取得伺服器設定,不等同於單一伺服器的分享連結。在「訂閱群組」中新增群組,填入名稱與網址並儲存,接著執行更新,再到該群組檢查清單。相較於逐筆手動輸入,訂閱可集中同步位址、連接埠與傳輸設定。更新失敗時,先確認網址仍有效,再檢查更新時使用直連或代理。訂閱網址可能包含存取憑證,請存放在可信任的位置;向他人展示介面時,隱藏完整網址,也不要傳送含有憑證的截圖。
訂閱群組 → 訂閱群組設定
新增群組 → 填入訂閱網址 → 儲存
更新訂閱 → 檢查伺服器清單
路由分流會在流量進入內核後生效,可依網域、目標 IP 或連接埠,選擇直連、代理等出口。先使用客戶端提供的預設,再依實際需求補上規則,比一次加入大量自訂項目更容易排查。規則通常依序比對,較具體的條件應排在較廣泛的條件之前。網域策略設為 IPIfNonMatch 時,只有網域規則未命中才會嘗試解析 IP 並繼續比對;這並非強制解析所有請求的開關。以下是規則欄位片段,出口標籤須與實際設定一致。
{
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}
]
}
自動設定系統代理會變更系統提供的代理入口,只有遵循此設定的應用程式才會將請求交給客戶端。這和路由中的全域或繞過中國大陸是不同選項:前者決定流量是否進入,後者決定進入後如何轉送。瀏覽器可以連線,其他軟體卻失敗時,先確認軟體是否讀取系統代理,或是否有獨立的代理設定。手動填寫代理時,請核對協定、本機位址與實際監聽連接埠,不要直接套用其他教學的連接埠。退出客戶端前請清除系統代理,避免留下失效入口。
系統代理:自動設定系統代理
本機位址:127.0.0.1
連接埠:以參數設定中的監聽連接埠為準
路由:個別選擇所需規則
TUN 模式透過虛擬網路介面導入流量,適合無法使用一般系統代理的應用程式。相較於修改單一軟體的代理設定,TUN 會牽涉系統路由、權限與 DNS;首次啟用前,建議先用系統代理確認伺服器可正常連線。桌面環境可能需要提高權限,實際行為取決於客戶端、內核與作業系統。啟用後若網域無法開啟或無法存取區域網路裝置,請分別檢查 DNS 與直連規則,並暫時停用其他會修改網路路由的軟體。請勿同時更換伺服器與整套路由,以免失去判斷依據。
先確認:使用系統代理可連線至目標網站
再啟用:TUN 模式與所需系統權限
最後檢查:DNS、區域網路存取、路由規則
圖形化客戶端負責編輯與管理設定,內核負責實際的協定處理、建立連線與執行路由。v2rayN 可管理不同內核,但可選項目與設定入口以目前安裝的客戶端為準。切換前先確認伺服器使用的協定、傳輸方式與安全參數,不能只憑協定名稱判斷相容性。設定包含 REALITY 或 XTLS Vision 時,應核對對應的 Xray 功能需求。切換後重新啟動連線並查看記錄;若不支援特定欄位,通常應調整內核或設定,而非反覆修改本機監聽連接埠。
客戶端:設定編輯與訂閱管理
內核:協定處理與流量轉送
選擇依據:協定 + 傳輸 + 安全參數
分享連結會將單一伺服器的連線參數編碼為文字,可透過客戶端的剪貼簿匯入功能新增。先複製完整連結,避免連同聊天文字、引號或換行一起複製,再執行匯入並檢查類型、位址、連接埠與傳輸層安全性。分享連結與訂閱不同,通常不會隨群組更新;伺服器參數變更時,必須重新匯入。VMess、VLESS、Trojan 與 Shadowsocks 的分享格式各不相同,部分擴充欄位也受內核支援範圍影響。匯入成功只代表解析通過,仍須實際測試連線,才能確認設定可用。
vmess://
vless://
trojan://
ss://
首次設定時,只保留一台可用伺服器與一組預設路由。確認瀏覽器能實際連線後,再調整分流、DNS 或 TUN。每次只變更一項設定,並記下變更前的值;發生異常時,就能還原至已驗證的狀態。
延遲測試、實際連線測試與下載速度測試衡量的項目不同。單一延遲數值無法證明目標網站、網域解析與應用程式代理設定都正常。比較伺服器時,請使用相同的測試方式並搭配實際連線結果,不要混用不同測試的排名。
客戶端選型 / PLATFORMS
桌面平台使用 v2rayN;Android 優先選擇 v2rayNG,需要 V2Fly 內核時再考慮 v2flyNG。先確認裝置架構與安裝套件格式,再查看對應下載入口。版本資訊統一列於下載頁的客戶端卡片中。
桌面版採用跨平台介面,經典 WPF 版則保留熟悉的操作配置。首次安裝可先選桌面版;使用經典版設定的使用者,可依介面習慣與相容性需求選擇。兩種介面都應先匯入訂閱,再設定系統代理與路由。
安裝前確認系統架構與執行需求。請使用獨立資料夾存放程式與設定,避免從暫存資料夾執行。更換介面或更新程式前,先透過客戶端匯出需要保留的設定,並確認本機連接埠未被其他軟體占用。
前往下載在系統的「關於這台 Mac」查看晶片資訊;Apple Silicon 請選 arm64,Intel 請選 x64。架構會影響程式能否正常執行,與訂閱使用 VMess 或 VLESS 無關,也不受伺服器所在地區影響。
首次啟動時,依系統提示處理應用程式權限。先確認一般代理連線正常,再視需要啟用需要額外權限的網路功能。若無法啟動,先確認安裝套件格式與晶片架構是否相符,再處理執行權限,避免把啟動問題誤判為訂閱故障。
前往下載v2rayNG 使用 Xray 內核,是 Android 的首選;v2flyNG 使用 V2Fly 內核,可作為有相容性需求時的替代方案。主流 arm64 裝置請選擇對應安裝入口;不確定架構時,可查看下載頁的通用版說明,不要只憑手機品牌判斷。
匯入後選擇伺服器,啟動連線時依系統提示授權 VPN 連線。持續執行也會受到電池最佳化與背景執行限制影響。切換到背景後若連線中斷,先檢查系統的背景執行設定,並確認沒有其他應用程式占用同一個 VPN 連線。
前往下載依發行版的套件管理系統選擇 deb 或 rpm,再確認 x64 或 arm64 架構。圖形化客戶端適用於桌面環境;安裝後仍須檢查桌面工作階段的代理設定。應用程式是否讀取系統代理,取決於其本身的實作與執行環境。
建議優先使用圖形化軟體安裝工具處理套件與相依項目。啟用 TUN 前,先檢查系統權限與現有網路管理工具,避免多組規則同時接管流量。一般代理可連線但 TUN 失敗時,先檢查本機權限與路由,不必急著更換訂閱。
前往下載初次設定 / QUICK START
客戶端與伺服器設定是兩個部分。安裝程式只完成本機工具的準備,建立連線還需要有效的伺服器參數。已有訂閱時,請依照以下順序操作;只有單筆分享連結時,從剪貼簿匯入後直接進行第二步。
開啟訂閱群組設定,新增群組並貼上完整網址,儲存後執行更新。檢查清單中是否出現伺服器,並確認類型、連接埠與安全設定皆已正確解析。訂閱網址用來取得設定,不可直接填入伺服器位址欄;從網頁複製時,留意前後空白與內容是否遭截斷。
更新失敗時,先判斷是網址無法連線、存取憑證過期,還是客戶端無法解析回傳內容。先保留現有設定,不要反覆刪除群組再重試。訂閱轉換會讓轉換服務接觸原始設定,只有確實需要轉換格式時才使用可信任的服務。
在伺服器清單中選擇一台作為使用中的伺服器。桌面端啟用自動設定系統代理,再選擇適合使用情境的路由預設;Android 端則啟動連線並完成系統授權。系統代理與全域路由屬於不同層次;選擇全域路由,不代表所有應用程式都會自動使用本機代理。
初次使用時,先維持其他參數不變。需要與區域網路共用時,再調整監聽位址與存取控制;只在本機使用則保留本機監聽。暫時不要同時啟用多種網路接管功能,先建立一個可重複驗證的基本連線。
進行實際連線測試,再從目標應用程式開啟需要存取的網站。分別檢查網域解析、連線建立與應用程式代理入口。延遲測試成功但網頁無法開啟時,應檢查 TLS 參數錯誤、DNS 異常,或應用程式是否繞過系統代理,而不是一再測速。
需要進一步排查時,記錄測試時間、所選伺服器與錯誤摘要。分享記錄前,請移除訂閱網址、使用者識別資訊與認證資料。連線恢復後,再逐項新增分流規則;日常退出前清除系統代理,避免應用程式繼續連往已關閉的監聽連接埠。
內核與客戶端 / OPEN SOURCE
V2Ray 不是某個固定介面的應用程式名稱。了解專案、內核與圖形化客戶端各自的分工,可減少選擇套件、匯入與更新時的混淆,也能判斷設定應在客戶端調整,還是需要伺服器端配合。
Project V 是以網路代理工具為核心的開源生態系,V2Ray 是其中的重要專案。V2Fly 社群延續 V2Ray 的開發與維護;Xray 則以相關技術為基礎,發展出獨立的內核路線。兩者背景相近,但協定擴充、設定欄位與功能演進並不完全一致,不能因名稱相似就認為所有設定都能互換。
VMess、VLESS、Trojan 與 Shadowsocks 是協定層面的選擇,REALITY 屬於安全機制,XTLS Vision 則涉及特定的流量控制與轉送處理。伺服器設定往往同時包含協定、傳輸、安全性與流量控制欄位。判斷是否可用時,須核對整組參數及內核支援情況,不能只看協定名稱就認定相容。
v2rayN、v2rayNG 與 v2flyNG 都是開源圖形化客戶端。客戶端提供伺服器清單、訂閱更新、設定編輯與啟動控制;內核則讀取產生的設定並建立連線。桌面端選擇 v2rayN,Android 端則依 Xray 或 V2Fly 的相容需求選擇客戶端;選擇時應考量功能需求與裝置環境,而不是把不同名稱當成服務等級。
開源表示可依照專案授權條款檢視、使用及修改相關程式碼。V2Fly 與 Xray 內核採用 MPL 2.0,圖形化客戶端也各有自己的授權條款與散布條件。開源特性有助於了解實作方式與社群協作,但不能取代對訂閱來源、伺服器權限、設定內容與裝置環境的判斷。客戶端本身不等於伺服器訂閱。
圖形介面更新可能涉及訂閱解析、操作版面與系統支援;內核更新則可能影響協定行為、路由與連線處理。兩類更新解決的問題不同。遇到新欄位無法辨識時,應先確認內核支援情況;介面無法開啟或選單操作異常時,則應優先檢查客戶端執行環境,不必先修改伺服器設定。
更新前匯出必要設定,並記錄目前的監聽連接埠、路由選擇與 DNS 設定。更新完成後,使用原有伺服器與目標應用程式重新測試,再逐項還原自訂設定。若連線行為有變化,優先比較相同設定在更新前後的結果。想要有系統地學習,可依完整手冊從核心概念、安裝與訂閱,逐章學到 TUN 與日常維護。
閱讀完整手冊設定筆記 / RECENT NOTES
從常見問題找到對應設定:安裝問題先檢查執行需求,連線問題先檢查入口與參數,選擇客戶端則比較平台與內核需求。以下三篇依發布日期由新到舊排列。
透過十個簡短問答,集中解答新手常遇到的疑問:訂閱為何更新失敗、如何看延遲測試結果、系統代理無效、瀏覽器無法開啟網頁等,並整理排查順序。
閱讀筆記涵蓋解壓縮位置、執行環境、首次啟動權限、內核切換與本機連接埠設定,整理 Windows 與 macOS 首次執行 v2rayN 時最容易卡關的環節。
閱讀筆記從平台、內核、訂閱管理、路由與 TUN 支援五個面向比較三款客戶端,並提供桌面平台首選 v2rayN、Android 在 v2rayNG 與 v2flyNG 之間如何選擇的建議。
閱讀筆記