ManusAI镜像拉取慢因依赖海外Docker Hub及私有镜像未被加速器缓存，需分三类处理：①公共镜像替换加速源前缀；②CUDA镜像配置registry-mirrors；③私有镜像强制HTTPS代理或NAS注册表注入加速URL。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
ManusAI部署时拉取镜像速度特别慢，是因为其依赖的底层容器镜像（如Qwen系列模型服务、Playwright浏览器环境、Conda基础镜像等）默认从Docker Hub拉取，而Docker Hub服务器位于海外，国内用户直连时平均延迟超400ms，100MB级镜像常需8～15分钟，且易因TLS握手失败或429限流中断；更关键的是OpenManus项目在GitHub中明确要求使用特定版本的manusai/python:3.12-cuda等私有命名空间镜像，这类镜像不被主流加速器缓存，必须走代理或自建中转才能稳定获取。
确认当前镜像拉取路径是否绕过加速
执行 podman info | grep -A 5 'registries:' 或 docker info | grep -A 5 'Registry'，检查输出中是否包含类似 https://docker.xuanyuan.me 或 https://docker.1ms.run 的加速地址。若只显示 https://registry-1.docker.io 或完全空白，则说明加速未生效——【加速配置必须写在daemon.json或registries.conf最顶层，不能嵌套在子字段里】。
这一步操作起来很简单，直接把文件拖进去就行。
针对ManusAI专用镜像的三类加速方案
ManusAI项目中涉及三类镜像：① 公共基础镜像（如python:3.12-slim）、② 社区CUDA镜像（如nvidia/cuda:12.4.0-devel-ubuntu22.04）、③ ManusAI私有命名空间镜像（如manusai/agent-core:0.4.2）。前三类需分别处理：
方法一：公共基础镜像 → 直接替换为加速源前缀
修改 docker-compose.yml 中所有 image: python:3.12-slim 类条目，在冒号前插入加速域名：image: docker.xuanyuan.me/library/python:3.12-slim。
注意：清华源 mirrors.tuna.tsinghua.edu.cn 不支持带/library/路径的写法，必须用 docker.m.daocloud.io/library/python 才能正确路由。
方法二：NVIDIA官方CUDA镜像 → 使用镜像别名映射
编辑 /etc/docker/daemon.json（Linux）或 Docker Desktop → Settings → Docker Engine，加入：
{"registry-mirrors": ["https://docker.1ms.run"], "experimental": true}
然后重启Docker服务。此配置可自动将 nvidia/cuda 请求重定向至毫秒镜像的CUDA专属节点，无需修改YAML文件。
方法三：ManusAI私有镜像 → 必须启用HTTPS代理中转
因为 manusai/* 镜像仅托管在私有Harbor实例上（地址为 https://hub.manusai.dev），而该域名未被任何公共加速器收录，此时需强制走代理：
第一步：在宿主机启动轻量代理 export HTTP_PROXY=http://127.0.0.1:8080; export HTTPS_PROXY=http://127.0.0.1:8080；
第二步：运行 docker pull manusai/agent-core:0.4.2，流量将经本地代理转发；
第三步：验证代理日志是否出现 GET /v2/manusai/agent-core/manifests/0.4.2 请求成功响应。
⚠️ 若代理未监听443端口或证书未导入系统信任库，会报错 x509: certificate signed by unknown authority，此时必须用 curl -k 测试代理连通性再继续。
NAS设备上部署ManusAI的加速实操
威联通、群晖、极空间等NAS平台无法直接修改daemon.json，但可通过“注册表”功能注入加速逻辑：
以群晖DSM 7.2为例：
① 进入「Docker」→「注册表」→「新增」→「URL」；
② 名称填 ManusAI-Accel，URL填 https://docker.xuanyuan.me（不要加/v2后缀）；
③ 点击「测试连接」，成功后保存；
④ 在创建容器时，镜像名称必须写成 docker.xuanyuan.me/manusai/agent-core:0.4.2，不能只写 manusai/agent-core:0.4.2——【NAS图形界面不会自动补全加速前缀，漏写即退回直连Docker Hub】。
