v2rayN Mac 教程：arm64/x64 选包、“已损坏”修复到开启代理

更新于 2026-10-24 · justcn2.online

简答：很多 Mac 用户卡在选错 arm64/x64 或“应用已损坏”。正确流程是确认芯片、从 Releases 下载对应 DMG/ZIP、放行应用、添加订阅并更新节点，再用系统代理和 curl 验证。

定义：v2rayN 是支持 Windows、Linux 和 macOS 的桌面客户端，可调用 Xray、sing-box 等核心处理已有节点或订阅配置，但软件本身不提供节点服务。

先看 5 步速查卡：Mac 上最快完成 v2rayN

本站是第三方使用指南站，下面只讲 macOS 上的实际操作路径。第一次安装时，按这 5 步走，能避开大多数架构、Gatekeeper 和端口问题。

v2rayN Mac 5 步速查

步骤	要做什么	判断标准
1	苹果菜单→关于本机	看到“芯片”选 arm64；看到“处理器”且为 Intel 选 x64
2	进入官方 Releases 下载	普通安装选对应 DMG；需要便携目录选对应 ZIP
3	首次启动并处理安全拦截	来源可信时，在“隐私与安全性”中选择“仍要打开”
4	添加订阅并更新	订阅分组中出现节点，且能完成延迟测试
5	开启系统代理并验证	使用设置页显示的混合端口，通过 curl 对比出口结果

截至2026-10-24，Releases 标记为 Latest 的是 v7.24.8；版本更新频繁，后续下载应以发布页的 Latest 标签和资产列表为准，预发布版本不要与正式版本混用。

如何确认 Mac 芯片：arm64、x64 应该选哪个

打开左上角苹果菜单，选择“关于本机”。Apple 的判断方式是：窗口显示“芯片”及芯片名称，表示 Apple 芯片；显示“处理器”及 Intel 处理器名称，表示 Intel Mac。可参考 Apple：Mac computers with Apple silicon。

Mac 架构与安装包选择

“关于本机”显示	对应架构	发布页资产
芯片，例如 M 系列	`arm64`	`v2rayN-macos-arm64.dmg` 或 `v2rayN-macos-arm64.zip`
处理器，例如 Intel	`x64`	`v2rayN-macos-64.dmg` 或 `v2rayN-macos-64.zip`

文件名以发布页实际资产为准，不要根据 MacBook 的外观、购买年份或系统语言猜架构。v2rayN 官方发布文件说明列出了 macOS 的 x64 与 arm64 包，并注明当前 v7.x 发布文件的 macOS 系统要求为 macOS 13.6 及以上；如果系统版本较低，应先查看项目说明和发布页，不要强行安装。

DMG 是安装版：打开后把应用拖入“应用程序”，适合大多数用户。ZIP 是便携版：解压到固定文件夹后直接运行，配置和程序文件通常保存在该文件夹中。官方说明中，ZIP 版还需要在解压目录执行 chmod +x v2rayN，再运行 ./v2rayN。详情见 v2rayN Wiki：发布文件介绍。

下载与安装：Mac 提示“应用已损坏”怎么处理

只从发布页下载。打开 v2rayN Releases，按芯片选择 v2rayN-macos-arm64.dmg、v2rayN-macos-64.dmg 或对应 ZIP。实际资产名称以当前发布页为准，不使用网盘、镜像或不明下载站提供的安装包。
安装 DMG。双击 DMG，将 v2rayN 拖到“应用程序”文件夹，然后从“应用程序”启动。官方发布文件说明明确写出，macOS DMG 安装包没有签名，可能出现“应用已损坏”提示。
先尝试右键打开。在“应用程序”中右键 v2rayN，选择“打开”。如果仍被拦截，先正常尝试启动一次，再打开“系统设置”→“隐私与安全性”，在安全性区域选择“仍要打开”或类似按钮。
DMG 仍提示“应用已损坏”。确认应用已经拖入“应用程序”，并且下载来源确实是项目 Releases 后，打开终端执行 xattr -cr /Applications/v2rayN.app，完成后重新启动应用。该命令来自 v2rayN 的官方发布文件说明，只针对已经确认来源的 DMG 安装版。
ZIP 版单独处理。进入解压后的目录，执行 chmod +x v2rayN，再执行 ./v2rayN。如果 macOS 仍提示无法验证开发者，优先通过“隐私与安全性”放行，不要对来源不明的文件强制清除安全属性。

