Windows
v2rayNDesktop 提供跨平台介面,WPF 則保留經典桌面操作方式。兩種版本都以訂閱管理與代理設定為主,介面不同不代表需要重新購買或更換訂閱。
先到系統「設定 → 系統 → 系統資訊」確認系統類型。首次啟動若出現執行階段提示,請依安裝檔說明補齊相依元件;更換介面版本前先保留原設定資料夾,避免直接覆寫使用中的檔案。
前往下載 Windows 用戶端 →Project V 生態系 · 用戶端與核心分層
下載入口
桌面版請使用 v2rayN,Android 裝置可優先查看 v2rayNG。先確認作業系統與處理器架構,再前往對應平台的安裝檔清單。
Desktop 提供跨平台介面,WPF 則保留經典桌面操作方式。兩種版本都以訂閱管理與代理設定為主,介面不同不代表需要重新購買或更換訂閱。
先到系統「設定 → 系統 → 系統資訊」確認系統類型。首次啟動若出現執行階段提示,請依安裝檔說明補齊相依元件;更換介面版本前先保留原設定資料夾,避免直接覆寫使用中的檔案。
前往下載 Windows 用戶端 →依晶片選擇 Apple Silicon 或 Intel 安裝檔。開啟系統選單中的「關於這台 Mac」,確認顯示的是晶片名稱還是 Intel 處理器;不要只憑裝置外觀或購買年份判斷架構。
先將用戶端移至「應用程式」資料夾再執行,方便日後更新與管理權限。啟用系統代理和啟用 TUN 是不同操作;初次設定可先確認一般代理連線正常,再依應用程式需求處理網路權限。
前往下載 macOS 用戶端 →v2rayNG 使用 Xray 核心,是 Android 裝置的優先選擇;v2flyNG 使用 V2Fly 核心,適合已有相應設定的使用者。多數較新的手機可先查看 arm64 版本;不確定架構時,請參閱通用版說明。
連線時需確認系統 VPN 授權。若其他網路工具已占用連線,請先停止原有連線。背景連線中斷也可能與電池管理有關;成功匯入設定不代表用戶端已獲准持續在背景執行。
前往下載 Android 用戶端 →依 Linux 發行版的套件格式選擇 deb 或 rpm,再確認 x64 或 arm64 架構。桌面環境中的系統代理通常只影響遵循該設定的程式;終端機工具可能仍須另外設定代理。
首次使用時,先更新訂閱、選擇設定,再測試應用程式連線。若需使用 TUN,請確認相關權限與本機網路管理方式;不要同時調整路由、DNS 和防火牆,以免難以判斷是哪項設定造成變化。
前往下載 Linux 用戶端 →用戶端負責讀取設定並管理本機連線入口;伺服器位址、連接埠與驗證資訊仍須由使用者自行準備。本網站提供下載索引與技術說明,不提供訂閱帳號或節點服務。
查看所有用戶端 →設定步驟
分別檢查設定來源、流量入口與核心出口。選擇設定項目,即可查看相應操作與設定片段。
訂閱適合集中更新多筆設定。在 v2rayN 的「訂閱群組 → 訂閱群組設定」中新增群組,輸入網址並儲存,再執行更新訂閱。單筆分享連結則從剪貼簿匯入,不要填入訂閱網址欄位。相較於逐筆新增,群組更方便區分來源與批次管理;更新會變更群組內容,手動修改前請先匯出要保留的設定。範例網址僅供辨識格式,無法用於實際連線。
https://example.com/sub?token=xxxx
查看訂閱匯入教學 →
流量進入核心後,路由規則才會生效,通常會依序檢查並採用第一條符合的規則。相較於將所有請求交給同一個出口,自訂規則可分別處理本機網路、指定網域及其他流量。以下片段會將中國網域集合與私人 IP 位址交由 direct 處理;實際設定中必須有同名出口,並備妥對應的規則資料庫。修改前請先備份原有規則,每次只調整一類條件,再用目標應用程式測試,避免將連線入口問題誤認為分流問題。
{
"routing": {
"rules": [
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
},
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}
閱讀路由規則實作指南 →
系統代理會透過作業系統設定,提示應用程式使用本機代理,只有遵循該設定的程式會受影響。「自動設定系統代理」會寫入設定,「清除系統代理」會移除設定,「不變更系統代理」則保留目前狀態。TUN 透過虛擬網路介面接收流量,涵蓋方式與一般系統代理不同,也涉及權限、路由與 DNS。建議先確認系統代理運作正常,再視需求啟用 TUN;兩者都不能取代正確的伺服器設定。
排查應用程式未使用代理 →v2rayN 介面負責管理設定,核心則負責協定處理與流量轉送。可用核心與切換方式依目前安裝版本而異;需要選擇時,請在設定中確認相應協定的核心類型。Xray-core 與 v2fly-core 各自發展,不能只因協定名稱相似,就認定所有欄位都相容。更換核心會影響設定解析能力,並非只更換介面。切換後請先查看啟動記錄,確認核心已啟動,再核對傳輸方式、安全參數與伺服器設定是否一致。
查看核心與協定術語 →跨裝置移轉時,優先使用原有訂閱網址;若只有單筆設定,可在伺服器清單中選取項目,透過右鍵選單匯出分享連結,再於目標用戶端從剪貼簿匯入。不同介面的選單名稱可能略有差異,請依匯出與匯入功能確認操作。相較於複製整個資料夾,分享連結更適合傳遞連線參數,但通常不含完整路由、DNS 與系統權限設定。移轉後請重新檢查本機連接埠與代理模式;含驗證資訊的連結只應在受控裝置間傳送。
查看各平台安裝與移轉說明 →匯入後先確認有可選設定,再確認核心能否啟動,接著檢查應用程式的連線入口,最後才調整路由與 DNS。瀏覽器能開啟某個網頁,只代表這次請求成功,不能證明所有程式都使用相同的代理設定。若要進一步判斷,請使用同一個應用程式與目標重複測試,並記錄剛才變更的設定。每次只改一項,回復時才有明確依據。
開源生態系與維護範圍
用戶端、核心與訂閱服務各處於不同層次。了解各自負責的部分,比只記住軟體名稱更有助於選擇與排查。
Project V 是以代理通訊工具為核心的技術生態系,V2Ray 是其中廣泛使用的實作。V2Fly 延續 V2Ray 社群的維護與開發,Xray 則以相關程式碼為基礎獨立發展。兩者共享部分概念,但新增功能、設定欄位與發行時程並不完全相同。閱讀設定文件時,請確認文件所對應的核心,不要將某個實作的設定直接套用到另一個實作。
協定名稱、傳輸方式與安全層也應分開理解。VMess、VLESS、Trojan 與 Shadowsocks 各代表不同的協定方案;WebSocket 等傳輸設定描述資料如何承載,TLS 等安全設定則屬於另一層。選擇用戶端前,先確認現有伺服器需要哪些功能,不必為了更多設定選項而更換已相容的工具。具體欄位應以伺服器提供的參數及目前核心的支援範圍為準。
v2rayN 適用於桌面系統,可管理訂閱群組、伺服器設定、路由與本機代理入口。v2rayNG 適用於 Android,使用 Xray 核心;v2flyNG 同樣適用於 Android,採用 V2Fly 核心。三款用戶端都是開源專案;介面負責整理操作,實際協定功能則取決於隨附核心與設定。桌面與手機可使用相容的同一份訂閱,但本機網路設定不宜直接照搬。
Android 系統 VPN 授權、桌面系統代理與 TUN 權限屬於不同機制。移轉時可以沿用連線參數,但不能因此假定所有應用程式都已接入代理。若只想比較用戶端定位,先查看作業系統、核心路線與設定管理方式;若要確認特定協定是否可用,則應進一步核對傳輸與安全參數。選擇用戶端時,不應以介面複雜度或設定選項數量推斷速度。
開源代表程式碼依照相應授權條款公開,可依授權約定閱讀、使用或修改。V2Fly 的 V2Ray 核心主要採用 MIT 授權,Xray 核心主要採用 MPL-2.0 授權;用戶端、核心與附帶元件的授權應分別查看專案隨附說明,不能以單一專案的授權取代整個安裝套件的授權判斷。若要重新散布或修改,請保留適用聲明並確認相關義務。
程式碼公開不代表每份訂閱都可信,也不能取代對設定來源的判斷。訂閱網址可能包含存取憑證,分享連結通常含有伺服器位址與驗證參數。排查問題時可保留錯誤類型、核心名稱及相關設定,並移除可識別帳戶的資訊。使用用戶端也應遵守所在地法律及所用網路的管理規範;本文僅說明軟體安裝與技術設定。
用戶端更新會影響介面與設定產生方式,核心更新會影響協定解析與流量轉送,GeoIP、GeoSite 資料更新則會影響規則集合。三類更新解決的問題不同。若網域分流結果改變,應檢查規則引用與資料庫;若設定無法解析,應先查看記錄與核心相容性。不要將所有問題都歸咎於用戶端版本過舊,也不要一次更新所有元件後才猜測原因。
更新前先備份訂閱群組與手動維護的規則,確認可以還原舊設定,再依下載頁的套件類型與架構選擇下載項目。本網站整理安裝與設定步驟,並非用戶端官方開發團隊,也不保證伺服器連線正常。教學中的介面文字供辨識功能之用,實際版面可能隨用戶端版本變動;若有差異,請以目前介面與記錄輸出為準。
設定與疑難排解紀錄
先釐清症狀,再查看相應步驟。以下三篇分別處理應用程式連線入口、用戶端啟動與規則比對,避免將不同層面的問題混為一談。
瀏覽器未使用代理,常見原因是擴充功能或代理設定遭覆寫;終端機未使用代理,則需手動設定環境變數。本文分別說明兩種情況的檢查順序。
閱讀文章 →依常見程度整理用戶端啟動後立即關閉的原因:缺少 .NET 桌面執行階段、安裝資料夾沒有寫入權限,或核心檔案遺失、遭封鎖,並逐一提供處理方式。
閱讀文章 →以 v2rayN 自訂路由為例,逐一說明 domain、ip、outboundTag 欄位,示範直連、代理、封鎖三種規則的排序與常見寫法。
閱讀文章 →用戶端不會內建個人伺服器帳號。你需要準備有效的訂閱或單筆分享連結,匯入並選取設定後才能連線。訂閱更新失敗時,先檢查網址格式、來源狀態與網路連線;不要任意將含有憑證的網址交給線上轉換服務。操作步驟請參閱使用指南。
不是。系統代理決定遵循系統設定的應用程式是否將請求交給本機入口;「全域」通常是用戶端的路由預設,決定已進入核心的流量使用哪個出口。應用程式尚未接入時,切換路由模式無法解決入口問題。相關概念請參閱術語表。
轉換主要是改變設定的表示方式,無法讓核心取得原本不具備的協定功能,也可能遺失部分專有欄位。請優先使用來源提供的相容訂閱;確實需要轉換時,先確認工具來源、欄位保留情況與憑證處理方式,再逐項檢查結果。更多說明請參閱說明中心。
先比較目前使用的設定與核心支援情況,再確認裝置時間、網路環境及應用程式的代理入口。不要將正常裝置的整個設定資料夾直接覆蓋到另一個平台。分享連結可傳遞連線參數,但本機權限、DNS 與路由仍須分別確認。各平台操作步驟請參閱完整安裝指南。