v2rayN 的 Mac 版：按芯片挑安装包，「已损坏」提示怎么解，和 Windows 版差在哪

10 月 17 日讯　Mac 上打开 v2rayN 时提示「已损坏，无法打开」，原因是 dmg 安装包没有签名、并非文件损坏，在终端执行 xattr -cr /Applications/v2rayN.app 后即可启动。

先认芯片，再挑安装包

v2rayN 的 Mac 版和 Windows 版出自同一个仓库、同一次发布。7.25.6 是 2dust/v2rayN 此时的正式版（信源：GitHub Releases，10 月 17 日），10 月 11 日发布，macOS 一共四个包：

每个文件旁边都有一个同名的 .sig，和 v2rayN-public-key.asc 一起用来校验下载的文件有没有被改过，不需要单独下载。按 wiki 的发布文件说明，Mac 版要求 macOS 13.6 以上，更老的系统装不上。拿不准自己的芯片，看苹果菜单里的「关于本机」：写着 Apple M1、M2 之类的就是 Apple 芯片。

zip 包适合想同时放几份独立配置、或者不想往系统里装东西的人：解压后在终端进入目录，执行 chmod +x v2rayN，再用 ./v2rayN 启动。日常用 dmg 就好。

只从 GitHub Releases 下载。网上流传的「Mac 版 v2rayN」镜像和二次打包，来源没法核对，不要装。

「已损坏，无法打开」：缺签名，不是文件坏了

v2rayN 的 wiki 写明：dmg 安装包没有签名，macOS 可能把它报成「已损坏」。这是系统的门禁机制给从网上下载、又没有开发者签名的程序打了隔离标记，并不代表下载出错，重新下载也没用。

处理办法是 wiki 给的那条命令。先确认 v2rayN 已经在「应用程序」里，然后打开「终端」，输入：

xattr -cr /Applications/v2rayN.app

回车后没有任何输出就是执行成功了，再从启动台或「应用程序」里打开 v2rayN。这条命令清除的是这个程序包上的扩展属性（包括隔离标记），只对你指定的这一个程序生效。也正因为它绕过了系统检查，只对确认来自官方 Releases 的文件这样做。

用 zip 包的话，对解压出来的整个文件夹执行同样的 xattr -cr，路径换成你的解压目录。升级到新版本、覆盖安装以后，标记会跟着新文件回来，再执行一次即可。

先准备一条通用订阅

装好以后，v2rayN 里还是空的，要导入订阅才有节点。v2rayN 读的是 vless://、vmess:// 这类分享链接组成的通用订阅，机场给的若是 Clash 用的 YAML，就不对路。一翻云是 2026 年 4 月开张的新机场，官网写的节点协议是 VLESS；它不在面板里放订阅地址，买完套餐后要去找客服，开口时讲明「v2rayN 用、要通用订阅」。轻享版一个月 ¥20，含 150GB（信源：一翻云价目页，10 月 9 日）；1FLYYUN 只给新注册的账号用，结算价九折。想多比较几家的订阅格式，看机场总表。

导入步骤和 Windows 版完全一样，「订阅分组 → 订阅分组设置 → 添加」，细节见 v2rayN 节点从哪来。

和 Windows 版不一样的地方

界面不同。 Mac 版用的是 Avalonia 界面，和 Windows 那个文件名带 desktop 的包、以及 Linux 版是同一套；Windows 默认包是 WPF 界面。网上很多截图来自 WPF 版，按钮位置对不上时，以菜单文字为准。

系统代理靠脚本。 在 Mac 上选「自动配置系统代理」，v2rayN 实际是运行一段脚本，把代理写进「系统设置 → 网络」。FAQ 提到，写不进去多半和本机环境有关，可以到 guiLogs 文件夹看脚本的报错；「参数设置 → 系统代理设置」里有一项 Windows 版没有的「自定义系统代理脚本文件路径」，供需要自己写脚本的人使用。同一页的「例外」地址，Mac 上用英文逗号分隔，Windows 上用分号。

Tun 要 sudo 密码。 在 Windows 上打开「启用 Tun」，程序会以管理员身份重启；Mac 上则弹出密码框，要这台 Mac 的登录密码，输一次只管到程序退出为止。

少了几项 Windows 专属功能。 「设置」菜单里的「以管理员身份重启」「全局热键设置」「解除 Win10 UWP 应用回环代理限制」只在 Windows 上显示；路由规则里按进程名分流也只支持 Linux 和 Windows，Mac 上只能按域名和 IP 写规则。

多了一个 Dock 开关。 「参数设置」里有「macOS 在 Dock 栏中显示 (需重启)」，关掉后 v2rayN 只留在菜单栏，改完要重开程序。

路由规则、Core 类型这些设置在两个系统上是一样的，逐项说明见 v2rayN 怎么配置。

配置存在哪，升级要注意什么

「设置 → 打开存储所在的位置」会直接打开配置目录，订阅分组、路由规则都在里面。wiki 提到，备份和还原针对的是其中的 guiConfigs 文件夹，非 Windows 系统做本地备份时，文件要用 zip 扩展名，还原后程序会自动重启。

升级有两条路：用菜单里的「检查更新」，或者到 Releases 下载新的 dmg 覆盖安装。前者会强制通过代理访问 GitHub，频繁检查可能碰上 GitHub API 的频率限制。另外 wiki 有一条安全提示：6.10 到 7.23.2 之间的版本，检查更新功能存在可能被中间人攻击的问题。手上的版本落在这个区间，就别用程序内更新，直接从 Releases 下载新版覆盖，再执行一次 xattr 命令。

同一台 Mac 上还想用 Clash 系客户端，安装和授权的写法在 Mac 上用 Clash 那篇。