Apple 说明，未公证或来自未识别开发者的应用可能带来安全风险；只有在确认应用来自可信来源且未被篡改时，才应通过“系统设置”→“隐私与安全性”→“仍要打开”临时覆盖拦截。参考 Apple：安全地打开 Mac 应用和 Apple：如果无法在 Mac 上打开应用。

导入订阅、更新节点并设为活动节点

v2rayN 是客户端，不会自动生成节点。安装完成后，你仍需要从自己使用的订阅服务提供方取得订阅地址，或者准备已有的单节点分享链接。订阅地址通常包含访问凭据，不要发到公开评论区、截图或不明网页。

启动 v2rayN。macOS 版通常会出现在菜单栏；点击菜单栏图标，选择打开主界面。
在主界面进入订阅分组→订阅分组设置，点击添加。
填写分组别名和订阅 URL，点击确定保存。别名建议使用“办公线路”“个人节点”等容易辨认的名称。
回到订阅分组菜单，选择更新全部订阅（不通过代理）。如果订阅地址只能通过现有代理访问，再改用通过代理更新。
更新完成后，回到主界面的节点列表。先选择一个节点执行延迟测试或批量测试，再双击目标节点，或选中节点后按回车，将其设为活动节点。

如果你拿到的是单节点链接，而不是订阅地址，可以复制链接后，在主界面非输入框区域按 Command+V；官方界面说明显示，剪贴板导入会识别以 https 开头的订阅地址和多种协议分享链接。参考 v2rayN Wiki：重要界面功能介绍。

更新成功但节点为空时，先检查是否把网页登录地址误当成订阅 URL，再查看更新结果和解析提示。节点列表为空不等于客户端损坏，也可能是订阅失效、地址带空格换行、返回格式不受支持或服务端暂时没有返回配置。

开启系统代理：端口不要照抄旧教程

第一次使用建议先开系统代理，不要一开始同时开启 TUN。进入 v2rayN 的设置或主界面代理选项，选择自动配置系统代理；官方 Wiki 将它定义为把部分系统软件（例如浏览器）的流量转发到核心的入站端口。

系统代理与 TUN 的选择顺序

模式	先后顺序	适合做什么
系统代理	先测试	验证浏览器等遵循 macOS 系统代理的软件
TUN	后测试	处理不遵循系统代理的软件，但涉及更底层的虚拟网卡和权限

端口方面，不要把旧教程中的 10809 固定当作 HTTP 端口。当前 v2rayN 的基础设置使用本地混合监听端口，该端口同时监听 SOCKS5 和 HTTP；官方界面说明中，第二个本地监听端口为混合端口加 1，其他辅助端口也按设置值递增。默认常见为 10808，但最终应以设置→参数设置→本地监听端口以及主界面状态栏显示为准。参考 v2rayN Wiki：重要界面功能介绍。

开启系统代理后，到 macOS 的“系统设置”→“网络”→当前网络→“详细信息”→“代理”中核对代理地址是否为 127.0.0.1，端口是否与 v2rayN 设置页一致。v2rayN 官方说明中的常规用法是选择“自动配置系统代理”；系统代理只影响遵循系统代理的应用，不能作为所有软件都已接管的证明。参考 v2rayN Wiki：系统代理和路由。

用 curl 验证代理是否真的生效

浏览器能打开网页，只能说明某个应用暂时可用。更直接的办法是使用终端对比带代理和不带代理的请求。下面命令使用 v2rayN 常见的混合端口示例，若你在设置页看到的端口不同，应替换为实际端口。

curl -x http://127.0.0.1:10808 https://www.cloudflare.com/cdn-cgi/trace

