參考 逐段解說 inbounds / routing / outbounds 設定

下載 v2rayN與 V2Ray 設定參考

整理四大平台用戶端下載入口,並以實際設定欄位說明訂閱匯入、代理模式與路由規則。

原始碼開放 Xray / V2Fly 核心 JSON 設定參考

V2Ray 用戶端下載入口

先確認作業系統與處理器架構,再選擇用戶端及安裝套件。

Windows v2rayN · Desktop / WPF

桌面平台建議優先選用 v2rayN。Desktop 採用跨平台介面,WPF 則保留經典桌面操作方式。兩者都以伺服器清單、訂閱群組和路由設定為核心,選擇時先考量介面使用習慣,再確認安裝需求。

首次啟動後,先匯入既有訂閱或分享連結,再選擇目前使用的伺服器。設定系統代理前,請確認本機監聽連接埠;結束使用時記得還原代理設定,避免應用程式繼續連線至已停止的本機服務。

前往下載
macOS v2rayN · Apple Silicon / Intel

使用 v2rayN 桌面介面管理設定。在「關於這台 Mac」查看晶片資訊:Apple Silicon 對應 arm64,Intel 處理器對應 x64。相同的安裝套件格式不代表處理器架構相同,下載前請先確認晶片型號。

匯入設定後,先測試一般系統代理。若要接管不讀取系統代理設定的應用程式,再確認 TUN 模式的需求。系統權限、網路服務與用戶端核心是三個不同的檢查項目,建議不要同時變更。

前往下載
Android v2rayNG / v2flyNG

建議優先使用採用 Xray 核心的 v2rayNG;若需要相容 V2Fly 設定,再考慮 v2flyNG。近年推出的主流手機通常選擇 arm64;不確定架構時,可查看裝置資訊,或選擇檔案較大的通用安裝套件。

首次連線時,請確認已授予系統 VPN 權限。同時執行其他占用該介面的應用程式,可能會影響連線。若背景連線中斷,先檢查系統電池管理與背景執行權限,再判斷是否為伺服器問題。

前往下載
Linux v2rayN · deb / rpm

使用 v2rayN 圖形介面管理伺服器與訂閱。Debian、Ubuntu 等發行版通常選擇 deb;採用 RPM 套件管理的發行版則選擇 rpm。同時確認架構是 x64 或 arm64,安裝套件格式不能取代架構選擇。

不同桌面環境對系統代理的支援程度可能有所差異。瀏覽器能連線、其他程式卻無法使用時,請確認該程式是否會讀取桌面代理設定。TUN 還涉及權限、路由與 DNS,不能只憑安裝成功就認定流量接管已生效。

前往下載

V2Ray 設定結構

從本機監聽到遠端出站,逐項了解流量處理流程。

inbounds:應用程式流量的入口

入站設定定義核心接收流量的方式。常見的本機設定會使用 SOCKS 監聽,並將位址限制在迴路介面。應用程式必須將代理位址與連接埠指向此處,流量才會進入後續路由。若連接埠已被占用,應先檢查其他用戶端或重複啟動的程序,而不是更換遠端伺服器。相較於只提供連線按鈕的用法,查看入站欄位有助於分辨「應用程式未將流量交給代理」與「代理已接收流量,但出站失敗」這兩類問題。

{
  "inbounds": [{
    "tag": "socks-in",
    "listen": "127.0.0.1",
    "port": 10808,
    "protocol": "socks",
    "settings": { "udp": true }
  }]
}

建議依序從入站開始閱讀:先確認應用程式將連線送往何處,再查看路由如何選擇出站,最後核對遠端協定與解析方式。用戶端介面中的訂閱、測速、系統代理屬於管理與系統整合功能,不一定對應核心設定中的同名欄位。釐清這兩個層次,才能判斷問題該從介面選項、執行設定還是作業系統設定著手。

Project V、V2Fly 與 Xray 核心生態

用戶端提供操作介面,核心負責協定、路由與解析。兩者各自更新,也各自影響相容性。

Project V:模組化代理設定的背景

Project V 是理解 V2Ray 生態的起點。它的設定方式並非將所有功能都塞進單一伺服器位址,而是分別描述接收連線、比對規則、建立出站及處理解析。單一執行個體可同時設定多個入站與出站,再透過標籤建立關聯。一般使用者可透過圖形介面省去大部分設定細節;需要排除問題時,這些功能界線正好提供逐段檢查的順序。

「V2Ray 用戶端」通常是類別名稱,不代表所有應用程式都使用相同核心與設定格式。即使是同一條分享連結,用戶端也必須先辨識協定及附加參數,再轉換成實際執行設定。匯入失敗時,請先確認是否支援該分享格式;匯入成功但啟動失敗時,再檢查核心能否辨識產生的欄位。這比反覆切換代理模式更能貼近問題所在。

V2Fly 與 Xray:源自共同基礎,各自發展

V2Fly 延續 V2Ray 的社群維護路線,Xray 則從相關程式碼基礎發展出自己的實作與擴充。兩者有許多共通的基本概念,例如入站、出站與路由標籤;但協定擴充、傳輸選項、DNS 行為及欄位支援不一定同步。某份設定能在一種核心上正常運作,不代表直接複製到另一種核心也會得到相同結果。

