Bash（riscv64架构）镜像文档

注意： 这是针对bash官方镜像的riscv64架构构建的“每架构”仓库——更多信息，请参见官方镜像文档中的“除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

快速参考（续）

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

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

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

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

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

什么是Bash？

Bash是GNU项目的Bourne Again SHell，是IEEE POSIX和Open Group shell规范的完整实现，具有交互式命令行编辑、在支持的架构上提供作业控制、类似csh的特性（如历史替换和花括号扩展）以及许多其他功能。

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运行脚本，而不是让解释器指令自动调用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

$ docker run -it --rm riscv64/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 /path/to/script.sh:/script.sh:ro riscv64/bash:4.4 bash /script.sh
...
$ docker run -it --rm -v /path/to/script.sh:/script.sh:ro riscv64/bash:3.2 bash /script.sh
...

通过Dockerfile测试脚本

FROM riscv64/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/目录中找到。

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