注意：这是bash镜像的amd64架构专用仓库——更多信息请参见镜像文档中的“除amd64外的架构？”和***镜像FAQ中的“镜像源在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

快速参考（续）

• 提交issue的地址：
  [***]

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

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

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

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

什么是 Bash？

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

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

!logo

如何使用本镜像

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

注意事项

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

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

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

交互式 shell

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

通过 bind-mount 测试脚本

console
$ docker run -it --rm -v /path/to/script.sh:/script.sh:ro amd64/bash:4.4 bash /script.sh
...
$ docker run -it --rm -v /path/to/script.sh:/script.sh:ro amd64/bash:3.2 bash /script.sh
...

通过 Dockerfile 测试脚本

dockerfile
FROM amd64/bash:4.4

COPY script.sh /

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

然后构建并运行 Docker 镜像：

console
$ 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/ 目录中。

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