故障排查

先运行诊断

anydo status
anydo doctor

优先确认版本、Hub URL、登录状态、Supervisor、Runner、机器 ID 和最近日志。

机器显示离线

1. 确认电脑联网且没有休眠
2. 执行 anydo status
3. 执行 anydo restart
4. 检查 Hub 域名和 TLS
5. 检查代理是否允许 Socket.IO WebSocket
6. 查看 anydo runner logs

仍有重复 Runner 或状态文件异常时：

anydo repair

会话有输出但前端不更新

• 刷新客户端并确认 SSE /api/events 可连接
• 检查 Hub 日志中的消息同步错误
• 确认会话属于当前账号/Space
• 检查浏览器是否长期后台冻结连接
• 重新打开会话，触发历史补齐

权限请求无法处理

• 确认会话仍活动
• 确认请求没有被其他客户端处理
• 检查当前权限模式是否与 Agent 匹配
• 避免对过期 requestId 重复审批

终端无法打开

• 确认拥有目标机器终端权限
• 确认 Runner 在线
• 检查目标 shell 是否存在
• 检查代理的 WebSocket 支持和超时

更新失败

anydo update
anydo status

检查：

• https://api.anydo.io/downloads/version
• 当前平台的 cli-latest.json
• 下载文件大小和校验值
• 安装目录写权限
• Supervisor 更新激活状态

如果 Hub 已记录同版本失败，即使发布文件后来修复，也需要清理/重试 Hub 更新状态，并等待客户端以新版本重新连接。

Hub 健康

curl -fsS https://your-hub.example.com/health

不要用 /api/hub/info 替代存活检查。