4. Busybox入门

做嵌入式构建，最让人头疼的是什么？我个人觉得，不是配置写错了，也不是代码编译不过，而是——等下载。

你想想看，一个干净的 Buildroot 环境，第一次编译，光下载源码包就得花半小时甚至更久。要是网络再不稳定，断断续续的，那真是折磨。我早期做项目时，就遇到过因为下载超时导致 CI 构建失败的情况，排查了半天，最后发现是某个 tarball 没拉下来。

所以这一章，咱们就专门聊聊怎么把下载这件事搞定。说白了，就是三个方向：本地缓存、镜像源、离线构建。这三板斧用好了，你的构建速度能提升 50% 以上。

4.1 配置本地下载缓存

Buildroot 本身支持一个叫 BR2_DL_DIR 的变量。这个变量指定了一个目录，用来存放所有下载的源码包、补丁、固件等。默认情况下，它指向 dl/ 目录（就在你的 Buildroot 源码根目录下）。

但问题来了：如果你同时维护多个项目，每个项目都各自下载一遍，那磁盘空间和带宽就白白浪费了。我习惯的做法是，在系统上设置一个共享的下载缓存目录。

4.1.1 设置全局 DL_DIR

最简单的方式，是在 ~/.bashrc 或 /etc/profile 里加一行环境变量：

export BR2_DL_DIR=/opt/buildroot_dl_cache

然后记得创建这个目录：

mkdir -p /opt/buildroot_dl_cache

这样，所有使用这个用户或系统的 Buildroot 项目，都会共用同一个下载缓存。第一次下载慢，第二次就秒过了。

4.1.2 在 .config 中指定

如果你不想改全局环境变量，也可以在项目的 .config 文件里直接指定：

BR2_DL_DIR="/opt/buildroot_dl_cache"

不过我个人更推荐用环境变量的方式，因为这样更灵活，切换项目时不用改配置。

4.1.3 缓存目录的结构

Buildroot 在 DL_DIR 里存放的文件，命名规则是 包名-版本.tar.gz 之类的。你打开看看，会发现里面既有源码包，也有 Buildroot 自己生成的 .hash 文件。这些 hash 文件用来校验下载完整性，别手欠删了。

文件类型	示例	说明
源码包	busybox-1.36.1.tar.bz2	上游原始 tarball
补丁文件	0001-fix-build.patch	Buildroot 维护的补丁
Hash 文件	busybox-1.36.1.tar.bz2.hash	校验和，防止下载被篡改

4.2 使用镜像源加速

有些时候，即便有本地缓存，第一次下载还是得从外网拉。这时候镜像源就派上用场了。

Buildroot 支持通过 BR2_BACKUP_SITE 和 BR2_PRIMARY_SITE 来指定下载源。默认情况下，它会从每个包自己的官方地址下载。但我们可以让它优先走镜像。

4.2.1 配置主下载站点

在 .config 里加上：

BR2_PRIMARY_SITE="https://mirrors.ustc.edu.cn/buildroot/"
BR2_BACKUP_SITE="https://mirrors.tuna.tsinghua.edu.cn/buildroot/"

这样，Buildroot 会先尝试从主站点下载，如果失败，再尝试备用站点。这两个是国内比较快的镜像，我一直在用。

4.2.2 使用 local mirror

如果你在公司内部搭建了完整的源码镜像服务器（比如用 apt-mirror 或 nginx 自建），可以把 BR2_PRIMARY_SITE 指向内网地址：

BR2_PRIMARY_SITE="http://192.168.1.100/buildroot/"

这样下载速度直接拉满到千兆局域网水平。我在之前的公司就是这么干的，整个研发团队几十号人，构建速度提升非常明显。

4.3 离线构建方案

有些场景下，目标机器压根不能联网。比如军工、医疗、工业控制等领域。这时候就需要完全离线构建。

离线构建的核心，就是提前把所有需要的源码包准备好，放到 DL_DIR 里。然后构建时断网运行。

4.3.1 生成源码包清单

首先，你需要知道你的项目依赖哪些包。Buildroot 提供了一个好用的命令：

make source

这个命令会下载所有需要的源码包到 DL_DIR，但不会编译。你可以先在有网的机器上跑一遍 make source，然后把 DL_DIR 整个目录打包，拷贝到离线机器上。

4.3.2 制作离线构建包

我一般会写一个脚本，把 DL_DIR 和 Buildroot 源码目录一起打包：

#!/bin/bash
# 打包离线构建环境
tar czf offline_buildroot.tar.gz \
  /opt/buildroot_dl_cache \
  /home/user/buildroot \
  /home/user/output

到了离线机器上，解压后设置 BR2_DL_DIR 指向缓存目录，然后直接 make 就行。只要缓存里有所有包，构建过程就不会去联网。

4.3.3 验证离线完整性

Buildroot 在下载完成后会校验 hash。如果某个包缺失或损坏，构建会报错。你可以手动检查：

make source-check

这个命令会检查 DL_DIR 里是否所有需要的包都存在且 hash 正确。如果输出没有错误，说明离线环境是完整的。

4.4 整体流程梳理

说了这么多，咱们用一张图把整个下载加速的逻辑串起来：

4.5 常见问题与避坑

• 缓存目录权限问题：如果多个用户共享 BR2_DL_DIR，记得设置好写权限。我遇到过因为 umask 导致其他用户无法读取缓存的情况。
• 镜像源不完整：有些镜像只同步了部分包。建议先用 make source 测试一下，看看有没有 404 错误。
• 离线包版本不一致：如果你在开发机上用的是 Buildroot 2024.02，离线机器上也得是同一个版本。否则包的 hash 可能对不上。
• 磁盘空间：DL_DIR 会随着项目增多越来越大。我一般每个月清理一次，用 make clean-dl 删除未使用的包。