下载、安装与发布文件

系统与架构要求

先确认操作系统版本，再确认处理器架构。Windows 可在“设置 → 系统 → 关于”查看系统类型；Mac 在“关于本机”查看芯片；Linux 可运行 uname -m，x86_64 对应 x64，aarch64 对应 ARM64。

发布包、界面与存储

ZIP 为便携版，需完整解压到可写文件夹，配置跟随该文件夹。DEB、RPM 和 DMG 安装版的运行文件与用户数据可能分开存放，可通过客户端“打开存储所在的位置”定位数据。

Windows 普通 ZIP 使用 WPF 界面，名称包含 desktop 的包使用 Avalonia。它们是界面实现的区别，不表示购买版或节点套餐。发布包包含部分核心；其他核心按需要添加，程序、核心和配置的架构都应匹配。

核心说明配置存储

Windows 安装与首次运行

x64 适用于 64 位 Intel / AMD 系统，ARM64 适用于 Windows on ARM，x86 对应 32 位系统。当前下载页的 x86 包来自 7.25.6 发布资产；旧 FAQ 中“需自行编译”的说明不适用于这个包。

下载对应 ZIP，右键解压全部，再从解压后的文件夹运行 v2rayN.exe。不要直接在压缩软件内运行，也不要只复制可执行文件。普通系统代理不要求为整个应用长期使用管理员权限；TUN 所需权限按客户端提示处理。

首次启动后导入配置并观察信息栏。程序打不开时检查是否选错架构、文件是否解压完整、目录是否可写，以及安全软件的拦截记录。

Windows 下载

macOS 安装与首次运行

Apple 芯片选择 arm64，Intel Mac 选择 64。打开 DMG，将应用拖入 Applications 后再启动。便携 ZIP 需完整解压，在可执行文件所在目录运行 chmod +x v2rayN，再以普通用户执行 ./v2rayN。

官方说明中 DMG 未签名，首次运行可能显示“已损坏”。确认文件来自项目发布资产并完成校验后，可在终端对这一应用运行下方命令，再重新打开。该命令会清除指定应用的扩展属性，不是修复损坏下载的工具。若文件未完整下载，应重新下载。

macOS · Terminal复制

xattr -cr /Applications/v2rayN.app

macOS 下载签名校验

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 下载

安装后完成第一次连接

复制自己的分享链接，在客户端非输入框区域按 Ctrl+V，或用菜单执行剪贴板导入。若是订阅地址，进入分组设置保存地址并更新订阅。选择列表中的一个配置设为活动项，再启用自动配置系统代理。

打开浏览器访问目标；没有连接时先看核心是否启动、信息栏是否报错。仅导入配置或完成测速，不代表浏览器已经使用代理。

订阅操作排查连接

升级、备份与恢复

升级前在客户端执行“备份和还原 → 备份”，保存 guiConfigs 的 ZIP 副本；非 Windows 系统应明确填写 .zip 扩展名。记录当前使用的客户端、核心和架构。

便携版可将新包解压到新的文件夹，运行新版本后还原备份；保留旧文件夹，确认连接和订阅正常后再自行整理。安装版用同平台和架构的包升级，不要假设卸载应用会同时清除用户数据。还原成功后客户端会重启，未自动重启时手动打开。

7.25.6 对核心版本与配置格式有调整，升级后检查活动节点、路由、DNS、订阅更新和 TUN。

当前版本更新内容备份说明