v2rayN
Windows 桌面客戶端
Desktop:新一代跨平台介面,首次安裝可從此版本開始。
WPF:經典穩定版,適合延續熟悉的 Windows 操作方式。
版本差異:Desktop 與 WPF 版的主要差別在介面技術和操作方式,並非使用兩種不同協定。節點能否使用,仍取決於訂閱欄位、所選核心及伺服器設定。若目前環境運作正常,切換介面版本前請先備份,避免混淆介面變更與連線問題。
桌面端選擇 v2rayN;Android 優先選 v2rayNG,需要確認 V2Fly 核心設定相容性時再考慮 v2flyNG。排序依據是平台與核心的相容性,不採用評分。
介面挑選:先決定使用 Desktop 或經典 WPF,再確認系統架構。以下兩個下載項目皆為 x64 壓縮安裝包,下載後請先解壓縮,再執行其中的安裝程式。
Windows 桌面客戶端
Desktop:新一代跨平台介面,首次安裝可從此版本開始。
WPF:經典穩定版,適合延續熟悉的 Windows 操作方式。
版本差異:Desktop 與 WPF 版的主要差別在介面技術和操作方式,並非使用兩種不同協定。節點能否使用,仍取決於訂閱欄位、所選核心及伺服器設定。若目前環境運作正常,切換介面版本前請先備份,避免混淆介面變更與連線問題。
晶片挑選:開啟系統選單中的「關於這台 Mac」,確認顯示的是 Apple 晶片還是 Intel 處理器。建議下載與裝置原生架構相符的安裝包。
macOS 桌面客戶端
arm64:適用於搭載 Apple 晶片的 Mac。
x64:適用於搭載 Intel 處理器的 Mac。
安裝方式:開啟 DMG,依視窗指示將應用程式拖曳至「應用程式」資料夾,再從該資料夾啟動。請勿長期直接從已掛載的磁碟映像檔執行,否則更新、權限與設定檔位置可能較難管理。首次執行若出現安全性提示,請先確認檔案來源及系統顯示的原因,再透過系統設定中的正式授權流程處理。
客戶端挑選:優先選用採用 Xray 核心的 v2rayNG;需要 V2Fly 核心相容性時再選 v2flyNG。2015 年後的主流手機通常適用 arm64,仍應以裝置支援的應用程式架構為準。
Android · Xray 核心
主流裝置請優先確認是否支援 arm64-v8a。
不確定裝置架構時可選;內含多種架構元件。
挑選理由:v2rayNG 適用於以 Xray 設定生態系為主的 Android 使用情境。若訂閱包含 VLESS、REALITY 等設定,請確認實際核心版本及欄位支援情況,不要只看客戶端名稱。首次連線時須確認系統 VPN 授權;授權代表允許客戶端建立本機流量通道,並不表示已取得可用的伺服器。
查看 Android 訂閱匯入與連線步驟 →Android · V2Fly 核心
裝置支援 arm64 時,優先選擇此下載項目。
適用於需要多種架構元件的裝置。
適用範圍:v2flyNG 是採用不同核心家族的備選,不是 v2rayNG 的另一種介面。不能只因介面或訂閱格式相似,就認定兩者功能相同。移轉前請確認協定、傳輸方式、安全參數與自訂設定;依賴 Xray 專用欄位的設定,不應直接假設 V2Fly 核心也能處理。
查看核心與設定相容性 →| 檢查項目 | 挑選依據 | 安裝後檢查 |
|---|---|---|
| 裝置架構 | 主流裝置通常選 arm64;不確定時請查閱裝置規格,或選擇通用版。 | 若顯示不相容,請檢查系統與應用程式架構。 |
| 系統相容性 | 最低系統版本請以安裝程式的實際要求為準。 | 記錄完整錯誤訊息,勿只是不斷重新下載。 |
| 安裝授權 | 依系統提示,僅為本次使用的檔案來源開放安裝權限。 | 安裝完成後,可撤銷臨時授權。 |
| 連線授權 | 連線時請確認系統 VPN 授權提示,並留意是否已有其他 VPN 應用程式正在使用。 | 避免多個應用程式同時使用同一連線通道。 |
背景執行:若鎖定螢幕後連線中斷,請先確認系統的電池最佳化、背景活動與應用程式休眠設定,再查看客戶端記錄。通用安裝包不會自動解除背景執行限制;頻繁更換架構版本也無法修復無效訂閱或無法連線的伺服器。
更新限制:若同名應用程式因簽章不同而無法覆蓋安裝,請先備份設定並確認來源,不要立即解除安裝。解除安裝可能會清除應用程式資料;確認移轉步驟後,再決定是否移除舊版。
套件格式挑選:先確認發行版使用 deb 或 rpm,再確認 x64 或 arm64。副檔名代表套件管理系統,不能只靠重新命名將一種套件轉成另一種。
Linux 圖形介面客戶端
適用於採用 deb 套件管理系統的 x64 桌面環境。
還須符合目標發行版與相依套件版本需求。
相容範圍:相同套件格式不代表所有發行版都能安裝。系統函式庫、桌面元件與套件相依性仍須符合安裝包需求,尤其不要只因副檔名是 rpm 就強制跨發行版安裝。建議先用系統的圖形化軟體安裝程式開啟檔案,查看相依性解析結果後再確認安裝。
查看路由、DNS 與 TUN 設定 →連線準備:安裝完成只代表客戶端可以執行。請先確認設定來源,再逐步啟用代理功能,減少排查時互相干擾的變數。
訂閱管理:將有效連結加入訂閱群組,更新後確認是否產生可辨識的節點。連結過期、回傳內容異常或欄位不相容,須分別處理。請勿將完整訂閱連結貼在公開截圖或討論區。
訂閱匯入步驟 →模式挑選:桌面端先測試系統代理,Android 端依提示建立 VPN 通道。只有確實需要接管更多應用程式流量時才啟用 TUN,並確認權限與 DNS 設定。系統代理、路由策略和 TUN 屬於不同層面的設定。
路由設定說明 →排查順序:先檢查本機監聽與代理狀態,再檢查訂閱設定、系統時間及伺服器連線狀況。每次只修改一項設定,並保留錯誤訊息。單次連線逾時,無法判斷是客戶端設定、網路路徑或伺服器出了問題。
查看常見連線問題 →適用範圍:先處理安裝包、架構與更新問題;連線設定則請參閱教學與進階用法。