AI Manus沙盒容器异常需立即定位根因：先用docker ps -a检查状态，Exited(137)表明OOM终止，Restarting说明启动崩溃；再通过docker logs查panic或connection refused等错误；若日志为空，则检查镜像完整性、入口脚本权限与换行符、架构兼容性；最后验证RPC通信及宿主机资源状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
AI Manus沙盒容器异常会直接导致Agent任务中断、工具调用失败或前端无响应，必须第一时间定位是沙盒本身崩溃、网络隔离失效，还是与后端RPC通信断开。
确认沙盒容器是否存活且状态异常
执行 docker ps -a --filter "name=manus-sandbox"，重点观察 STATUS 列：
若显示 Exited (137)，说明沙盒被 OOM Killer 强制终止，需立即检查内存限制；
若显示 Restarting，表明容器启动后迅速崩溃并陷入重启循环；
若容器名未列出，说明沙盒未被创建或已自动销毁（正常行为），此时应检查后端是否成功下发创建指令。
记录下对应容器的 CONTAINER ID，后续所有操作都基于该 ID 展开。
提取关键日志定位根因
方法一：查看标准输出与错误流
运行 docker logs <container_id>。重点关注最后一屏中是否出现 panic:、fatal error: 或 connection refused 类字样——前者指向沙盒内服务（如 headless Chrome）崩溃，后者多因后端未正确注入 RPC 地址或沙盒网络未就绪。
方法二：捕获启动全过程（适用于日志为空或极短的情况）docker logs <container_id> 2>&1 | tail -n 100。这能绕过 Docker 日志缓冲机制，暴露容器从 entrypoint 执行到崩溃前的真实行为链。
【注意】若日志完全为空，说明容器在 exec 进程启动前即退出，问题一定出在镜像层或 docker run 参数上，跳过日志分析，直接进入镜像检查环节。
验证沙盒镜像完整性与启动配置
第一步：确认镜像是否存在且可 inspectdocker image inspect manus/sandbox:latest。若报错 No such image，说明镜像未拉取或 tag 错误；若返回 JSON 中 Config.Entrypoint 为空或指向不存在路径（如 ["/bin/entrypoint.sh"] 但镜像内无此文件），则启动必然失败。
第二步：检查入口脚本权限与格式docker run --rm -it manus/sandbox:latest ls -l /entrypoint.sh。输出中若缺失 x 权限位（如 -rw-r--r--），需重建镜像并添加 RUN chmod +x /entrypoint.sh；
若权限正常，再执行 docker run --rm -it manus/sandbox:latest cat -A /entrypoint.sh | head -n 1，输出含 ^M 表示 Windows 换行符，必须转为 LF 格式，否则 shell 解释器无法识别 shebang。
这款全能AI助手融合了深度推理、多模态对话与图像生成等前沿技术，全面赋能职场、学习与生活。它支持多模态搜索，精准响应各类信息需求；内置AI文档助手，快速提炼要点并生成思维导图；更有智能创作功能，一键生成报告与文案。强大的AI能力助你高效处理复杂任务，让工作与生活更轻松便捷。
第三步：验证架构兼容性
在宿主机运行 uname -m，得到 aarch64 或 amd64；再执行 docker inspect manus/sandbox:latest | jq '.[0].Architecture'。二者不一致时，强制指定平台启动：docker run --platform linux/amd64 manus/sandbox:latest。
检查沙盒与后端的 RPC 通信链路
进入正在运行的沙盒容器：docker exec -it <container_id> /bin/sh。
在容器内执行：ping -c 3 backend（假设后端服务注册名为 backend）；
若不通，说明 DNS 解析失败或网络策略阻断——检查 /etc/hosts 是否注入了 backend 的 IP，或确认 Docker 网络模式是否为 --network manus-net（而非默认 bridge）。
若 ping 通，继续测试 RPC 端口：nc -zv backend 8080（端口以实际部署为准）。连接拒绝（Connection refused）表明后端服务未监听该端口，或沙盒未被正确加入服务发现体系。
【关键前提】沙盒容器必须以 --add-host=backend:<ip> 方式启动，否则 hostname 解析必然失败。
排查宿主机资源与 Docker 守护进程状态
执行 systemctl status docker，确认服务 Active 状态；若为 inactive，运行 sudo systemctl start docker 并检查 journalctl -u docker.service -n 30 中是否有 permission denied 或 failed to start daemon。
检查磁盘空间：df -h /var/lib/docker。若使用率 ≥95%，Docker 将拒绝写入，导致沙盒创建失败；此时执行 docker system prune -af 清理 dangling 数据。
检查内存压力：dmesg | grep -i "killed process"。若输出含 manus-sandbox 进程名，证实 OOM 发生——需在 docker run 命令中显式添加 -m 2g --memory-swap=2g 限制内存上限。
