v2rayN
7.24.1Windows x64 · Desktop 為新一代跨平台介面,WPF 為經典穩定介面。兩種安裝包皆以 ZIP 檔提供。
先解壓縮,再執行安裝程式。切換介面前,請匯出現有設定,並記下訂閱群組與自訂路由。
客戶端安裝 / 套件格式選擇
桌面系統請選擇 v2rayN,Android 則建議使用 v2rayNG。先確認作業系統,再依處理器架構下載相應檔案。
安裝後的訂閱匯入與連線步驟 →同一平台還可依介面、晶片或套件格式細分;版本資訊標示在客戶端名稱下方。
v2rayN 提供 Desktop 與經典 WPF 兩種介面。這兩種安裝包適用於 x64 系統,主要差異在介面技術與操作配置,並非兩種不同的代理協定。初次安裝可依照教學中使用的選單選擇介面;已有設定的使用者,請先備份再決定是否移轉。
Desktop 採用新一代跨平台 UI,適合會使用多種桌面系統、希望操作習慣相近的使用者;WPF 是經典穩定版,適合沿用既有 Windows 操作流程。兩個版本對作業系統版本及執行環境的需求可能不同,請以目前安裝程式的提示為準。
若安全軟體封鎖檔案,請先確認檔案來源及具體警示內容。警示不明確時應暫停安裝,而非直接關閉所有防護。程式成功啟動後,再設定訂閱匯入、系統代理與路由。
Windows x64 · Desktop 為新一代跨平台介面,WPF 為經典穩定介面。兩種安裝包皆以 ZIP 檔提供。
先解壓縮,再執行安裝程式。切換介面前,請匯出現有設定,並記下訂閱群組與自訂路由。
| 檢查項目 | 選擇依據 |
|---|---|
| 處理器架構 | 本頁提供的兩種安裝包皆為 x64 |
| 桌面環境 | Windows 圖形桌面;版本限制請參閱安裝程式提示 |
| 執行環境 | Desktop 與 WPF 的需求可能不同,請依缺少元件的提示補齊 |
| 資料夾權限 | 解壓縮資料夾須可讀寫,設定資料夾須能儲存設定 |
macOS 使用 v2rayN 桌面介面,安裝前最重要的是分辨 Apple Silicon 與 Intel。開啟蘋果選單中的「關於這台 Mac」,查看「晶片」或「處理器」欄位:Apple M 系列適用 Apple Silicon 安裝包,Intel 處理器則適用 Intel 安裝包。請勿只憑裝置名稱判斷。
兩種 DMG 提供相同客戶端的不同處理器版本。Apple Silicon 電腦建議優先選擇原生 arm64 套件,Intel 電腦則選擇 x64 套件。架構是否相符與連線協定是兩回事,更換安裝包架構無法修正錯誤的訂閱網址或伺服器參數。
安裝錯誤與網路授權應分開排查。「無法開啟應用程式」通常發生在啟動階段;若應用程式已啟動但瀏覽器未使用代理,則應檢查系統代理模式與瀏覽器本身的設定。請勿為處理單一應用程式的提示而關閉整個系統的安全機制。
移轉舊設定時,請先備份現有訂閱與規則,再匯入新安裝的客戶端。移轉至不同桌面系統後,也應檢查路徑設定,例如本機規則檔案的位置,避免沿用另一台電腦的資料夾路徑。
在「關於這台 Mac」查看晶片:Apple M 系列選 Apple Silicon;Intel 處理器選 Intel。
檔案格式為 DMG。首次開啟與網路權限的處理方式請參閱安裝教學,不必先修改伺服器參數。
| 檢查項目 | 選擇依據 |
|---|---|
| Apple Silicon | Apple M 系列晶片,選擇 arm64 DMG |
| Intel | Intel 處理器,選擇 x64 DMG |
| 系統版本 | 請以目前應用程式的啟動提示與發行說明為準 |
| 權限準備 | 允許安裝應用程式;依實際功能授予網路相關權限 |
Android 建議優先使用 v2rayNG,其核心為 Xray;若需要使用 V2Fly 生態系的設定,可考慮 v2flyNG。兩款客戶端是獨立應用程式,選單名稱、設定功能與資料目錄並不完全相同,請勿將它們視為同一應用程式的不同介面。
2015 年後推出的主流手機通常可優先選擇 arm64 套件,但部分裝置可能採用不同架構,或執行不同位元數的系統,仍應以系統實際支援的 ABI 為準。不確定時可選通用版;通用版支援多種架構,不代表連線速度更快,也不會改變訂閱本身的相容性。
若出現「未安裝應用程式」,請先檢查儲存空間、系統版本與架構,再確認已安裝應用程式是否有簽章衝突。同名應用程式若來自不同建置來源,可能無法直接覆蓋安裝;尚未保存設定前,請勿直接解除安裝舊版。
連線後切換至背景就中斷時,請檢查電池最佳化與背景執行限制。排查時一次只調整一個項目,並記錄結果。v2rayNG 與 v2flyNG 不宜同時啟用網路接管,以免系統連線狀態反覆切換,影響問題判斷。
Xray 核心 · 主流 arm64 裝置建議優先選第一項;不確定架構時可選通用版。
APK 安裝包。首次連線時須確認系統 VPN 授權,訂閱網址需另外匯入。
適用於 V2Fly 設定需求的替代客戶端。匯入前請確認協定與傳輸方式是否支援,不應預設可取代 v2rayNG 的設定。
| 檢查項目 | 選擇依據 |
|---|---|
| arm64 | 系統支援 arm64-v8a,主流手機可優先選擇 |
| 通用版 | 架構不確定時選擇,仍須符合系統版本需求 |
| 系統版本 | 請以所選 APK 安裝程式顯示的相容性提示為準 |
| 連線權限 | 安裝來源授權與首次 VPN 連線授權應分開處理 |
Linux 使用 v2rayN 桌面客戶端,請先依發行版的套件管理機制選擇 deb 或 rpm,再確認處理器架構。Debian、Ubuntu 及其衍生發行版通常選 deb;Fedora、RHEL 系及其衍生發行版通常選 rpm。請勿依桌面主題或視窗外觀判斷套件格式。
常見桌上型電腦多採用 x64,系統資訊可能顯示為 x86_64;部分開發板與桌上型裝置使用 arm64,系統可能顯示為 aarch64。兩者不可混用。下載卡片中的主要入口為 x64,arm64 套件另列於下方,安裝前請再次確認。
圖形化客戶端需要可用的桌面工作階段。只有命令列環境的電腦不適用本頁的桌面安裝流程。若出現缺少動態函式庫或相依套件版本不符,請先確認發行版支援範圍,不要強制忽略相依套件。
Linux 上不同應用程式對桌面系統代理設定的支援程度可能不同。瀏覽器能連線,不代表所有終端機程式都使用相同代理。安裝後請依實際使用的應用程式逐一測試;待客戶端正常啟動後,再調整路由與 DNS。
主要安裝入口適用於 x64 桌面環境。請先選擇發行版採用的套件格式,再確認安裝程式列出的相依套件。
需要圖形化桌面環境。選擇 arm64 時,套件格式仍須符合發行版採用的套件管理機制。
| 檢查項目 | 選擇依據 |
|---|---|
| 套件格式 | 依發行版選擇 deb 或 rpm |
| 處理器架構 | x86_64 對應 x64;aarch64 對應 arm64 |
| 執行環境 | 具備可用的圖形化桌面工作階段,並符合安裝程式列出的相依套件需求 |
| 權限準備 | 軟體安裝授權與設定資料夾讀寫權限 |
程式能啟動、設定能匯入、應用程式能連線,是三個不同的檢查階段。
桌面版請開啟 v2rayN 的「訂閱群組」選單,新增訂閱網址並執行更新;Android 版則在 v2rayNG 中開啟「訂閱群組設定」,儲存網址後更新訂閱。若要匯入單一設定連結,請使用「從剪貼簿匯入」。複製時請保留完整連結,不要將介紹文字或網頁網址一併複製為訂閱內容。
設定出現在清單後,先選取要使用的項目,再啟用相應的連線模式。v2rayN 的「自動設定系統代理」主要影響遵循系統代理的應用程式,不代表所有流量都會自動接管。首次測試建議使用預設或已充分了解的路由規則,避免同時修改系統代理、路由與 DNS,導致難以判斷問題來源。
記下訂閱群組、自訂規則與本機監聽設定,並使用客戶端提供的備份或匯出功能保存。訂閱網址可能含有個人存取識別資訊,請勿公開分享備份檔與截圖。更換客戶端或核心系列時,也須確認協定與傳輸方式是否支援;能匯入連結不代表所有欄位都受到支援。
需要逐步操作說明,請閱讀 v2rayN 與 v2rayNG 設定教學;需要確認 VMess、VLESS 與核心的相容性,請閱讀 協定與核心技術參考。DNS 相關問題可接著查看 DNS 設定步驟。
套件格式、處理器架構與設定移轉的檢查順序。
Desktop 採用新一代跨平台介面,適合希望在不同桌面系統間維持相近操作體驗的使用者;WPF 則是經典穩定介面,適合依照既有 Windows 教學操作的使用者。兩種安裝包皆為 x64 壓縮檔,請先解壓縮,再執行其中的安裝程式。
開啟蘋果選單中的「關於這台 Mac」。晶片欄顯示 Apple M 系列時,請選擇 Apple Silicon;處理器欄顯示 Intel 時,請選擇 Intel。請勿只憑裝置外觀或購買年份判斷,安裝包架構應與電腦的實際處理器相符。
2015 年後推出的主流手機通常可優先選擇 arm64,但仍須確認系統支援 arm64-v8a。不確定架構時可選擇通用版。通用版支援多種架構,不會因此提升連線速度;若安裝失敗,也需檢查系統版本、儲存空間與簽章衝突。
Debian、Ubuntu 及採用相同套件管理機制的發行版通常選 deb;Fedora、RHEL 系及其衍生發行版通常選 rpm。也要確認 x64 或 arm64 架構,並檢查安裝程式提示的相依套件需求;套件格式相同,不代表適用於所有版本的發行版。
安裝包只包含客戶端程式,不含可用的伺服器設定。請向有權使用的服務取得訂閱連結或單一設定,再透過訂閱群組設定或從剪貼簿匯入。匯入後選取設定,依照教學設定代理模式並測試連線。
請先使用客戶端提供的匯出或備份功能保存設定,並記下目前的訂閱群組與自訂規則。相同客戶端、相同簽章來源的更新通常會保留資料,但仍請以安裝程式提示為準。若遇到簽章衝突,請勿直接解除安裝;先確認備份可用,再處理移轉。