首次在 Mac 安装 v2rayN,先按芯片选包,再按系统提示决定是否单独放行。主窗口打开后,先验证系统代理,再按需测试 TUN。这样可以区分应用启动、代理内核、系统网络设置三个环节的故障。
Apple 芯片与 Intel:按架构选择安装包
打开苹果菜单「」→「关于本机」。看到「芯片」以及 Apple M 系列名称,选 ARM64;看到「处理器」以及 Intel 名称,选 x64。两种架构都需要核对当前发布包标注的最低 macOS 版本;芯片匹配不代表系统版本也满足要求。
ARM64 原生包
推荐Apple 芯片机型优先使用标记为 ARM64 或 arm64 的 macOS 包。首次打开时如果意外出现安装 Rosetta 的提示,先核对下载项和所用内核的架构。
适合: Apple 芯片 Mac
x64 原生包
Intel Mac 选 x64 或 x86_64 包。ARM64 包不能在 Intel Mac 上运行;更改隐私权限也不能解决架构不匹配。
适合: Intel 处理器 Mac
下载的是磁盘映像时,打开映像,把 v2rayN 应用拖入「应用程序」,推出映像后再从「应用程序」启动。下载的是压缩包时,先完整解压,再按该发布包的说明移动应用;不要从压缩预览直接运行,也不要单独移动包内的内核文件。
Gatekeeper 提示:在哪里点「仍要打开」
「无法验证开发者」是启动阶段的系统检查,与订阅、节点和网络权限无关。仅在确认软件来源可信、文件确实是预期发布包,而且设备管理政策允许时,为这个应用做单独例外。若系统提示应用会损害电脑或检测到恶意软件,应停止运行并重新核对来源,不要把它当成普通的开发者验证提示。
从应用程序启动
在访达打开「应用程序」,双击 v2rayN。记下弹窗的应用名和提示原文,关闭提示。先核对名称,避免误放行同一时间被系统拦截的其他程序。
打开安全设置
在 macOS 13 及之后的版本,打开「」→「系统设置」→「隐私与安全性」,下滚到「安全性」。建议在被拦截后立即查看;这个入口针对近期的启动尝试,并非一直显示。
确认单独放行
确认安全性区块中显示的是 v2rayN,再点「仍要打开」。按系统提示进行身份验证,并在确认框中选择打开。若受管设备没有提供该选项,请联系管理员,不要修改全局安全策略。
检查启动结果
主窗口出现后再处理订阅和代理。如果主窗口能打开,但日志显示核心启动失败,问题已经不在应用入口。根据报错核对内核架构、文件是否齐全和监听端口是否被占用。
系统代理:先核对本地监听,再检查网络服务
先关闭 TUN,选中一个已知可用的节点。通过 v2rayN 的「设置」→「参数设置」查看本地监听设置,然后在主界面的「系统代理」选项中选择「自动配置系统代理」(不同版本的按钮位置可能不同)。以下数字用于说明如何核对地址和端口,不代表所有版本的默认值。
- 检查当前连接。在「系统设置」→「网络」中选正在使用的连接。以无线连接为例,进入「Wi-Fi」→ 已连接网络旁的「详细信息」→「代理」。有线连接要检查对应的以太网服务。切换连接后,原服务的代理设置不会自动证明新服务也已配置。
- 匹配代理类型。查看已启用的网页代理或 SOCKS 代理所填的地址和端口,按实际监听协议核对。不要把仅支持 SOCKS 的端口填给 HTTP 代理;如果版本使用混合监听,则以该监听实际支持的协议为准。
- 验证浏览器请求。用遵循系统代理设置的浏览器打开一个已知可访问的网页,同时看 v2rayN 日志是否收到新请求。有请求但连接失败,优先检查节点和路由;完全没有请求,先查浏览器是否使用了独立代理设置,以及当前网络服务的代理是否生效。
启用系统代理前,记下原有的手动代理或自动配置地址。测试结束时,先在 v2rayN 里清除由客户端写入的系统代理,再退出程序,并确认原有设置已经恢复。否则浏览器可能继续尝试连接已经停止监听的本地端口。
TUN 与网络扩展:只授权当前功能所需的项目
系统代理面向遵循代理设置的应用。TUN 则通过虚拟接口和路由接管流量,适合验证不读取系统代理设置的程序。TUN 不等于网络扩展:不同版本的实现可能要求管理员授权、使用特权辅助程序,或触发系统的 VPN 配置及网络扩展提示。没有出现扩展提示,不代表缺少安装步骤。
- 先确认系统代理模式下节点可用。测试 TUN 时,清除本轮写入的系统代理设置,保留必要的网络管理配置,再单独开启 TUN,以免混淆流量走的是哪条路径。
- 若系统要求添加 VPN 配置或允许网络扩展,先核对提示中的应用名称和本次主动执行的操作。macOS 15 可在「系统设置」→「通用」→「登录项与扩展」的「网络扩展」中检查相关条目;仅在当前版本确实使用该扩展、且条目与提示相符时启用。若提示要求管理员确认,由有权限的账户在系统对话框内完成。
- 开启后测试网页和局域网资源,再看日志中的接口创建、DNS 或路由报错。如果办公资源失联,先关闭 TUN 并确认原连接恢复,再检查是否与现有 VPN、网段路由或企业策略冲突。一次只改一项,避免把修正路由和更换节点混作同一次测试。
首次启动与断网排查
为什么看不到「仍要打开」?
从「应用程序」再次尝试启动 v2rayN,关闭拦截提示,立即回到「隐私与安全性」底部。如果提示是架构不兼容或系统版本过低,按安装包要求重新选择版本;如果是设备管理策略限制,交由管理员处理。
订阅更新成功,为什么网页还是打不开?
订阅更新只说明订阅地址可访问并取得了配置,不代表所选节点可用。选中目标节点,核对核心日志中的监听状态,再到当前网络服务的「代理」页比对端口。日志有请求但握手失败时,检查节点配置,不必重新授权应用。
退出 v2rayN 后浏览器怎么断网了?
检查当前网络服务是否仍把网页请求指向回环地址。如果残留的是本次测试写入的代理,可重新启动 v2rayN 后先清除系统代理再退出,或在网络设置中恢复事先记录的值。若刚使用过 TUN,同时确认 TUN 已关闭。