注意：这是 bash 官方镜像 的 arm32v7 架构专用仓库——更多信息，请参见官方镜像文档中的“除 amd64 外的架构？”和官方镜像常见问题中的“镜像的源代码在 Git 中已更改，现在该怎么办？”。

快速参考

• 维护者：
  Tianon（来自 Docker 社区），并得到 Bash 上游 Chet 的支持

• 获取帮助：
  Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应的 Dockerfile 链接

• devel-20251006, devel, devel-20251006-alpine3.22, devel-alpine3.22

• 5.3.3, 5.3, 5, latest, 5.3.3-alpine3.22, 5.3-alpine3.22, 5-alpine3.22, alpine3.22

• 5.2.37, 5.2, 5.2.37-alpine3.22, 5.2-alpine3.22

• 5.1.16, 5.1, 5.1.16-alpine3.22, 5.1-alpine3.22

• 5.0.18, 5.0, 5.0.18-alpine3.22, 5.0-alpine3.22

• 4.4.23, 4.4, 4, 4.4.23-alpine3.22, 4.4-alpine3.22, 4-alpine3.22

• 4.3.48, 4.3, 4.3.48-alpine3.22, 4.3-alpine3.22

• 4.2.53, 4.2, 4.2.53-alpine3.22, 4.2-alpine3.22

• 4.1.17, 4.1, 4.1.17-alpine3.22, 4.1-alpine3.22

• 4.0.44, 4.0, 4.0.44-alpine3.22, 4.0-alpine3.22

• 3.2.57, 3.2, 3, 3.2.57-alpine3.22, 3.2-alpine3.22, 3-alpine3.22

• 3.1.23, 3.1, 3.1.23-alpine3.22, 3.1-alpine3.22

• 3.0.22, 3.0, 3.0.22-alpine3.22, 3.0-alpine3.22

快速参考（续）

• 问题反馈地址：
  [***]

• 支持的架构：(更多信息)
  amd64、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x

• 镜像 artifact 详情：
  repo-info 仓库的 bash/ 目录（历史记录）
  （镜像元数据、传输大小等）

• 镜像更新：
  official-images 仓库的 library/bash 标签
  official-images 仓库的 library/bash 文件（历史记录）

• 本描述的来源：
  docs 仓库的 bash/ 目录（历史记录）

什么是 Bash？

Bash 是 GNU 项目的 Bourne Again Shell，是 IEEE POSIX 和开放群组 shell 规范 的完整实现，支持交互式命令行编辑、在支持的架构上进行作业控制、类似 csh 的功能（如历史替换和大括号扩展）以及许多其他功能。

tiswww.case.edu/php/chet/bash/bashtop.html

!logo

如何使用此镜像

此镜像的主要使用场景是在主发行版更新软件包之前测试新版本 Bash 的新功能，以及针对不同 Bash 版本测试 shell 脚本以确保兼容性。可能还有其他有趣的使用场景，但这是镜像最初创建时要解决的主要两个场景！

注意事项

关于此镜像，有几个重要事项需要注意：

1. Bash 本身安装在 /usr/local/bin/bash，而非 /bin/bash，因此推荐的解释器指令是 #!/usr/bin/env bash，而非 #!/bin/bash（或者显式通过 bash /.../script.sh 运行脚本，而不是让解释器指令自动调用 Bash）。镜像不包含 /bin/bash，但如果通过镜像中包含的包管理器安装，该软件包会安装到 /bin/bash，可能会造成混淆（尽管 /usr/local/bin 在 $PATH 中优先于 /bin，因此只要一致使用 bash 或 /usr/bin/env，镜像提供的 Bash 将被优先使用）。

2. 镜像仅包含 Bash，因此如果脚本依赖外部工具（例如 jq），则需要手动添加（例如通过 apk add --no-cache jq）。

交互式 shell

$ docker run -it --rm arm32v7/bash:4.4
bash-4.4# which bash
/usr/local/bin/bash
bash-4.4# echo $BASH_VERSION
4.4.0(1)-release

通过绑定挂载测试脚本

$ docker run -it --rm -v /本地路径/script.sh:/script.sh:ro arm32v7/bash:4.4 bash /script.sh
...
$ docker run -it --rm -v /本地路径/script.sh:/script.sh:ro arm32v7/bash:3.2 bash /script.sh
...

通过 Dockerfile 测试脚本

FROM arm32v7/bash:4.4

COPY script.sh /

CMD ["bash", "/script.sh"]

然后，构建并运行 Docker 镜像：

$ docker build -t my-bash-app .
...
$ docker run -it --rm --name my-running-app my-bash-app
...

许可

Bash 是自由软件，根据 GNU 通用公共许可证第 3 版 分发。

与所有 Docker 镜像一样，这些镜像可能还包含其他软件，这些软件可能采用其他许可（例如基础发行版中的 Bash 等，以及包含的主要软件的任何直接或间接依赖项）。

一些能够自动检测到的额外许可信息可能位于 repo-info 仓库的 bash/ 目录。

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用符合其中包含的所有软件的相关许可。