amd64/busybox

BusyBox Docker镜像文档

镜像概述

amd64/busybox是https://hub.docker.com/_/busybox%E7%9A%84%60amd64%60%E6%9E%B6%E6%9E%84%E4%B8%93%E7%94%A8%E4%BB%93%E5%BA%93%E3%80%82BusyBox%E8%A2%AB%E8%AA%89%E4%B8%BA%22%E5%B5%8C%E5%85%A5%E5%BC%8FLinux%E7%9A%84%E7%91%9E%E5%A3%AB%E5%86%9B%E5%88%80%22%EF%BC%8C%E6%98%AF%E4%B8%80%E4%B8%AA%E9%9B%86%E6%88%90%E4%BA%86%E5%A4%9A%E7%A7%8D%E5%B8%B8%E8%A7%81UNIX%E5%B7%A5%E5%85%B7%E7%9A%84%E5%B0%8F%E5%9E%8B%E5%8F%AF%E6%89%A7%E8%A1%8C%E6%96%87%E4%BB%B6%EF%BC%8C%E7%A3%81%E7%9B%98%E5%A4%A7%E5%B0%8F%E9%80%9A%E5%B8%B8%E5%9C%A81-5MB%E4%B9%8B%E9%97%B4%EF%BC%88%E5%8F%96%E5%86%B3%E4%BA%8E%E5%8F%98%E4%BD%93%EF%BC%89%EF%BC%8C%E9%9D%9E%E5%B8%B8%E9%80%82%E5%90%88%E6%9E%84%E5%BB%BA%E7%A9%BA%E9%97%B4%E9%AB%98%E6%95%88%E7%9A%84%E5%AE%B9%E5%99%A8%E5%8F%91%E8%A1%8C%E7%89%88%E3%80%82

注意：有关非amd64架构的信息，参见https://github.com/docker-library/official-images#architectures-other-than-amd64%EF%BC%9B%E6%9C%89%E5%85%B3%E9%95%9C%E5%83%8F%E6%BA%90%E7%A0%81%E5%8F%98%E6%9B%B4%E7%9A%84%E8%AF%B4%E6%98%8E%EF%BC%8C%E5%8F%82%E8%A7%81https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E3%80%82

核心功能与特性

核心功能

• 多工具集成：将数十种常见UNIX工具（如ls、cp、sh、grep等）整合为单个小型可执行文件
• 功能兼容：提供与GNU工具集基本兼容的命令选项，确保常用功能正常工作
• 轻量级设计：极小的磁盘占用（1-5MB）和内存 footprint，适合资源受限环境

主要特性

• 多libc支持：提供glibc、uClibc、musl三种libc变体，适应不同场景需求
• 跨架构兼容：支持多种硬件架构（amd64、arm32v5/v6/v7、arm64v8等）
• 静态编译选项：部分变体（uClibc、musl）采用静态编译，减少运行时依赖
• 版本化标签：提供稳定版（stable）和不稳定版（unstable）标签，满足不同稳定性需求

支持的标签及Dockerfile链接

使用场景

• 嵌入式系统开发：作为轻量级基础环境，提供核心工具链
• 资源受限环境：在低内存、小磁盘空间的设备中运行基础命令
• 轻量级容器基础：作为静态编译应用的基础镜像，减小最终镜像体积
• 临时调试环境：快速启动包含基础工具的容器，用于系统调试
• CI/CD流水线：在构建流程中作为轻量级执行环境，减少资源消耗

使用方法

运行BusyBox Shell

通过以下命令启动交互式BusyBox shell：

console
$ docker run -it --rm amd64/busybox

此命令会启动一个临时容器并进入sh shell，退出后容器自动删除（--rm参数）。

创建静态二进制基础镜像

对于静态编译的应用，可使用BusyBox作为基础镜像构建极小镜像。创建Dockerfile如下：

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

说明：需确保my-static-binary是静态编译的（无动态依赖），可通过ldd my-static-binary验证（输出"not a dynamic executable"表示静态编译）。

镜像变体

amd64/busybox提供三种libc变体，适应不同兼容性和大小需求：

amd64/busybox:glibc

• libc来源：Debian的glibc（动态链接）
• 特点：兼容性最好，支持更多动态链接应用，但体积相对较大
• 适用场景：需要广泛兼容性的动态链接应用

amd64/busybox:uclibc

• libc来源：通过Buildroot构建的uClibc（静态编译）
• 特点：体积小于glibc变体，专为嵌入式系统优化
• 适用场景：嵌入式设备、对体积敏感的静态应用

amd64/busybox:musl

• libc来源：Alpine的musl（静态编译）
• 特点：体积最小，严格遵循POSIX标准，安全性高
• 适用场景：极简容器、安全敏感的静态应用

维护与支持

维护者

https://github.com/docker-library/busybox

获取帮助

• Docker Community Slack
• Server Fault
• Unix & Linux Stack Exchange
• Stack Overflow

提交Issue

https://github.com/docker-library/busybox/issues?q=

支持的架构

• amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x
  （https://github.com/docker-library/official-images#architectures-other-than-amd64%EF%BC%89

镜像元数据

• https://github.com/docker-library/repo-info/blob/master/repos/busybox%EF%BC%88%E5%8C%85%E5%90%AB%E9%95%9C%E5%83%8F%E5%85%83%E6%95%B0%E6%8D%AE%E3%80%81%E4%BC%A0%E8%BE%93%E5%A4%A7%E5%B0%8F%E7%AD%89%EF%BC%89

镜像更新

• https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fbusybox
• https://github.com/docker-library/official-images/blob/master/library/busybox%EF%BC%88%E6%9B%B4%E6%96%B0%E5%8E%86%E5%8F%B2%EF%BC%89

许可证

软件许可证

BusyBox的许可证信息参见官方页面。

镜像包含软件

与所有Docker镜像一样，本镜像可能包含其他软件（如基础发行版的Bash等），这些软件可能具有独立许可证。

额外许可证信息

自动检测的许可证信息可在https://github.com/docker-library/repo-info/tree/master/repos/busybox%E4%B8%AD%E6%89%BE%E5%88%B0%E3%80%82

使用责任：镜像用户需自行确保其使用符合所有包含软件的相关许可证要求。