V2Ray 用戶端與中文設定文件

V2Ray 用戶端v2rayN 下載與設定

下載 v2rayN 查看教學

依裝置選擇開源用戶端，從匯入訂閱開始，再設定系統代理與路由分流。

中文操作說明 Xray · V2Fly

依裝置平台選擇

v2rayN

伺服器訂閱分組設定重新載入檢查更新說明

訂閱分組

全部

預設分組

+ 新增訂閱

類型別名位址連接埠傳輸協定TLS測試結果

Ctrl+V從剪貼簿匯入分享連結

系統代理

自動設定系統代理

清除系統代理

不變更系統代理

路由預設

繞過中國大陸全域

geosite:cn → direct

geoip:private → direct

啟用 TUN 模式

允許來自區域網路的連線

設定→

SOCKS 127.0.0.1:10808 · HTTP 127.0.0.1:10809

核心 Xray

訂閱分組

路由規則

系統代理

設定關係／先設定入口，再設定出站

訂閱、路由與系統代理

用戶端視窗負責管理設定，核心負責處理連線。訂閱分組用來保存伺服器來源；系統代理讓遵循系統設定的應用程式連上本機連接埠；路由規則則決定這些連線要前往何處。三者屬於不同層次，不必同時調整。初次設定時，先確認一筆伺服器資料可正常使用，再逐項加入分流與其他入口。

依來源管理訂閱分組

在「訂閱分組」中新增訂閱網址，並為分組取一個容易辨認來源的名稱。更新後先選取該分組，再檢查伺服器清單，避免把其他來源的資料誤認為更新結果。分享連結適合匯入單筆資料，訂閱網址則適合持續同步，兩者不能互相取代。訂閱內含的網址與參數屬於連線設定，請勿公開轉傳。以下是辨識單筆 VMess 分享連結時可能遇到的欄位片段，並非完整連線設定。

{
  "v": "2",
  "ps": "範例別名",
  "add": "example.com",
  "port": "443",
  "net": "ws",
  "tls": "tls"
}

查看多訂閱管理說明

依規則順序選擇出站

路由規則通常依照由上而下的順序比對，符合後便選擇對應的出站。可以先讓私人位址直接連線，再新增網域集合規則，最後保留明確的預設去向。「繞過中國大陸」是預設名稱，實際涵蓋範圍仍由載入的規則決定。以下片段將私人位址交由 direct 處理；此標籤必須對應已存在的出站。匯入自訂規則前請先備份，並確認 geosite 與 geoip 資料可用，不能只憑規則名稱判斷效果。

{
  "routing": {
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}

查看路由規則實例

讓應用程式連上本機連接埠

「自動設定系統代理」會修改作業系統的代理設定，讓遵循此設定的應用程式連上用戶端；「清除系統代理」會移除這個入口；「不變更系統代理」則保留現有設定。這些選項不負責決定目標是否直連，出站仍由核心路由處理。若應用程式有獨立的代理選項，請核對其位址與實際監聽連接埠。以下僅示意回送位址上的 HTTP 入站，連接埠可調整，請以用戶端目前的設定為準，切勿預設開放給區域網路。

{
  "inbounds": [
    {
      "listen": "127.0.0.1",
      "port": 10809,
      "protocol": "http"
    }
  ]
}

查看系統代理操作步驟

為其他應用程式設定 TUN 入口

TUN 模式透過虛擬網路介面接收流量，適合需要涵蓋不遵循系統代理設定之應用程式的情境。先透過一般代理入口確認連線正常，再啟用「啟用 TUN 模式」，並依系統提示授權。此模式涉及路由表、DNS 與虛擬介面，若出現異常，應先關閉模式，恢復基本連線後再進行排查。以下是 sing-box 格式的介面欄位片段，僅供辨識設定結構；是否使用這類設定取決於用戶端實作，請勿直接貼入 Xray 設定。

{
  "type": "tun",
  "tag": "tun-in",
  "address": ["172.19.0.1/30"],
  "auto_route": true,
  "strict_route": true
}

閱讀 TUN 設定說明

依協定參數選擇核心

圖形介面與代理核心是兩個部分。介面負責匯入伺服器資訊，核心則處理協定、傳輸與路由。切換前請先核對協定類型、TLS 與傳輸參數，不要假設同一份設定在所有核心中的行為都相同。以下的 freedom 出站是 Xray 與 V2Fly 生態系常見的直連設定形式。切換後先重新載入並查看日誌，確認設定可正常啟動，再測試實際連線；不要同時變更核心、DNS 和路由，否則難以找出故障原因。

{
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {}
    }
  ]
}

