v2rayN · v2rayNG · v2flyNG

v2rayN
下載與設定指南

依作業系統選擇用戶端,按照中文步驟匯入訂閱,再檢查路由分流與 DNS 設定;先確認連線正常,再逐項調整。

程式碼開源 圖形介面 多核心設定
  • 教學—從匯入訂閱到確認連線的四個步驟
  • 設定參考—從 inbounds 到 policy 的逐段範例
  • 問題排查—無法連線與測速失敗
依裝置作業系統選擇下載入口

我的設定工作區

相關文件

V2Ray 用戶端:依作業系統下載

桌面裝置可先查看 v2rayN,Android 裝置可先查看 v2rayNG;需要 V2Fly 核心時,再了解 v2flyNG。安裝檔取決於作業系統與處理器,連線方式則取決於設定與核心。將這兩件事分開判斷,就不容易選錯。下載頁集中列出各平台的下載入口與安裝需求,首頁則協助你確認方向。

用戶端負責儲存設定、啟動核心及設定流量入口,不會憑空產生可用的遠端服務。開始前,請準備好有權使用的訂閱網址或伺服器參數。若已有舊設定,先保留群組與自訂路由,再安裝或移轉;第一次使用則先按照教學完成單一連線測試,暫時不必同時啟用所有進階選項。

Windows

v2rayN

桌面版採用跨平台介面,經典 WPF 版則保留熟悉的操作配置。初次安裝可先了解桌面版;若已有使用習慣與設定,先比較介面差異再決定。安裝完成後,確認用戶端能正常啟動核心,再匯入訂閱;程式成功啟動不代表代理已生效。

macOS

v2rayN

先在系統的「關於這台 Mac」確認晶片,再選擇 Apple Silicon 或 Intel 對應的下載入口。匯入訂閱後,確認系統代理是否已啟用,以及瀏覽器是否沿用系統設定。需要使用 TUN 時,再另外處理權限;初次連線不必同時啟用系統代理與虛擬網卡,以免增加難以判斷的變因。

Android

v2rayNG / v2flyNG

v2rayNG 使用 Xray 核心,v2flyNG 則提供採用 V2Fly 核心的另一種選擇。多數較新的手機可先查看 arm64 版本;若不確定裝置架構,可查詢裝置資訊或考慮通用版。初次連線時須確認系統 VPN 權限;若切換至背景後就中斷,請再檢查電池最佳化、背景執行權限,以及其他占用 VPN 通道的應用程式。

Linux

v2rayN

依 Linux 發行版的套件格式選擇 deb 或 rpm,再確認處理器架構。圖形介面的系統代理設定不一定適用於終端機程式;每個應用程式是否會使用代理,都要分別確認。如果瀏覽器可以連線、命令列卻不行,先檢查該程式的代理設定與環境變數,不要直接更換整套伺服器設定。

v2rayN 能幫你
處理哪些設定

先釐清三個環節:應用程式將請求送至本機入口,核心依照規則選擇出口,DNS 則為連線查詢所需資訊。用戶端透過圖形介面集中管理這些設定;發生問題時,沿著這條路徑逐一檢查,比反覆匯入同一筆訂閱更有效。

訂閱可將多筆伺服器設定集中在同一個更新入口。先建立群組,再貼上有權使用的網址;更新後,確認清單中確實出現設定。一般更新失敗時,可在現有連線正常的前提下,嘗試透過代理更新。訂閱網址可能包含存取憑證,不適合放進截圖或公開記錄。與逐筆手動輸入相比,群組較容易保留設定來源與更新範圍;不過,自訂備註、排序與路由應另外備份,避免誤將遠端更新當成本機設定的永久備份。右側範例僅示範在 JSON 中儲存 URL 的寫法,並非用戶端訂閱檔案格式。

{
  "url": "https://example.com/sub"
}

設定檢查:依序確認入口、規則與出口

如果訂閱已更新卻無法連線,先確認是否選取有效設定,再查看核心啟動記錄。接著確認應用程式是否確實連上本機入站,最後檢查路由選取的出口與網域解析。TCP 連接埠可連通,只代表有機會建立交握,不能取代完整的協定連線;測試失敗也可能是測試目標本身無法連線。保留原始錯誤訊息,比只記下「逾時」更容易找出問題。

