wecom-ai-assistant/QUICK_BUILD.md

快速构建并推送到 registry.667788.cool

问题：无法连接 Docker Hub

如果遇到 failed to fetch oauth token 错误，需要配置 Docker 镜像加速。

解决方案

方案一：配置 Docker Desktop 镜像加速（推荐）

1. 打开 Docker Desktop
2. Settings → Docker Engine
3. 添加镜像加速配置：

   {
     "registry-mirrors": [
       "https://docker.mirrors.ustc.edu.cn",
       "https://hub-mirror.c.163.com",
       "https://mirror.baidubce.com"
     ]
   }
   

4. 点击 Apply & Restart
5. 等待 Docker 重启完成

方案二：使用构建参数指定镜像源

如果无法配置 Docker Desktop，可以使用构建参数：

构建 Backend 镜像

# 使用 USTC 镜像源
docker build --build-arg PYTHON_IMAGE=docker.mirrors.ustc.edu.cn/library/python:3.12-slim -f deploy/docker/backend.Dockerfile -t registry.667788.cool/wecom-ai/wecom-ai-backend:latest .

# 推送
docker push registry.667788.cool/wecom-ai/wecom-ai-backend:latest

构建 Admin 镜像

# 使用 USTC 镜像源
docker build --build-arg NODE_IMAGE=docker.mirrors.ustc.edu.cn/library/node:20-alpine -f deploy/docker/admin.Dockerfile -t registry.667788.cool/wecom-ai/wecom-ai-admin:latest .

# 推送
docker push registry.667788.cool/wecom-ai/wecom-ai-admin:latest

完整构建流程

1. 配置镜像加速（方案一）

按照上面的方案一配置 Docker Desktop。

2. 构建并推送镜像

# Backend
docker build -f deploy/docker/backend.Dockerfile -t registry.667788.cool/wecom-ai/wecom-ai-backend:latest .
docker push registry.667788.cool/wecom-ai/wecom-ai-backend:latest

# Admin
docker build -f deploy/docker/admin.Dockerfile -t registry.667788.cool/wecom-ai/wecom-ai-admin:latest .
docker push registry.667788.cool/wecom-ai/wecom-ai-admin:latest

3. 验证

# 查看本地镜像
docker images | grep registry.667788.cool

# 应该看到：
# registry.667788.cool/wecom-ai/wecom-ai-backend   latest   ...
# registry.667788.cool/wecom-ai/wecom-ai-admin     latest   ...

如果 Registry 需要认证

# 登录 Registry
docker login registry.667788.cool
# 输入用户名和密码

故障排查

问题：仍然无法拉取基础镜像

解决方案：

1. 尝试其他镜像源：
   • hub-mirror.c.163.com/library/python:3.12-slim
   • mirror.baidubce.com/library/python:3.12-slim
2. 使用代理
3. 手动拉取基础镜像：

   docker pull docker.mirrors.ustc.edu.cn/library/python:3.12-slim
   docker tag docker.mirrors.ustc.edu.cn/library/python:3.12-slim python:3.12-slim
   

问题：推送失败

检查项：

1. Registry 是否需要登录
2. 网络连接是否正常
3. 镜像名称格式是否正确

参考文档

• Docker 镜像加速配置
• Registry 配置指南