实战：用QEMU给树莓派定制Ubuntu-base镜像（含图形界面配置）

实战：用QEMU给树莓派定制Ubuntu-base镜像（含图形界面配置）

最近在折腾树莓派项目时，我常常遇到一个头疼的问题：官方提供的系统镜像要么过于臃肿，要么缺少我需要的特定组件。每次都要在资源受限的板卡上反复安装、配置，效率实在太低。后来我发现，直接在x86开发机上，利用QEMU模拟ARM环境，从头构建一个轻量、定制的Ubuntu-base系统镜像，再烧录到SD卡里，简直是打开了新世界的大门。这种方法不仅能精确控制系统中包含的每一个软件包，还能预先配置好图形界面、开发环境甚至开机自启动的应用，真正做到“一次构建，随处运行”。对于物联网设备开发者、嵌入式爱好者，或者任何需要在特定硬件上部署精简Linux系统的人来说，这都是一项极具价值的技能。

今天，我就把自己这套从零开始，为树莓派等ARM设备定制带图形界面的Ubuntu-base镜像的完整流程分享出来。我们会涵盖从获取基础根文件系统、使用QEMU进行跨架构修改、配置轻量级X11桌面环境（以Openbox为例），到最终打包成可直接烧录的.img文件的每一个步骤。过程中，我还会穿插一些实际踩过的“坑”和提升效率的小技巧，希望能帮你少走弯路。

1. 环境准备与基础概念解析

在开始动手之前，我们有必要先理清几个核心概念和工具链。Ubuntu-base并非一个完整的桌面系统，而是一个最小化的根文件系统（rootfs）。它只包含最基本的命令行工具和包管理器（apt），就像一个毛坯房，为我们后续的个性化装修提供了最干净的基础。我们的目标就是在这个“毛坯房”里，安装必要的“家具”（软件包），粉刷“墙面”（配置系统），最终把它变成一个功能齐全、可直接入住（启动）的定制系统。

那么，如何在x86电脑上为ARM架构的系统安装软件、修改配置呢？这就轮到QEMU用户态模拟（qemu-user-static）登场了。它就像一个实时翻译官，当我们在x86主机上试图运行ARM架构的可执行文件（比如apt install命令）时，QEMU能即时将其“翻译”成x86指令并执行，效果就像我们真的在一台ARM机器上操作一样。这比启动一个完整的ARM虚拟机要轻量和高效得多。

提示：确保你的宿主机是Linux系统（如Ubuntu 20.04/22.04），并拥有sudo权限。本文的命令均基于此环境。

首先，我们需要在宿主机上安装必要的工具：

sudo apt update sudo apt install qemu-user-static binfmt-support -y

binfmt-support这个包很重要，它帮助系统识别不同架构的可执行文件格式，并自动调用对应的QEMU模拟器来处理。安装完成后，你可以检查一下支持的状态：

ls /proc/sys/fs/binfmt_misc/

应该能看到qemu-aarch64等注册项。

接下来，为我们的定制工作创建一个独立的工作目录，避免弄乱系统文件：

mkdir -p ~/custom_pi_image cd ~/custom_pi_image

2. 获取并挂载Ubuntu-base根文件系统

现在，我们去Ubuntu官方镜像站获取基础材料。选择版本时，需要考虑树莓派的型号和你的需求。对于树莓派3/4/5等64位板卡，建议选择arm64版本；对于更早的树莓派Zero/1/2，则选择armhf版本。这里我们以当前流行的Ubuntu 22.04 Jammy Jellyfish (arm64)为例。

# 下载Ubuntu 22.04 arm64基础根文件系统 wget https://cdimage.ubuntu.com/ubuntu-base/releases/22.04/release/ubuntu-base-22.04-base-arm64.tar.gz # 创建用于解压和后续操作的目录 mkdir rootfs sudo tar -xpf ubuntu-base-22.04-base-arm64.tar.gz -C rootfs/

解压参数说明：

• -x: 解压。
• -p: 保留原文件的权限属性，这对根文件系统至关重要。
• -f: 指定要解压的文件。
• -C: 指定解压目标目录。

解压后，rootfs目录里就是一个最简Linux系统的骨架。但此时我们还无法直接在里面操作，需要把它“挂载”到当前系统，并借助QEMU来“进入”这个ARM环境。关键一步是将QEMU的静态二进制文件拷贝进去：

sudo cp /usr/bin/qemu-aarch64-static rootfs/usr/bin/

这个qemu-aarch64-static文件就是我们的“翻译官”，它会被自动调用以执行ARM指令。

为了让后续在模拟环境内能顺利安装软件，我们需要预先配置两件事：

