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

## 问题：无法连接 Docker Hub

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

## 解决方案

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

1. **打开 Docker Desktop**
2. **Settings** → **Docker Engine**
3. **添加镜像加速配置**：
   ```json
   {
     "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 镜像

```powershell
# 使用 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 镜像

```powershell
# 使用 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. 构建并推送镜像

```powershell
# 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. 验证

```powershell
# 查看本地镜像
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 需要认证

```powershell
# 登录 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. 手动拉取基础镜像：
   ```powershell
   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 镜像加速配置](./docs/docker-mirror.md)
- [Registry 配置指南](./REGISTRY_667788_SETUP.md)