Windows
v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面,WPF 版則保留經典操作版面。首次安裝前請先確認系統需求;若已有設定,請先備份訂閱群組與路由設定。
安裝後先匯入一份有效訂閱,再選擇伺服器並設定系統代理。TUN 需要額外權限並會使用網路介面,首次測試時不必一併啟用;先確認基本代理可用,較容易區分設定錯誤與權限問題。
前往下載整理四大平台客戶端下載入口,說明訂閱匯入與路由分流的設定順序。
v2rayN 靜態介面示意。選單名稱與版面可能隨客戶端更新而調整,指示燈與開關不代表本機連線狀態。
CLIENT DIRECTORY
桌面平台可從 v2rayN 開始;Android 首選 v2rayNG,若要使用 V2Fly 核心設定,也可考慮 v2flyNG。先確認作業系統與處理器架構,再前往對應的下載入口。
v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面,WPF 版則保留經典操作版面。首次安裝前請先確認系統需求;若已有設定,請先備份訂閱群組與路由設定。
安裝後先匯入一份有效訂閱,再選擇伺服器並設定系統代理。TUN 需要額外權限並會使用網路介面,首次測試時不必一併啟用;先確認基本代理可用,較容易區分設定錯誤與權限問題。
前往下載v2rayN 依 Apple Silicon 與 Intel 晶片提供不同安裝入口。請在系統的「關於這台 Mac」查看晶片或處理器資訊,依實際架構選擇,不要只憑電腦外觀或購買年份判斷。
請先將應用程式安裝至合適的位置,再執行。若系統顯示安全性提示,請先確認下載來源與應用程式資訊,再依系統設定中的指示處理。匯入訂閱後仍須選擇代理模式;只開啟視窗,不會讓所有應用程式自動使用代理。
前往下載v2rayNG 使用 Xray 核心,v2flyNG 使用 V2Fly 核心。較新的主流裝置通常選擇 arm64;不確定架構時,可查看通用版。兩款應用程式支援的協定與參數處理方式,仍須以實際核心支援為準。
首次啟動連線時,系統會要求授予 VPN 權限。授權只是接管流量的必要條件,不代表遠端伺服器可用。若鎖定螢幕後連線中斷,請檢查背景執行、省電限制與個別應用程式代理規則,避免誤以為訂閱失效。
前往下載v2rayN 提供 deb 與 rpm 安裝套件,並區分 x64 和 arm64。請先確認 Linux 發行版使用的套件格式,再確認處理器架構;套件格式相同,不代表桌面相依套件、權限政策與系統代理行為完全一致。
圖形桌面的系統代理通常只影響遵循該設定的程式。終端機工具、容器及自行管理代理設定的應用程式,須分別確認。啟用 TUN 前,請檢查權限與現有虛擬網路;若發生異常,先還原原本的網路路徑再排查。
前往下載客戶端負責儲存設定並呼叫核心,不等於可用的伺服器。訂閱是批次取得伺服器參數的方式之一,其有效期限、存取權限與格式由提供者決定。安裝前請準備可信來源的訂閱或完整設定,別把「安裝完成」當成「連線完成」。
初次使用時,只匯入一個來源、選擇一台伺服器,並以一種代理模式完成驗證。確認成功後,再新增訂閱群組、自訂路由或 TUN。每次只變更一項設定,並記錄修改前後的情況,日後發生問題才知道如何還原。
CONFIGURATION NOTES
圖形客戶端會將常用設定整理成選單;核心則依產生的設定處理流量。以下片段用於說明欄位關係,並非可直接連線的完整設定。
訂閱用於集中更新伺服器參數,不是客戶端登入帳號。請先在訂閱群組中儲存連結並命名,再執行更新;匯入成功後,仍須選擇要使用的伺服器。不同來源應分組儲存,方便找出失效連結,也能避免更新時與手動設定混淆。若解析失敗,請先檢查連結是否過期、回應內容及格式是否受支援,不要連續重裝客戶端。訂閱通常包含存取憑證,分享記錄或螢幕截圖前,請遮蔽完整連結。下方為無法使用的格式範例。
https://subscription.example.com/list?token=xxxx
路由會依網域、目標位址、連接埠等條件選擇出口,規則順序會影響最終結果。請將明確的例外規則放在較廣泛的規則之前,並確認引用的出口標籤已經定義。網域規則與位址規則依據的資訊不同;修改 DNS 後,也應重新檢查規則命中情況。以下片段將私有位址交由直連出口處理,適合用來說明規則結構;它不是完整的分流方案,也未包含所有 DNS 設定。匯入他人規則前,請先確認核心支援的語法與規則資源。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}
系統代理會將本機代理位址寫入作業系統設定,主要影響遵循該設定的應用程式;TUN 則透過虛擬網路介面接管符合路由條件的流量,通常需要額外權限。兩者不是連線品質的高低等級。排查時請先選擇其中一種方式,避免與其他網路工具疊加使用。下方展示本機 SOCKS 入站欄位,連接埠僅為設定範例,並非所有安裝都使用固定值。應用程式若自行填寫代理,位址、連接埠與協定必須和客戶端實際監聽的設定一致。
{
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": true
}
}
]
}
客戶端負責編輯與管理,核心負責處理協定;切換核心不會自動轉換所有設定。請先確認目標核心支援所需的協定、傳輸方式與安全參數,再檢查產生的設定與啟動記錄。桌面端可依客戶端提供的選項選擇核心;Android 上的兩款客戶端採用不同核心路線,不應視為只改名稱的同一個應用程式。下方的記錄欄位有助於理解核心設定層,但不能只憑記錄等級判斷伺服器是否相容。
{
"log": {
"loglevel": "warning"
}
}
此處所說的跨平台同步,是指移轉訂閱或設定,不代表客戶端內建雲端同步功能。訂閱可以分別匯入不同裝置;本機監聽連接埠、系統代理、TUN 權限與個別應用程式規則,則須依平台重新設定。移轉前請備份原有設定,移轉後先更新訂閱並測試單一伺服器,再還原路由。下方片段可用來了解直連出口;完整設定能否沿用,取決於核心與欄位支援情況,不能只靠檔案副檔名判斷相容性。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
}
]
}
PROJECT / CORE / CLIENT
專案、核心與圖形介面屬於不同層次。釐清這三者,有助於選擇客戶端,也能縮小設定失敗時的排查範圍。
PROJECT V
V2Ray 是 Project V 生態系中的代理工具,設定圍繞入站、出站、路由與傳輸等概念組成。日常所稱的「V2Ray 客戶端」,通常是指管理這些設定的圖形應用程式,而非單一核心程式。了解這項差異,就能明白為什麼同一份訂閱在不同應用程式中會呈現不同選單,也能理解介面更新與協定支援更新不一定同步。
伺服器設定通常由協定、位址、連接埠、識別資訊、傳輸方式與安全參數共同組成。只看到 VMess、VLESS 或其他協定名稱,還不足以判斷設定能否連線。傳輸層選項、伺服器端要求,以及客戶端實際呼叫的核心都必須相符。教學中的術語應作為核對參數的線索,而不是將特定協定名稱視為速度或穩定性的保證。
V2FLY / XRAY
V2Fly 社群持續維護 V2Ray 相關實作;Xray 則是從 V2Ray 發展出的另一條核心路線。兩者共享部分設定概念,也各自持續演進。教學中出現相似的 JSON 欄位,不代表所有新增選項都能跨核心使用。匯入失敗、啟動報錯與執行後連線失敗,屬於不同階段;處理前應先確認實際使用的核心,再依該階段的錯誤訊息排查。
更換圖形客戶端時,優先移轉雙方都支援的訂閱或分享連結。直接複製整份自訂設定,可能連同平台專用路徑、資源檔案引用與監聽設定一併帶入。遇到不相容欄位時,請先保留原始設定並查明用途,避免刪除報錯欄位後雖然可以啟動,卻改變原有路由或安全行為。選擇核心應依設定需求,而非是否採用較新的名稱。
OPEN SOURCE
v2rayN 是桌面端開源圖形客戶端,可集中管理伺服器、訂閱群組、路由與核心呼叫。v2rayNG 是使用 Xray 核心的 Android 開源客戶端;v2flyNG 則採用 V2Fly 核心路線。三者提供的是設定與連線工具,伺服器來源須另行準備,訂閱服務是否可用也不由圖形介面決定。選擇時先確認平台,再確認所需協定與設定是否受支援。
V2Ray 與 Xray 核心採用 MPL-2.0 授權;這三款圖形客戶端則採用 GPL-3.0 授權。授權條款說明程式碼使用、修改與散布的條件,不等同於遠端服務的使用條款,也不能取代對訂閱來源的判斷。客戶端、核心及隨附元件可能各自適用不同授權;若涉及重新散布或修改,應以各專案隨附的授權文字為準。
開源表示程式碼與協作過程可以接受檢視,不代表所有來源的安裝檔、設定與訂閱都同樣可信。含有帳號或訂閱憑證的內容應存放於受控位置;公開求助時只提供必要的錯誤資訊,並隱去識別欄位、完整位址中的存取權杖,以及其他可還原訂閱權限的內容。
MAINTENANCE
客戶端更新可能會調整介面、相依環境、設定產生方式或隨附核心。升級前請保留訂閱來源、自訂路由與重要本機設定,並閱讀目前的版本發行說明。升級後先確認能否啟動及更新訂閱,再測試系統代理或 TUN,最後檢查自訂規則。一次變更多個環節會讓問題難以追查,尤其是同時替換訂閱、切換核心並調整 DNS 時。
升級核心也無法解決所有連線問題。訂閱過期需更新來源,系統時間錯誤需先校正時間,權限不足需處理系統授權,遠端服務無法使用則應確認服務狀態。與其反覆安裝,不如保留可重現的測試條件:使用相同網路、相同伺服器與相同目標應用程式,每次只調整一項,再記錄記錄檔的變化。
READING PATH
RECENT NOTES
從本機網路、訂閱群組與 Android 背景權限著手。先找出問題發生的環節,再決定是否要修改設定。
依序檢查本機網路、系統代理與 TUN、客戶端路由規則、核心記錄及節點參數,判斷逾時發生在本機還是伺服器端。
閱讀文章同時使用多個訂閱來源時,可用訂閱群組區隔來源,再搭配別名關鍵字篩選、排序與批次測試,讓伺服器清單更清楚。
閱讀文章v2rayNG 透過 Android VpnService 接管流量。本文整理授權提示、廠商省電策略造成的背景連線中斷,以及個別應用程式代理的設定方式。
閱讀文章