Project V
Project V 是了解 V2Ray 技術背景的起點。V2Ray 將入站、出站、路由與傳輸拆分為可組合的設定模組。本機監聽入口可接收應用程式的請求,再依規則交由不同出站處理。這種模組化架構也說明了,為什麼客戶端介面需要分別設定系統代理、伺服器和路由,而不是只提供單一連線開關。
查看專案介紹 →開源客戶端 · 中文設定指南
桌面裝置使用 v2rayN,Android 裝置使用 v2rayNG。依照步驟完成訂閱、路由與 DNS 設定,再確認應用程式是否透過代理連線。
PROJECT V / V2FLY / XRAY
先分清核心與客戶端。核心負責處理協定、連線和路由;圖形客戶端則用來管理訂閱、設定與程序。客戶端名稱相近,不代表核心功能和設定欄位完全相同。
Project V 是了解 V2Ray 技術背景的起點。V2Ray 將入站、出站、路由與傳輸拆分為可組合的設定模組。本機監聽入口可接收應用程式的請求,再依規則交由不同出站處理。這種模組化架構也說明了,為什麼客戶端介面需要分別設定系統代理、伺服器和路由,而不是只提供單一連線開關。
查看專案介紹 →V2Fly 是持續維護 V2Ray 的社群專案,其核心實作延續模組化設定的設計理念。v2flyNG 將這個核心家族作為 Android 客戶端的另一種選擇。若現有設定仰賴特定功能,請先確認協定、傳輸方式和欄位是否受支援,再決定使用哪款客戶端;訂閱能夠匯入,不代表目前使用的核心能執行其中所有項目。
了解核心與客戶端的差異 →Xray 源自 V2Ray 技術體系,在協定與傳輸的實作上有自己的維護方向。v2rayNG 使用 Xray 核心,v2rayN 也常用來管理 Xray 設定。VLESS、Trojan 和 REALITY 等名稱屬於不同層級的設定概念,不能互相替代;組合能否使用,須確認伺服器端需求、客戶端欄位與核心功能彼此相符。
查看進階設定 →v2rayN 適用於桌面裝置,將伺服器清單、訂閱分組、系統代理與路由整合在同一個管理介面。v2rayNG 適用於 Android 裝置,透過系統 VPN 介面接管應用程式流量,也提供依應用程式代理等設定。v2flyNG 同樣適用於 Android,適合需要 V2Fly 核心的設定。這三款產品皆有開源專案背景,客戶端本身可免費使用;伺服器位址與訂閱內容仍須自行準備,下載安裝不會自動產生可連線的服務。
開源授權規範程式碼的使用、修改與散布條件,不同元件應分別查看各自的授權說明。圖形介面、代理核心和路由資源可能各自更新,因此更新客戶端、更新訂閱與更新規則資料是三件不同的事。升級前請備份訂閱分組、自訂路由和 DNS 設定;升級後先用原有設定測試,再逐項啟用新功能。遇到錯誤時,記下錯誤位置與相關設定,通常比反覆重新安裝更容易找出問題。
本網站依客戶端選擇、安裝與設定等任務編寫中文指南。專案名稱用於說明技術關係;本站品牌不代表 Project V、V2Fly 或 Xray 專案的官方維護者。介面示意用來呈現設定結構,實際選單名稱請以已安裝的客戶端為準。
先確認裝置系統與處理器架構,再選擇安裝套件。桌面裝置可優先查看 v2rayN,Android 裝置可優先查看 v2rayNG;需要 V2Fly 核心時,再考慮 v2flyNG。下載頁整理了下載入口、適用條件與安裝前檢查事項。
使用 v2rayN。桌面版採用跨平台介面,WPF 版則保留傳統桌面介面。先在系統的「關於」頁面確認處理器架構,再依下載頁說明選擇;兩種介面並不代表使用不同的伺服器,切換前請備份設定。
前往下載使用 v2rayN。在「關於這台 Mac」中查看晶片名稱,並依 Apple Silicon 或 Intel 選擇相應安裝套件。首次啟動時依照系統提示授予權限,接著檢查網路代理設定,避免其他代理工具覆寫目前的設定值。
前往下載優先選擇 v2rayNG,v2flyNG 則是核心方面的另一個選項。多數裝置通常選擇 arm64;不確定架構時,請查看通用套件說明。首次連線時須允許系統提出的 VPN 要求;啟用依應用程式代理前,先確認預設連線正常。
前往下載使用 v2rayN。Debian 和 Ubuntu 系發行版選擇 deb,Fedora 等發行版選擇 rpm,並確認處理器架構為 x64 或 arm64。圖形桌面的系統代理與終端機環境變數各自生效;安裝完成後,請在實際使用的應用程式中測試。
前往下載安裝完成後,先匯入現有訂閱或伺服器設定,再選擇可用項目。訂閱是用來更新一組設定的入口,客戶端只負責讀取和管理內容;請妥善保管訂閱網址,勿放入公開截圖或分享給無關人士。需要還原設定時,先判斷要還原的是訂閱內容還是客戶端參數,兩者的處理方式不同。
初次使用建議從系統代理或預設 VPN 模式開始。確認瀏覽器與常用應用程式都能正常連線後,再設定分流、區域網路分享或 TUN。每次只調整一項,並保留可正常運作的基本設定,排除問題時才有明確的比較依據。
查看所有客戶端 →依照「設定來源 → 流量目的地 → 應用程式範圍 → 網域解析」的順序檢查。下方設定示意維持展開,方便逐項比對;任務分頁則用來查看各步驟的檢查重點。
先確認設定是否已載入。更新後查看目前的分組與伺服器清單,不要把清單空白誤認為網路連線故障。訂閱更新失敗時,先記下記錄中的錯誤類型,再檢查網址和更新方式。
比對訂閱分組設定 ↓接著確認請求會交由哪個出站處理。規則會依設定順序比對,範圍較廣的規則可能先攔截請求。修改前記下目前的路由模式,測試時使用相同目標,避免把伺服器變更誤認為規則變更。
比對路由規則設定 ↓分清系統代理與 VPN 的接管範圍。系統代理仰賴應用程式主動讀取設定;Android 的依應用程式代理也會受清單模式影響。測試前先確認目標應用程式在清單中的設定代表什麼,不要只看開關是否已啟用。
比對應用程式範圍設定 ↓最後確認網域解析路徑。只有 DNS 伺服器能連線,後續連線才有可能完成。先恢復可正常運作的基本解析設定,再測試分流與 FakeDNS,避免同時變更多個因素。
比對 DNS 欄位 ↓在「訂閱分組設定」中,為不同來源各自建立分組,填入完整訂閱網址後再更新。分組用於管理來源,不會自動變更伺服器協定或可用狀態。更新後先確認目前選取的分組,再用名稱篩選縮小清單範圍;若清單空白,請檢查篩選條件,避免把「沒有符合項目」誤判為訂閱失效。相較於直接匯入單一分享連結,訂閱可以持續更新設定,但手動修改的項目也可能在更新時遭到覆寫,重要變更請另外備份。
查看訂閱分組與多訂閱管理 →依名稱篩選目前分組先選擇符合需求的路由預設,再新增少量自訂規則。網域比對與 IP 比對是不同條件,規則順序也會影響最後結果。示意中的區域網路位址會交由直連出站處理,範例網域則交由代理出站處理;這些文字用於說明比對語法,並非可直接貼上執行的完整設定。相較於只切換全域模式,依目標分流可保留區域網路存取,但須同時了解 DNS 與目標比對之間的關係。每次修改後請儲存,並使用相同目標重新測試。
查看路由規則與出站比對 →domain:example.comgeosite:privateip:192.168.0.0/16v2rayNG 首次連線時會要求系統 VPN 權限,允許後才能透過虛擬網路介面接管流量。若只想處理部分應用程式,再進入「依應用程式代理」,確認目前使用的是允許清單還是略過清單;兩種模式下,相同的勾選操作代表不同意思。相較於桌面系統代理,VPN 模式的接管範圍較廣,但實際行為仍須一併考量應用程式清單、路由與系統限制。修改清單後,依客戶端提示重新連線,並檢查背景電池限制,避免把程序遭暫停誤判為伺服器斷線。
查看 Android 連線與驗證步驟 →若網域無法開啟,但直接連線位址可用,請先檢查 DNS 記錄,不要立刻更換所有伺服器。確認解析請求經由本機網路還是代理通道,再檢查上游解析器是否可連線。加密 DNS 位址本身也可能需要先解析,設定不當會形成啟動依賴。比起只換一個 DNS 位址,依網域分流的解析策略更精細,但須與路由設定一致。FakeDNS 會回傳映射位址,啟用前請閱讀相關設定說明;排除問題時,先恢復簡單且可驗證的解析路徑。
查看 DNS 最佳化與 FakeDNS →223.5.5.5https://dns.example.com/dns-queryUseIPv4先確認核心程序已啟動,再檢查本機監聽連接埠,接著確認系統代理或 VPN 狀態,最後在目標應用程式中送出請求。客戶端顯示「已連線」只能表示連線流程已啟動,不能取代應用程式層級的驗證。若瀏覽器能連線、終端機卻無法連線,請分別檢查瀏覽器擴充功能、終端機代理環境變數與應用程式本身的設定。記錄檔有助於判斷錯誤發生在解析、建立連線或協定交握階段;分享記錄檔前,請移除訂閱網址、個人資訊與伺服器憑證。
若只有某個網站異常,先保留目前的客戶端與伺服器,重新測試其他目標,再查看該目標套用的路由規則。若所有應用程式都同時異常,請先檢查本機網路和核心執行狀態。依影響範圍逐步排查,可避免在訂閱、DNS、路由等頁面反覆修改,最後失去原始線索。基本流程請參閱使用指南,依症狀尋找解決方法可前往說明中心。
先閱讀與目前狀況相符的文章,再決定是否需要修改設定。以下三篇依發布日期由新到舊排列,涵蓋應用程式代理範圍、設定檔結構與桌面安裝。若需要虛擬網卡或區域網路分享,可繼續瀏覽文章列表中的相關專題。
分兩個方向排查:瀏覽器端檢查擴充功能與代理設定是否覆寫系統值;終端機端設定 http_proxy 環境變數,並逐項執行指令驗證。先確認應用程式讀取哪一層設定,再調整代理入口。
閱讀排查步驟 →以一份最精簡的可用設定為例,依序解析 log、inbounds、outbounds、routing、dns 各欄位的用途與相互參照關係。適合從圖形介面設定轉而閱讀核心設定檔時參考。
閱讀設定解析 →分別示範 Debian/Ubuntu 與 Fedora 系發行版的安裝指令,並說明相依套件、桌面啟動項目、開機自動啟動設定與常見權限錯誤。先確認手動啟動正常,再設定登入後自動執行。
閱讀安裝指南 →