常见问题

WebSocket 地址应该填写哪个端口？

填写机器人主程序独立 WebSocket 服务的地址，默认 ws://127.0.0.1:9090。它不是 Web 管理后台端口。如果插件与机器人不在同一台机器，请使用服务器可达地址并检查防火墙。

集群子服为什么连接不上代理？

检查代理 control.bind_host 和 control.port 是否正确监听、防火墙是否放行、子服 control.host 是否指向代理，以及双方 control.token 是否完全一致。每个实例的 server_id 也必须唯一。

多个子服都可以开启白名单模式吗？

不可以。一个集群只允许一个子服设置 whitelist 或 captcha 登录拦截模式。其他需要接收数据的子服设为 sync_only。启用多个拦截实例会触发冲突保护。

修改配置后何时生效？

执行 /sab reload；代理使用 /sabproxy reload。热重载会重新读取配置，并按新值重建连接。

机器人应该怎么处理 message_transfer？

作为无需 ACK 的事件推送；集群代理会广播给全部已接入子服。群服互通还需要 chat_bridge_enabled: true 且 chat_bridge_sensitive: false。

大型白名单快照会超时吗？

尽量将全量数据拆成多个 sync 增量事件。插件会顺序异步处理同步持久化，但网络单条消息仍有 1 MiB 上限。

还有问题需要提供什么信息？

排障时附上 Bukkit / 代理平台与版本、部署模式、相关配置（隐藏令牌和密码）、/sab status 或 /sabproxy status 结果，以及连接失败附近的控制台日志。