Windows
v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面,WPF 版則保留經典視窗操作方式;選擇時先確認系統與處理器是否相容,再考量介面偏好。首次執行後,先匯入訂閱並確認伺服器可用,不要直接覆寫既有設定資料夾。
前往下載先釐清訂閱來源、流量入口與出站規則,再調整解析方式。以下為設定項目示意,實際名稱與可用選項依使用的客戶端及核心而異。
訂閱群組可將不同來源的伺服器設定分開管理,適合同時保留日常連線與備用設定。進入訂閱群組設定,填入容易辨識的別名與有效訂閱網址,再只更新目前群組。若需要篩選伺服器,請先檢查篩選條件,避免更新後誤以為訂閱內容為空。相較於反覆貼上單一連結,使用群組更方便追蹤來源及找出更新失敗的原因;不過,訂閱內容由提供者決定,客戶端群組不會改變遠端服務狀態,也不會自動補上缺少的協定參數。
查看訂閱群組說明 →路由分流會決定已進入核心的請求要使用哪個出站,和系統代理開關並不相同。先保留私人位址直連,確認區域網路裝置與本機服務都能存取,再依網域或位址新增規則。規則通常依序比對,實際邏輯視核心而定;條件較明確的規則應排在範圍較廣的規則之前。相較於長期使用全部代理,分流能清楚指定不同請求的處理路徑,但需搭配 DNS 與規則資料庫維護;修改後應查看日誌中的實際比對結果。
查看路由規則說明 →設定 DNS 時,需同時考量解析伺服器,以及解析請求使用的出站路徑。先確認代理伺服器的網域能完成初始解析,再區分直連與代理流量所使用的解析方式。只填入遠端解析位址,不代表所有查詢都會經過代理;瀏覽器的加密 DNS 與系統快取也可能影響觀察結果。相較於直接套用整份範本,逐項修改更容易找出故障原因。每次調整後,分別測試網域存取、規則比對,以及退出客戶端後 DNS 是否恢復正常。
查看 DNS 設定說明 →TUN 模式透過虛擬網路介面接收流量,適合處理不讀取系統代理設定的應用程式。啟用前,先用一般代理入口確認同一台伺服器能正常連線,再檢查執行權限、虛擬網卡及其他網路工具是否衝突。相較於系統代理,TUN 的影響範圍更廣,因此區域網路存取、DNS 接管與預設路由都需要分別驗證。TUN 並不是連線失敗時的萬用修復開關;若一般代理入口已無法建立連線,應先排查伺服器設定與網路,再加入這層設定。
查看 TUN 模式說明 →圖形化客戶端負責管理設定,核心則負責執行協定、傳輸、路由與解析邏輯。選擇核心類型時,應先確認訂閱所需的協定及傳輸組合,而不是只看名稱就切換。不同核心支援的欄位與功能不盡相同,既有自訂設定也未必能直接沿用。相較於頻繁更換客戶端,先確認核心相容性更有助於縮小問題範圍。切換前請備份原有設定,切換後檢查啟動日誌;若出現不支援的欄位或傳輸方式,請依實際使用的核心文件調整。
查看核心選擇說明 →設定時可將連線拆成三層理解:應用程式先將請求交給系統代理或 TUN 入口,核心接著依規則選擇直連或代理出站,DNS 則為需要網域解析的環節提供結果。三層設定彼此相關,但不能互相取代。瀏覽器能存取目標網站,不代表所有應用程式都使用相同入口;啟用代理出站,也不代表每筆網域查詢都會沿著同一條路徑傳送。
建議先保存一份可正常運作的基本設定,再加入分流、遠端解析與虛擬網卡。每次只修改一個環節,並記錄修改前後的狀況。發生問題時,先還原基本設定以重現問題,再查看日誌,不要同時啟用多個選項。若要比較客戶端介面、核心與適用情境,可先閱讀客戶端比較,再決定是否遷移設定。
桌面平台可使用 v2rayN,Android 裝置可優先考慮 v2rayNG;需要 V2Fly 核心時,再選擇 v2flyNG。下載頁集中說明安裝檔的處理器架構、系統格式與介面版本。
v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面,WPF 版則保留經典視窗操作方式;選擇時先確認系統與處理器是否相容,再考量介面偏好。首次執行後,先匯入訂閱並確認伺服器可用,不要直接覆寫既有設定資料夾。
前往下載v2rayN 安裝檔依 Apple Silicon 與 Intel 晶片分別提供。請在系統的「關於這台 Mac」確認晶片資訊,並選擇相符的架構;安裝完成後,先確認應用程式能正常執行,再設定系統代理。若其他網路工具仍在接管代理或路由,應先停止重複功能再進行測試。
前往下載v2rayNG 使用 Xray 核心,v2flyNG 則是採用 V2Fly 核心的替代選項。多數裝置可選擇 arm64;若無法確認處理器架構,請查看通用版本說明。首次連線時需授予系統 VPN 權限;若背景連線中斷,再檢查電池最佳化與背景執行限制。
前往下載v2rayN 依 Linux 發行版的套件管理方式提供 deb 與 rpm 套件,並區分處理器架構。請先確認發行版與硬體架構,再使用系統的軟體安裝工具處理相依套件。圖形桌面中的系統代理是否會被應用程式讀取,取決於該應用程式本身;需要接收更多流量時,再評估使用 TUN。
前往下載下載客戶端與設定代理服務是兩個獨立步驟。安裝客戶端只是準備好管理與連線工具,實際使用仍需要有效的伺服器參數或訂閱網址。訂閱通常包含驗證資訊,不應貼到公開討論區,也不應交給來源不明的線上轉換網站。跨客戶端匯入失敗時,先確認原始格式與核心支援情況,再判斷是否真的需要轉換。
更換平台前,建議記下訂閱群組名稱、路由策略與 DNS 設定,不要直接複製整個執行目錄。不同系統的設定路徑、權限機制與網路入口各有差異,逐項遷移更容易判斷問題出在哪一層。若現有連線可正常使用,請保留原客戶端與設定,等新環境確認無誤後再清理。
先建立一條可重現的基本連線,再設定分流與 DNS。以下三個步驟可協助了解操作順序;實際選單與權限提示請參考完整教學。
在訂閱群組設定中新增來源,填入別名與完整訂閱網址,儲存後更新目前群組。匯入成功只代表網址已儲存,還需確認群組中已出現可辨識的伺服器設定。若清單為空,請先檢查篩選條件、訂閱是否有效,以及更新日誌。
單一分享連結與訂閱網址是不同的輸入類型。匯入單一連結後通常只會新增一筆設定,後續參數變更也不會隨訂閱更新自動同步。請勿將訂閱網址填入伺服器位址欄;若格式錯誤,請回到原始來源確認連結類型。
將一筆設定設為目前使用的伺服器,啟動連線,並依需求啟用系統代理。桌面端先用會遵循系統代理設定的瀏覽器測試;Android 裝置則確認已授予 VPN 權限。入口設定負責讓請求進入客戶端,路由策略才負責決定請求進入後要如何出站。
「全域代理」可能是指系統代理入口,也可能是路由中的全部代理策略;閱讀教學時請確認它指的是哪個選單。首次設定時先保留預設路由,避免同時調整 TUN、FakeDNS 與自訂出站,以免發生問題後難以判斷原因。
分別測試需要代理的網站、直連網站與區域網路資源,確認行為符合預期。若發生逾時、握手失敗或解析錯誤,請記下對應時段的日誌。能匯入訂閱不代表能連上伺服器;一次成功開啟網頁,也無法證明所有分流規則都已驗證。
確認基本連線可用後,再逐項加入 DNS 與路由調整。測試結束時,也要確認退出客戶端後網路是否恢復正常。若只有特定應用程式異常,請先確認它是否讀取系統代理,再決定要設定應用程式內的代理,或改用其他流量入口。
客戶端名稱、核心家族與代理協定屬於不同層級。了解各自負責的設定範圍,比單純記住軟體名稱更有助於遷移與排錯。
Project V 是由網路代理工具及相關功能所構成的開源生態背景,V2Ray 是其中廣泛使用的專案。日常使用的圖形化客戶端,會在這類核心功能之上提供訂閱管理、伺服器選擇與參數設定介面。介面中儲存的是設定,實際建立連線、執行路由與處理解析的則是執行中的核心。因此,客戶端能顯示某個協定名稱,不代表目前使用的核心一定支援任意傳輸組合。
v2rayN、v2rayNG 與 v2flyNG 都是開源客戶端專案,但並不是同一個程式換了不同外觀。桌面與 Android 環境在權限、網路接入與背景執行機制上有所不同,設定項目也不會完全對應。閱讀設定說明時,應一併確認客戶端名稱、使用的核心與特定功能,避免將某款客戶端的設定檔原封不動匯入另一款。
V2Fly 社群持續維護 V2Ray 相關實作,Xray 則是從 V2Ray 發展而來的另一個核心專案。兩者共用部分協定與設定概念,也各自發展不同功能與欄位。選擇時應依伺服器需求,確認目前的核心是否支援所需協定、傳輸方式、安全層、網域參數及其他選項,而不是假設名稱相近就能完全互換。
桌面端 v2rayN 提供多核心相關設定選項;Android 端 v2rayNG 使用 Xray 核心,v2flyNG 使用 V2Fly 核心,可依既有設定需求選擇。若需要特定協定擴充功能,請先確認核心支援情況,再選擇客戶端。只需要基本訂閱與日常連線時,先使用與訂閱相容的預設組合,通常比頻繁切換核心更容易維護。
開源代表專案程式碼依相應授權公開,使用、修改與散布仍須遵守各專案的授權條款。V2Fly 的 V2Ray 與 Xray-core 使用 MPL-2.0;客戶端專案也各有授權說明,不能將核心授權視為所有介面程式與附帶元件的共同授權。若要重新散布或修改,請分別閱讀實際使用專案的授權條款及第三方元件說明。
程式碼公開與遠端服務是否可信,是兩件不同的事。客戶端本身無法決定訂閱提供者如何處理帳戶、連線與服務紀錄,也不保證一定有可用伺服器。請妥善保管訂閱連結,視同帳戶憑證;分享截圖、匯出設定或提交日誌前,應移除驗證欄位、訂閱網址及可辨識個人帳戶的資訊。本站的設定示意僅用於說明設定之間的關係,不包含可供連線的服務參數。
客戶端更新、核心更新、規則資料更新與訂閱更新分別處理不同問題。客戶端更新會影響介面與設定產生方式;核心更新可能改變協定支援或執行行為;規則資料更新會影響分類比對;訂閱更新則同步遠端伺服器參數。某一項更新成功,不代表其他項目也已完成;排查時應先確認最近實際變更了哪些內容。
更新前記下目前可用的設定與自訂規則,更新後先確認核心能否啟動,再測試原有連線與重要服務。若只在新增規則後出現異常,請優先還原該規則;若核心無法啟動,先查看錯誤日誌提及的欄位與檔案路徑。不要把所有異常都歸咎於訂閱問題。若要有系統地記錄訂閱、路由、DNS 與自訂出站設定,可接著閱讀進階設定手冊;遇到具體操作問題,可依分類查閱常見問題。
聚焦單一設定項目:先判斷適用情境,再記錄修改步驟與驗證方式。閱讀文章中的操作說明時,請配合實際使用的客戶端介面、核心支援情況與網路環境。
說明 FakeDNS 如何透過虛擬位址池保留網域與位址之間的對應關係,以及它如何搭配 TUN 模式。請先確認流量入口與解析路徑,再判斷是否需要啟用,並留意與現有應用程式的相容性。
閱讀設定說明 →從訂閱連結失效、取得訂閱時的網路路徑、憑證與系統時間著手,分別檢查網址是否有效及連線方式。接著依群組設定自動更新,避免將伺服器連線異常誤判為訂閱更新失敗。
閱讀排查步驟 →先釐清系統、瀏覽器與客戶端各自可能發出的解析請求,再設定遠端 DNS、路由與 TUN。驗證時應同時檢查查詢路徑與實際存取情況,不要只憑解析伺服器名稱判斷設定是否生效。
閱讀 DNS 實作指南 →