curl https://www.cloudflare.com/cdn-cgi/trace

第一条命令明确指定 HTTP 代理，能返回结果，说明本地 HTTP 代理端口至少可以建立请求。
第二条命令不指定代理，用于和第一条结果对照；两者是否相同，取决于当前网络、路由模式和目标地址，不能只凭出口地址变化一个条件下结论。
如果第一条提示无法连接到 127.0.0.1:10808，先回到设置页确认混合端口、核心是否已启动，以及是否有其他程序占用了端口。
验证结束后关闭系统代理，再到 macOS“网络”设置的代理页面确认 HTTP、HTTPS 或 SOCKS 项已清除；随后重新执行不带 -x 的命令，完成关闭代理后的复核。

v2rayN 的核心日志通常显示核心启动、入站连接、目标地址和错误信息；GUI 日志则用于查看界面操作、设置和测速等问题。不要把它当成带有策略面板的连接统计页。官方 FAQ 区分了 GUI 日志目录与主界面核心日志，排查时应先确认自己查看的是哪一类日志，参考 v2rayN Wiki：常见问题。

订阅失败、节点为空和无法联网的排查顺序

订阅更新失败：检查 URL 是否完整，是否多了空格、换行或失效凭据；再分别尝试“不通过代理”和“通过代理”更新。
更新成功但节点为空：查看更新结果是否有解析错误，确认使用的是订阅地址而不是后台登录地址；如果服务端返回空内容，客户端也不会凭空生成节点。
节点能测速但浏览器打不开：确认该节点已经双击或按回车设为活动节点，再检查 macOS 系统代理地址和端口是否与设置页一致。
浏览器能用，终端不能用：终端命令不会自动读取所有图形应用的代理配置，应使用 curl -x http://127.0.0.1:10808 明确指定代理进行测试。
开启 TUN 后无法联网：先关闭 TUN，只保留系统代理；如果要测试 TUN，再在设置中的 TUN 模式设置里单独开启，并根据系统提示输入管理员密码或完成授权。官方界面说明指出，具有管理员权限的启动方式主要用于启动 TUN 模式。
端口冲突：查看设置页的本地混合监听端口是否被其他程序使用，必要时改成未占用端口，然后重新启动核心并同步修改测试命令。

排查时一次只改一个变量：先固定订阅地址，再固定活动节点，随后依次测试系统代理、TUN 和端口。这样才能区分订阅解析、节点连接、本地监听和 macOS 代理设置的问题。

常见问题

v2rayN 有 Mac 版吗？

有。官方项目列出 macOS 支持，并提供 x64 与 arm64 架构的发布包，下载入口应以项目 Releases 页面为准。

Apple 芯片 Mac 应该下载 arm64 还是 x64？

打开苹果菜单→关于本机，看到“芯片”字段时选 arm64；看到“处理器”并写着 Intel 时选 x64。

DMG 和 ZIP 应该选哪个？

希望拖入“应用程序”并按普通方式安装，选 DMG；希望解压到固定目录、保留便携配置，选 ZIP。ZIP 版需要按官方说明赋予执行权限。

Mac 提示“应用已损坏”怎么办？

先确认安装包来自官方 Releases 并重新核对来源；确认可信后，在“系统设置→隐私与安全性”中选择“仍要打开”。DMG 已安装到“应用程序”时，可按官方发布文件说明执行 xattr 命令。

v2rayN 安装后为什么没有节点？

因为 v2rayN 是客户端，不自带节点。需要导入自己拥有的订阅地址或单节点分享链接，再更新订阅并选择活动节点。

v2rayN Mac 的代理端口是 10808 还是 10809？

不要把旧教程中的 10809 当作固定 HTTP 端口。当前基础设置使用本地混合监听端口，常见示例为 10808，并同时支持 SOCKS5 与 HTTP；最终以设置页和状态栏显示为准。

系统代理和 TUN 要同时开启吗？

新手建议先单独测试系统代理，再单独测试 TUN。两者同时开启后无法联网时，先关闭 TUN并查看核心日志与系统代理设置。