macOS 安装与首次运行

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

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

macOS · Terminal复制
xattr -cr /Applications/v2rayN.app
macOS 下载签名校验

安装后完成第一次连接

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

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

订阅操作排查连接

升级、备份与恢复

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

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

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

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