Windows
首選 v2rayNv2rayN 提供 Desktop 桌面版與經典 WPF 版。前者採用跨平台介面，後者保留熟悉的桌面操作配置。下載前請確認作業系統與處理器需求，再選擇安裝套件；不要只憑檔案大小判斷是否適用。
首次安裝後，先匯入既有訂閱或連線資訊，選擇設定並啟動核心，再設定系統代理。系統代理只會影響遵循系統設定的應用程式，不代表所有程式的流量都已接管。若要處理更多應用程式，再參閱 TUN 說明。
客戶端入口／設定欄位參考
V2Ray 客戶端官網v2rayN 下載與設定
依作業系統選擇開源客戶端，從訂閱匯入到 config.json 欄位，逐步對照設定與解析路徑。
- Xray-core
- V2Fly-core
- GPL-3.0
V2Ray 客戶端下載入口
先選擇作業系統，再確認處理器架構與安裝套件格式。桌面端使用 v2rayN；Android 端可優先考慮 v2rayNG，需要 V2Fly 核心時再選擇 v2flyNG。
macOS
v2rayNv2rayN 依 Apple Silicon 與 Intel 晶片提供不同下載選項。可在系統的「關於這台 Mac」查看晶片或處理器資訊，再選擇相符的架構。晶片類型必須與安裝套件架構相符，不能只憑桌面外觀或裝置年份判斷。
安裝後，先確認客戶端能正常啟動並匯入設定，再檢查系統網路代理。若只有部分應用程式能連線，請分別確認應用程式是否遵循系統代理、路由是否符合預期出站，以及網域解析是否走正確路徑，避免一再重新安裝。
Android
首選 v2rayNGv2rayNG 使用 Xray 核心；v2flyNG 使用 V2Fly 核心，適合需要相應核心行為的設定。較新的主流裝置通常選擇 arm64；若不確定處理器架構，可先確認通用套件的適用範圍。兩款客戶端的設定相容性仍須逐項確認。
啟動連線時，系統會要求允許建立 VPN 連線。這是 Android 客戶端接管流量的系統入口，不代表伺服器端已可正常使用。首次連線時請留意客戶端記錄，同時檢查依應用程式設定的代理；其他使用相同系統通道的程式可能造成衝突。
Linux
v2rayNv2rayN 提供適用於不同發行版的套件。Debian、Ubuntu 系統通常使用 deb，Fedora 等發行版通常使用 rpm；處理器架構則須區分 x64 與 arm64。套件格式決定安裝方式，處理器架構則影響執行檔相容性，兩者都要確認。
桌面環境、系統代理與開機自動啟動是三個獨立環節。建議先在圖形介面完成一次手動連線，再設定登入後自動啟動。若程式能執行但應用程式無法連線，請先檢查桌面代理設定與應用程式本身的代理選項，再確認權限和相依套件。
客戶端負責本機設定與連線管理。實際連線仍需要可用的伺服器參數；下載並安裝程式不會自動建立訂閱或遠端帳戶。
查看所有客戶端 →客戶端設定與欄位參考
從介面操作追查實際設定。以下皆為局部範例，用來說明資料流向；客戶端管理項目與核心欄位分開介紹，請勿將片段視為完整連線設定。
inbounds.json／匯入後的本機入口
訂閱由客戶端管理
匯入訂閱可批次儲存連線項目；更新網址屬於客戶端管理資料，並非通用 config.json 的頂層欄位。v2rayN、v2rayNG 與 v2flyNG 的選單和儲存方式各有不同，匯入後都應確認協定、位址與傳輸參數。下方展示的是選定項目後可搭配使用的本機 SOCKS 入站，並非訂閱檔案。監聽範圍限制為迴路位址，可讓本機應用程式透過該連接埠交由核心處理；更新訂閱也不應覆蓋自行維護的路由規則。
{
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"udp": true
}
}
]
}
routing.json／依規則選擇出站
規則順序與出站標籤
路由分流會將不同目標導向不同出站，不會重新定義遠端連線參數。規則會依序比對，具體規則應排在較廣泛的規則之前。此範例將私人位址導向標籤為 direct 的出站，該標籤也必須存在於 outbounds 中。v2rayN 可透過介面管理路由，Android 客戶端的預設選項與自訂入口則各有不同。修改後請重新載入設定，並檢查記錄中的目標位址與出站標籤；若網域尚未解析，單靠 IP 規則可能無法達到預期效果。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
},
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
}
]
}
outbounds.json／接管後的出口範例
接管範圍與路由分開設定
TUN 透過虛擬網路介面接收流量，通常用來處理不遵循系統代理的應用程式。v2rayN 的實際作法、權限需求與使用元件各有不同；Android 客戶端則透過系統 VPN 介面接管流量，不能直接套用桌面版的開關。通用 V2Ray 設定沒有可跨核心照搬的頂層 tun 開關。下方僅展示接管流量後可使用的直連與阻擋出站，並不會建立虛擬網卡。啟用前請確認是否與其他網路接管程式衝突，並預先了解如何還原系統網路設定。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
},
{
"tag": "block",
"protocol": "blackhole",
"settings": {}
}
]
}
dns.json／內建解析伺服器
先確認解析發生的位置
設定 DNS 時，需同時考量由誰發出查詢、查詢經過哪條連線，以及解析結果如何參與路由。核心的 dns 區段不會自動取代所有應用程式的系統解析設定。此範例使用 localhost 呼叫本機解析路徑，適合說明伺服器清單的結構，但不代表適用於所有網路環境。v2rayN 與 Android 客戶端可能另有遠端解析、虛擬位址或流量接管相關選項，修改時請確認實際產生的設定。若網域連線失敗但 IP 可連通，應先區分是解析問題還是路由問題。
{
"dns": {
"servers": [
"localhost"
]
}
}
policy.json／確認核心設定支援
依協定與欄位選擇核心
切換多個核心是客戶端功能，不是 config.json 中通用的切換欄位。v2rayN 可依支援情況選擇核心；v2rayNG 與 v2flyNG 則分別對應 Xray 與 V2Fly。設定結構相似，不代表所有協定、傳輸方式與擴充欄位都完全相容；切換前請先確認伺服器端需求。下方的 policy 片段示範使用者層級策略的寫法，是否生效仍取決於相關使用者是否採用對應的 level。遷移時先保留可用設定，再逐項測試，避免同時更換核心與路由。
{
"policy": {
"levels": {
"0": {
"handshake": 4,
"connIdle": 300
}
}
}
}Project V、V2Fly 與 Xray
分清專案生態系、連線核心與圖形介面客戶端。協定由連線兩端協商，客戶端負責將設定交由核心執行；名稱相近不代表設定可以直接互換。
ecosystem／組成層級
- 專案背景
- Project V
- 核心系列
- V2Fly / Xray
- 桌面客戶端
- v2rayN
- Android 客戶端
- v2rayNG / v2flyNG
- 設定結構
- JSON／入站／出站／路由
- VMess
- VLESS
- Trojan
- GPL-3.0
協定名稱可用來確認設定需求，但不代表任意核心與傳輸方式的組合都能直接使用。
生態系歷史與職責界線
Project V 是了解 V2Ray 技術背景的起點。代理核心以入站、出站與路由組織連線，圖形客戶端則提供訂閱清單、系統代理與設定介面。V2Fly 延續 V2Ray 相關開發，Xray 則發展為獨立的核心分支。兩者保留部分相近概念，但後續功能與設定演進並不完全一致。閱讀資料時，除了標題中的 V2Ray 名稱，也應確認內容對應的核心。
核心系列與協定相容性
VMess、VLESS、Trojan 是連線協定；TCP、WebSocket 等描述傳輸方式；TLS 則涉及傳輸安全設定。理解完整設定時，必須一併考量這些層次，不能用單一協定名稱代替全部參數。選擇核心前，先確認伺服器提供的協定、傳輸方式、安全參數與擴充需求，再確認客戶端能否產生相應欄位。若遇到不相容，應先找出具體欄位問題，不宜一概歸因於客戶端安裝失敗。
三款客戶端與開源授權
v2rayN、v2rayNG 與 v2flyNG 都是開源圖形客戶端，各自的客戶端專案採用 GPL-3.0 授權。核心、規則資料與附加元件可能採用各自的授權，不能只憑客戶端的授權標示概括所有相依項目。開源讓使用者能檢視程式實作、了解設定，但不能取代對伺服器來源、訂閱權限與系統權限的判斷。訂閱網址可能包含存取憑證，分享截圖或記錄前請先移除敏感資訊。
更新機制與設定遷移
客戶端更新、核心更新、訂閱更新與規則資料更新是不同操作。客戶端更新會影響介面與設定產生方式；核心更新會影響欄位支援與連線行為；訂閱更新會變更連線項目；規則更新則會改變比對範圍。調整環境前，先保存目前可用的設定與自訂規則，每次只變更一個環節。完成後重新載入設定，並分別測試網域解析、直連目標與代理目標，以便找出變化來源。
V2Ray 技術筆記
依照實際問題閱讀。先了解設定結構，再處理解析路徑與平台部署；文章中的局部範例須搭配所用客戶端與核心判斷。
v2rayN Linux 版安裝：deb／rpm 套件部署與開機自動啟動設定
介紹 Debian、Ubuntu 與 Fedora 系發行版的桌面安裝方式，說明套件格式、架構選擇、自動啟動項目與常見相依性問題。請分別檢查軟體安裝、桌面啟動與網路代理。
閱讀筆記 →V2Ray config.json 分段解析：inbounds、outbounds 與 routing 怎麼設定
從頂層結構說明入站監聽、出站連線與路由標籤之間的關係。搭配 JSON 片段了解客戶端產生的設定，並區分本機監聽參數與伺服器連線參數。
閱讀筆記 →V2Ray DNS 分流解析設定：中國大陸與海外網域分開解析及防污染設定
說明 dns 區段中的 servers、domains 與 expectIPs 欄位，探討本機解析、遠端解析及其與路由的關係。先確認查詢路徑，再判斷解析結果是否符合預期。
閱讀筆記 →技術筆記依問題逐一說明；欄位的完整層級與適用範圍請參閱設定參考。
查看所有文章 →