library/busybox

BusyBox 镜像介绍

快速参考

维护方

Docker 社区

获取帮助

可通过以下途径获取帮助：

• Docker 社区 Slack
• Server Fault（Unix/Linux 相关问题）
• Unix & Linux Stack Exchange
• Stack Overflow

支持的标签及对应 Dockerfile 链接

以下是 BusyBox 镜像支持的标签及其对应的 Dockerfile 链接：

• 1.37.0-glibc, 1.37-glibc, 1-glibc, unstable-glibc, glibc
• 1.37.0-uclibc, 1.37-uclibc, 1-uclibc, unstable-uclibc, uclibc
• 1.37.0-musl, 1.37-musl, 1-musl, unstable-musl, musl
• 1.37.0, 1.37, 1, unstable, latest
• 1.36.1-glibc, 1.36-glibc, stable-glibc
• 1.36.1-uclibc, 1.36-uclibc, stable-uclibc
• 1.36.1-musl, 1.36-musl, stable-musl
• 1.36.1, 1.36, stable

快速参考（续）

提交问题的位置

[***]

支持的架构

（更多信息见 官方镜像架构说明）
amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x

已发布镜像的详细信息

repo-info 仓库的 repos/busybox/ 目录（包含镜像元数据、传输大小等）

镜像更新

• 关注 official-images 仓库的 library/busybox 标签
• 查看 official-images 仓库的 library/busybox 文件历史

本说明的来源

docs 仓库的 busybox/ 目录（含历史版本）

什么是 BusyBox？

BusyBox 被称为“嵌入式 Linux 的瑞士军刀”，磁盘大小通常在 1-5 Mb 之间（取决于变体），是构建空间高效发行版的理想组件。

它将众多常见 UNIX 工具的精简版本整合到单个小型可执行文件中，提供了 GNU fileutils、shellutils 等工具的替代品。虽然 BusyBox 工具的选项通常比 GNU 完整版少，但包含的选项能满足基本功能需求，且行为与 GNU 工具高度一致，可为小型或嵌入式系统提供完整的运行环境。

更多信息：***.org/wiki/BusyBox

!logo

如何使用此镜像

运行 BusyBox shell

console
$ docker run -it --rm busybox

该命令会启动一个 sh shell，方便在 BusyBox 环境中执行操作。

为二进制文件创建 Dockerfile

dockerfile
FROM busybox
COPY ./my-static-binary /my-static-binary
CMD ["/my-static-binary"]

此 Dockerfile 可用于为静态编译的二进制文件构建最小镜像。需注意，二进制文件需在其他环境（如另一个容器）中编译。若需更易扩展的轻量替代方案，可参考 alpine 镜像。

镜像变体

BusyBox 镜像基于不同的“libc”变体构建（关于 libc 变体对比，Eta Labs 的图表 列出了主要异同点）。各变体的构建细节可查看对应 Dockerfile 目录下的 Dockerfile.builder 文件（见上文标签链接）。

busybox:glibc

• 基于 Debian 的 glibc（已包含在镜像中）

busybox:uclibc

• 基于 Buildroot 的 uClibc（静态编译）

busybox:musl

• 基于 Alpine 的 musl（静态编译）

许可协议

镜像中软件的许可信息可查看 BusyBox 许可页面。

与所有 Docker 镜像一样，本镜像可能包含其他软件（如基础发行版的 Bash 及依赖项），这些软件可能适用不同许可协议。

自动检测到的额外许可信息可在 repo-info 仓库的 busybox/ 目录 中找到。

使用预构建镜像时，用户需自行确保符合所有包含软件的许可要求。