查看用戶端與核心的差異

移轉連線資訊，分別設定入口

桌面裝置優先選用 v2rayN；Android 裝置優先選用 v2rayNG，需要 V2Fly 核心時再考慮 v2flyNG。跨裝置移轉通常使用訂閱網址或單筆分享連結，不要直接複製整個應用程式的資料目錄。伺服器參數可以共用，但系統代理、虛擬介面與授權都需要在各裝置上分別設定。以下的日誌欄位可作為閱讀核心設定時的辨識範例；實際日誌位置依用戶端而定。分享截圖前，也請遮蔽訂閱網址與伺服器連線資訊。

{
  "log": {
    "loglevel": "warning"
  }
}

依平台選擇用戶端

訂閱決定伺服器來源，系統代理決定流量入口，路由規則決定連線的出站。

分流示意中的 direct、block 與 proxy 是出站標籤，不是固定的協定名稱。標籤可在設定中自行定義，規則中的寫法必須與出站一致。例如，阻斷出站可使用 blackhole 協定，但標籤仍可命名為 block。複製規則時應一併核對引用關係，避免發生「規則已儲存，核心卻無法啟動」的情況。

DNS 設定也會影響比對結果。網域規則與 IP 規則取得的資訊不同，應用程式自行解析、用戶端解析與遠端解析也不一定經過相同路徑。若基本連線正常，但個別網站的流量去向不符，請先查看日誌記錄的目標與出站，再檢查規則順序和解析策略。不要直接把所有連線改成全域代理來取代問題排查；測試結束後也應還原原本的預設設定。

用戶端入口／依作業系統與處理器選擇

四大平台的用戶端選擇

先確認作業系統，再確認處理器架構與安裝格式。用戶端名稱相近，不代表安裝檔可以互換。下載頁集中列出可選入口與系統需求；本頁僅提供平台導覽，不在首頁混放安裝檔。若已安裝用戶端，更新前請先備份訂閱分組與自訂規則，並記下目前使用的入口模式。

Windows

首選 v2rayN。下載頁提供桌面版與經典 WPF 版：桌面版採用跨平台介面，WPF 版保留經典視窗配置。參照教學操作時，請先確認使用哪一種介面，因為選單位置可能不同。安裝後若無法啟動，先確認系統需求與桌面執行環境，再檢查程式是否已完整解壓縮至可寫入的資料夾。

適合需要訂閱分組、伺服器清單與路由設定的桌面使用情境。請勿在壓縮檔預覽視窗中直接執行程式。

前往下載 →

macOS

選擇 v2rayN，並在系統的「關於這台 Mac」中查看晶片資訊。Apple Silicon 對應 ARM 架構，Intel 對應 x64 架構，不能只憑檔名相似就選擇。安裝後先開啟用戶端並完成訂閱匯入，再設定系統代理。若涉及虛擬網路介面，請仔細閱讀授權提示，確認要求來自剛啟動的應用程式。

移轉設定時，優先使用訂閱網址或分享連結；不同桌面系統的代理入口與應用程式資料目錄並不相同。

前往下載 →

Android

優先選擇使用 Xray 核心的 v2rayNG；需要 V2Fly 核心時，可改用備選的 v2flyNG。多數主流裝置可選 arm64，不確定架構時請查看通用版入口。匯入後選取一筆伺服器資料，再啟動連線並處理系統的 VPN 授權提示。若連線中斷，也應檢查背景執行限制與省電設定。

QR 碼適合移轉單筆設定，訂閱則適合持續更新伺服器清單；請勿將訂閱 QR 碼公開上傳至公開頁面。

前往下載 →

Linux

選擇 v2rayN，並依發行版的套件管理系統區分 deb 與 rpm，再核對 x64 或 arm64 架構。圖形桌面的系統代理設定與命令列應用程式的代理設定是兩條不同路徑；瀏覽器可以連線，不代表所有程式都已使用代理。先測試圖形用戶端的基本連線，再決定是否要為其他程式個別設定代理入口。

若使用 TUN 模式，還需確認權限與系統網路管理方式。請勿透過擴大監聽範圍來解決本機連接埠設定錯誤。

前往下載 →

查看所有用戶端 →三款用戶端比較評測 →

快速入門／先完成一條可驗證的連線

從匯入訂閱到驗證連線

用戶端提供連線工具，伺服器設定則需要自行準備。安裝完成不代表已有可用的伺服器；若清單為空，請先取得有權使用的訂閱網址或分享連結。以下順序適合初次設定，也適合在進行多項變更後，回到基本狀態重新驗證。

