v2rayN
推薦 7.24.1Desktop 採用新一代跨平台 UI,適合初次使用者,以及希望在不同桌面系統上維持相同操作習慣的使用者;WPF 則是經典穩定版,保留熟悉的 Windows 介面。擇一安裝即可,不必為了使用不同協定而同時執行兩個版本。
客戶端/安裝包選擇
先選作業系統,再選架構。桌面端使用 v2rayN,Android 優先選 v2rayNG,v2flyNG 則是採用不同核心的替代選項。
同一款客戶端,提供兩種介面。以下下載項目皆適用於 x64 系統。
Desktop 採用新一代跨平台 UI,適合初次使用者,以及希望在不同桌面系統上維持相同操作習慣的使用者;WPF 則是經典穩定版,保留熟悉的 Windows 介面。擇一安裝即可,不必為了使用不同協定而同時執行兩個版本。
| 檢查項目 | 選擇與需求 |
|---|---|
| 系統架構 | 本頁提供的 Windows 安裝包為 x64。可在「設定 → 系統 → 系統資訊」查看系統類型;請勿將 x64 安裝包當成原生 arm64 版本。 |
| 系統環境 | 請使用仍可接收安全性更新的 Windows;最低系統版本與執行階段需求,請以安裝程式提示為準。 |
| 目錄與權限 | 請解壓縮至可寫入的目錄,避免放在權限受限的位置。一般系統代理與 TUN 的權限需求不同,請依實際功能授予權限。 |
下載完成後,先結束正在執行的代理程式,避免監聽連接埠或系統代理設定互相覆蓋。安裝後開啟 v2rayN 的「訂閱群組設定」,新增群組並填入訂閱網址,再執行「更新訂閱」。若只有單一分享連結,可從剪貼簿匯入伺服器;請勿將完整設定 JSON 貼到訂閱網址欄位。
首次連線建議先使用系統代理。選擇伺服器後,查看記錄確認是否正常啟動。部分版本常見的本機 SOCKS 與 HTTP 連接埠分別為 10808 和 10809,實際設定請以設定頁面為準。只有在目標程式不遵循系統代理,且確實需要接管其流量時,才參閱 TUN 設定說明。切換 Desktop 與 WPF 前請先備份,避免兩個版本同時寫入同一份設定。
開啟「關於這台 Mac」,依晶片名稱選擇 DMG。
Apple Silicon 機型請選 arm64,Intel 處理器機型請選 x64。請以「關於這台 Mac」中的晶片或處理器資訊為準,而不是電腦購買年份或目前使用的瀏覽器。v2rayN 在 macOS 上採用跨平台桌面介面。
| 檢查項目 | 選擇與需求 |
|---|---|
| Apple Silicon | 若「關於這台 Mac」顯示 Apple 晶片,請選擇 arm64 DMG,優先使用相符架構的 App。 |
| Intel | 若「關於這台 Mac」顯示 Intel 處理器,請選擇 x64 DMG;arm64 App 無法直接取代。 |
| 系統與安全性許可 | 請使用仍可接收安全性更新的 macOS,並確認目前 App 的最低系統需求。首次開啟時,系統可能會要求確認安全性提示。 |
請勿長期直接從已掛載的磁碟映像檔執行 App。先完成複製,再退出磁碟映像檔,並從「應用程式」資料夾啟動 v2rayN。若系統阻止開啟,確認下載來源無誤後,再依提示前往「系統設定 → 隱私權與安全性」處理。請勿為了省略這個步驟而全面關閉系統安全機制。
匯入訂閱並更新伺服器清單後,再啟用系統代理並測試瀏覽器連線。系統代理不會自動套用至所有終端機程式;終端機工具可能需要另外設定代理網址。啟用 TUN 會涉及權限與網路路由,建議先確認一般代理可正常使用,再依文件逐項設定。更新前請結束舊版 App,並保留可還原的設定備份。
繼續查看 macOS 安裝設定 →優先選 v2rayNG,v2flyNG 為替代選項。請依序選擇,不必同時連線。
Android 日常使用建議優先選擇 v2rayNG。2015 年後的主流手機通常可選 arm64;不確定系統架構時,請選通用版。協定與傳輸能否使用,仍取決於訂閱設定及內含核心;安裝客戶端不會自動補齊伺服器端參數。
若要使用 v2fly 核心生態系的設定,可選擇 v2flyNG。這是獨立的 Android 客戶端,不是安裝在 v2rayNG 上的擴充套件。兩款 App 支援的設定欄位不一定完全相同;匯入使用特定核心功能的分享連結前,請先確認相容性。
| 檢查項目 | 選擇與需求 |
|---|---|
| arm64 | 適用於支援 64 位元應用程式的 ARM 裝置;較新的主流手機通常符合條件,但不能只依硬體年份判斷系統架構。 |
| 通用版 | 不確定架構時可優先考慮。通用包無法略過 App 對最低 Android 系統版本的要求。 |
| 安裝與連線 | 請暫時允許用來安裝的瀏覽器或檔案管理器安裝 App;連線時依系統提示授予 VPN 權限。 |
下載 APK 後,從系統下載清單或檔案管理器開啟。若無法安裝,請先查看錯誤原因:架構不符、系統版本過舊、儲存空間不足及簽章衝突,處理方式各不相同。不要一開始就解除安裝舊版 App;先匯出必要設定,確認是否能從相同來源覆蓋升級,以免遺失訂閱與路由設定。
安裝後,在「訂閱設定」新增訂閱網址並儲存,返回主畫面執行更新,再選擇伺服器並連線。首次連線時,系統會要求授予 VPN 權限;這代表 App 建立了本機流量接管介面,不代表遠端連線已成功。若鎖定螢幕後連線中斷,請再檢查系統的電池最佳化與背景執行限制,僅針對確有需要的 App 調整設定。
繼續查看 Android 安裝設定 →先確認發行版使用的套件格式,再核對 x64 或 arm64 架構。
Debian、Ubuntu 等採用 deb 套件管理的系統請選 deb;採用 RPM 套件管理的發行版請選 rpm,並確認發行版及相依套件相容。以下主要下載項目為 x64;ARM 桌上型裝置請使用下方的 arm64 版本。圖形介面客戶端需要可用的桌面工作階段。
| 檢查項目 | 選擇與需求 |
|---|---|
| 套件管理系統 | deb 和 rpm 不能只更改副檔名就互換。請使用系統的軟體安裝程式開啟相符的安裝包。 |
| 執行相依套件 | 發行版必須符合套件宣告的相依套件、系統函式庫及桌面執行環境需求;若遇到相依性錯誤,請先查看安裝程式的訊息。 |
| 代理與權限 | 應用程式是否會讀取桌面系統代理,取決於程式本身;TUN 另涉及網路介面、路由與權限設定。 |
請在系統資訊頁確認架構與發行版,下載後使用圖形介面的軟體安裝程式處理相依套件。若安裝程式指出系統函式庫版本不足,請勿強制忽略相依性,也不要混用其他發行版的基礎函式庫。相同的套件格式只代表採用同類型的套件管理系統,不表示所有發行版都能執行同一個建置版本。
啟動 v2rayN 後,先匯入訂閱、選擇伺服器,確認核心正常執行且本機監聽正常,再設定代理。瀏覽器、終端機與桌面 App 使用代理的方式可能不同;若某個程式未經代理,請先檢查程式本身的網路設定。若要透過 TUN 讓更多 App 使用代理,請依文件設定權限,避免長期以高權限執行整個桌面工作階段。
繼續查看 Linux 安裝設定 →三款客戶端都用於管理代理設定,安裝包本身不等於連線服務。請先準備有權使用的訂閱網址、單一分享連結或完整設定檔,並確認各自的匯入方式。訂閱網址通常要填入訂閱設定;分享連結可從剪貼簿或掃描匯入;完整 JSON 則應使用相對應的設定匯入功能。格式放錯位置時,反覆下載客戶端通常無法解決問題。
訂閱連結可能含有存取憑證。排除問題時,建議描述錯誤類型、選單路徑與記錄中的關鍵行,不要將完整網址貼到公開討論區。匯入後先執行更新;若清單為空,請檢查訂閱網址是否完整、群組是否遭到篩選,以及客戶端能否連上訂閱服務。
在清單中選取要使用的伺服器,查看記錄是否出現設定解析錯誤或連接埠遭占用的訊息。桌面端通常先設定系統代理;Android 則確認連線狀態及 VPN 授權。系統代理會讓遵循系統設定的 App 使用本機代理;TUN 是另一種流量接管方式,不清楚用途前,不建議反覆切換兩者。
驗證時,除了確認目標 App 能否連線,也要檢查區域網路存取、網域名稱解析與路由是否符合預期。規則可能會將部分請求導向直連出口,這不一定是異常。需要細分流量時再設定路由規則,並先備份目前可用的設定;不要把規則問題誤認為安裝包問題。
替換或覆蓋安裝前,請先結束客戶端,避免檔案仍被占用。升級前備份訂閱群組、路由規則與自訂設定,尤其要留意切換介面版本、安裝來源或裝置時的移轉情況。Android 遇到簽章衝突時,先確認舊版 App 的來源及資料匯出方式;解除安裝可能會一併刪除本機設定。
客戶端介面版本與核心版本是不同概念。Xray 與 V2Fly 同屬 Project V 相關生態系,但支援的協定、傳輸方式與設定欄位並非總是相同。只因介面名稱相近就直接沿用所有進階欄位,可能導致啟動失敗。下載時選對平台,設定時再依協定能力選擇;詳細差異請參閱概念速查。
DOWNLOAD / FAQ
先確認安裝包類型,再排查系統權限、設定匯入或代理接管問題。