Project V 生態系・圖形設定指南

V2Ray圖形客戶端v2rayN / v2rayNG

依裝置選擇開源客戶端,從匯入訂閱到路由分流,逐步完成連線設定。

依作業系統選擇
協定與安全層
  • VMess
  • VLESS
  • Trojan
  • SS
  • REALITY
核心系列
  • Xray
  • V2Fly

客戶端下載

依作業系統選擇安裝檔

桌面系統請選擇 v2rayN,Android 優先選用 v2rayNG;需要 V2Fly 核心時,再考慮 v2flyNG。先確認裝置架構,再前往下載頁選擇對應版本。安裝客戶端後,還需要有效的伺服器設定或訂閱連結才能建立連線。

Windows

v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面,適合希望在不同桌面系統維持相近操作方式的使用者;WPF 版保留經典桌面介面,可依原有使用習慣選擇。兩者都需依伺服器參數設定協定、傳輸方式與安全層,不能只看介面外觀判斷連線能力。

首次安裝前,先確認系統需求與執行環境。若已有可用設定,升級前請記下訂閱群組、路由規則與本機監聽設定,避免同時修改多項參數,增加問題排查難度。

前往下載

macOS

v2rayN 依 Apple Silicon 與 Intel 晶片提供不同的安裝選項。可在系統的「關於這台 Mac」查看晶片資訊,再選擇相符的架構。晶片架構與協定類型是兩回事:前者決定程式能否正常執行,後者決定客戶端如何連線至伺服器;更換電腦不代表需要自行修改訂閱中的協定。

安裝後先確認一般系統代理是否生效,再依需求設定更廣泛的流量接管範圍。出現權限提示時,請詳閱系統顯示的說明,確認操作對象與下載的客戶端相符。

前往下載

Android

v2rayNG 使用 Xray 核心,是 Android 裝置的首選;v2flyNG 使用 V2Fly 核心,適合已有相應設定的使用者作為替代選擇。主流裝置通常選擇 arm64;無法確認架構時,請參閱通用版說明。匯入訂閱後,應確認項目包含目前核心支援的協定與安全層,避免在兩款客戶端間反覆匯入同一份不相容設定。

連線時需確認系統 VPN 權限。切換應用程式後若連線中斷,請檢查電池最佳化、背景執行權限,以及是否有其他應用程式占用 VPN 介面;這些系統行為不代表訂閱已失效。

前往下載

Linux

v2rayN 提供 deb 與 rpm 安裝檔,並區分 x64 與 arm64。請先依發行版的套件管理系統選擇格式,再確認處理器架構。圖形客戶端適合在桌面環境中管理訂閱、選擇伺服器與調整路由;安裝檔格式不會改變協定支援,實際支援情況仍取決於客戶端使用的核心。

桌面環境的系統代理設定不一定涵蓋所有應用程式。若瀏覽器可以連線、其他程式卻無法使用,請先確認該程式是否遵循系統代理設定,再評估是否需要 TUN 與相關權限,不必急著重新安裝客戶端。

前往下載

設定功能

訂閱、協定與流量範圍

從左側選擇設定主題。畫面示意用於說明各項設定,實際選單名稱可能因客戶端而異;設定參數時,請以伺服器提供的資訊及目前核心的支援範圍為準。

更新訂閱(不透過代理)
自動更新訂閱
subscription

訂閱可將多組伺服器設定集中在同一個網址,方便定期同步項目。v2rayN 可透過訂閱群組區分來源;v2rayNG 則可在訂閱設定中新增網址並更新。首次匯入時,請保留原始連結,確認群組中出現可辨識的設定後,再選擇項目連線。更新失敗時,應分辨網址過期、網路無法連線或回傳格式不相容等原因;是否透過代理更新,則取決於訂閱網址是否能直接連線。相較於逐一貼上分享連結,訂閱更方便同步,但更新也可能覆寫手動修改的項目。

查看訂閱匯入步驟 →

開源生態系與設定範圍

Project V、V2Fly 與 Xray

V2Ray 是 Project V 生態系中的核心專案之一。了解「客戶端、核心、協定」三者的關係,比記住一串設定名稱更有幫助:客戶端提供操作介面,核心負責執行連線邏輯,協定則規範雙方如何通訊。桌面與手機可以使用不同客戶端,但伺服器參數必須以各客戶端能正確表達的方式設定。

專案背景:從核心到圖形介面

Project V 以模組化網路代理工具為基礎,V2Ray 將入站、出站、路由與傳輸等功能整合在同一套設定架構中。V2Fly 延續 V2Ray 的社群維護與發展;Xray 則從相關程式碼基礎發展,在部分協定與安全層領域形成自己的實作。它們不是同一個程式的不同外觀,也不能只因名稱相近,就假設設定可以直接互換。

圖形客戶端在這些功能之上,加入訂閱群組、分享連結解析、選單設定與記錄檢視等功能。使用者在介面中選擇設定後,客戶端通常會將其轉換成核心可辨識的設定。因此,介面顯示儲存成功,只代表輸入內容已被接受;能否啟動並建立連線,仍需查看核心記錄與伺服器狀態。

