01 · 系統與架構要求

先確認操作系統版本,再確認處理器架構。Windows 可在“設置 → 系統 → 關於”查看系統類型;Mac 在“關於本機”查看芯片;Linux 可運行 uname -m,x86_64 對應 x64,aarch64 對應 ARM64。

平臺最低系統 / 架構
WindowsWindows 10+;x64、ARM64、x86
macOSmacOS 13.6+;Apple Silicon(ARM64)、Intel(x64)
Debian / UbuntuDebian 12+ / Ubuntu 22.04+;使用 DEB
Fedora / Red HatFedora 36+ / Red Hat 9+;使用 RPM
其他 Linux 架構發佈頁還提供 RISC-V 64、Loong64 的部分包,需與系統及核心匹配

02 · 發佈包、界面與存儲

ZIP 爲便攜版,需完整解壓到可寫文件夾,配置跟隨該文件夾。DEB、RPM 和 DMG 安裝版的運行文件與用戶數據可能分開存放,可通過客戶端“打開存儲所在的位置”定位數據。

Windows 普通 ZIP 使用 WPF 界面,名稱包含 desktop 的包使用 Avalonia。它們是界面實現的區別,不表示購買版或節點套餐。發佈包包含部分核心;其他核心按需要添加,程序、核心和配置的架構都應匹配。

核心說明配置存儲

03 · Windows 安裝與首次運行

x64 適用於 64 位 Intel / AMD 系統,ARM64 適用於 Windows on ARM,x86 對應 32 位系統。當前下載頁的 x86 包來自 7.25.6 發佈資產;舊 FAQ 中“需自行編譯”的說明不適用於這個包。

下載對應 ZIP,右鍵解壓全部,再從解壓後的文件夾運行 v2rayN.exe。不要直接在壓縮軟件內運行,也不要只複製可執行文件。普通系統代理不要求爲整個應用長期使用管理員權限;TUN 所需權限按客戶端提示處理。

首次啓動後導入配置並觀察信息欄。程序打不開時檢查是否選錯架構、文件是否解壓完整、目錄是否可寫,以及安全軟件的攔截記錄。

Windows 下載

04 · macOS 安裝與首次運行

Apple 芯片選擇 arm64,Intel Mac 選擇 64。打開 DMG,將應用拖入 Applications 後再啓動。便攜 ZIP 需完整解壓,在可執行文件所在目錄運行 chmod +x v2rayN,再以普通用戶執行 ./v2rayN。

官方說明中 DMG 未簽名,首次運行可能顯示“已損壞”。確認文件來自項目發佈資產並完成校驗後,可在終端對這一應用運行下方命令,再重新打開。該命令會清除指定應用的擴展屬性,不是修復損壞下載的工具。若文件未完整下載,應重新下載。

macOS · Terminal複製
xattr -cr /Applications/v2rayN.app
macOS 下載簽名校驗

05 · Linux 安裝命令

在下載目錄打開終端,按發行版和處理器選擇一條安裝命令。文件名前的 ./ 表示安裝當前目錄的本地文件。RPM 的 x64 發佈文件實際名爲 v2rayN-linux-rhel-64.rpm。

安裝完成後從應用菜單啓動。使用 ZIP 時先解壓,進入程序目錄運行 chmod +x v2rayN,然後 ./v2rayN。不要用 sudo 啓動整個桌面應用來代替安裝權限;TUN 另按客戶端提示授權。

Linux · choose one command複製
# Debian / Ubuntu · x64
sudo apt install ./v2rayN-linux-64.deb
# Debian / Ubuntu · ARM64
sudo apt install ./v2rayN-linux-arm64.deb
# Fedora / Red Hat · x64
sudo dnf install ./v2rayN-linux-rhel-64.rpm
# Fedora / Red Hat · ARM64
sudo dnf install ./v2rayN-linux-rhel-arm64.rpm
Linux 下載

06 · 安裝後完成第一次連接

複製自己的分享鏈接,在客戶端非輸入框區域按 Ctrl+V,或用菜單執行剪貼板導入。若是訂閱地址,進入分組設置保存地址並更新訂閱。選擇列表中的一個配置設爲活動項,再啓用自動配置系統代理。

打開瀏覽器訪問目標;沒有連接時先看核心是否啓動、信息欄是否報錯。僅導入配置或完成測速,不代表瀏覽器已經使用代理。

訂閱操作排查連接

07 · 升級、備份與恢復

升級前在客戶端執行“備份和還原 → 備份”,保存 guiConfigs 的 ZIP 副本;非 Windows 系統應明確填寫 .zip 擴展名。記錄當前使用的客戶端、核心和架構。

便攜版可將新包解壓到新的文件夾,運行新版本後還原備份;保留舊文件夾,確認連接和訂閱正常後再自行整理。安裝版用同平臺和架構的包升級,不要假設卸載應用會同時清除用戶數據。還原成功後客戶端會重啓,未自動重啓時手動打開。

7.25.6 對核心版本與配置格式有調整,升級後檢查活動節點、路由、DNS、訂閱更新和 TUN。

當前版本更新內容備份說明
參考資料官方文檔

步驟與參數已在本頁展開,參考鏈接用於標註資料來源。覈對日期:2026-10-19。