# 如何构建 Docker 镜像

## 前提条件

1. 安装 Docker BuildX
2. 启用 Docker BuildKit
   ```bash
   export DOCKER_BUILDKIT=1
   export BUILDX_NO_DEFAULT_ATTESTATIONS=1
   ```

## 本地构建步骤

### 1. 创建 BuildX 实例
```bash
docker buildx create --name multiarch --driver docker-container
docker buildx use multiarch
docker buildx inspect --bootstrap
```

### 2. 构建多架构镜像
```bash
# 构建 Ubuntu 版本
docker buildx build \
  --platform linux/amd64,linux/arm64 \
  -f docker/Dockerfile.ubuntu \
  -t xxxigcc-proxy:latest \
  --push .

# 构建 Alpine 版本
docker buildx build \
  --platform linux/amd64,linux/arm64 \
  -f docker/Dockerfile.alpine \
  -t xxxigcc-proxy:alpine \
  --push .
```

## 添加新的架构/发行版

### 修改步骤
1. 更新 Dockerfile
2. 调整 `.gitea/workflows/ci.yaml`
3. 更新 `init.sh` 中的兼容性脚本

### 注意事项
- 确保所有依赖支持新架构
- 验证交叉编译兼容性
- 更新 CI/CD 矩阵配置

## 常见问题排查

### 构建失败
- 检查 BuildX 实例状态
- 验证依赖工具链
- 查看详细构建日志