例如,使用 REALITY 或 XTLS Vision 相關參數時,請確認目前核心具備相應功能,且符合伺服器端要求的參數組合。選擇核心應考量設定所需功能與用戶端整合情況,而非只看產品名稱。排查前記下目前使用的用戶端、實際啟動的核心及其設定入口,可避免用一種實作的文件解讀另一種實作的錯誤訊息。

三款用戶端:平台與核心的對應關係

v2rayN、v2rayNG 與 v2flyNG 都是原始碼開放的圖形用戶端。桌面平台可使用 v2rayN 管理伺服器、訂閱與路由;Android 優先考慮採用 Xray 核心的 v2rayNG,v2flyNG 則適合需要使用 V2Fly 核心的情況。選擇時應先考量作業系統,再確認協定支援與設定相容性,不宜只用同一套效能指標為三款軟體排名。

v2rayN 的介面設定也可能影響執行時使用的元件。選擇伺服器後,請留意其協定是否符合用戶端實際呼叫的核心。行動裝置還需考量系統 VPN 介面、應用程式分流與背景執行限制。將桌面平台的本機 SOCKS 連接埠直接照搬到手機介面,並不能取代行動系統的流量接管流程;同一組伺服器參數在不同平台上,也必須搭配各自的網路入口。

用戶端選擇指南集中比較這三款軟體適用的平台、設定方式與使用限制。若現有設定運作正常,不必為了統一介面而同時更換用戶端、核心與路由方案。每次只變更一項並保留原有設定,結果改變時才能判斷原因。

開源授權:分別查看用戶端與核心

原始碼開放代表專案依照相應授權公開原始碼與使用條件,但用戶端、核心及附帶元件可能採用不同授權。V2Fly 核心採用 MIT 授權,Xray 核心採用 MPL-2.0;用戶端則應查看各自發行版本附帶的授權文件。個人使用、修改原始碼與重新散布屬於不同情況,不能只憑「開源」兩字推定所有權利與義務。

一般安裝使用時,請確認軟體名稱、平台與元件說明。若要重新散布或修改程式,應逐項閱讀適用授權,並保留授權要求的聲明。開源也不代表設定無須檢查:流量會被路由到哪裡、訂閱會更新哪些伺服器,以及哪些位址能連入本機監聽連接埠,都由實際設定決定,應在執行環境中確認。

更新項目分開處理:程式、核心、訂閱與規則

用戶端更新會改變介面與設定產生邏輯,核心更新會影響協定實作,訂閱更新會重新整理伺服器項目,規則資源更新則會影響網域或位址分類。這四種操作解決的問題各不相同。無法辨識新的協定欄位時,先確認核心支援;訂閱中的伺服器位址變更時,更新對應群組;規則檔遺失時,檢查資源設定與執行日誌,不要只重裝用戶端。

調整前可先保留現有設定與自訂規則。更新後先確認目前使用的伺服器能否啟動,再檢查系統代理或 TUN 是否依預期接管流量,最後測試常用應用程式與區域網路存取。若同時更換核心、清空訂閱並重寫 DNS,即使連線恢復,也很難判斷是哪項變更奏效。保留清楚的操作順序,比頻繁嘗試無關的開關更有利於長期維護。

連線驗證:分辨測速、交握與實際請求

伺服器清單中的測試結果,只代表特定測試條件。連接埠可以建立連線,不代表協定交握一定成功;交握成功,也不代表目標網站的解析與路由都正確。使用 V2Ray 節點測速時,請先了解測試目標與方式,再配合實際請求判斷。不要把單次測試結果當成所有應用程式都能連線的保證。

建議依固定順序驗證:先確認用戶端是否已啟動核心,再使用明確設定代理的應用程式送出請求,接著檢查系統代理,最後測試 TUN。每個步驟都應保留相應日誌。發生逾時時,先確認請求停在哪個階段;出現交握錯誤時,再核對身分、安全與傳輸欄位。日誌中的本機連接埠、出站標籤與目標網域,通常比籠統的「連線失敗」提示更有助於定位問題。

代理模式:流量接管範圍與分流策略是兩回事

系統代理決定遵循此設定的應用程式是否將連線交給本機代理;路由策略則決定已進入核心的流量要使用哪個出站。介面上的「全域」通常代表一種路由選擇,不一定能接管所有程序。若某個應用程式不讀取系統代理設定,即使選擇全域路由,它的連線仍可能沒有進入核心。需要擴大流量接管範圍時,應再評估 TUN,而不是只反覆切換分流規則。

因此,排查「瀏覽器正常、其他程式失敗」時,應先檢查流量接管入口;排查「部分網域走錯路徑」時,則應查看規則順序與 DNS。桌面操作可先閱讀 系統代理與全域代理說明;行動裝置則可參考 v2rayNG 使用教學,檢查系統授權與應用程式範圍。其他常見問題請參閱 常見問題;設定欄位的預設值與引用關係則於 設定參考中逐段說明。

協定、設定與使用文章

依照實際問題繼續閱讀:身分欄位、用戶端操作與協定選擇。