因此,教學需要同時標明客戶端與核心名稱。同樣名為「路由設定」的選單,可能提供不同的預設選項;同一份分享連結,在不同實作中也可能無法辨識某些欄位。更換裝置時,先確認基本連線正常,再移轉自訂規則,比一次搬入所有舊設定更容易排查問題。

選擇核心:先確認設定相容性

Xray 與 V2Fly 都能處理多種代理設定,但各自支援的欄位、傳輸組合與擴充功能會隨版本演進而改變。使用 REALITY 等特定功能時,必須選擇明確支援該功能的核心;既有 V2Fly 設定也應依其支援格式使用,不能只改協定名稱,就期待效果相同。

連線體驗也會受到伺服器負載、網路路徑、傳輸方式與裝置效能影響。協定名稱本身無法保證更低延遲、更省電或更快的速度。行動裝置尤其應留意背景連線是否穩定、是否頻繁重新連線,以及是否啟用了不必要的功能。沒有實際需求時,維持預設設定並一次只調整一項,通常更容易判斷設定帶來的影響。

訂閱包含多種協定時,可讓客戶端依自身支援方式產生設定。若記錄顯示欄位未知、缺少必要參數或不支援安全層,請先確認匯入結果與核心能力,再向設定提供者確認參數。若保留同一個錯誤欄位,只是不斷切換伺服器,通常無法解決這類啟動問題。

開源授權:分辨各層授權條款

v2rayN、v2rayNG 與 v2flyNG 都是開源圖形客戶端,核心程式碼採用 GPL 系列授權;V2Fly 的 v2ray-core 與 Xray-core 核心程式碼則採用 MPL 2.0。客戶端、核心與套件所附的相依元件不一定使用相同授權;實際發行版本應以隨附的授權條款與第三方聲明為準,不能將某個核心的授權直接套用到整個安裝套件。

對一般使用者而言,開源代表程式實作可供研究,社群也能協力回報問題、改善相容性與功能。但開源不能取代對設定來源的判斷,也不代表所有訂閱服務都值得信任。客戶端只是工具;伺服器由誰營運、訂閱網址由誰提供,以及記錄會保存哪些資訊,都需要分別了解。

回報問題時,建議只提供錯誤類型、相關設定名稱與必要的環境資訊。訂閱連結、驗證欄位及完整設定可能包含存取憑證,不宜直接貼在公開討論區。排查問題通常需要的是錯誤發生時的相關資訊,而不是公開所有個人設定。

更新方式:分開管理程式與訂閱

更新客戶端、更新核心與更新訂閱是不同操作。客戶端更新主要涉及介面、解析邏輯與功能整合;核心更新會影響底層協定與設定行為;訂閱更新則是同步伺服器項目。若只有訂閱更新失敗,不應直接認定客戶端安裝損壞;若核心無法啟動,也不必先刪除並重建所有訂閱。

更新前,先記下目前可用的設定與自訂選項。更新後先沿用原本的連線方式,確認一般網頁與常用應用程式可正常使用,再逐項嘗試新功能。若同時調整核心、DNS、路由與流量接管模式,即使發生異常,也很難判斷是哪項變更造成。

本站首頁提供平台下載入口與設定說明,安裝檔資訊則集中在下載頁。是否需要更新,應依目前遇到的問題、功能需求與版本說明判斷,而不只是看版本號有沒有變動。容易長期維護的設定應盡量簡潔,讓每條自訂規則都有明確用途,並在不再需要時及時移除。

三款客戶端的適用情境

v2rayN:適用於桌面環境,方便管理多個訂閱群組、查看記錄與維護常用路由。不同桌面平台的介面、系統代理介面與權限處理可能有所不同,不宜直接套用其他平台的操作步驟。已有設定的使用者,應先確認常用協定與自訂規則能正常載入,再決定是否調整介面或核心選項。

v2rayNG:適用於 Android,使用 Xray 核心,並將訂閱、分享連結與連線設定整合在行動介面中。系統 VPN 權限、依應用程式代理與背景執行策略,會共同決定實際的流量處理範圍。若某個應用程式無法連線,除了檢查代理規則,也要確認它是否被排除在接管範圍之外,不要只靠重新匯入訂閱嘗試修復。

v2flyNG:適用於需要 V2Fly 核心的 Android 情境,有相應設定時可作為替代選擇。它與 v2rayNG 名稱相近,但底層能力不能一概而論。選用前先確認協定與傳輸參數;若設定依賴特定核心擴充功能,就應使用明確支援該功能的客戶端,而不是匯入後不斷刪改重要欄位。

三款客戶端都需要使用者自行提供有效的連線設定。圖形介面負責管理設定,安裝完成並不會自動建立伺服器。初次使用可先閱讀設定教學;需要比較協定、安全層與核心相容性時,再參閱協定詳解。遇到訂閱更新或連線異常,可前往常見問題,依照狀況縮小排查範圍。

設定文章

路由、憑證與訂閱管理

基本連線正常後,再逐項處理規則與管理需求。以下三篇文章分別說明流量路由、握手錯誤與多訂閱整理,依目前遇到的問題閱讀即可,不必先修改所有設定。