26、容器化与部署：Docker跨平台编译、CI/CD（GitHub Actions）中的多平台构建

说实话，跨平台开发这件事，我早年吃过不少亏。

那时候在Windows上写得欢天喜地，一部署到Linux服务器上就崩。后来换了ARM架构的树莓派做边缘计算，又得重新编译一遍。你想想看，一个项目维护三套编译环境，光是折腾依赖库就够喝一壶的。

直到Docker和CI/CD工具成熟起来，这个问题才算真正有了标准解法。今天我们就聊聊怎么用Docker做跨平台编译，再配合GitHub Actions实现自动化多平台构建。

为什么需要跨平台编译？

说白了，你的开发机可能是x86_64的Mac或Windows，但生产环境可能是ARM64的云服务器，或者客户那边用的是Linux armv7的嵌入式设备。你不可能每换一个平台就买一台新电脑。

跨平台编译（Cross-compilation）就是让你在一台机器上，编译出能在其他架构上运行的二进制文件。Docker在这里扮演的角色，就是提供一个标准化的编译环境，避免「在我机器上能跑」的尴尬。

Docker跨平台编译的两种方式

方式一：使用Docker Buildx + QEMU

这是目前最主流的方式。我个人习惯在项目根目录放一个docker-bake.hcl文件，或者直接用命令行指定平台。

先安装QEMU模拟器支持：

docker run --privileged --rm tonistiigi/binfmt --install all

然后创建Buildx构建器：

docker buildx create --name mybuilder --use
docker buildx inspect --bootstrap

接下来，一个简单的Dockerfile就可以同时构建多个平台：

FROM --platform=$TARGETPLATFORM alpine:3.18
ARG TARGETPLATFORM
RUN echo "Building for $TARGETPLATFORM"
COPY ./app /app
CMD ["/app"]

构建命令：

docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t myapp:latest --push .

方式二：使用交叉编译工具链

如果你不想依赖QEMU模拟（模拟器确实会慢一些），可以直接在Docker镜像里安装交叉编译工具链。比如编译ARM64的C程序：

FROM ubuntu:22.04
RUN apt-get update && apt-get install -y \
    gcc-aarch64-linux-gnu \
    g++-aarch64-linux-gnu
COPY ./src /src
RUN aarch64-linux-gnu-gcc -o /app /src/main.c

这种方式编译速度快，但需要你手动处理依赖库的交叉编译版本。嗯，这里要注意：很多第三方库并没有提供交叉编译版本，你得自己用工具链重新编译一遍。

CI/CD中的多平台构建：GitHub Actions实战

手动构建多平台镜像只是第一步。真正的价值在于自动化——每次代码推送，CI/CD流水线自动为所有目标平台构建并推送镜像。

下面是我在项目中实际用过的GitHub Actions配置，你可以直接拿来改：

name: Multi-Platform Build

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Set up QEMU
        uses: docker/setup-qemu-action@v3

      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v3

      - name: Login to Docker Hub
        uses: docker/login-action@v3
        with:
          username: ${{ secrets.DOCKER_USERNAME }}
          password: ${{ secrets.DOCKER_PASSWORD }}

      - name: Build and push
        uses: docker/build-push-action@v5
        with:
          context: .
          platforms: linux/amd64,linux/arm64,linux/arm/v7
          push: true
          tags: |
            yourusername/myapp:latest
            yourusername/myapp:${{ github.sha }}

这个工作流做了几件事：

• 检出代码
• 安装QEMU模拟器（让Docker能在x86上模拟ARM）
• 设置Buildx（多架构构建器）
• 登录Docker Hub（或者你自己的镜像仓库）
• 构建并推送三个平台的镜像

多平台构建的SVG流程图

下面这张图展示了从代码提交到多平台镜像推送的完整流程：

多平台构建的常见问题与避坑

问题	原因	解决方案
构建速度慢	QEMU模拟ARM指令集，性能损失较大	使用交叉编译工具链替代QEMU；或使用原生ARM runner（GitHub已支持）
依赖库不兼容	某些C库在ARM上行为不同	在Dockerfile中按架构条件编译；使用dpkg --add-architecture arm64安装多架构库
镜像体积过大	每个平台单独构建，重复层多	使用--provenance=false减少元数据；合理利用Docker缓存
CI/CD超时	多平台构建耗时长，超过默认限制	在GitHub Actions中设置timeout-minutes: 60；或拆分构建任务

总结

容器化跨平台编译，说白了就是三件事：

• Docker Buildx + QEMU：快速上手，适合大多数场景
• 交叉编译工具链：性能更好，但需要更多手动配置
• GitHub Actions自动化：把多平台构建集成到CI/CD流水线中

我个人建议，如果你的项目还在早期阶段，先用Buildx+QEMU跑起来。等产品稳定了，再考虑优化构建速度。毕竟，先解决「有没有」的问题，再解决「快不快」的问题。

---

公众号:蓝海资料掘金营，微信deep3321