busybox编译安装完整教程

云磊酱_8652

云磊酱_8652

2026-06-11

782人浏览

原创

必须从源码交叉编译BusyBox并安装到目标路径:先装build-essential、gcc-arm-linux-gnueabihf和libncurses5-dev;再下载1.36.1源码,make defconfig后make menuconfig勾选静态编译、设ARM架构及交叉编译前缀;最后export CROSS_COMPILE=arm-linux-gnueabihf- && make -j$(nproc),用make CONFIG_PREFIX=/work/rootfs install完成部署。

busybox编译安装完整教程

要在嵌入式设备或自定义根文件系统中部署一个精简、静态、可直接运行的Linux工具集,必须从源码交叉编译BusyBox并正确安装到目标路径,跳过apt包管理器提供的通用二进制包。

准备交叉编译环境

在Ubuntu 22.04主机上执行以下命令安装必需组件:

sudo apt update && sudo apt install -y build-essential gcc-arm-linux-gnueabihf libncurses5-dev

这一步缺一不可——【没有libncurses5-dev就无法运行make menuconfig】,后续配置将卡死在文本界面初始化阶段。若使用ARM64目标平台,需改用gcc-aarch64-linux-gnu包。

获取并解压BusyBox源码

下载稳定版1.36.1源码(官方推荐用于生产环境):

wget https://busybox.net/downloads/busybox-1.36.1.tar.bz2 && tar xjf busybox-1.36.1.tar.bz2 && cd busybox-1.36.1

不建议用git克隆最新开发分支,其defconfig在ARM平台存在已知符号冲突,会导致编译失败。

配置目标平台与关键选项

第一步:加载默认ARM适配配置

make defconfig

第二步:启动图形化配置菜单进行微调

make menuconfig

在菜单中重点修改三项:

→ BusyBox Settings → Build Options → 【Build static binary (no shared libs)】 必须勾选,否则生成的busybox在无glibc目标设备上直接报“not found”错误;

→ Target Platform Settings → Target architecture → 选择 ARM (little endian);

→ Cross Compiler prefix → 输入 arm-linux-gnueabihf-(注意末尾短横线不能遗漏)。

保存退出后,当前目录下会生成.config文件,它是整个编译过程的唯一配置依据。

执行交叉编译

方法一:通过环境变量指定工具链(推荐)

export CROSS_COMPILE=arm-linux-gnueabihf-

Sologo AI
Sologo AI

Sologo AI是一款用于生成 Logo、品牌图像和整套品牌资产的 AI 设计平台。

下载

export ARCH=arm

make -j$(nproc)

方法二:命令行内联指定(临时生效)

make CROSS_COMPILE=arm-linux-gnueabihf- ARCH=arm -j$(nproc)

编译成功后,当前目录下将生成一个名为busybox的可执行文件,大小通常在1.2–1.8 MB之间。若输出中出现“undefined reference to `__stack_chk_fail`”,说明未启用静态链接,需回退检查menuconfig配置。

验证二进制架构与功能

运行file busybox确认输出包含“ARM, EABI5 version 1 (SYSV), statically linked”字样;

执行./busybox --help | head -5,观察是否列出ash、ls、cp等applet名称;

用qemu-arm-static快速测试基础功能(需先安装qemu-user-static):

qemu-arm-static ./busybox ls -l

安装到目标根文件系统目录

第一步:创建干净的目标安装路径

mkdir -p /work/rootfs

第二步:执行安装命令,将所有符号链接和busybox本体写入该路径

make CONFIG_PREFIX=/work/rootfs install

第三步:检查结果

ls -l /work/rootfs/bin/ | head -10

你会看到ls、cp、sh等均为指向busybox的符号链接。此时不要手动复制busybox到其他位置——【CONFIG_PREFIX路径必须与目标设备实际挂载路径一致,否则符号链接将失效】。

相关专题

更多
GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

20

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

60

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

60

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

20

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

60

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

40

16

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

180

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

140

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

160

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习