故障排查Browser Relay断连恢复

Browser Relay 频繁断连时，先从连接面排查

大多数 Relay 断连问题来自扩展兼容性、权限漂移或网络策略，而不是 Agent 本身。

  • ›先看扩展状态和浏览器版本。
  • ›再看权限和长连接是否被网络策略中断。
  • ›修复后一定验证自动重连能力。

开始使用

把 Relay 连接问题缩到最小范围

先看扩展、权限和网络，再做长连接与网页任务验证。

控制台定价

最常见的根因

浏览器升级后扩展失效、权限被系统撤销、代理或 VPN 杀掉 WebSocket 长连接，是最常见的三类原因。

恢复后还要做什么

不要只看能不能重新连上，还要做一次真实网页任务，确认会话恢复后的稳定性和持续时长。

相关指南

详细排查文章
按连接模式、浏览器和网络层细化定位步骤。
配置指南
回到整体配置顺序理解 Relay 所在层级。
API
当你在 API 与网页自动化之间做取舍时参考。

问答

为什么看起来连上了，任务还是不稳定？

因为真正的问题可能出在长连接保持、浏览器权限或系统休眠策略，所以必须用完整网页任务做持续性验证。

重新安装浏览器是第一步吗？

不是。绝大多数问题都先出在扩展状态、权限漂移或网络策略，先把这些排干净再考虑重装浏览器。