Windows
v2rayN / Desktop · WPF
桌面版採用跨平台介面,WPF 版則保留經典桌面操作方式。下載前先確認套件類型,兩個下載入口並不代表使用不同協定。已有設定的使用者,遷移前應備份訂閱群組、路由設定與本機監聽連接埠記錄。
初次使用可先匯入一筆設定、選擇作用中的伺服器,再設定系統代理。若瀏覽器能連線、其他程式卻不行,先確認程式是否會讀取系統代理,不要一再更換伺服器。兩個版本的介面細節可能不同,請以目前顯示的選單名稱為準。
前往下載 Windows 用戶端01 / CLIENT SHELF
先確認作業系統與處理器架構,再選擇安裝套件。桌面端使用 v2rayN;Android 建議先查看 v2rayNG,如需 V2Fly 核心再比較 v2flyNG。安裝套件與連線參數須分開確認;安裝用戶端後,仍需匯入可用的設定。
v2rayN / Desktop · WPF
桌面版採用跨平台介面,WPF 版則保留經典桌面操作方式。下載前先確認套件類型,兩個下載入口並不代表使用不同協定。已有設定的使用者,遷移前應備份訂閱群組、路由設定與本機監聽連接埠記錄。
初次使用可先匯入一筆設定、選擇作用中的伺服器,再設定系統代理。若瀏覽器能連線、其他程式卻不行,先確認程式是否會讀取系統代理,不要一再更換伺服器。兩個版本的介面細節可能不同,請以目前顯示的選單名稱為準。
前往下載 Windows 用戶端v2rayN / Apple Silicon · Intel
在系統的「關於這台 Mac」查看晶片資訊。Apple Silicon 與 Intel 使用不同安裝套件,不能只靠副檔名判斷。將 App 移至「應用程式」資料夾後,再依系統提示確認是否開啟及授予網路權限,避免從暫存位置反覆啟動。
分別檢查系統代理與流量接管權限。若升級後連線行為有所改變,先確認用戶端是否已啟動核心,再查看系統代理是否指向目前的監聽連接埠。若遇到開發者提示,請依系統設定中的安全性提示處理,不建議為了啟動 App 而全面關閉系統安全機制。
前往下載 macOS 用戶端v2rayNG / v2flyNG
v2rayNG 主要使用 Xray 核心,v2flyNG 則提供 V2Fly 核心選項。兩款 App 名稱相近,但支援的協定欄位不一定相同。選擇前請確認設定是否包含 REALITY、特定傳輸方式或其他與核心相關的參數。
依裝置架構選擇 arm64 或通用套件,安裝後匯入訂閱,並確認系統 VPN 授權。此授權是讓 App 接管裝置流量,並不表示用戶端附帶遠端服務。若 App 切換至背景後連線中斷,請檢查電池最佳化、背景活動限制,以及是否與其他 VPN 類 App 衝突。
前往下載 Android 用戶端v2rayN / deb · rpm
先確認 Linux 發行版使用的套件管理系統,再選擇 x64 或 arm64。deb 與 rpm 是安裝套件格式,不是連線協定;選錯通常會在安裝階段出問題,而非路由階段。圖形桌面環境也可能影響代理設定,不能假設所有 App 都會自動沿用。
安裝後確認本機監聽連接埠及核心執行狀態,再設定瀏覽器或桌面系統代理。終端機程式可能需要另外設定代理參數。若只有特定程式無法連線,先確認該程式的代理設定;如需接管更多流量,再評估目前用戶端的 TUN 功能與權限需求。
前往下載 Linux 用戶端02 / CONFIG INSPECTOR
用戶端負責管理介面設定,核心則負責執行連線與分流。以下分別說明兩層設定:訂閱群組屬於用戶端管理資料;入站、出站、路由與 DNS 則是常見的核心設定。程式碼均為局部範例,請勿直接覆蓋整份執行設定。
訂閱可用來批次取得連線設定,群組則方便在用戶端中區分來源。先建立群組,再填入訂閱網址並更新,確認回傳內容能由目前的用戶端解析。更新後檢查節點名稱、協定與傳輸欄位,不要只看清單中是否出現項目。群組名稱與自動更新間隔屬於用戶端設定,並非通用核心欄位。下方僅示範匯入後可能產生的出站結構;範例未包含遠端認證資料,無法據此建立代理連線。若要整理多個來源,可再設定篩選條件並保留原始群組。
{
"outbounds": [
{ "tag": "direct", "protocol": "freedom" },
{ "tag": "block", "protocol": "blackhole" }
]
}
路由會依規則順序決定流量使用哪個出站,通常先符合的規則會先執行。先處理私人 IP 位址,再加入明確的網域或 IP 規則,最後確認未符合規則的流量預設會往哪裡走。規則中的出站標籤必須與出站清單完全相同,否則即使規則存在也無法如預期運作。下方範例將私人 IP 位址交由直連出站處理,並需要對應的地理資料檔案。相較於只切換全域模式,規則分流能保留區域網路存取路徑,但也須檢查網域解析時機與規則涵蓋範圍。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}
選擇核心應以連線參數為準,而非只看用戶端名稱。先確認協定、傳輸方式與安全層,再確認目前核心是否支援這些欄位。若涉及特定擴充功能,不能假設另一個核心也能直接讀取相同設定。切換前請保留現有設定,切換後查看啟動記錄與產生的設定,確認實際執行的核心。下方的記錄層級可協助初步排查;暫時提高詳細程度後,請記得調回原設定。執行記錄可能包含位址與連線資訊,分享前請移除敏感內容。
{
"log": {
"loglevel": "warning"
}
}
系統代理只會影響願意讀取系統代理設定的 App,不能視為接管所有流量。先用本機代理入站確認連線,再評估是否需要 TUN。TUN 功能取決於用戶端、搭配元件、核心與系統權限,不是替任意設定加個開關就能啟用。下方示範僅監聽本機的 SOCKS 入站,可讓 App 手動填入代理位址;這不是 TUN 設定。切換模式時請留意其他代理軟體、虛擬網卡與 DNS 設定,避免同時接管造成流量迴圈。
{
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth", "udp": true }
}
]
}
DNS 設定需從 App、系統與核心三個層面檢查。在用戶端填入解析器,不代表所有 App 的查詢都會進入核心。先確認網域在哪裡解析,再檢查解析器的連線路徑是否依賴尚未建立的代理連線。下方示範透過本機環境解析的基本寫法,適合用來說明欄位位置,但不一定適用於所有網路。若 IP 位址可連線、網域名稱卻不行,應先比對解析結果與路由策略,避免只更換解析器,卻漏了查詢流量未進入核心的問題。
{
"dns": {
"servers": ["localhost"]
},
"routing": {
"domainStrategy": "AsIs"
}
}
區域網路分享需要同時正確設定監聽位址、系統防火牆及其他裝置的代理。只監聽迴圈位址時,其他裝置無法連線;若開放所有介面,還須限制可存取的來源。下方是含認證的 HTTP 入站局部範例,認證資料為教學用假值,使用前務必更換。其他裝置應填入電腦的區域網路位址,而非迴圈位址。分享功能僅適用於可信任的網路,請勿將代理連接埠轉發至公網;不再需要分享時,應關閉監聽或恢復僅限本機存取。
{
"inbounds": [
{
"tag": "lan-http",
"listen": "0.0.0.0",
"port": 10809,
"protocol": "http",
"settings": {
"accounts": [
{ "user": "example-user", "pass": "your-password" }
]
}
}
]
}
03 / OPEN-SOURCE ECOSYSTEM
用戶端、核心、協定與遠端服務屬於不同層次。了解這些界線,有助於釐清為何同一份訂閱在不同 App 中的表現不一,也能避免排查時把權限、解析與伺服器參數問題混為一談。
ORIGIN / PROJECT V
Project V 是認識 V2Ray 生態系的起點。V2Ray 透過入站、出站、傳輸、路由與網域解析組織代理功能,並以設定檔串連這些模組。日常搜尋所說的「V2Ray 用戶端」,通常是指管理這些功能的圖形化 App,不一定代表某個特定核心。下載用戶端前,請先分清楚選擇的是管理介面,還是負責執行連線的程式。
V2Fly 延續 V2Ray 的社群開發路線;Xray 則發展成另一個核心分支,並加入自有的協定與傳輸擴充功能。兩者背景相近,部分基礎設定概念也相似,但不代表所有欄位都相容。參照說明時,除了檢查欄位名稱,也要確認範例適用於哪個核心,以及用戶端實際呼叫的核心是否相符。
CLIENT / THREE APPLICATIONS
v2rayN 適用於桌面系統,可管理訂閱、選擇伺服器、編輯路由及設定本機代理等。跨平台介面讓桌面使用者能沿用相近的操作方式,但作業系統權限、安裝方式與系統代理機制仍有差異。移轉至其他裝置時,應先轉移必要設定,再確認監聽連接埠與接管模式,不要直接套用另一台電腦的全部環境設定。
v2rayNG 與 v2flyNG 適用於 Android,常見使用方向分別對應 Xray 與 V2Fly。兩者都是開源用戶端,主要差異應從核心能力、可識別欄位與 App 設定來判斷。能匯入訂閱不代表每筆連線都能正常運作;解析成功後,還需確認協定、安全層、傳輸參數與系統授權。桌面與手機共用同一來源時,也應分別測試。
LICENSE / SOURCE CODE
V2Fly 核心採用 MIT 授權,Xray-core 採用 MPL-2.0 授權;用戶端、核心與附加元件各自適用的授權條款應分別閱讀。開源說明的是程式碼使用與散布的條件,不等於遠端服務的收費資訊,也不代表在所有網路環境中都有相同表現。用戶端可免費使用,連線所需的伺服器與訂閱則由使用者自行準備。
開源生態系的價值,在於實作方式可以被討論、檢視與改進,也能依據具體模組定位問題。不過,程式碼公開不代表使用者可以免於判斷設定來源、網路權限與資料處理方式。匯入設定前,應先了解伺服器由誰提供;分享故障資訊時,請移除訂閱網址、身分識別資訊與認證參數,只保留重現問題所需的欄位結構。
UPDATE / COMPATIBILITY
用戶端更新、核心更新與訂閱更新會變更不同內容。用戶端更新可能調整介面、設定產生方式或系統整合;核心更新可能變更協定支援及欄位處理;訂閱更新則主要替換遠端連線資訊。因此,發現變化時,先記錄是哪一層有所變動,再決定要查看記錄、還原設定或重新匯入訂閱,避免同時執行多項操作而無法判斷原因。
升級前請備份可還原的用戶端設定與自訂規則,升級後先測試一筆原本可用的連線。基本連線正常後,再檢查分流、網域解析與區域網路分享。不要只以介面顯示「執行中」作為驗證結果:核心啟動成功只代表程序已在運作;實際請求是否走向預期的出站,還須搭配 App 代理設定與記錄中的路由結果判斷。
READING / CONFIGURATION PATH
04 / FIELD NOTES
依照操作情境補充說明。修改前先確認問題與監聽、權限、設定產生方式或遠端連線哪一項有關,再查看相應文章。文章中的局部範例用於說明設定之間的關係,實際參數仍須符合使用環境。
開啟允許區域網路連線後,確認監聽位址與連接埠、在系統防火牆中放行,再於其他裝置設定 HTTP 或 SOCKS 代理,即可在同一區域網路中共用。
閱讀區域網路分享設定 →說明如何判讀核心啟動記錄中的錯誤行,逐一排查 JSON 語法錯誤、連接埠占用、未知協定欄位及 geo 檔案缺失等常見原因。
閱讀核心啟動故障排查 →同時匯入多個訂閱時,如何依來源建立群組、用關鍵字篩選節點並設定自動更新間隔,讓節點清單保持整齊、好管理。
閱讀訂閱群組整理方法 →