Files
xxxigcc-proxy/llmdoc/guides/how-to-build-docker-images.md
Wang Defa 9afe4a8649
All checks were successful
Build and Release / build-and-test (arm64, alpine) (push) Successful in -13s
Build and Release / build-and-test (amd64, alpine) (push) Successful in -6s
Build and Release / build-and-test (arm64, ubuntu) (push) Successful in -7s
Build and Release / build-and-test (amd64, ubuntu) (push) Successful in 7s
Build and Release / release (push) Successful in 21s
简化 Debian 发布流程并添加项目文档系统
- 将 Debian 包仓库从 bookworm/trixie 双发行版改为通用 stable 仓库
- 新增完整的 llmdoc 文档系统,包含架构、指南和参考文档
- 更新 README.md 和部署指南以反映新的仓库配置
- 添加 .gitignore 文件
2025-12-25 10:18:07 +08:00

1.1 KiB

如何构建 Docker 镜像

前提条件

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

本地构建步骤

1. 创建 BuildX 实例

docker buildx create --name multiarch --driver docker-container
docker buildx use multiarch
docker buildx inspect --bootstrap

2. 构建多架构镜像

# 构建 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 实例状态
  • 验证依赖工具链
  • 查看详细构建日志