适合首次安装 v2rayN,或升级后遇到启动拦截、代理不生效的 macOS 用户。先核对应用来源与处理器架构,再按系统提示处理单个应用的启动许可;能打开主界面之后,分别验证系统代理、本地网络和 TUN,不把三类权限混在一起排查。
识别 Gatekeeper 提示与安装包架构
代码签名用于确认签名身份和签名后代码的完整性;公证则是 Apple 对提交的软件进行自动安全检查的流程。Gatekeeper 会依据系统策略评估下载的应用。提示「无法验证开发者」或「无法验证是否包含恶意软件」时,不能仅凭弹窗判断安装包是否安全,也不能把所有启动失败都归因于未公证。
- 架构:打开 Apple 菜单 →「关于本机」。显示 Apple 芯片时选 ARM64;显示 Intel 处理器时选 x64。架构不匹配与签名校验是两件事,修改安全性设置不会让错误架构的程序变为原生可运行。
- 来源:核对下载渠道、发布版本和文件名。不熟悉的镜像、聊天附件或二次打包文件,不应仅凭名称与图标相同就继续打开。
- 警告类型:如果系统明确报告恶意软件,或提示应用已损坏,停止打开并重新核实来源、重新获取安装包。单位管理的 Mac 如果限制了应用运行,请由管理员确认组织策略。
在「隐私与安全性」中放行单个应用
以下路径适用于使用「系统设置」的 macOS 版本。只在确认来源可信、且系统提供单应用例外时操作;不需要关闭 Gatekeeper,也不需要修改系统级安全策略。
移入应用程序
若安装包是磁盘映像,打开后按窗口提示将 v2rayN 拖到「应用程序」;若是压缩包,先解压,再移动其中的应用。随后从 Finder 的「应用程序」启动,避免误开下载目录中的旧副本。
触发启动检查
双击刚安装的 v2rayN。出现无法验证的弹窗后先关闭弹窗,记下应用名称。若没有弹窗且主界面能打开,跳过本节剩余步骤。
查找安全提示
打开 Apple 菜单 →「系统设置」→「隐私与安全性」,向下找到「安全性」。核对最近被阻止的应用是否为 v2rayN,再点击「仍要打开」。该选项通常在尝试启动后约一小时内可用。
确认打开
在系统对话框中按提示验证身份并确认打开。该例外针对这次选定的应用,不等于授予网络权限。更新或替换应用后如果再次出现提示,先重新核对新包的来源与版本。
系统代理与 TUN 分开验证
能打开主界面,只说明应用已启动,不说明内核监听正常,也不说明浏览器流量已经进入代理。首次测试只开一种入口;如果两种同时打开,浏览器恢复访问也无法证明是哪一种设置生效。
两种入口的检查路径
系统代理:先测浏览器
- 关闭 TUN,选择节点,在 v2rayN 的「系统代理」菜单选择「自动配置系统代理」。若系统针对本次修改弹出认证窗口,核对请求与刚才的操作是否一致,再按提示认证。
- 在「系统设置」→「网络」→ 当前服务(如「无线局域网」)→「详细信息」→「代理」查看启用项。核对地址和端口是否对应 v2rayN 的本地监听;切换到有线网络后,应重新核对当前服务。
TUN:再测虚拟网卡
- 先清除系统代理,再启用 v2rayN 的 TUN 模式。按实际提示区分管理员认证、添加 VPN 配置和允许网络扩展;它们不是同一项权限,不是每种实现都会请求网络扩展。
- 在 macOS 15 中,如果明确提示网络扩展被禁用,可到「系统设置」→「通用」→「登录项与扩展」→「网络扩展」,打开详情并启用对应条目。若实际提示添加 VPN 配置,则在系统确认框中核对名称,再在「系统设置」→「VPN」检查状态。
代理页显示的端口与客户端监听一致,只能证明设置指向同一入口;节点是否连通还要看内核日志和实际请求。
系统代理修改不一定弹出授权,也没有一个适用于所有版本的常驻权限开关。如果代理页没有变化,先确认客户端选择的不是「不改变系统代理」,再检查客户端日志有无权限错误。若有其他软件或托管策略接管代理,记录原设置,避免直接覆盖。
本地网络权限按访问对象决定
macOS 15 的「本地网络」权限用于控制应用访问局域网设备。浏览器连本机回环地址 127.0.0.1,与 v2rayN 或其内核连接另一台局域网主机是两条不同的连接。使用公网节点并把浏览器指向回环端口时,不要仅因网页打不开就打开本地网络权限。
公网节点与回环监听
推荐保持代理监听在本机。用遵循系统代理的浏览器验证连接;若端口填的是示例值 10808,但日志显示实际监听在其他端口,应修正客户端或代理配置。
适合:首次安装、只代理本机应用
访问局域网节点
当节点确实部署在同一局域网,例如地址为 192.168.1.20,在「系统设置」→「隐私与安全性」→「本地网络」检查对应应用的开关。若列表尚未出现对应项,先发起实际访问并观察系统是否弹出请求。以系统显示的请求方为准,不批量放行未知条目。
适合:节点或目标服务实际位于局域网
授权后仍不能联网的排查顺序
- 查本地监听。在终端运行
lsof -nP -iTCP:10808 -sTCP:LISTEN,把端口替换成客户端当前值。有记录时核对进程名;没有记录时回到 v2rayN 日志,检查内核是否启动、端口是否绑定失败。监听成功不代表远端握手成功。 - 查节点握手。选定一个节点后发起请求,对照当时的内核日志。连接超时先查节点地址和端口;握手错误再核对服务端要求的传输方式和安全层设置。不要仅凭节点名称判断配置,也不要用关闭证书验证来掩盖错误。
- 查应用与路由。若浏览器正常而某个应用失败,先确认该应用是否读取系统代理。若只在 TUN 模式失败,先关掉其他 VPN,检查路由及 DNS 是否冲突;若局域网服务单独失败,再核对分流规则、本地网络权限和目标设备是否在线。
- 恢复原网络设置。排查结束后先关闭 TUN,再通过 v2rayN 清除系统代理。回到当前网络服务的「代理」页复核;使用单位代理或手动代理的设备应恢复先前记录的配置,而不是把所有项目一律关闭。