設定參考中的 JSON 用來說明欄位之間的關係。用戶端通常會依介面設定產生執行設定,直接修改暫存產生檔,可能會在下次啟動時被覆寫。需要長期保留的規則,應放在用戶端支援的自訂入口,並在修改後檢查產生的設定。完整欄位說明可從入站章節開始閱讀;第一次操作則可接著查看訂閱匯入教學。

Project V 生態系
與用戶端的分工

「V2Ray」在日常討論中常被當作一個大類名稱,但實際操作時,最好將專案生態系、代理核心與圖形用戶端分開理解。Project V 提供模組化代理工具的設計概念:入站接收請求,路由決定流量去向,出站負責建立連線。V2Fly 延續 V2Ray 的社群開發,Xray 則發展出另一條核心分支。兩者有共同的技術背景,也各自持續發展功能,不能因為名稱相近,就認為設定永遠通用。

用戶端負責操作介面,核心負責處理連線。v2rayN 將訂閱、伺服器清單、系統代理與設定選項集中在桌面介面,再呼叫相應核心運作。v2rayNG 適用於 Android 裝置,採用 Xray 核心;v2flyNG 則提供 V2Fly 核心路線。這三款用戶端都是開源軟體專案。選擇時先看裝置,再看設定需求,不必為了名稱一致,勉強要求不同裝置使用完全相同的介面。

協定支援必須具體到各項功能。VMess、VLESS、Trojan 是協定層級的選擇;傳輸方式以及 TLS、REALITY 等安全設定則是不同面向。設定能否運作,取決於用戶端能否正確匯入、核心能否辨識,以及伺服器參數是否一致。只看到「支援 VLESS」,還不足以判斷含有特定傳輸方式與安全選項的設定是否相容。遇到無法啟動時,先查看錯誤欄位,再核對支援範圍,比反覆更換用戶端更能有效排查。

開源授權也要依專案分別確認。v2rayN、v2rayNG 與 v2flyNG 採用 GPL 系列授權;V2Fly 與 Xray 核心專案則採用 MPL 2.0。授權條款說明原始碼的使用、修改與散布條件,並不代表你獲得使用遠端服務的授權。訂閱、伺服器與網路仍各有管理規範。日常使用未必需要逐條研究授權內容,但若要重新散布、修改或整合程式碼,就應閱讀相應專案的授權條款,不能將「開源」簡單理解為完全不受限制。

更新也分成不同層面:用戶端更新會改變介面與整合功能,核心更新會影響協定實作,訂閱更新會替換遠端設定,規則資料庫更新則會影響網域與 IP 集合。這四種更新各自解決不同問題,遇到故障時不必一次全部更新。例如網站被錯誤分流時,可先檢查規則順序與資料庫;若核心明確回報欄位不受支援,再確認核心功能;如果只有一個訂閱群組更新失敗,則先檢查網址、權限與更新路徑。

保留可還原的設定,比一次就調整到位更實際。修改前記下目前的出站、路由模式、DNS 與代理入口,每次只變更一組設定。確認瀏覽器能正常連線後,再測試其他需要使用的應用程式。對背景執行的應用程式、遊戲或命令列程式,不要預設它們都會遵循系統代理;使用 TUN 時,也不要認為啟用後就能涵蓋所有網路情境。流量入口、路由與解析都必須依裝置環境實際測試;介面上的開關狀態只代表設定,不代表結果。

測試連線時,要先了解結果代表什麼。TCPing 較接近連接埠連通性檢查;實際連線測試則會繼續檢查協定交握及測試目標。結果會受到本機網路、伺服器狀態、解析結果與目標回應影響;單次成功不代表所有應用程式都能正常使用,單次失敗也不能直接證明是用戶端出了問題。可以固定一套測試步驟:選取設定、啟動核心、確認代理模式、連線至預期目標,再比對記錄進行檢查。步驟一致,結果才有比較價值。

這裡的中文說明將「如何操作」與「為什麼這樣設定」分開:教學介紹安裝後的連續操作步驟,設定參考說明欄位與片段,問題排查依症狀縮小檢查範圍,技術筆記則探討特定機制。本網站是獨立整理用戶端資料的網站,並非遠端連線服務提供者。準備好有權使用的設定後,可先完成基本連線,再決定是否需要複雜的分流設定;依眼前需求閱讀即可,不必一次看完所有章節。

技術筆記:連線、核心與 DNS

完成基本連線後,再依問題深入了解。以下三篇分別說明首次連線驗證、核心選擇與 FakeDNS,避免將不同層級的設定混在一起調整。