INPUT
訂閱統一匯入群組
將訂閱網址儲存至群組後再執行更新，客戶端會讀取設定並重建伺服器清單。多個來源可分組管理，更新與篩選互不混雜。
Xray 核心客戶端指南
下載與設定入口
Xray官網 v2rayN 下載與路由分流
依作業系統選擇圖形化客戶端，依序完成訂閱匯入、系統代理與路由分流。頁面也會說明 Xray、V2Fly 核心與客戶端之間的關係。
Xray-core
永久免費
開放原始碼
中文操作文件
CONFIGURATION FLOW
一份設定流向四個平台
客戶端介面各異，但核心操作順序一致：選擇適合作業系統的程式，匯入有效訂閱，確認代理接管範圍，再透過路由規則決定各類連線的出站方向。
CORE
Xray 與 V2Fly 核心
圖形化客戶端負責匯入、選擇與狀態控制，核心負責協定處理、DNS、入站、出站與路由比對，兩層職責清楚分離。
OUTPUT
規則決定連線出口
路由依序比對網域、IP 與程序等條件，符合後交由 direct、proxy 或 block 出站處理。
SUBSCRIPTION
先儲存網址，再更新清單
訂閱匯入不是把網頁網址直接當成伺服器連線。客戶端會先儲存訂閱 URL，再要求其中的設定內容，解析完成後才會產生可選取的伺服器項目。首次操作應確認網址首尾完整，並將不同來源放入對應群組。儲存後執行「更新訂閱」，看到清單重新整理才代表匯入階段完成。之後更新設定時繼續使用相同入口，不必逐一重新新增。
若更新後清單仍為空白，應先檢查系統時間、網路連線與訂閱有效期限，再查看客戶端日誌中的要求結果。如此可分開釐清網址、網路與解析問題。
訂閱群組
└─ 預設群組
├─ 新增訂閱
├─ 更新訂閱
└─ 篩選伺服器
URL 結構：
https://example.invalid/sub?token=xxxxROUTING
規則由上而下比對
路由分流處理的是「哪一類連線使用哪個出口」。客戶端將網域或 IP 交給規則清單，核心依排列順序檢查條件，符合後選擇 direct、proxy 或 block。常見做法是先處理私有位址與明確的網域集合，再安排預設規則。順序錯誤會讓寬泛條件提前攔截連線，因此修改後應同時檢查規則位置與目標出站，而不只是查看規則內容。
內建方案適合快速開始，自訂方案則適合需要固定網域、程序或連接埠策略的情境。每次新增規則後只驗證相關連線，有助於找出是哪項條件改變了結果。
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
},
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}SYSTEM PROXY
讓支援系統代理的程式接入
系統代理適合瀏覽器及遵循作業系統代理設定的桌面程式。選擇「自動設定系統代理」後，客戶端會將本機監聽位址寫入系統設定；清除系統代理則會撤銷這項設定。它不會變更各程式自身的代理選項，因此某個應用程式未接入時，應先確認該程式是否使用系統設定，或是否儲存了獨立代理位址。
排查時先確認客戶端正在執行，再查看系統代理狀態與本機連接埠是否相符。退出客戶端前清除系統代理，可避免系統仍指向已停止的本機監聽連接埠。
系統代理選單
○ 清除系統代理
● 自動設定系統代理
○ 不變更系統代理
○ PAC 模式
本機入口：
http://127.0.0.1:10809PROXY MODE
分開設定接管方式與分流策略
代理模式決定程式流量如何進入客戶端，路由模式決定進入後如何選擇出口，兩者不應混為一個開關。「自動設定系統代理」主要接管遵循系統設定的程式；PAC 模式依腳本決定哪些位址進入本機代理；「不變更系統代理」則保留現有系統狀態，適合手動設定應用程式代理或搭配其他接管方式。
日常使用可從系統代理搭配規則分流開始。需要除錯時先固定接管方式，再逐項調整路由；同時變更兩層設定會增加判斷成本，也難以確認問題來自入口還是出站。
入口層
應用程式 → 系統代理 → 本機入站
策略層
本機入站 → 路由比對
├─ direct
├─ proxy
└─ blockDNS
解析路徑應與路由目標一致
DNS 設定負責將網域轉換為位址，會直接影響後續 IP 比對與連線結果。使用網域規則時，應先釐清解析由系統完成還是交由核心處理，再選擇相應的查詢出口。若網域解析成功但連線異常，需要分別觀察 DNS 回應值、domainStrategy 與最終路由命中情況，不能只依瀏覽器提示判斷。
複雜設定可為不同網域集合指定伺服器，並透過規則讓查詢走 direct 或 proxy。調整 DNS 後應清除應用程式與系統快取，再重新發出要求，避免舊記錄掩蓋設定變更。
{
"dns": {
"servers": [
"localhost",
{
"address": "https+local://1.1.1.1/dns-query",
"domains": ["geosite:geolocation-!cn"]
}
]
}
}TUN
透過虛擬網卡接管更多連線
TUN 模式透過虛擬網卡接收系統網路流量，適用於不讀取系統代理設定的程式。啟用前需要允許客戶端建立網路裝置並修改路由表，關閉後則應確認相關路由已恢復。與一般系統代理相比，它的涵蓋範圍更廣，也更依賴系統權限、DNS 處理與排除規則。
第一次啟用時不要同時加入大量自訂規則。先使用基本設定確認網路可用，再新增私有位址繞過、區域網路存取與應用程式分流。若出現連線中斷，應依序檢查權限、虛擬網卡狀態、路由表與 DNS，而不是頻繁切換伺服器。
{
"inbounds": [{
"tag": "tun-in",
"protocol": "tun",
"settings": {
"name": "xray-tun",
"mtu": 1500
}
}]
}GROUPS
依來源隔離多個訂閱
訂閱群組用於管理設定來源，不等同於路由出站。將工作、測試或不同用途的訂閱分別儲存後，可以獨立更新、篩選與選擇伺服器，減少同名項目混在一起的情況。群組名稱應表達來源或用途，不建議將暫時連線狀態寫入名稱，因為狀態會變動，而群組結構應保持穩定。
更新某個群組前先確認目前的選取範圍，完成更新後再依地區或關鍵字篩選。刪除群組會同時影響其中的伺服器項目，因此應先確認目前使用的伺服器是否來自該群組，並準備可切換的設定。
訂閱群組
├─ 預設群組
│ └─ 目前使用
├─ 工作設定
│ └─ 獨立更新
└─ 測試設定
└─ 關鍵字篩選DIAGNOSIS
依鏈路順序定位連線問題
連線失敗時，建議依「訂閱內容—伺服器選擇—核心執行—本機入站—系統接管—路由出站—DNS 解析」的順序檢查。先確認客戶端日誌沒有設定解析錯誤，再檢查系統是否將流量交給正確的本機連接埠。只有入口正常後，路由命中與遠端連線結果才具有診斷意義。
一次只變更一個變數，例如更換伺服器、切換路由方案或關閉 TUN。記錄每次操作後的日誌變化，可避免將偶發網路波動誤認為設定修復，也能更快找出穩定重現的條件。
檢查順序
1. 訂閱是否已更新
2. 設定是否已解析
3. 核心是否已啟動
4. 本機連接埠是否正在監聽
5. 系統代理是否生效
6. 路由與 DNS 是否相符CLIENT DOWNLOADS
依作業系統選擇客戶端
桌面平台使用 v2rayN，Android 可在 v2rayNG 與 v2flyNG 之間選擇。下載頁會繼續說明安裝套件類型、處理器架構與系統需求。
DESKTOP
Windows
使用 v2rayN 圖形化客戶端，可在桌面版與經典 WPF 版之間選擇。首次安裝後先匯入訂閱，再設定系統代理與路由方案。
- 適合一般桌面瀏覽與應用程式代理
- 提供訂閱群組、路由與 TUN 設定
DESKTOP
macOS
依裝置處理器選擇 v2rayN 的 Apple Silicon 或 Intel 安裝套件。首次開啟時需要依系統提示完成應用程式放行與網路權限設定。
- 安裝套件需與處理器架構相符
- 分別確認系統代理與網路權限
MOBILE
Android
優先選擇使用 Xray 核心的 v2rayNG；需要 V2Fly 核心時可選擇 v2flyNG。多數近年裝置適用 arm64，無法確認時請查看系統架構說明。
- 支援掃描、剪貼簿與訂閱匯入
- 依核心需求選擇對應客戶端
DESKTOP
Linux
使用 v2rayN 桌面客戶端，並依發行版選擇 deb 或 rpm 軟體套件。處理器為 ARM 架構時，還需要選擇對應的 arm64 建置版本。
- 套件類型應與發行版相符
- 系統代理可依桌面環境個別檢查
OPEN SOURCE ECOSYSTEM
Project V、V2Fly 與 Xray 核心的關係
客戶端、核心、協定與訂閱服務屬於不同層級。分開理解這些概念，才能準確判斷安裝、設定與連線問題分別發生在哪一層。
從 Project V 走向核心家族
Project V 是圍繞網路代理協定與可組合設定形成的開放原始碼技術生態。早期常見的 V2Ray 名稱既用於描述核心程式，也常被使用者泛指相關協定、客戶端與設定格式。隨著專案演進，V2Fly 延續了 v2ray-core 的社群維護路線，Xray 則在相容常見設定思路的基礎上發展出獨立核心。兩者都包含入站、出站、路由、DNS、傳輸與策略等模組，但具體功能、設定欄位與更新節奏可能不同。
圖形化客戶端不等於核心。v2rayN、v2rayNG 與 v2flyNG 負責提供選單、訂閱管理、伺服器選擇、日誌檢視與系統接管入口；真正處理協定連線與路由比對的是客戶端呼叫的核心。因此，遇到介面操作問題時應查看客戶端設定，遇到設定解析、協定交握或路由行為問題時，則需要結合核心日誌判斷。
三款客戶端的定位
v2rayN 面向 Windows、macOS 與 Linux 桌面環境，適合需要訂閱群組、系統代理、路由規則與 TUN 功能的使用者。v2rayNG 面向 Android，通常搭配 Xray 核心使用，介面圍繞行動裝置上的匯入、選擇、啟動與應用程式接管。v2flyNG 同樣面向 Android，但採用 V2Fly 核心路線，可用於需要對應核心行為或設定相容性的情境。
三款程式都屬於社群維護的開放原始碼客戶端。開放原始碼代表程式碼、變更記錄與授權條款可供檢視，也代表不同專案會依各自維護者的規劃發布更新。客戶端與核心可能採用不同的開放原始碼授權，安裝或重新散布時應分別查看專案附帶的授權文字，而不是只根據產品名稱推斷授權範圍。
更新機制與設定相容性
客戶端更新通常包含介面、系統整合、訂閱處理與核心管理方面的變更；核心更新則更可能涉及協定實作、傳輸行為、路由規則、DNS 與底層網路處理。兩者不一定要在同一天更新。下載頁提供目前的客戶端安裝入口，程式內的核心管理功能則用於查看與切換客戶端所呼叫的核心元件。
設定相容性也需要分層判斷。基本的入站、出站與路由結構可能相近，但特定協定參數或擴充功能未必能在不同核心間直接沿用。遷移設定前應先保留原始內容，再從最小可用設定開始測試；確認基本連線正常後，逐步加入 DNS、分流與 TUN 設定。如此可以明確找出是哪個欄位造成解析失敗或行為差異。
COMMON QUESTIONS
開始設定前的四個問題
以下問題涵蓋客戶端選擇、訂閱更新、系統代理與路由順序。更完整的安裝與排查步驟分別收錄於教學、進階手冊與常見問題頁。
桌面系統應選擇哪個客戶端？
Windows、macOS 與 Linux 都可從 v2rayN 開始。下載時先確認作業系統與處理器架構，再選擇對應安裝套件。安裝完成後依「新增訂閱—更新清單—選擇伺服器—設定系統代理」的順序操作，避免在沒有可用設定時先修改複雜路由。
查看客戶端比較 →訂閱網址新增成功，為什麼伺服器清單仍是空白？
新增網址只完成儲存動作，還需要執行更新訂閱。若更新後仍為空白，依序檢查網址是否完整、系統時間是否準確、訂閱是否有效，以及日誌中是否出現網路要求或內容解析錯誤。不同原因對應的處理方式不同，不建議反覆刪除並重新安裝客戶端。
查看訂閱匯入步驟 →開啟系統代理後，為什麼個別程式沒有接入？
系統代理只會影響讀取作業系統代理設定的程式。某些應用程式使用獨立網路堆疊、儲存了自己的代理位址，或需要透過 TUN 模式接管。先確認瀏覽器等一般程式是否正常，再檢查目標應用程式的網路設定，避免將應用程式接管問題誤判為伺服器連線問題。
查看系統代理排查 →路由規則中的 direct、proxy 與 block 分別代表什麼？
direct 代表連線直接出站，proxy 代表交由已設定的代理出站，block 代表阻止連線。規則通常由上而下檢查，第一個符合的結果會被採用。新增規則時除了核對比對內容，也要確認它位於寬泛預設規則之前。
閱讀路由分流章節 →LATEST GUIDES
近期設定與排查文章
整理權限處理、訂閱群組與 DNS 路徑的可重現操作步驟。每篇文章聚焦一個具體問題，方便依現象進入對應的檢查流程。
v2rayN macOS 無法開啟怎麼辦：未驗證開發者與網路權限逐步處理
從系統封鎖提示開始，依序說明在隱私權與安全性中放行、授權網路延伸功能及處理權限要求，區分應用程式無法啟動與網路功能未獲授權兩類問題。
閱讀全文 →v2rayN 多訂閱群組管理：依關鍵字篩選伺服器與群組排序實務
說明多個訂閱並存時如何隔離來源、設定更新節奏、依地區關鍵字篩選伺服器，並讓群組選擇與路由方案保持清楚對應。
閱讀全文 →V2Ray DNS 洩漏檢測方法與 dns 模組防洩漏設定實作
解釋解析要求可能偏離預期路徑的原因，提供分步檢測方法，並使用 dns 出站與 domainStrategy 等設定項調整解析流量方向。
閱讀全文 →