Docker镜像配置Healthcheck指令需使用真实业务端点(如curl -f /actuator/health)而非进程检查,合理设置--interval、--timeout、--start-period和--retries参数,并验证退出码与权限,确保服务真正就绪。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想在本地快速验证ManusAI的核心能力,比如让AI执行代码、调用浏览器、读写文件,又不想被复杂的依赖编译和权限配置卡住——Docker镜像已经为你打包好全部运行时环境,只需一条命令就能启动一个干净、隔离、即用的测试沙箱。
确认Docker服务已就绪
打开终端,执行 docker --version,确保输出版本号不低于 24.0.0;若提示 command not found,请先安装 Docker Desktop 或 Docker Engine。
再运行 sudo docker info | grep "Default Runtime",确认输出含 runc ——这是默认安全运行时,【ManusAI沙箱依赖 runc 隔离机制,使用 containerd 或 kata-runtime 可能导致工具调用失败】。
最后检查 Docker socket 权限:ls -l /var/run/docker.sock,返回结果中应包含 docker 用户组,且当前用户已在该组内;若无,需执行 sudo usermod -aG docker $USER && newgrp docker 并重启终端。
拉取并启动官方测试镜像
执行以下命令一次性完成拉取与运行:
docker run -d --name manus-test -p 8080:8080 -v $(pwd)/manus-data:/app/data -e MANUS_ENV=dev --restart unless-stopped ghcr.io/manus-ai/openmanus:v1.0.0
这条命令做了四件事:后台启动容器(-d)、映射本地 8080 端口到容器内服务、将当前目录下 manus-data 文件夹挂载为持久化数据卷、设置开发模式环境变量以启用调试日志和沙箱工具面板。
注意:首次拉取可能耗时 2–5 分钟,镜像大小约 1.2GB,依赖稳定网络;若中途断开,再次执行会自动续传,无需重头开始。
验证服务是否正常响应
等待 30 秒后,在浏览器访问 http://localhost:8080/health,页面应返回 JSON:
{"status":"ok","sandbox":"ready","tools":["browser","shell","file"]}
若返回 404 或连接被拒绝,请执行 docker logs manus-test 查看错误——常见原因是端口被占用(如本地已有 Nginx 占用 8080)或挂载路径权限不足(manus-data 目录需有读写权限)。
确认健康状态后,直接访问 http://localhost:8080 进入 Web UI,输入任意自然语言指令,例如 “生成斐波那契数列前 10 项并保存为 fib.txt”,系统将自动创建沙箱容器、执行 Python 代码、写入文件并返回结果。


















