Docker Moby 26.1.5 在 Linux/arm64 架构下的安装问题分析与解决方案

问题背景

在 Docker 生态系统中，Moby 是一个重要的开源项目，它为容器化技术提供了基础组件。近期在 Linux/arm64 架构上安装 Moby 26.1.5 版本时，用户遇到了一个特殊的安装问题。这个问题特别出现在使用 QEMU 模拟的 arm64 环境中，通过 buildx 进行多架构构建时。

问题现象

当尝试在 Linux/arm64 架构上安装 Moby 26.1.5 版本时，安装过程会在 postinstall 脚本执行阶段失败，系统报告"Exec format error"错误。具体表现为：

Setting up moby-cli (26.1.5-debian12u1) ...
Error while loading /var/lib/dpkg/info/moby-cli.postinst: Exec format error
dpkg: error processing package moby-cli (--configure):
installed moby-cli package post-installation script subprocess returned error exit status 1

深入分析

安装脚本差异

通过对比不同版本的 Moby 安装包，发现 23.0.7+azure 版本的 postinstall 脚本与 26.1.5 版本有显著差异：

26.1.5 版本的脚本较为简单：

#!/bin/sh
set -e

if ! grep -q "^docker:" /etc/group
then
    addgroup --system docker
fi

而 23.0.7+azure 版本的脚本则更为完整：

#!/bin/sh
set -e

case "$1" in
  configure)
    if ! grep -q "^docker:" /etc/group
    then
      addgroup --system docker
    fi
  ;;
  *)
    echo "postinst called with unknown argument \`$1'" >&2
    exit 1
  ;;
esac

架构模拟问题

问题的根本原因在于构建环境缺少 QEMU 模拟支持。当在非原生 arm64 架构（如通过 buildx 进行跨架构构建）上运行时，系统需要 QEMU 来正确执行 arm64 架构的二进制文件和脚本。

解决方案

1. 确保 QEMU 正确配置

在使用 buildx 进行多架构构建时，必须确保 QEMU 模拟器已正确安装和配置。在 GitHub Actions 中，可以通过以下步骤添加 QEMU 支持：

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

2. 临时解决方案

如果暂时无法解决 QEMU 配置问题，可以考虑以下替代方案：

1. 使用兼容性更好的旧版本（如 23.0.7+azure）
2. 在原生 arm64 环境中进行构建和安装

3. 长期建议

对于软件包维护者，建议：

1. 完善 postinstall 脚本，正确处理各种调用场景
2. 在构建系统中增加对模拟环境的检测和友好提示
3. 确保多架构构建的测试覆盖

技术启示

这个案例为我们提供了几个重要的技术启示：

1. 跨架构构建的复杂性：在多架构环境中，不仅要考虑主程序的兼容性，还要注意安装脚本的执行环境。

2. 安装脚本的健壮性：postinstall 脚本应该能够处理各种可能的调用场景，包括不同的参数和系统状态。

3. 构建环境的完整性：在使用模拟环境时，必须确保所有必要的支持组件都已正确安装和配置。

通过理解这个问题及其解决方案，开发者可以更好地处理类似的跨架构构建和安装问题，确保容器化应用在不同平台上的兼容性和稳定性。