使用 qemubuilder 构建不同架构的 Debian 软件包

qemubuilder 是一个强大的工具，允许在 x86/x86_64 主机上为其他架构（如 arm64、armhf、ppc64el 等）构建 Debian 软件包。它使用 QEMU 模拟目标架构，并结合 pbuilder 提供纯净的构建环境。

安装和配置 qemubuilder

1. 安装必要软件包

sudo apt update
sudo apt install qemubuilder qemu-user-static binfmt-support debootstrap

2. 配置 binfmt 支持

确保 binfmt 支持已启用：

sudo update-binfmts --enable

3. 创建基础环境

为特定架构创建基础环境（以 arm64 为例）：

sudo DIST=bookworm ARCH=arm64 qemubuilder create

构建不同架构的软件包

1. 更新构建环境

sudo DIST=bookworm ARCH=arm64 qemubuilder update

2. 准备源代码包

在源代码目录中：

dpkg-source -b .

3. 构建软件包

sudo DIST=bookworm ARCH=arm64 qemubuilder build *.dsc

4. 获取构建结果

构建完成的软件包位于：

/var/cache/pbuilder/result/

支持的其他架构

qemubuilder 支持多种架构：

架构	命令示例	常见设备
arm64	ARCH=arm64 qemubuilder build ...	Raspberry Pi 4, AWS Graviton
armhf	ARCH=armhf qemubuilder build ...	Raspberry Pi 2/3, Chromebooks
ppc64el	ARCH=ppc64el qemubuilder build ...	IBM Power Systems
mips	ARCH=mips qemubuilder build ...	嵌入式设备
mipsel	ARCH=mipsel qemubuilder build ...	嵌入式设备
s390x	ARCH=s390x qemubuilder build ...	IBM Z Systems

高级用法

1. 自定义镜像源

sudo DIST=bookworm ARCH=arm64 MIRROR="http://deb.debian.org/debian" qemubuilder create

2. 添加额外软件仓库

sudo DIST=bookworm ARCH=arm64 qemubuilder create --othermirror "deb http://example.com/repo bookworm main"

3. 登录到构建环境

sudo DIST=bookworm ARCH=arm64 qemubuilder login

4. 安装额外依赖

在登录环境中：

apt install build-essential devscripts fakeroot

5. 手动构建软件包

在登录环境中：

cd /path/to/source
dpkg-buildpackage -us -uc

性能优化技巧

1. 使用 cowbuilder 后端：

   sudo apt install cowbuilder
   sudo DIST=bookworm ARCH=arm64 qemubuilder create --builder cowbuilder

2. 启用 ccache：

   sudo DIST=bookworm ARCH=arm64 qemubuilder login
   apt install ccache
   echo 'export PATH="/usr/lib/ccache:$PATH"' >> ~/.bashrc

3. 增加内存限制：
   编辑 /etc/qemubuilder/pbuilderrc：

   MEMORY=2048  # 增加 QEMU 内存到 2GB

4. 使用 tmpfs：
   在 /etc/fstab 添加：

   tmpfs /var/cache/pbuilder/build tmpfs defaults,size=4G 0 0

常见问题解决

问题： 构建过程非常缓慢
解决：

• 使用 cowbuilder 代替默认构建器
• 增加 QEMU 内存限制
• 确保主机有足够内存和交换空间

问题： binfmt_misc 注册失败
解决：

sudo systemctl restart systemd-binfmt
sudo service binfmt-support restart

问题： 依赖关系解析失败
解决：

1. 登录到构建环境：

   sudo DIST=bookworm ARCH=arm64 qemubuilder login

2. 手动安装缺失依赖：

   apt update
   apt install -f

问题： QEMU 崩溃或段错误
解决：

1. 更新 QEMU 到最新版本：

   sudo apt install --only-upgrade qemu-user-static

2. 尝试使用不同的 QEMU 策略：

   echo "QEMU_MODE=system" | sudo tee -a /etc/qemubuilder/pbuilderrc

完整示例工作流

# 创建 arm64 构建环境
sudo DIST=bookworm ARCH=arm64 qemubuilder create

# 更新环境
sudo DIST=bookworm ARCH=arm64 qemubuilder update

# 获取源代码
git clone https://salsa.debian.org/debian/hello.git
cd hello

# 安装构建依赖
sudo mk-build-deps -i -r

# 生成源代码包
dpkg-source -b .

# 构建软件包
sudo DIST=bookworm ARCH=arm64 qemubuilder build ../hello_*.dsc

# 检查构建结果
ls -l /var/cache/pbuilder/result/

清理环境

# 删除特定架构环境
sudo DIST=bookworm ARCH=arm64 qemubuilder clean

# 删除所有 qemubuilder 环境
sudo rm -rf /var/cache/pbuilder/base-*.cow

使用 qemubuilder 可以在单一主机上为多种架构构建 Debian 软件包，无需维护多个物理设备，大大简化了跨架构开发流程。