crazymax/xgo

Go CGO 交叉编译器 Docker 镜像

概述

本Docker镜像提供了预配置的Go语言CGO交叉编译环境，旨在解决CGO项目跨平台构建的复杂性。通过容器化工具链，开发者无需本地配置复杂依赖，即可为多种目标操作系统和架构编译带有CGO依赖的Go应用。

核心功能与特性

• 多平台支持：覆盖主流操作系统及架构，包括Linux（x86_64/arm64）、Windows（x86_64）、macOS（x86_64/arm64）等
• 预配置工具链：集成Go编译器、目标平台系统库、链接器等必要组件，开箱即用
• 简化流程：通过统一命令行接口自动处理CGO依赖解析与跨平台链接逻辑
• 灵活性：支持自定义Go版本、编译标签、链接参数等高级构建选项
• 轻量集成：适合本地开发环境及CI/CD流水线集成，减少环境一致性问题

使用场景

• 开发环境：在单一系统（如Linux）中为Windows/macOS等平台构建带CGO的Go应用
• CI/CD流水线：作为标准化构建步骤，实现多平台应用的自动化编译
• 复杂CGO项目：处理依赖系统库（如libc、OpenGL）的Go应用跨平台构建

使用方法与配置说明

基本编译命令

通过docker run启动容器，挂载项目目录并指定目标平台：

bash
docker run --rm -v $(pwd):/src -w /src crazy-max/xgo \
  --targets=windows/amd64,linux/arm64,darwin/arm64 \
  -o myapp \
  ./cmd/myapp

参数说明

常用配置选项

docker-compose集成示例

创建docker-compose.yml简化重复构建：

yaml
version: '3'
services:
  xgo:
    image: crazy-max/xgo
    volumes:
      - ./:/src
    working_dir: /src
    command: >
      --targets=linux/amd64,windows/amd64,darwin/amd64
      --go=1.21.0
      --ldflags="-s -w"
      -o myapp
      ./cmd/myapp

执行编译：

bash
docker-compose run --rm xgo

注意事项

• 目标平台兼容性：部分系统库可能存在平台限制，需参考镜像文档确认支持范围
• macOS构建：需注意Apple代码签名要求，编译后可能需要额外签名步骤
• 版本锁定：生产环境建议使用具体镜像标签（如crazy-max/xgo:v0.15.0）确保稳定性

完整文档及更新说明请参考GitHub仓库：https://github.com/crazy-max/xgo