# Docker 镜像加速器配置指南

## 问题说明

错误信息显示无法连接到 Docker Hub (`registry-1.docker.io`)，这是因为网络访问受限导致的。

## 解决方案

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

#### 1. 创建或编辑 Docker 配置文件

```bash
# 创建 docker 配置目录（如果不存在）
sudo mkdir -p /etc/docker

# 编辑 daemon.json 配置文件
sudo nano /etc/docker/daemon.json
```

#### 2. 添加以下配置

```json
{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com",
    "https://mirror.baidubce.com",
    "https://docker.nju.edu.cn"
  ],
  "insecure-registries": [],
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}
```

#### 3. 重启 Docker 服务

```bash
# 重新加载配置
sudo systemctl daemon-reload

# 重启 Docker
sudo systemctl restart docker

# 验证配置
docker info | grep -A 5 "Registry Mirrors"
```

#### 4. 测试拉取镜像

```bash
# 测试拉取一个小镜像
docker pull alpine:latest

# 如果成功，继续构建项目
cd /home/AIRouter
docker compose up --build -d
```

### 方案二：使用国内替代基础镜像

如果镜像加速器仍然不稳定，可以修改 Dockerfile 使用国内镜像源。

#### 修改后端 Dockerfile

创建 `backend/Dockerfile.cn`：

```dockerfile
# 使用国内 Go 镜像源
FROM golang:1.24-bookworm AS builder

WORKDIR /app

# 配置 Go 模块代理（使用国内镜像）
ENV GO111MODULE=on \
    GOPROXY=https://goproxy.cn,https://goproxy.io,direct \
    CGO_ENABLED=1

COPY go.mod go.sum ./
RUN go mod download

COPY . .

RUN go build -ldflags="-w -s" -o gateway main.go

# 运行阶段使用清华大学镜像源
FROM debian:bookworm-slim

RUN sed -i 's/deb.debian.org/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list.d/debian.sources && \
    apt-get update && \
    apt-get install -y --no-install-recommends ca-certificates wget && \
    rm -rf /var/lib/apt/lists/*

WORKDIR /app

COPY --from=builder /app/gateway .

RUN mkdir -p /app/data

ENV DB_PATH=/app/data/gateway.db

EXPOSE 8080

CMD ["./gateway"]
```

#### 修改前端 Dockerfile

创建 `frontend/Dockerfile.cn`：

```dockerfile
FROM node:20-alpine AS builder

WORKDIR /app

# 配置 npm 使用国内镜像
RUN npm config set registry https://registry.npmmirror.com

COPY package*.json ./
RUN npm ci

COPY . .
RUN npm run build

FROM nginx:1.27-alpine

COPY --from=builder /app/dist /usr/share/nginx/html
COPY nginx.conf /etc/nginx/conf.d/default.conf

RUN echo "OK" > /usr/share/nginx/html/health

EXPOSE 80

CMD ["nginx", "-g", "daemon off;"]
```

#### 修改 docker-compose.yml

```yaml
version: '3.8'

services:
  backend:
    build:
      context: ./backend
      dockerfile: Dockerfile.cn  # 使用国内优化版本
    # ... 其他配置保持不变
  
  frontend:
    build:
      context: ./frontend
      dockerfile: Dockerfile.cn  # 使用国内优化版本
    # ... 其他配置保持不变
```

### 方案三：手动拉取所需镜像

```bash
# 使用镜像加速器手动拉取所需的基础镜像
docker pull golang:1.24-bookworm
docker pull debian:bookworm-slim
docker pull node:20-alpine
docker pull nginx:1.27-alpine

# 然后再构建项目
docker compose up --build -d
```

### 方案四：使用代理（临时方案）

如果你有可用的代理服务器：

```bash
# 设置 Docker 客户端代理
export HTTP_PROXY="http://your-proxy:port"
export HTTPS_PROXY="http://your-proxy:port"
export NO_PROXY="localhost,127.0.0.1"

# 然后执行构建
docker compose up --build -d

# 构建完成后取消代理
unset HTTP_PROXY HTTPS_PROXY NO_PROXY
```

或者配置 Docker daemon 使用代理：

```bash
# 创建 systemd 配置目录
sudo mkdir -p /etc/systemd/system/docker.service.d

# 创建代理配置文件
sudo nano /etc/systemd/system/docker.service.d/http-proxy.conf
```

添加以下内容：

```ini
[Service]
Environment="HTTP_PROXY=http://your-proxy:port"
Environment="HTTPS_PROXY=http://your-proxy:port"
Environment="NO_PROXY=localhost,127.0.0.1"
```

然后重启 Docker：

```bash
sudo systemctl daemon-reload
sudo systemctl restart docker
```

## 推荐操作步骤

1. **首先尝试方案一**（配置镜像加速器）- 最简单且长期有效
2. 如果方案一不稳定，**使用方案三**（手动拉取镜像）
3. 如果以上都不行，**使用方案二**（国内优化 Dockerfile）

## 验证成功

配置完成后，执行以下命令验证：

```bash
# 查看 Docker 配置
docker info

# 测试拉取镜像速度
time docker pull alpine:latest

# 构建项目
cd /home/AIRouter
docker compose up --build -d

# 查看构建进度
docker compose logs -f

# 检查服务状态
docker compose ps
```

## 常见问题

### Q: 镜像加速器配置后仍然超时？
A: 尝试使用不同的镜像源，或者切换到方案二使用国内优化的 Dockerfile。

### Q: 某些镜像源不可用？
A: 镜像源可能会变化，可以尝试其他可用的源，或搜索最新的国内 Docker 镜像源。

### Q: 构建速度仍然很慢？
A: 考虑使用本地镜像缓存，或者在网络条件好的时候提前拉取所需镜像。

## 其他国内可用镜像源

- 阿里云：https://your-id.mirror.aliyuncs.com （需要注册获取专属地址）
- 腾讯云：https://mirror.ccs.tencentyun.com
- 南京大学：https://docker.nju.edu.cn
- 中国科技大学：https://docker.mirrors.ustc.edu.cn
- 网易：https://hub-mirror.c.163.com
- 百度云：https://mirror.baidubce.com