适合首次在 Mac 安装 v2rayN,或系统升级后发现代理失效的用户。先根据提示判断是应用启动、本地监听还是系统代理写入出了问题,再按对应路径检查。只有来源明确且系统提供例外入口时,才考虑为当前应用单独放行。
先区分启动拦截与代理故障
Gatekeeper 会检查从互联网下载的应用,签名和公证是其中的判断依据。「无法验证开发者」说明系统未能按默认策略验证当前副本,不等于网络权限被拒绝,也不能作为文件安全的证明。包的来源不明、系统明确报告恶意软件,或出现「已损坏」提示时,不要把普通的开发者验证例外当作修复手段。
从提示出现的位置查起
推荐双击后没有主窗口,先处理启动提示;能看到主窗口但启用代理后才断网,先看核心日志和当前网络服务的代理设置。先记下原始提示,再一次只调整一个设置。
适合:首次安装、升级后原因不明
先做直连对照
如果 v2rayN 能打开,先记录原有代理设置,再清除由本次测试写入的代理,用同一浏览器重试原本可直连的网站。直连也失败时,优先检查 Wi-Fi、门户登录或现有网络策略,不要继续改节点参数。
适合:切换网络后浏览器突然无法访问网页
结论:先确认主窗口是否出现
只要主窗口能打开,就先保留现有安全设置,转查内核日志;应用获准启动,不代表随包提供的内核已成功运行。
在「隐私与安全性」中单独放行
核对安装包
从可信发布入口重新确认下载来源。在苹果菜单 →「关于本机」查看是 Apple 芯片还是 Intel 处理器,分别选择标为 arm64 或 x64 的对应构建。解压后在访达里确认后续一直打开同一份应用,避免同时测试下载目录和「应用程序」里的两个副本。
读取拦截提示
双击应用并阅读系统提示。如果只是开发者无法验证,且来源明确,关闭提示后继续下一步。如果系统提示应用会损坏电脑,或来源无法确认,停止启动并向发布方或设备管理员核实。
打开安全设置
在 macOS 13 及更新版本,进入苹果菜单 →「系统设置」→「隐私与安全性」,下滚到「安全性」。找到刚才被阻止的应用记录;只有确认应用名与刚才打开的副本一致,才点「仍要打开」。
确认本次授权
按系统对话框确认,必要时使用有权限的账户认证。没有看到按钮时,可重新尝试打开同一份应用并立即返回设置查看;如果设备受学校或公司策略管理,让管理员确认是否允许例外,不要关闭系统级保护。
检查核心日志
主窗口打开后选择一条已有配置,查看客户端日志,确认对应核心能启动且本地监听没有报错。此时先不打开 TUN,也不批量更新订阅,避免把应用启动、核心加载和远端连接混在一起排查。
核对系统代理与本地网络权限
系统代理配置属于网络服务。v2rayN 写入的是供遵循系统代理的应用使用的地址和端口,并不是一个涵盖所有程序的上网权限。使用 Wi-Fi 时,在客户端底栏的「系统代理」菜单选择「自动配置系统代理」;如果界面版本不同,以当前客户端提供的系统代理入口为准。随后到苹果菜单 →「系统设置」→「网络」→「Wi-Fi」→ 当前已连接网络的「详细信息」→「代理」复核。用有线连接时,则查看实际使用的以太网服务。
- 检查监听端口:在 v2rayN「设置」→「参数设置」核对本地监听端口,再对照核心日志。若端口实际是
10808,可在终端运行lsof -nP -iTCP:10808 -sTCP:LISTEN查看监听进程。端口被其他进程占用时,先识别进程归属,再退出已知冲突程序或更换端口,并重新应用系统代理。 - 匹配代理类型:系统「网页代理(HTTP)」「安全网页代理(HTTPS)」和「SOCKS 代理」是不同项目。以客户端实际写入的项目和对应监听类型为准,不要把 SOCKS 专用端口填进 HTTP 项。若原来使用自动代理配置或工作网络代理,先记录原值,避免覆盖后无法恢复。
- 只授予所需访问:macOS 15 起,访问局域网设备时,系统可能要求本地网络权限。确实需要访问局域网地址时,可在「系统设置」→「隐私与安全性」→「本地网络」核对与请求相符的应用项目。仅通过
127.0.0.1使用本机代理,通常不需要为此打开局域网访问权限。
系统升级后恢复代理设置
- 确认运行的是哪份应用。从「应用程序」启动准备继续使用的副本。若升级后换了应用包并再次收到验证提示,将其视为新的启动检查,重新核对来源。不要假设旧副本的例外会沿用到新副本。
- 先让核心恢复监听。打开客户端日志检查启动结果。遇到端口占用时,先处理监听冲突;若日志指向核心文件缺失或无法执行,检查是否完整解压、是否混用了不同架构的文件。核心没有监听时,反复打开系统代理只会让程序继续请求一个不可用的端口。
- 重新应用到当前网络。确认核心就绪后,通过客户端的「系统代理」菜单清除本次写入的旧值,再自动配置。回到当前网络服务的「代理」页面核对结果。如果系统要求认证,只有在操作确由自己发起、提示对象与当前操作一致时才确认。受管理的项目由管理员处理。
- 分开验证浏览器与其他应用。用遵循系统代理的浏览器做对照,再测试目标应用。浏览器恢复而目标应用仍失败,先查该应用是否使用自己的代理配置。浏览器也失败时,结合核心日志区分本机连接被拒绝与远端连接超时,避免反复改系统权限。
首次打开与网络权限常见问题
为什么找不到「仍要打开」?
先从访达打开准备使用的那份应用,记录提示原文,再到「隐私与安全性」下方查看。若提示是损坏或恶意软件警告,或设备策略不提供例外,该入口不适用于当前情况。
退出 v2rayN 后为什么网页也打不开?
检查当前网络服务是否仍把请求发往已停止监听的本地端口。可重新打开客户端,用「系统代理」菜单清除它写入的设置;如原本有单位代理或自动配置地址,恢复此前记录的值,而不是关闭所有代理项目。
本地网络里没有 v2rayN,要手动添加吗?
先区分目标是不是局域网设备。访问远端服务器失败时,优先看远端地址、端口和核心日志;确实需要访问局域网时,再重试该操作并核对系统是否发出请求,不必为了普通联网寻找额外授权。