v2ray Mac 使用教程：v2rayN 安装、订阅导入与代理排查
简答：在 Mac 上使用 V2Ray，建议先安装支持 macOS 的 v2rayN，再按芯片选择 arm64 或 x64 安装包。完成订阅导入后，测试节点并开启自动配置系统代理；只有需要覆盖不遵循系统代理的软件时，再考虑 TUN。
定义：V2Ray 是一类网络连接核心与协议生态的统称，v2rayN 和 V2rayU 则是调用相关核心、负责订阅、节点和系统代理设置的图形客户端。
先试这一步：确认 Mac 芯片并选对客户端
本站是第三方使用指南站，不代表任何客户端项目的官方页面。搜索“v2ray Mac 使用教程”时，容易把核心、客户端和订阅服务混在一起：V2Ray 更接近核心与协议生态，v2rayN 是支持 Windows、Linux 和 macOS 的桌面图形客户端，可调用 Xray、sing-box 等核心；V2rayU 是另一款面向 macOS 的独立客户端。v2rayN 官方仓库明确将它定位为电脑版，并把下载入口和使用文档放在项目仓库及 Wiki 中，适合希望在多个桌面系统之间保持相近操作逻辑的用户。参考 v2rayN 官方仓库 与 V2rayU 官方仓库。
截至 2026-10-24，Releases 标记为 Latest 的是 v2rayN 7.25.6。本文步骤按 v7.x 的 macOS 安装包和常见界面组织；macOS 最低版本以 官方发布文件说明 为准，当前说明列出 macOS 12+。
- 点击左上角苹果菜单，选择“关于本机”。如果页面显示“芯片”并列出 Apple 芯片，选择
v2rayN-macos-arm64.dmg或v2rayN-macos-arm64.zip；如果显示“处理器”并列出 Intel，选择v2rayN-macos-64.dmg或v2rayN-macos-64.zip。Apple 对两类 Mac 的识别方法可参考 Apple 芯片 Mac 说明。 - 优先从 v2rayN 的 GitHub Releases 页面下载，不要从搜索结果中的不明镜像获取安装包。DMG 适合常规安装，ZIP 适合希望直接解压运行的用户。
- 如果你只使用 Mac，V2rayU 也是可选客户端；但本文只讲 v2rayN，避免把两个客户端的菜单、权限和本地配置混用。
| 你的 Mac | 应选择的文件名 | 适合谁 |
|---|---|---|
| Apple 芯片 | v2rayN-macos-arm64.dmg | 大多数 M 系列 Mac |
| Intel | v2rayN-macos-64.dmg | Intel 处理器 Mac |
| 不想拖拽安装 | 对应架构的 ZIP | 熟悉解压和终端的用户 |
安装 v2rayN：DMG、无法验证开发者与应用已损坏
- 双击下载的 DMG 文件，将 v2rayN 拖入“应用程序”文件夹。
- 从“应用程序”中首次启动。如果 macOS 弹出“无法验证开发者”，先确认文件确实来自项目的 Releases 页面，再打开“系统设置→隐私与安全性”，在安全性区域查看是否出现“仍要打开”，确认后再次启动。Apple 的处理建议见 如果在 Mac 上无法打开 App。
- 如果 DMG 安装后提示“应用已损坏”，不要直接关闭系统安全机制。v2rayN 官方发布文件说明指出，macOS DMG 未签名时可能出现该提示，安装后可在“终端”执行：
xattr -cr /Applications/v2rayN.app执行后重新打开应用。命令只针对你从官方 Releases 下载并安装到“应用程序”目录的 v2rayN；如果你的应用路径不同，应先在“访达→应用程序”中确认实际名称和位置。若仍无法启动，删除当前安装包并重新从官方发布页下载，避免对来源不明的应用强行解除隔离。
首次启动时，v2rayN 可能创建用户配置目录并准备核心文件。不要把订阅地址、UUID、密码或完整配置发到公开论坛；订阅地址通常等同于账户凭据，泄露后应在提供方后台重置或重新生成。
导入订阅：添加分组、更新节点并选择活动服务器
你需要先从自己的服务后台复制订阅地址。订阅地址不是客户端自动生成的内容，也不能用一个公开示例地址代替。拿到地址后，按 v2rayN 的常见路径操作：
- 打开 v2rayN，进入“订阅分组”或“订阅分组设置”。
- 选择“添加”，在“可选地址”或订阅地址字段中粘贴完整地址，填写一个容易识别的分组名称，然后保存。
- 回到订阅菜单，选择“更新当前订阅”或更新刚建立的订阅分组，等待节点列表出现。
- 在节点列表中选中一个节点，执行“测试真连接延迟”或同等名称的真实连接测试；不要只把空白延迟或连接失败的节点当作可用节点。
- 双击目标节点，或使用右键菜单中的“设为活动服务器”。之后再开启系统代理。
官方 UI 说明提到，订阅分组支持可选地址、多个地址、别名过滤和证书链校验；地址填写错误、订阅内容过期、返回 HTML 登录页或证书链不受信任，都可能导致更新后没有节点。可参考 v2rayN UI 与订阅分组说明。
订阅更新失败时按这个顺序查：先在浏览器或后台确认订阅地址仍有效，再检查是否复制了完整地址；然后删除多余空格和换行，重新保存并更新；最后查看 v2rayN 的界面日志。如果界面操作、设置或测速异常，官方 FAQ 指向 guiLogs 文件夹；如果是核心启动失败，则应同时查看主界面的核心日志。参考 v2rayN 官方 FAQ。
系统代理、路由模式、PAC 与 TUN 怎么选
新手先使用系统代理，不要一上来开启 TUN。系统代理只影响遵循 macOS 系统代理设置的软件；TUN 则通过虚拟网络接口接管范围更大的流量，权限、DNS、路由和核心兼容性要求更高。
| 设置维度 | 建议选项 | 作用 | 适用场景 |
|---|---|---|---|
| 系统代理 | 自动配置系统代理 | 让系统支持代理的软件使用 v2rayN 本地入口 | 浏览器、常见桌面应用 |
| 系统代理 | 清除系统代理 | 关闭 v2rayN 写入的系统代理设置 | 停止使用后恢复直连 |
| 系统代理 | 不改变系统代理 | 不修改当前系统代理状态 | 由其他工具管理代理 |
| 路由模式 | 全局 | 尽量让规则匹配到的流量走代理 | 排查分流规则导致的连接问题 |
| 路由模式 | 绕过大陆或同类分流模式 | 按规则将部分流量直连、部分流量交给代理 | 日常分流使用 |
| 增强接管 | TUN | 通过虚拟网卡接管更多应用流量 | 软件不遵循系统代理时再尝试 |
系统代理设置和核心路由不是同一个维度：前者决定哪些应用把流量送入本地代理入口，后者决定进入核心后的流量走哪个出口。v2rayN 官方说明将“自动配置系统代理”和“路由功能”分开描述，具体可参考 系统代理与路由说明。
- 先确认节点已经设为活动服务器。
- 在系统代理选项中选择“自动配置系统代理”。
- 路由模式先选“全局”做连通性排查；确认可用后，再切换到分流模式。
- 停止使用时，先关闭系统代理，再退出 v2rayN，避免其他应用继续读取残留代理设置。
- 如果开启 TUN，按界面提示输入 Mac 管理员密码。TUN 涉及虚拟网卡和路由操作，权限不足时可能启动失败；遇到报错应先关闭 TUN，改用系统代理确认节点本身是否正常。
如何确认代理真的生效：出口 IP、日志与应用差异
不要只看客户端图标或延迟数字判断连接成功。最简单的复现方法是：
- 关闭 v2rayN 系统代理，记录一次当前出口 IP 和地区。
- 打开 v2rayN，确认活动服务器、自动配置系统代理和路由模式均已生效，再查询一次出口 IP。
- 如果前后出口 IP 或地区发生变化，且目标应用可以正常建立连接，说明该应用至少使用了当前代理路径。
- 如果浏览器可用但某个桌面软件不可用，先判断该软件是否遵循系统代理；必要时再考虑 TUN，而不是先更换节点。
- 如果节点延迟测试成功但页面打不开，查看连接日志中是否出现目标域名、命中的策略和失败原因；日志能帮助区分 DNS、路由、TLS、端口或核心启动问题。
若本地代理端口需要手动填写，不要套用其他客户端的端口。v2rayN 常见默认本地 SOCKS 端口为 10808、HTTP 端口为 10809，新版本也可能使用合并的 mixed 端口，最终应以 v2rayN 设置页显示的数值为准。查询端口占用时，macOS 使用：
lsof -nP -iTCP:10808 -sTCP:LISTEN
lsof -nP -iTCP:10809 -sTCP:LISTEN如果实际端口不是这两个数字，请把命令中的端口替换成设置页显示的端口。端口被其他程序占用时，修改 v2rayN 本地监听端口，或关闭冲突程序后重新启动核心。
Mac 上常见故障速查
| 现象 | 优先检查 | 处理方式 |
|---|---|---|
| 应用无法打开 | 架构、来源、隔离状态 | 确认 arm64/x64 是否选对；从官方发布页重新下载；按 Apple 的“隐私与安全性”流程处理 |
| 提示应用已损坏 | 未签名 DMG 与应用路径 | 确认来源可信后，对 /Applications/v2rayN.app 执行 xattr -cr |
| 订阅更新后没有节点 | 地址、返回内容、证书 | 重新复制订阅地址，检查是否过期或被登录页替换，再看 guiLogs |
| 节点测试失败 | 活动服务器、核心日志、本地端口 | 重新设为活动服务器，检查核心日志和端口占用，不要先改 DNS |
| 浏览器能用，其他软件不能用 | 软件是否遵循系统代理 | 先确认系统代理设置；仍不支持时再评估 TUN |
| TUN 启动失败 | 管理员权限、核心和路由 | 输入正确的管理员密码；关闭 TUN 改用系统代理，确认节点正常后再排查 TUN |
| 关闭客户端后仍无法联网 | 系统代理残留 | 重新打开 v2rayN，选择“清除系统代理”，再退出客户端 |
如果是界面操作、订阅、测速或检查更新异常，优先收集界面日志；如果是核心无法启动、连接失败或 TUN 报错，保留主界面核心日志。反馈时不要公开完整订阅链接、UUID、密码和个人配置。
安全使用清单
- 只从 v2rayN 项目的 Releases 或项目文档进入下载，不使用无法确认来源的二次打包。
- 根据“关于本机”选择 arm64 或 x64，不要把 Intel 包当成 Apple 芯片原生包。
- 下载后核对文件名、应用路径和系统提示；不要为了启动未知文件而关闭 Gatekeeper。
- 订阅地址按敏感凭据处理，不截图、不公开粘贴到聊天群或工单。
- 先用系统代理验证节点，再考虑 TUN；TUN 需要额外权限，也会扩大排查范围。
- 关闭使用后清除系统代理，并通过出口 IP 或连接日志再次确认状态。
参考资料
本文主要依据以下已打开的项目文档与系统说明整理：v2rayN 官方仓库、发布文件介绍、UI 与订阅分组说明、系统代理与路由说明、官方 FAQ、Apple 芯片 Mac 说明 和 Apple：如果在 Mac 上无法打开 App。
常见问题
Mac 上应该下载 v2rayN 的 arm64 还是 64 位版本？
在“关于本机”中看到“芯片”并列出 Apple 芯片时选 arm64；看到“处理器”并列出 Intel 时选 64 位。不要依据 Mac 外观或购买年份猜测。
v2rayN 订阅导入后没有节点怎么办？
先确认订阅地址完整、未过期且没有复制多余空格，再进入订阅分组更新。仍为空时查看 guiLogs；如果返回的是登录页面或证书校验失败，客户端不会得到有效节点。
系统代理和 TUN 模式有什么区别？
系统代理主要影响遵循 macOS 代理设置的应用；TUN 通过虚拟网络接口接管更大范围的流量，需要管理员权限和额外路由处理。新手应先用系统代理验证节点。
开启代理后怎么确认真的生效？
关闭代理时查询一次出口 IP，开启活动服务器和系统代理后再查询一次；如果出口 IP 或地区发生变化，同时连接日志显示目标请求命中代理策略，通常可以确认该应用已经走代理。
为什么浏览器能用，但某个软件仍然连不上？
该软件可能不遵循系统代理。先确认 v2rayN 的自动配置系统代理和本地端口，再检查软件自身代理设置；仍不支持时，才考虑 TUN，并观察核心日志中的失败原因。