Ubuntu?22.04?AArch64?交叉編譯 Docker 鏡像構建指南
作者：?（填寫作者）??
發布日期：?2025?05?26
1?背景與目標
在企業內網（需要代理）環境下，我們需要一套可靠、可復用的 Ubuntu?22.04 交叉編譯鏡像，用于 ARM64 (AArch64) 固件和內核構建。本文檔從零梳理鏡像構建全過程，并總結常見坑點與加固方案，便于團隊后續快速復制實踐。
2?目錄結構
.
├── Dockerfile # 鏡像構建文件
└── sources.list.tuna # 清華 Ubuntu 鏡像源(HTTP/HTTPS 可選)
3?TUNA 源文件（sources.list.tuna）
版本一定要用?
jammy（22.04），勿用?bionic（18.04）！
# 建議使用 HTTP，HTTPS 需先安裝 ca-certificates
deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiverse
deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiverse
deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse
deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverse
如需源碼倉庫或 proposed，請自行取消注釋并添加 deb-src/-proposed。
4?Dockerfile（HTTPS 方案示例）
FROM ubuntu:22.04ENV DEBIAN_FRONTEND=noninteractive \LANG=C.UTF-8# 1?? 先更新官方源，安裝 TLS 根證書
RUN apt-get update && \apt-get install -y --no-install-recommends ca-certificates && \rm -rf /var/lib/apt/lists/*# 2?? 覆蓋為清華鏡像并刷新索引
COPY sources.list.tuna /etc/apt/sources.list
RUN apt-get update# 3?? 安裝交叉工具鏈與常用構建環境（已刪 gcc?multilib / g++?multilib，gpgv 替代 gpgv2）
RUN apt-get install -y --no-install-recommends \build-essential git openssh-client make \gcc-aarch64-linux-gnu g++-aarch64-linux-gnu \cpp-aarch64-linux-gnu binutils-aarch64-linux-gnu \libssl-dev liblz4-tool libgmp-dev libmpc-dev \libexpat1-dev libgucharmap-2-90-dev ncurses-dev \bison flex fakeroot cmake unzip bc \device-tree-compiler patchelf chrpath gawk texinfo diffstat \qemu-user-static binfmt-support live-build \expect lz4 gpgv python-is-python3 python2 \&& apt-get clean && rm -rf /var/lib/apt/lists/*# 4?? 啟用 qemu-aarch64（宿主內核支持時）
RUN update-binfmt --enable qemu-aarch64 || trueCMD ["/bin/bash"]
HTTP 方案：直接把
sources.list.tuna中的https://改為http://，并刪除第一階段安裝ca-certificates的步驟即可。
5?構建與使用
5.1?構建鏡像
# 推薦開啟 BuildKit 提升速度
export DOCKER_BUILDKIT=1docker build -t cross-aarch64:22.04 .
5.2?本地使用示例
# 映射當前源代碼目錄進入容器docker run --rm -it -v "$(pwd)":/workspace cross-aarch64:22.04 bash# 容器中編譯內核示例
cd /workspace/linux-source
export CROSS_COMPILE=aarch64-linux-gnu-
make ARCH=arm64 defconfig
make -j$(nproc) ARCH=arm64
5.3?多平臺構建（可選）
# 推送到私有 Harbor 并同時生成 x86_64/arm64 兩架構鏡像
docker buildx build --platform linux/amd64,linux/arm64 \-t harbor.example.com/base/cross-aarch64:22.04 --push .
6?常見報錯與排查
| 錯誤現象 | 根因 | 解決方案 |
|---|---|---|
Certificate verification failed | 鏡像源為 HTTPS，但鏡像內無 ca-certificates | 先安裝 ca-certificates 或改用 HTTP 源 |
gcc-multilib conflicts with gcc?*-aarch64-linux-gnu | 兩者互斥 | 刪除 multilib 或使用多階段 Dockerfile 分離 |
Package gpgv2 has no installation candidate | 22.04 已廢棄 gpgv2 | 改裝 gpgv 或 gnupg |
TLS handshake timeout | 公司代理或網絡慢 | 在 apt 命令加 -o Acquire::Retries=3 -o Acquire::http::Timeout=30 |
7?最佳實踐
- BuildKit 緩存：在 CI/CD 中使用
--cache-from與共享緩存卷，顯著減少二次構建耗時。 - 鏡像瘦身：如果只需運行環境，使用多階段將產物拷貝到
FROM scratch或alpine。 - 安全：盡量使用非 root 用戶運行編譯腳本；定期用
trivy掃描漏洞。 - 代理：在公司代理環境，需同時配置 Docker daemon 與容器內部
apt代理，避免 407 錯誤。 - 版本鎖：給
Dockerfile固定包版本 (e.g.gcc-aarch64-linux-gnu=11.*) 以保證可重現性。
8?引用與參考
- Tsinghua Tuna 鏡像站說明
- Ubuntu 22.04 Jammy 官方倉庫
- Docker 官方 BuildKit 文檔
- GNU Arm Embedded Toolchain (Ubuntu cross packages)
版權聲明：本文檔為原創，遵循?CC?BY?SA?4.0?協議；轉載請注明出處。
