BusyBox嵌入式Linux的瑞士军刀——从原理剖析到根文件系统实战大家好我是黒漂技术佬。今天聊一个在服务器上默默无闻、但在嵌入式设备里无处不在的神器——BusyBox。如果你做过路由器、安卓手机、物联网网关、树莓派甚至智能电表那你大概率已经和它打过交道——只是你未必知道。你敲的ls、ps、mount在绝大多数嵌入式 Linux 系统里背后其实都是同一个程序BusyBox。这篇文章会把它扒个底朝天从一个为什么 1MB 能装下 300 个命令的好奇心出发讲透它的实现原理这部分是面试和装逼双料素材再到亲手交叉编译、用 BusyBox 从零搭一个能跑起来的最小根文件系统——这是我做智慧农业网关时真实走过的路坑都帮你踩完了。一、BusyBox 是什么一句话BusyBox 是把几百个常用 Unix 命令打 包进一个可执行文件里的瑞士军刀。先看一组对比感受一下它存在的意义组件标准 GNU 工具集BusyBoxls、cp、mv等 coreutils每个一个独立二进制全部集成grep、sed、awk等独立安装全部集成shellbash/ash几 MB集成ashvi编辑器独立安装集成体积缩减版init、udhcpc、telnet各自独立集成总体积数百 MB约 1~2 MB静态编译数 MB 对服务器来说不算什么但你要是拿着一个 8MB Nor Flash、内存只有 32MB 的 STM32MP1 或者 RT510都是我实际项目里用过的板子做产品每一 KB 都是真金白银。这时候 GNU 全家桶就是奢侈品BusyBox 才是口粮。BusyBox 的项目历史也挺有意思1996 年由 Bruce Perens 发起最初是为了给 Debian 的安装盘做一个迷你环境——安装盘空间有限塞不下完整系统那就把所有工具压进一个二进制。后来 Eric Andersen 接手维护逐渐成为嵌入式 Linux 的事实标准。今天你能在 OpenWrt、buildroot、Yocto、安卓的 recovery 模式、几乎所有的 Linux initramfs 里找到它。它还有一个官方梗项目吉祥物是一只名叫BusyBox 的鸭子……好吧是商标注册时随手选的但社区里大家都叫它瑞士军刀The Swiss Army Knife of Embedded Linux这个称号名副其实。二、核心原理一个二进制怎么变成 300 个命令这是全文最值得细读的部分。很多人用了很多年 BusyBox都没搞明白下面这个现象# 在嵌入式设备上执行ls--help# 输出显示这是 BusyBox v1.36.1 的 lscat/bin/ls /bin/cat /bin/ps2/dev/null|md5sum# 三个不同命令竟然是同一个文件内容的哈希真相/bin/ls、/bin/cat、/bin/ps是三个软链接symlink全部指向/bin/busybox这一个二进制ls-l/bin/ls /bin/cat /bin/ps# lrwxrwxrwx 1 root root 7 Jan 1 2026 /bin/cat - busybox# lrwxrwxrwx 1 root root 7 Jan 1 2026 /bin/ls - busybox# lrwxrwxrwx 1 root root 7 Jan 1 2026 /bin/ps - busybox2.1 argv[0] 多路复用程序界的一人分饰三百角BusyBox 的核心机制叫multi-call binary多路复用二进制。原理简单到令人发指intmain(intargc,char*argv[]){// argv[0] 是程序被调用时的名字// 链接名为 ls → argv[0] ls → 执行 ls 的逻辑// 链接名为 cat → argv[0] cat → 执行 cat 的逻辑busybox_main(argc,argv);}在 BusyBox 内部每个命令官方术语叫applet注册在一个表里// BusyBox 源码中每个 applet 的注册方式简化示意// ls 的实现文件 coreutils/ls.c// applet 宏会在编译时生成一张全局表conststructbb_appletapplets[]{{ls,ls_main,...},{cat,cat_main,...},{mount,mount_main,...},{ps,ps_main,...},// ... 300 多个};busybox_main()拿到argv[0]之后把路径剥掉只留程序名/bin/ls→ls去这张表里查查到谁就调用谁的入口函数。所以三种等价的调用方式ls-l/tmp# 方式1通过软链接调用argv[0] lsbusyboxls-l/tmp# 方式2显式传 applet 名作为第一个参数busyboxls-l/tmp# 方式3busybox 自己也常给自己做个叫 busybox 的链接方式 2 在调试时特别有用——后面讲。2.2 这样设计到底省了多少关键不只是把 300 个命令编进一个文件而是共享了所有公共代码一份 libc 调用代码错误处理、参数解析、字符串处理所有 applet 共用一套工具函数BusyBox 源码里的libbb/目录就是干这个的。一份 ELF 开销每个 ELF 二进制都有文件头、段对齐的填充、动态链接信息单个 GNU 命令动辄几十 KB其中大半是包装纸。合体之后只需要一份包装纸。代码级裁剪BusyBox 每个 applet 都为了体积做了魔改——它的grep不支持 GNU grep 的全部花活但 90% 的常用功能都在体积只有十分之一。实际数据ARM Cortex-A53静态编译仅供参考量级busybox全功能 ≈ 1.0 ~ 1.2 MB busybox裁剪后 ≈ 300 ~ 600 KB GNU coreutils 完整套件 ≈ 15 MB还是动态链接运行时还要 libc这就是为什么老工程师会说嵌入式领域Flash 是按 MB 收租的BusyBox 是包租婆眼里的模范租客。2.3 那为什么 PC 服务器不用 BusyBox好问题。省体积是优点但代价也明确功能缩水BusyBox 的 applet 是够用版而非完整版。比如它的find支持的参数比 GNU findutils 少一大截awk不是 gawkBusyBox 用的是改进版 awf/awx 之外的一个精简 awk 实现gawk 脚本不一定能跑。性能非优先它的目标是小不是快。某些实现路径比 GNU 版本简单粗暴。生态兼容性生产环境里的脚本可能依赖 GNU 工具的行为细节比如sed的某些扩展语法、cp -a的语义差异换 BusyBox 可能踩坑。所以策略很清晰磁盘富裕的地方用 GNU 全家桶磁盘紧张的地方用 BusyBox。两者并不对立——很多系统混合部署核心命令用 GNU长尾命令交给 BusyBox。三、动手实战一在 x86 上把玩 BusyBox先别急着上 ARM 板在你自己的 Linux或 WSL上 5 分钟就能体验。3.1 安装与快速体验# Ubuntu/Debiansudoaptinstallbusybox# 看看它肚子里有多少 appletbusybox|head-20# BusyBox v1.36.1 (Ubuntu ...) multi-call binary.# Usage: busybox [function [arguments]...]# or: busybox --list# ...# Currently defined functions:# [, [[, acpid, addgroup, adduser, adjtimex, ar, arch, arp, arping, ...busybox--list|wc-l# 300 个busybox --list列出所有编译进来的 applet这是后面排查命令为什么没有的第一手段。3.2 一个 applet 都不认识你时applet not found新手最常撞见的报错$ ./busybox xyz xyz: applet not found两种可能拼写错了或者这个 applet 在编译时被裁剪掉了。用busybox --list验证。这个报错在交叉编译场景下还有个著名的坑——后面第五节讲那个坑能让老手都翻车。3.3 把 BusyBox 当急救包静态编译版BusyBox 官方提供静态链接的二进制不依赖系统 libc。这玩意儿是个系统救援神器系统 glibc 损坏、动态链接器挂了普通命令全部罢工时静态的 busybox 还能跑chroot 进一个几乎没有东西的环境时复制一个 busybox 进去立刻拥有全套基础工具。# 下载官方静态版wgethttps://busybox.net/downloads/binaries/1.36.1-uclibc/busybox-i686chmodx busybox-i686 ./busybox-i686sh# 进入 busybox 的 ash shell试试 ls、ps、vi —— 全都能用把一个静态 busybox 扔到 U 盘里随身带着是很多运维老炮的习惯。这玩意救过我的服务器——glibc 升级失败导致所有动态链接命令全灭最后靠 U 盘里的 busybox 把系统救了回来。四、动手实战二交叉编译 BusyBox 到 ARM进入正题。目标场景一块瑞芯微 RV1106或者任何 ARM Cortex-A 板子我们要给它编译 BusyBox。4.1 准备交叉工具链假设工具链已解压在/opt/toolchain/不同芯片厂商 SDK 自带的工具链均可比如arm-linux-gnueabihf-exportPATH/opt/toolchain/bin:$PATHarm-linux-gnueabihf-gcc--version# 能打印版本号就 OK4.2 获取源码并配置wgethttps://busybox.net/downloads/busybox-1.36.1.tar.bz2tarxjf busybox-1.36.1.tar.bz2cdbusybox-1.36.1makedistcleanmakedefconfigmake defconfig启用一组通用默认配置——几乎所有常用 applet 全开。对第一次玩的人最友好先跑通再谈裁剪。然后打开菜单做两处关键修改makemenuconfig第一处指定交叉编译器和架构Settings --- (arm-linux-gnueabihf-) Cross compiler prefix (*) Build static binary (no shared libs) ← 关键勾上为什么强烈建议静态编译动态编译的 busybox 依赖目标板上的动态库libc.so 等。如果你自制最小根文件系统时忘了放库文件启动时 shell 都起不来报一个令人窒息的错误/bin/sh: cant load library libc.so.6 # 然后 kernel panic卡死迎接寂静静态编译把 libc 直接编进二进制体积大几百 KB但到处能跑——对自制 rootfs 阶段来说是巨大的减负。第二处可选裁剪不需要的 appletLinux Module Utilities --- # 不用 insmod 的话整组关掉 Networking Utilities --- # telnetd/tftp 按需保留 Shells --- Choose your shell (ash) # 保持 ash别选成 none4.3 编译与安装make-j8makeCONFIG_PREFIX/home/hanxi/rootfsinstallmake install会把 busybox 装到CONFIG_PREFIX指定的目录并且自动创建所有 applet 的软链接cd/home/hanxi/rootfslsbin/|head# arch awk base32 base64 basename busybox cat ...ls-lbin/ls# bin/ls - busybox软链接的组织方式默认有三种风格--install时的-s/-l/-l之外的差异默认是把大多数链接放在/bin少数在/sbin、/usr/bin。对嵌入式足够了不用纠结。看看成果ls-lrootfs/bin/busybox# -rwxr-xr-x 1 hanxi hanxi 1015480 ... busybox ← 1MB 出头全家桶到手五、动手实战三从零搭一个能启动的最小根文件系统这是本篇的高潮。我们要用 BusyBox 造一个麻雀虽小五脏俱全的 rootfs并用 QEMU 验证它能跑——没有开发板也能完整走完这个流程这是我推荐所有嵌入式新手必做的实验。5.1 rootfs 还缺什么make install只给了我们/bin、/sbin、/usr下的命令。一个能被内核挂载的根文件系统还缺这些骨架目录和设备节点cd/home/hanxi/rootfs# 骨架目录mkdir-pdev etc proc sys tmp root lib# 两个生死攸关的设备节点内核挂载 rootfs 后要用的sudomknod-m666dev/null c13sudomknod-m666dev/console c51/dev/null和/dev/console这两个节点没有的话内核启动到挂载 rootfs 阶段直接 panic。经典翻车现场Warning: unable to open an initial console. Kernel panic - not syncing: no init found新手看到no init found一脸懵其实多半是 console 节点缺失或者 init 路径不对。5.2 配置 etcinit 是内核点的第一把火内核启动的最后一步是执行第一个用户态程序由内核启动参数rdinit或init指定默认找/sbin/init。BusyBox 的/sbin/init会读取/etc/inittab来决定接下来干什么。BusyBox init 语法和经典 SysVinit 一脉相承但更精简# /etc/inittab# id:runlevels:action:process::sysinit:/etc/init.d/rcS# 系统初始化最先执行等它跑完才继续::respawn:-/bin/sh# 在控制台上启动交互 shell前面加 - 表示登录 shell::restart:/sbin/init# init 重启时执行::ctrlaltdel:/sbin/reboot# CtrlAltDel 重启::shutdown:/bin/umount-a-r# 关机时卸载所有挂载点respawn的含义进程退出后自动重启。所以你exit退出 shell它马上又给你拉一个新的——这就是为什么嵌入式设备串口里 shell “打不死”。然后写rcS系统初始化脚本mkdir-petc/init.dcatetc/init.d/rcSEOF #!/bin/sh # 挂载虚拟文件系统——没有它们 ps/free/lsmod 都是瞎的 mount -t proc none /proc mount -t sysfs none /sys mount -t devtmpfs none /dev 2/dev/null || mdev -s # 设置主机名串口里看着体面点 hostname mini-box echo echo BusyBox mini rootfs is alive! echo EOFchmodx etc/init.d/rcS这里有个知识点要展开/proc、/sys、/dev为什么必须挂/proc内核状态的用户态窗口。ps列进程、cat /proc/cpuinfo、cat /proc/meminfo全靠它/sys设备模型树后面加载驱动、看温度传感器的值都要用/dev设备节点。内核开了CONFIG_DEVTMPFS就自动填充推荐没开就得靠 BusyBox 的mdev -s扫描/sys生成设备节点。mdev是嵌入式里的 udev 替代品轻量级热插拔管理配合/etc/mdev.conf还能在 U 盘插入时自动执行脚本——做无人售货柜自动挂载存储卡时我就用它。5.3 打包成 initramfs 并用 QEMU 启动最省事的验证方式是 initramfs把 rootfs 打包进内核镜像内核启动时展开到内存里cd/home/hanxi/rootfsfind.|cpio-o-Hnewc|gzip../rootfs.cpio.gz再配一个 QEMU 能跑的 ARM 内核Debian/Ubuntu 有linux-image-*-armmp包或用 buildroot 编译启动qemu-system-arm\-Mvexpress-a9\-kernelzImage\-initrdrootfs.cpio.gz\-appendconsolettyAMA0 rdinit/sbin/init\-nographic串口输出节选[ 0.000000] Booting Linux on physical CPU 0x0 ... [ 3.10] VFS: Mounted root (initramfs filesystem) on device 0:12 Run /sbin/init as init process BusyBox mini rootfs is alive! / # ps PID USER TIME COMMAND 1 root 0:00 init 2 root 0:00 [kthreadd] ... / # busybox | head -3 BusyBox v1.36.1 multi-call binary.恭喜一个约 1.5MBbusybox 内核镜像另算的完整 Linux 用户空间跑起来了。在这个 shell 里ls、vi、ifconfig、top……三百个命令任你调遣。5.4 迁移到真实开发板QEMU 验证通过后上真板只差两步rootfs 烧到存储介质Nor/Nand/eMMC 分区后格式化如 ext4/SquashFS把 rootfs 目录内容拷进去内核启动参数改成root/dev/mmcblk0p2 rootfstypeext4 init/sbin/init改动态编译可选产品定型后如果内存 Flash 依然紧张就保持静态若 rootfs 里已有 libc比如之后要跑自己的 C 程序可以改动态编译省几百 KB——注意把工具链的libc.so.6、ld-linux-armhf.so.3一并放进/lib。第 2 步就是传说中的 “libc 忘拷” 翻车点报错见 4.2 节。别问我为什么记得这么清楚。六、实战中的 BusyBox 高频技巧以下是我多年嵌入式项目里沉淀的 BusyBox 使用心得每一条都值一顿烧烤。6.1 串口调试一个busybox顶一个工具箱板子上没有 gdb、没有 strace、甚至没有ls完整参数时# 系统还活着吗内存剩多少free# 哪个进程在吃 CPUtop-b-n1|head-15# 网卡状态udhcpc 是 busybox 自带的 dhcp 客户端ifconfigeth0 udhcpc-ieth0# 看内核打印没接串口日志时兜底dmesg|tail-20# 起个 http 服务器从 PC 拉文件到板子调试神器busybox httpd-f-p8000-h/tmp最后这个 httpd 值得单独说你在 PC 浏览器访问http://板子IP:8000就能浏览/下载板子/tmp下的文件。反向的传输用busybox wget或者tftp。不装任何额外工具文件就进出板子了现场调试效率翻倍。6.2ash脚本注意和 bash 的差异BusyBox 默认 shell 是ashAlmquist Shell语法接近 POSIX sh但和 bash 有几个差异脚本移植时最容易踩# 1. bash 特有的 [[ ]] 双括号ash 不支持[[$xy]]# bash ✓ ash ✗[$xy]# 两边都 OK注意 而不是 POSIX 惯例# 2. 数组ash 没有arr(a b c)# bash ✓ ash ✗ —— 直接报语法错误# 3. 本地变量localx1# ash 的 local 只能在函数内用行为一致没事# 4. 算术$((12))# 两边都支持放心用# 5. source 关键字source/etc/profile# bash ✓./etc/profile# 两边都 OK推荐用点号经验法则给板子写的脚本按 POSIX sh 写别写 bash 方言同时注意 shebang 用#!/bin/sh。脚本开头别用#!/bin/bash——busybox rootfs 里根本没有 bash等着你的只有not found。6.3 mdevU 盘/TF 卡自动挂载无人售货柜项目里运维要在现场插 U 盘导出日志。做法# /etc/mdev.confsd[a-z][0-9]0:0660/etc/hotplug/udisk_insert.sh mmcblk[0-9]p[0-9]0:0660/etc/hotplug/udisk_insert.sh配合内核热插拔echo /sbin/mdev /proc/sys/kernel/hotplug插入 U 盘时 mdev 自动执行后面的脚本在脚本里mount并触发日志同步。轻量、无依赖比移植完整 udev 省心太多。6.4 裁剪按需定制你的军刀产品量产前建议做一轮正式裁剪。思路不是关得越多越好而是对照你设备实际要跑的东西关掉的典型项 - 调试类strace 需要单独移植telnet/telnetd 量产必关安全 - 不用的文件系统工具mkfs.ext2 若没有 ext2 就关 - 打印/邮件类lpr、sendmail 基本必关 必须确认保留的 - init、ash、mount/umount、mdev、ps、sh 系列 - 你 rcS 和业务脚本里用到的每一个命令裁剪完的验证方法很朴素把 rootfs 部署后把 rcS 和所有业务脚本从头跑一遍。--list和脚本里用到的命令做交叉检查# 在 PC 上检查脚本用到的命令是否都被 busybox 支持forcmdinmountpsgrepawksedcuttrfind;dobusybox--list|grep-qx$cmdechoOK$cmd||echoMISS$cmddone量产版裁到 500KB 以内是常见成绩。6.5 安全提醒busybox telnetd 是无密码后门必须单独强调一条安全纪律呼应安全系列文章的老规矩量产固件里telnetd、httpd、ftpd这些 BusyBox 网络服务要么关闭要么加认证。BusyBox 的 telnetd 直接派生登录 shell没有像 OpenSSH 那样的密钥体系httpd 的 Basic Auth 也只是明文 base64。历史上大量 IoT 设备被入侵入口就是出厂默认开启的 busybox telnetd。智慧农业网关那批设备我们的做法是量产配置直接裁掉 telnetd调试口只留物理串口。七、原理补完BusyBox 与 systemd 时代的相处之道有读者可能要问现在 PC 上都是 systemd 一统天下BusyBox 的 init 还有什么用答案两者不在一个生态位。维度BusyBox initsystemd体积几 KB十几 MB连依赖启动速度极快一个 rcS 脚本了事中规中矩有优化手段依赖无不依赖 dbus/journald 等一整套用户态组件服务管理inittab 手写脚本声明式 unit依赖管理强大适用场景嵌入式、initramfs、容器通用发行版有个概念新人常混淆initramfs 里的 init 和系统正式的 init 是两回事。哪怕你的目标系统用 systemd内核启动初期的 initramfs解锁加密分区、加载驱动的那段里跑的 init 也十有八九是 BusyBox 的——干完活再switch_root切到真正的系统。Ubuntu、Debian 的 initramfs 全是这么干的。你可以在 initramfs 的 emergency shell 里执行busybox --list亲自验证。另外容器场景里 BusyBox 也活得很好——docker pull busybox只有 4MB 出头是很多 CI 流水线里我就是想执行几个 shell 命令场景的最省镜像。虽然现在 alpine同样基于 BusyBox 的 musl 系发行版更流行但 BusyBox 镜像依然是最小可用的标杆。八、常见报错速查表把我这些年遇到的 BusyBox 相关问题做成表建议直接收藏报错/现象原因解决xxx: applet not found命令被裁剪/拼写错busybox --list核对busybox xxx显式调用Kernel panic - not syncing: no init foundrootfs 无/sbin/init或 rcS 配置错检查 init 路径、inittab、执行权限cant load library libc.so.6动态编译但 rootfs 缺 libc拷工具链 libc 到/lib或改静态编译shell 一闪就重启respawn 循环/bin/sh链接损坏或 inittab respawn 了必退出的程序修软链接respawn 指向真正的交互 shellps只显示两三个进程没挂/procrcS 里加mount -t proc none /procmdev 不生成设备节点内核没配 devtmpfs 且没设 hotplugmdev -secho /sbin/mdev /proc/sys/kernel/hotplug交叉编译报testsuite错误在 x86 上跑了给 ARM 的编译测试make CONFIG_PREFIX... install跳过测试即可或加CROSS_COMPILE前缀确认无误applet 链接颜色异常/行为怪文件系统不支持符号链接如 FATrootfs 用 ext4/squashfs别用 FAT九、总结最后收个尾这篇的信息密度确实不小帮你把主线拎出来BusyBox 是单二进制多路复用300 个 applet 打包进一个可执行文件靠argv[0]分发到不同的入口函数——这是它体积奇迹的全部秘密软链接是它的躯干/bin/ls - busybox这套结构让一个二进制长出了整个命令体系交叉编译三板斧make defconfig→menuconfig里设工具链前缀 静态编译 →make install得到带全套软链接的 rootfs 雏形最小根文件系统四件套骨架目录、dev/null和dev/console节点、etc/inittab、etc/init.d/rcS挂 proc/sys/dev——齐活就能启动量产前裁剪 安全加固按业务实际用到的命令裁网络服务类 applettelnetd/httpd默认关闭。从 Bruce Perens 当年为 Debian 安装盘写的那个小工具集合到今天跑在全球数十亿设备里的嵌入式基石BusyBox 用 30 年时间证明了一件事在工程世界里小而克制是可以穿越技术周期的。对做嵌入式的朋友我的建议始终是哪怕你用的是 buildroot/Yocto 这类一键出镜像的框架也要亲手用 BusyBox 从零搭一次 rootfs。框架帮你屏蔽的细节恰恰是你排障时的底气。我是黒漂技术佬咱们下篇见。
BusyBox：嵌入式Linux的瑞士军刀——从原理剖析到根文件系统实战
BusyBox嵌入式Linux的瑞士军刀——从原理剖析到根文件系统实战大家好我是黒漂技术佬。今天聊一个在服务器上默默无闻、但在嵌入式设备里无处不在的神器——BusyBox。如果你做过路由器、安卓手机、物联网网关、树莓派甚至智能电表那你大概率已经和它打过交道——只是你未必知道。你敲的ls、ps、mount在绝大多数嵌入式 Linux 系统里背后其实都是同一个程序BusyBox。这篇文章会把它扒个底朝天从一个为什么 1MB 能装下 300 个命令的好奇心出发讲透它的实现原理这部分是面试和装逼双料素材再到亲手交叉编译、用 BusyBox 从零搭一个能跑起来的最小根文件系统——这是我做智慧农业网关时真实走过的路坑都帮你踩完了。一、BusyBox 是什么一句话BusyBox 是把几百个常用 Unix 命令打 包进一个可执行文件里的瑞士军刀。先看一组对比感受一下它存在的意义组件标准 GNU 工具集BusyBoxls、cp、mv等 coreutils每个一个独立二进制全部集成grep、sed、awk等独立安装全部集成shellbash/ash几 MB集成ashvi编辑器独立安装集成体积缩减版init、udhcpc、telnet各自独立集成总体积数百 MB约 1~2 MB静态编译数 MB 对服务器来说不算什么但你要是拿着一个 8MB Nor Flash、内存只有 32MB 的 STM32MP1 或者 RT510都是我实际项目里用过的板子做产品每一 KB 都是真金白银。这时候 GNU 全家桶就是奢侈品BusyBox 才是口粮。BusyBox 的项目历史也挺有意思1996 年由 Bruce Perens 发起最初是为了给 Debian 的安装盘做一个迷你环境——安装盘空间有限塞不下完整系统那就把所有工具压进一个二进制。后来 Eric Andersen 接手维护逐渐成为嵌入式 Linux 的事实标准。今天你能在 OpenWrt、buildroot、Yocto、安卓的 recovery 模式、几乎所有的 Linux initramfs 里找到它。它还有一个官方梗项目吉祥物是一只名叫BusyBox 的鸭子……好吧是商标注册时随手选的但社区里大家都叫它瑞士军刀The Swiss Army Knife of Embedded Linux这个称号名副其实。二、核心原理一个二进制怎么变成 300 个命令这是全文最值得细读的部分。很多人用了很多年 BusyBox都没搞明白下面这个现象# 在嵌入式设备上执行ls--help# 输出显示这是 BusyBox v1.36.1 的 lscat/bin/ls /bin/cat /bin/ps2/dev/null|md5sum# 三个不同命令竟然是同一个文件内容的哈希真相/bin/ls、/bin/cat、/bin/ps是三个软链接symlink全部指向/bin/busybox这一个二进制ls-l/bin/ls /bin/cat /bin/ps# lrwxrwxrwx 1 root root 7 Jan 1 2026 /bin/cat - busybox# lrwxrwxrwx 1 root root 7 Jan 1 2026 /bin/ls - busybox# lrwxrwxrwx 1 root root 7 Jan 1 2026 /bin/ps - busybox2.1 argv[0] 多路复用程序界的一人分饰三百角BusyBox 的核心机制叫multi-call binary多路复用二进制。原理简单到令人发指intmain(intargc,char*argv[]){// argv[0] 是程序被调用时的名字// 链接名为 ls → argv[0] ls → 执行 ls 的逻辑// 链接名为 cat → argv[0] cat → 执行 cat 的逻辑busybox_main(argc,argv);}在 BusyBox 内部每个命令官方术语叫applet注册在一个表里// BusyBox 源码中每个 applet 的注册方式简化示意// ls 的实现文件 coreutils/ls.c// applet 宏会在编译时生成一张全局表conststructbb_appletapplets[]{{ls,ls_main,...},{cat,cat_main,...},{mount,mount_main,...},{ps,ps_main,...},// ... 300 多个};busybox_main()拿到argv[0]之后把路径剥掉只留程序名/bin/ls→ls去这张表里查查到谁就调用谁的入口函数。所以三种等价的调用方式ls-l/tmp# 方式1通过软链接调用argv[0] lsbusyboxls-l/tmp# 方式2显式传 applet 名作为第一个参数busyboxls-l/tmp# 方式3busybox 自己也常给自己做个叫 busybox 的链接方式 2 在调试时特别有用——后面讲。2.2 这样设计到底省了多少关键不只是把 300 个命令编进一个文件而是共享了所有公共代码一份 libc 调用代码错误处理、参数解析、字符串处理所有 applet 共用一套工具函数BusyBox 源码里的libbb/目录就是干这个的。一份 ELF 开销每个 ELF 二进制都有文件头、段对齐的填充、动态链接信息单个 GNU 命令动辄几十 KB其中大半是包装纸。合体之后只需要一份包装纸。代码级裁剪BusyBox 每个 applet 都为了体积做了魔改——它的grep不支持 GNU grep 的全部花活但 90% 的常用功能都在体积只有十分之一。实际数据ARM Cortex-A53静态编译仅供参考量级busybox全功能 ≈ 1.0 ~ 1.2 MB busybox裁剪后 ≈ 300 ~ 600 KB GNU coreutils 完整套件 ≈ 15 MB还是动态链接运行时还要 libc这就是为什么老工程师会说嵌入式领域Flash 是按 MB 收租的BusyBox 是包租婆眼里的模范租客。2.3 那为什么 PC 服务器不用 BusyBox好问题。省体积是优点但代价也明确功能缩水BusyBox 的 applet 是够用版而非完整版。比如它的find支持的参数比 GNU findutils 少一大截awk不是 gawkBusyBox 用的是改进版 awf/awx 之外的一个精简 awk 实现gawk 脚本不一定能跑。性能非优先它的目标是小不是快。某些实现路径比 GNU 版本简单粗暴。生态兼容性生产环境里的脚本可能依赖 GNU 工具的行为细节比如sed的某些扩展语法、cp -a的语义差异换 BusyBox 可能踩坑。所以策略很清晰磁盘富裕的地方用 GNU 全家桶磁盘紧张的地方用 BusyBox。两者并不对立——很多系统混合部署核心命令用 GNU长尾命令交给 BusyBox。三、动手实战一在 x86 上把玩 BusyBox先别急着上 ARM 板在你自己的 Linux或 WSL上 5 分钟就能体验。3.1 安装与快速体验# Ubuntu/Debiansudoaptinstallbusybox# 看看它肚子里有多少 appletbusybox|head-20# BusyBox v1.36.1 (Ubuntu ...) multi-call binary.# Usage: busybox [function [arguments]...]# or: busybox --list# ...# Currently defined functions:# [, [[, acpid, addgroup, adduser, adjtimex, ar, arch, arp, arping, ...busybox--list|wc-l# 300 个busybox --list列出所有编译进来的 applet这是后面排查命令为什么没有的第一手段。3.2 一个 applet 都不认识你时applet not found新手最常撞见的报错$ ./busybox xyz xyz: applet not found两种可能拼写错了或者这个 applet 在编译时被裁剪掉了。用busybox --list验证。这个报错在交叉编译场景下还有个著名的坑——后面第五节讲那个坑能让老手都翻车。3.3 把 BusyBox 当急救包静态编译版BusyBox 官方提供静态链接的二进制不依赖系统 libc。这玩意儿是个系统救援神器系统 glibc 损坏、动态链接器挂了普通命令全部罢工时静态的 busybox 还能跑chroot 进一个几乎没有东西的环境时复制一个 busybox 进去立刻拥有全套基础工具。# 下载官方静态版wgethttps://busybox.net/downloads/binaries/1.36.1-uclibc/busybox-i686chmodx busybox-i686 ./busybox-i686sh# 进入 busybox 的 ash shell试试 ls、ps、vi —— 全都能用把一个静态 busybox 扔到 U 盘里随身带着是很多运维老炮的习惯。这玩意救过我的服务器——glibc 升级失败导致所有动态链接命令全灭最后靠 U 盘里的 busybox 把系统救了回来。四、动手实战二交叉编译 BusyBox 到 ARM进入正题。目标场景一块瑞芯微 RV1106或者任何 ARM Cortex-A 板子我们要给它编译 BusyBox。4.1 准备交叉工具链假设工具链已解压在/opt/toolchain/不同芯片厂商 SDK 自带的工具链均可比如arm-linux-gnueabihf-exportPATH/opt/toolchain/bin:$PATHarm-linux-gnueabihf-gcc--version# 能打印版本号就 OK4.2 获取源码并配置wgethttps://busybox.net/downloads/busybox-1.36.1.tar.bz2tarxjf busybox-1.36.1.tar.bz2cdbusybox-1.36.1makedistcleanmakedefconfigmake defconfig启用一组通用默认配置——几乎所有常用 applet 全开。对第一次玩的人最友好先跑通再谈裁剪。然后打开菜单做两处关键修改makemenuconfig第一处指定交叉编译器和架构Settings --- (arm-linux-gnueabihf-) Cross compiler prefix (*) Build static binary (no shared libs) ← 关键勾上为什么强烈建议静态编译动态编译的 busybox 依赖目标板上的动态库libc.so 等。如果你自制最小根文件系统时忘了放库文件启动时 shell 都起不来报一个令人窒息的错误/bin/sh: cant load library libc.so.6 # 然后 kernel panic卡死迎接寂静静态编译把 libc 直接编进二进制体积大几百 KB但到处能跑——对自制 rootfs 阶段来说是巨大的减负。第二处可选裁剪不需要的 appletLinux Module Utilities --- # 不用 insmod 的话整组关掉 Networking Utilities --- # telnetd/tftp 按需保留 Shells --- Choose your shell (ash) # 保持 ash别选成 none4.3 编译与安装make-j8makeCONFIG_PREFIX/home/hanxi/rootfsinstallmake install会把 busybox 装到CONFIG_PREFIX指定的目录并且自动创建所有 applet 的软链接cd/home/hanxi/rootfslsbin/|head# arch awk base32 base64 basename busybox cat ...ls-lbin/ls# bin/ls - busybox软链接的组织方式默认有三种风格--install时的-s/-l/-l之外的差异默认是把大多数链接放在/bin少数在/sbin、/usr/bin。对嵌入式足够了不用纠结。看看成果ls-lrootfs/bin/busybox# -rwxr-xr-x 1 hanxi hanxi 1015480 ... busybox ← 1MB 出头全家桶到手五、动手实战三从零搭一个能启动的最小根文件系统这是本篇的高潮。我们要用 BusyBox 造一个麻雀虽小五脏俱全的 rootfs并用 QEMU 验证它能跑——没有开发板也能完整走完这个流程这是我推荐所有嵌入式新手必做的实验。5.1 rootfs 还缺什么make install只给了我们/bin、/sbin、/usr下的命令。一个能被内核挂载的根文件系统还缺这些骨架目录和设备节点cd/home/hanxi/rootfs# 骨架目录mkdir-pdev etc proc sys tmp root lib# 两个生死攸关的设备节点内核挂载 rootfs 后要用的sudomknod-m666dev/null c13sudomknod-m666dev/console c51/dev/null和/dev/console这两个节点没有的话内核启动到挂载 rootfs 阶段直接 panic。经典翻车现场Warning: unable to open an initial console. Kernel panic - not syncing: no init found新手看到no init found一脸懵其实多半是 console 节点缺失或者 init 路径不对。5.2 配置 etcinit 是内核点的第一把火内核启动的最后一步是执行第一个用户态程序由内核启动参数rdinit或init指定默认找/sbin/init。BusyBox 的/sbin/init会读取/etc/inittab来决定接下来干什么。BusyBox init 语法和经典 SysVinit 一脉相承但更精简# /etc/inittab# id:runlevels:action:process::sysinit:/etc/init.d/rcS# 系统初始化最先执行等它跑完才继续::respawn:-/bin/sh# 在控制台上启动交互 shell前面加 - 表示登录 shell::restart:/sbin/init# init 重启时执行::ctrlaltdel:/sbin/reboot# CtrlAltDel 重启::shutdown:/bin/umount-a-r# 关机时卸载所有挂载点respawn的含义进程退出后自动重启。所以你exit退出 shell它马上又给你拉一个新的——这就是为什么嵌入式设备串口里 shell “打不死”。然后写rcS系统初始化脚本mkdir-petc/init.dcatetc/init.d/rcSEOF #!/bin/sh # 挂载虚拟文件系统——没有它们 ps/free/lsmod 都是瞎的 mount -t proc none /proc mount -t sysfs none /sys mount -t devtmpfs none /dev 2/dev/null || mdev -s # 设置主机名串口里看着体面点 hostname mini-box echo echo BusyBox mini rootfs is alive! echo EOFchmodx etc/init.d/rcS这里有个知识点要展开/proc、/sys、/dev为什么必须挂/proc内核状态的用户态窗口。ps列进程、cat /proc/cpuinfo、cat /proc/meminfo全靠它/sys设备模型树后面加载驱动、看温度传感器的值都要用/dev设备节点。内核开了CONFIG_DEVTMPFS就自动填充推荐没开就得靠 BusyBox 的mdev -s扫描/sys生成设备节点。mdev是嵌入式里的 udev 替代品轻量级热插拔管理配合/etc/mdev.conf还能在 U 盘插入时自动执行脚本——做无人售货柜自动挂载存储卡时我就用它。5.3 打包成 initramfs 并用 QEMU 启动最省事的验证方式是 initramfs把 rootfs 打包进内核镜像内核启动时展开到内存里cd/home/hanxi/rootfsfind.|cpio-o-Hnewc|gzip../rootfs.cpio.gz再配一个 QEMU 能跑的 ARM 内核Debian/Ubuntu 有linux-image-*-armmp包或用 buildroot 编译启动qemu-system-arm\-Mvexpress-a9\-kernelzImage\-initrdrootfs.cpio.gz\-appendconsolettyAMA0 rdinit/sbin/init\-nographic串口输出节选[ 0.000000] Booting Linux on physical CPU 0x0 ... [ 3.10] VFS: Mounted root (initramfs filesystem) on device 0:12 Run /sbin/init as init process BusyBox mini rootfs is alive! / # ps PID USER TIME COMMAND 1 root 0:00 init 2 root 0:00 [kthreadd] ... / # busybox | head -3 BusyBox v1.36.1 multi-call binary.恭喜一个约 1.5MBbusybox 内核镜像另算的完整 Linux 用户空间跑起来了。在这个 shell 里ls、vi、ifconfig、top……三百个命令任你调遣。5.4 迁移到真实开发板QEMU 验证通过后上真板只差两步rootfs 烧到存储介质Nor/Nand/eMMC 分区后格式化如 ext4/SquashFS把 rootfs 目录内容拷进去内核启动参数改成root/dev/mmcblk0p2 rootfstypeext4 init/sbin/init改动态编译可选产品定型后如果内存 Flash 依然紧张就保持静态若 rootfs 里已有 libc比如之后要跑自己的 C 程序可以改动态编译省几百 KB——注意把工具链的libc.so.6、ld-linux-armhf.so.3一并放进/lib。第 2 步就是传说中的 “libc 忘拷” 翻车点报错见 4.2 节。别问我为什么记得这么清楚。六、实战中的 BusyBox 高频技巧以下是我多年嵌入式项目里沉淀的 BusyBox 使用心得每一条都值一顿烧烤。6.1 串口调试一个busybox顶一个工具箱板子上没有 gdb、没有 strace、甚至没有ls完整参数时# 系统还活着吗内存剩多少free# 哪个进程在吃 CPUtop-b-n1|head-15# 网卡状态udhcpc 是 busybox 自带的 dhcp 客户端ifconfigeth0 udhcpc-ieth0# 看内核打印没接串口日志时兜底dmesg|tail-20# 起个 http 服务器从 PC 拉文件到板子调试神器busybox httpd-f-p8000-h/tmp最后这个 httpd 值得单独说你在 PC 浏览器访问http://板子IP:8000就能浏览/下载板子/tmp下的文件。反向的传输用busybox wget或者tftp。不装任何额外工具文件就进出板子了现场调试效率翻倍。6.2ash脚本注意和 bash 的差异BusyBox 默认 shell 是ashAlmquist Shell语法接近 POSIX sh但和 bash 有几个差异脚本移植时最容易踩# 1. bash 特有的 [[ ]] 双括号ash 不支持[[$xy]]# bash ✓ ash ✗[$xy]# 两边都 OK注意 而不是 POSIX 惯例# 2. 数组ash 没有arr(a b c)# bash ✓ ash ✗ —— 直接报语法错误# 3. 本地变量localx1# ash 的 local 只能在函数内用行为一致没事# 4. 算术$((12))# 两边都支持放心用# 5. source 关键字source/etc/profile# bash ✓./etc/profile# 两边都 OK推荐用点号经验法则给板子写的脚本按 POSIX sh 写别写 bash 方言同时注意 shebang 用#!/bin/sh。脚本开头别用#!/bin/bash——busybox rootfs 里根本没有 bash等着你的只有not found。6.3 mdevU 盘/TF 卡自动挂载无人售货柜项目里运维要在现场插 U 盘导出日志。做法# /etc/mdev.confsd[a-z][0-9]0:0660/etc/hotplug/udisk_insert.sh mmcblk[0-9]p[0-9]0:0660/etc/hotplug/udisk_insert.sh配合内核热插拔echo /sbin/mdev /proc/sys/kernel/hotplug插入 U 盘时 mdev 自动执行后面的脚本在脚本里mount并触发日志同步。轻量、无依赖比移植完整 udev 省心太多。6.4 裁剪按需定制你的军刀产品量产前建议做一轮正式裁剪。思路不是关得越多越好而是对照你设备实际要跑的东西关掉的典型项 - 调试类strace 需要单独移植telnet/telnetd 量产必关安全 - 不用的文件系统工具mkfs.ext2 若没有 ext2 就关 - 打印/邮件类lpr、sendmail 基本必关 必须确认保留的 - init、ash、mount/umount、mdev、ps、sh 系列 - 你 rcS 和业务脚本里用到的每一个命令裁剪完的验证方法很朴素把 rootfs 部署后把 rcS 和所有业务脚本从头跑一遍。--list和脚本里用到的命令做交叉检查# 在 PC 上检查脚本用到的命令是否都被 busybox 支持forcmdinmountpsgrepawksedcuttrfind;dobusybox--list|grep-qx$cmdechoOK$cmd||echoMISS$cmddone量产版裁到 500KB 以内是常见成绩。6.5 安全提醒busybox telnetd 是无密码后门必须单独强调一条安全纪律呼应安全系列文章的老规矩量产固件里telnetd、httpd、ftpd这些 BusyBox 网络服务要么关闭要么加认证。BusyBox 的 telnetd 直接派生登录 shell没有像 OpenSSH 那样的密钥体系httpd 的 Basic Auth 也只是明文 base64。历史上大量 IoT 设备被入侵入口就是出厂默认开启的 busybox telnetd。智慧农业网关那批设备我们的做法是量产配置直接裁掉 telnetd调试口只留物理串口。七、原理补完BusyBox 与 systemd 时代的相处之道有读者可能要问现在 PC 上都是 systemd 一统天下BusyBox 的 init 还有什么用答案两者不在一个生态位。维度BusyBox initsystemd体积几 KB十几 MB连依赖启动速度极快一个 rcS 脚本了事中规中矩有优化手段依赖无不依赖 dbus/journald 等一整套用户态组件服务管理inittab 手写脚本声明式 unit依赖管理强大适用场景嵌入式、initramfs、容器通用发行版有个概念新人常混淆initramfs 里的 init 和系统正式的 init 是两回事。哪怕你的目标系统用 systemd内核启动初期的 initramfs解锁加密分区、加载驱动的那段里跑的 init 也十有八九是 BusyBox 的——干完活再switch_root切到真正的系统。Ubuntu、Debian 的 initramfs 全是这么干的。你可以在 initramfs 的 emergency shell 里执行busybox --list亲自验证。另外容器场景里 BusyBox 也活得很好——docker pull busybox只有 4MB 出头是很多 CI 流水线里我就是想执行几个 shell 命令场景的最省镜像。虽然现在 alpine同样基于 BusyBox 的 musl 系发行版更流行但 BusyBox 镜像依然是最小可用的标杆。八、常见报错速查表把我这些年遇到的 BusyBox 相关问题做成表建议直接收藏报错/现象原因解决xxx: applet not found命令被裁剪/拼写错busybox --list核对busybox xxx显式调用Kernel panic - not syncing: no init foundrootfs 无/sbin/init或 rcS 配置错检查 init 路径、inittab、执行权限cant load library libc.so.6动态编译但 rootfs 缺 libc拷工具链 libc 到/lib或改静态编译shell 一闪就重启respawn 循环/bin/sh链接损坏或 inittab respawn 了必退出的程序修软链接respawn 指向真正的交互 shellps只显示两三个进程没挂/procrcS 里加mount -t proc none /procmdev 不生成设备节点内核没配 devtmpfs 且没设 hotplugmdev -secho /sbin/mdev /proc/sys/kernel/hotplug交叉编译报testsuite错误在 x86 上跑了给 ARM 的编译测试make CONFIG_PREFIX... install跳过测试即可或加CROSS_COMPILE前缀确认无误applet 链接颜色异常/行为怪文件系统不支持符号链接如 FATrootfs 用 ext4/squashfs别用 FAT九、总结最后收个尾这篇的信息密度确实不小帮你把主线拎出来BusyBox 是单二进制多路复用300 个 applet 打包进一个可执行文件靠argv[0]分发到不同的入口函数——这是它体积奇迹的全部秘密软链接是它的躯干/bin/ls - busybox这套结构让一个二进制长出了整个命令体系交叉编译三板斧make defconfig→menuconfig里设工具链前缀 静态编译 →make install得到带全套软链接的 rootfs 雏形最小根文件系统四件套骨架目录、dev/null和dev/console节点、etc/inittab、etc/init.d/rcS挂 proc/sys/dev——齐活就能启动量产前裁剪 安全加固按业务实际用到的命令裁网络服务类 applettelnetd/httpd默认关闭。从 Bruce Perens 当年为 Debian 安装盘写的那个小工具集合到今天跑在全球数十亿设备里的嵌入式基石BusyBox 用 30 年时间证明了一件事在工程世界里小而克制是可以穿越技术周期的。对做嵌入式的朋友我的建议始终是哪怕你用的是 buildroot/Yocto 这类一键出镜像的框架也要亲手用 BusyBox 从零搭一次 rootfs。框架帮你屏蔽的细节恰恰是你排障时的底气。我是黒漂技术佬咱们下篇见。