1. 网络：拷贝宿主机的DNS解析配置，确保模拟环境能解析域名。
2. 软件源：将默认的海外源替换为国内镜像，大幅提升下载速度。

# 拷贝DNS配置 sudo cp /etc/resolv.conf rootfs/etc/ # 备份并修改软件源，这里使用清华源 sudo sed -i 's|http://ports.ubuntu.com|https://mirrors.tuna.tsinghua.edu.cn|g' rootfs/etc/apt/sources.list

为了方便地挂载和卸载必要的系统目录（如/proc,/sys,/dev），我习惯使用一个封装好的脚本。这些目录是Linux内核与用户空间通信的接口，在chroot环境中必须挂载，系统才能正常工作。

创建一个名为ch-mount.sh的脚本：

#!/bin/bash function mnt() { echo "Mounting rootfs from $2" sudo mount -t proc /proc ${2}proc sudo mount -t sysfs /sys ${2}sys sudo mount -o bind /dev ${2}dev sudo mount -o bind /dev/pts ${2}dev/pts sudo chroot ${2} } function umnt() { echo "Unmounting rootfs from $2" sudo umount ${2}dev/pts sudo umount ${2}dev sudo umount ${2}sys sudo umount ${2}proc } if [ "$1" == "-m" ] && [ -n "$2" ]; then mnt $1 $2 elif [ "$1" == "-u" ] && [ -n "$2" ]; then umnt $1 $2 else echo "Usage:" echo " $0 -m <rootfs_path> to mount and chroot" echo " $0 -u <rootfs_path> to unmount" fi

赋予脚本执行权限并运行它，进入我们的定制环境：

sudo chmod +x ch-mount.sh sudo ./ch-mount.sh -m rootfs/

如果一切顺利，你的命令行提示符会发生变化，意味着你已经“身处于”那个ARM架构的Ubuntu-base系统之中了！

3. 在QEMU模拟环境中定制系统

现在，我们就在这个模拟的ARM系统里进行操作了。首先更新软件包列表并安装一些最基础的实用工具和网络组件。

# 在chroot环境中执行 apt update apt install -y sudo vim bash-completion net-tools iputils-ping wget curl

接下来，创建一个日常使用的普通用户，并赋予其sudo权限，这比一直使用root账户更安全。

# 添加用户，如用户名为‘pi’，并设置密码 adduser pi # 将用户pi添加到sudo组 usermod -aG sudo pi

对于物联网或嵌入式设备，我们通常希望系统能自动连接网络。这里安装NetworkManager并配置一个简单的Wi-Fi连接示例（假设使用USB Wi-Fi适配器或树莓派内置Wi-Fi）。

apt install -y network-manager wpasupplicant # 退出chroot环境后，在宿主机上，将预配置的NetworkManager连接文件放入rootfs # 先退出chroot exit # 此时脚本会自动卸载挂载点 # 创建一个Wi-Fi连接配置示例 sudo tee rootfs/etc/NetworkManager/system-connections/MyWiFi.nmconnection > /dev/null <<EOF [connection] id=MyWiFi uuid=$(cat /proc/sys/kernel/random/uuid) type=wifi interface-name=wlan0 [wifi] mode=infrastructure ssid=你的Wi-Fi名称 [wifi-security] key-mgmt=wpa-psk psk=你的Wi-Fi密码 [ipv4] method=auto [ipv6] addr-gen-mode=stable-privacy method=auto EOF # 重新进入chroot环境继续操作 sudo ./ch-mount.sh -m rootfs/

现在，我们来安装图形界面的核心组件。为了保持轻量，我们选择Xorg作为显示服务器，Openbox作为窗口管理器，而不是完整的桌面环境（如GNOME或XFCE）。这种组合在树莓派上运行非常流畅。

apt install -y xorg openbox lightdm xinit

• xorg: X Window系统的基础。
• openbox: 一个极简、高效的窗口管理器。
• lightdm: 一个轻量级的显示管理器，负责图形化登录。你也可以选择不安装，直接通过命令行startx启动。
• xinit: 包含startx命令，用于启动X会话。

安装一些可能需要的字体和基础应用：

apt install -y fonts-dejavu-core pcmanfm lxterminal firefox-esr

pcmanfm是轻量级文件管理器，lxterminal是终端模拟器，firefox-esr是长期支持版的Firefox浏览器。你可以根据实际需要增删软件包。

为了让系统启动后自动进入图形界面，我们需要配置自动登录和自动启动X会话。这里我们配置lightdm自动登录到我们创建的pi用户。

# 退出chroot环境后配置 exit sudo tee rootfs/etc/lightdm/lightdm.conf.d/50-autologin.conf > /dev/null <<EOF [Seat:*] autologin-user=pi autologin-user-timeout=0 EOF