匯入設定，確認來源

開啟 v2rayN，在「訂閱分組」中新增訂閱網址，儲存後執行訂閱更新。若只有單筆分享連結，可複製連結後在主視窗按 Ctrl+V 匯入。兩種方式的更新流程不同：訂閱會從來源同步，單筆連結通常需要手動替換。匯入完成後，檢查協定、位址、連接埠與傳輸資訊，確認清單中出現預期的資料，再選取要使用的伺服器。

若更新後清單仍為空，先確認是否複製了完整網址，以及目前分組是否被篩選條件隱藏。請勿重複新增相同訂閱來嘗試修復，也不要在公開截圖中展示完整訂閱網址。Android 用戶端可透過其匯入選單完成類似操作，按鈕位置請以目前介面為準。
設定入口，再選擇路由預設

在桌面用戶端選擇「自動設定系統代理」，讓遵循系統設定的應用程式連上本機代理連接埠。接著查看路由預設：使用「繞過中國大陸」時，符合直連規則的目標會直接連線；使用「全域」時，也應了解預設中可能保留的特殊規則。系統代理與全域路由並非同一個開關，啟用其中一項不會自動完成另一層設定。

初次測試請保留預設 DNS 與一般代理入口，暫時不要再啟用 TUN 模式。若應用程式有自己的代理設定，請確認它是否覆蓋系統設定。Android 端啟動連線時，依提示處理 VPN 授權，再查看用戶端連線狀態與實際連線結果。
開啟目標頁面，搭配日誌判斷

使用遵循系統代理的瀏覽器連線至要測試的目標，確認頁面是否完整載入，再查看用戶端日誌。TCPing 只能表示某一段 TCP 連線是否可達，不能取代包含協定交握、TLS 與目標存取的實際驗證。數值正常但頁面無法開啟時，應繼續核對伺服器參數、系統時間、DNS 解析與所選出站，而不是只根據測試結果反覆更換順序。

每次只變更一個變數，重新載入後再連線至相同目標，方便比較。測試結束、準備關閉桌面用戶端時，先清除系統代理再關閉程式，避免應用程式繼續連線至已停止監聽的本機連接埠。若需進一步排查，記錄錯誤訊息與操作順序，會比單說「無法連線」更有幫助。

查看完整教學 → 依問題現象查找常見問題

開源生態系／區分專案、核心與介面

Project V、V2Fly 與 Xray 的關係

「V2Ray」常被用來泛指一系列代理工具，但專案背景、核心與圖形用戶端需要分開理解。Project V 是相關網路工具與技術的專案背景，V2Ray 則是其中廣泛使用的核心元件。V2Fly 社群延續 V2Ray 相關開發；Xray 從這個生態系分支發展，逐步形成自身的功能演進與設定支援範圍。術語相近，不代表所有欄位都能直接互換。

核心處理連線，用戶端負責整合操作

代理核心負責協定交握、傳輸、DNS 與路由等工作；圖形用戶端則將這些功能整合成選單、伺服器清單與設定頁面。v2rayN 提供桌面設定介面，並可在支援範圍內選擇相應核心；v2rayNG 適用於 Android 裝置，使用 Xray 核心；v2flyNG 則是使用 V2Fly 核心的 Android 替代選項。選擇時先考量裝置與伺服器需求，不必把用戶端名稱直接當作協定名稱。

例如，VMess、VLESS 與 Trojan 是連線協定名稱，WebSocket 是傳輸方式，TLS 則是與連線安全相關的設定；REALITY 是否可用，還取決於相應核心與設定。分享連結會將這些參數放在一起，介面則將它們拆分為不同欄位。排查時須逐項核對伺服器提供的資訊，不能只因協定名稱相同就認定設定完整。

分開看待開源授權與設定責任

三款圖形用戶端皆為開源軟體，但用戶端、核心與規則資料可能採用不同的開源授權。閱讀原始碼、修改及散布時，應分別遵守各元件隨附的授權條款；例如，V2Fly 的 V2Ray 核心與 Xray 核心採用 MPL 2.0，不能因此推論所有圖形用戶端也採用相同授權。用戶端是免費使用的連線工具，伺服器資源與訂閱服務則是另外的項目。

開源描述的是程式碼與授權的關係，不能取代對設定來源的判斷。訂閱網址可能包含存取識別資訊，分享連結也可能含有連線憑證。備份時請妥善保存，傳送日誌或截圖前先移除這些資訊。訂閱轉換會增加一個處理設定的環節；若只是要將設定移轉至另一台裝置，請先試用用戶端原有的訂閱或分享匯入功能。