4. 配置图形界面与打包镜像文件

图形界面启动后，我们还需要一个基本的桌面环境配置。为Openbox创建一个简单的菜单和自动启动项。

首先，重新进入chroot环境：

sudo ./ch-mount.sh -m rootfs/

为pi用户创建Openbox的配置目录和基础配置文件：

# 切换到pi用户环境（仍在chroot内） su - pi # 创建Openbox配置目录 mkdir -p ~/.config/openbox # 创建基本的自动启动脚本，例如启动一个终端和设置壁纸（需要先安装feh） cat > ~/.config/openbox/autostart <<EOF # 设置背景色（如果没有壁纸工具） xsetroot -solid "#2E3440" # 启动一个终端 lxterminal & # 启动一个轻量级面板（可选，如tint2） # tint2 & EOF # 创建一个简单的菜单文件 cat > ~/.config/openbox/menu.xml <<EOF <?xml version="1.0" encoding="UTF-8"?> <openbox_menu xmlns="http://openbox.org/3.4/menu"> <menu id="root-menu" label="Applications"> <item label="Terminal"> <action name="Execute"> <command>lxterminal</command> </action> </item> <item label="File Manager"> <action name="Execute"> <command>pcmanfm</command> </action> </item> <item label="Web Browser"> <action name="Execute"> <command>firefox-esr</command> </action> </item> <separator /> <item label="Exit Openbox"> <action name="Exit"> <prompt>yes</prompt> </action> </item> </menu> </openbox_menu> EOF chmod +x ~/.config/openbox/autostart exit # 退出pi用户，回到root

现在，所有定制工作已完成。退出chroot环境并卸载挂载点：

exit # 退出chroot，脚本会自动执行umount # 或者手动执行 # sudo ./ch-mount.sh -u rootfs/

接下来是最激动人心的步骤——将我们精心定制的rootfs目录打包成一个可以直接烧录的磁盘镜像文件。这个过程就像把装修好的房子整体浇筑成一个可移动的模块。

首先，计算一下rootfs目录的实际大小，以便创建大小合适的镜像文件。

sudo du -sh rootfs/

假设显示大小为1.2G，我们留出一些增长空间，创建一个2G的镜像文件。

# 创建一个2GB的全零文件作为镜像容器 dd if=/dev/zero of=custom-ubuntu-pi.img bs=1M count=2048 # 在镜像上创建ext4文件系统，并设置卷标为‘rootfs’ sudo mkfs.ext4 -F -L rootfs custom-ubuntu-pi.img

现在，将这个空的镜像文件挂载到一个临时目录，并把我们定制好的根文件系统全部拷贝进去。

# 创建挂载点 mkdir -p mnt_point # 挂载镜像文件 sudo mount -o loop custom-ubuntu-pi.img mnt_point # 拷贝所有文件，保留权限和属性 sudo cp -a rootfs/* mnt_point/ # 同步数据，确保所有写入完成 sync

拷贝完成后，卸载镜像。然后使用e2fsck检查文件系统完整性，并用resize2fs收缩镜像到最小实际大小，节省存储空间和烧录时间。

sudo umount mnt_point # 强制检查文件系统 sudo e2fsck -p -f custom-ubuntu-pi.img # 将镜像收缩到最小 sudo resize2fs -M custom-ubuntu-pi.img

收缩完成后，你可以再次检查镜像文件的大小：

ls -lh custom-ubuntu-pi.img

现在，custom-ubuntu-pi.img就是最终成品了。你可以使用Raspberry Pi Imager、balenaEtcher或者命令行工具dd将它烧录到SD卡，插入树莓派即可启动。

# 使用dd命令烧录示例（请务必确认of=/dev/sdX是你的SD卡设备，切勿写错！） # sudo dd if=custom-ubuntu-pi.img of=/dev/sdX bs=4M status=progress

第一次启动时，系统可能会自动扩展根分区以填满整个SD卡空间。登录后（已配置自动登录），你应该能看到简洁的Openbox桌面，并且可以打开终端、浏览器等我们预装的应用。

整个流程走下来，虽然步骤不少，但每一步都有其明确的目的。掌握了这套方法，你就拥有了为特定硬件量身打造Linux系统的能力。无论是做产品原型，还是部署专用设备，都能做到游刃有余。我自己的几个树莓派项目，从数字标牌到家庭监控中心，都是用类似的方法构建镜像，省去了大量重复配置的时间。如果你在实践过程中遇到问题，多检查挂载步骤、软件源配置和QEMU静态文件是否正确拷贝，这几个地方最容易出岔子。