注意：这是rabbitmq镜像的arm32v6架构构建版本的“按架构”仓库——更多信息，请参见镜像文档中的“非amd64架构？”和***镜像FAQ中的“镜像源在Git中更改后怎么办？”。

快速参考

• 维护者：
  Docker社区

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

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

• 4.2.0-rc.1-alpine, 4.2-rc-alpine

• 4.2.0-rc.1-management-alpine, 4.2-rc-management-alpine

• 4.1.4-alpine, 4.1-alpine, 4-alpine, alpine

• 4.1.4-management-alpine, 4.1-management-alpine, 4-management-alpine, management-alpine

• 4.0.9-alpine, 4.0-alpine

• 4.0.9-management-alpine, 4.0-management-alpine

• 3.13.7-alpine, 3.13-alpine, 3-alpine

• 3.13.7-management-alpine, 3.13-management-alpine, 3-management-alpine

快速参考（续）

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

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

• 已发布镜像工件详情：
  repo-info仓库的repos/rabbitmq/目录（历史记录）
  （镜像元数据、传输大小等）

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

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

什么是RabbitMQ？

RabbitMQ是开源的消息代理软件（有时称为面向消息的中间件），实现了高级消息队列协议（AMQP）。RabbitMQ服务器使用Erlang编程语言编写，并基于Open Telecom Platform框架构建，支持集群和故障转移。所有主要编程语言都有用于与代理交互的客户端库。

***.org/wiki/RabbitMQ

!logo

如何使用本镜像

运行守护进程

关于RabbitMQ需要注意的重要事项之一是，它基于所谓的“节点名称”（默认为主机名）存储数据。这对于Docker中的使用意味着，我们应该为每个守护进程显式指定-h/--hostname，以避免随机主机名并能跟踪数据：

console
$ docker run -d --hostname my-rabbit --name some-rabbit arm32v6/rabbitmq:3

这将启动一个RabbitMQ容器，监听默认端口5672。稍等片刻后，执行docker logs some-rabbit，你将在输出中看到类似以下的块：

=INFO REPORT==== 6-Jul-2015::20:47:02 ===
node           : rabbit@my-rabbit
home dir       : /var/lib/rabbitmq
config file(s) : /etc/rabbitmq/rabbitmq.config
cookie hash    : UoNOcDhfxW9uoZ92wh6BjA==
log            : tty
sasl log       : tty
database dir   : /var/lib/rabbitmq/mnesia/rabbit@my-rabbit

注意其中的database dir，特别是它在文件存储路径末尾附加了我的“节点名称”。本镜像默认将/var/lib/rabbitmq设为卷。

环境变量

有关RabbitMQ本身支持的环境变量列表，请参见rabbitmq.com/configure的“环境变量”部分

警告：从RabbitMQ 3.9开始，以下列出的所有Docker特定变量均已弃用且不再使用。请改用配置文件；访问rabbitmq.com/configure了解有关配置文件的更多信息。作为起点，3.8版本的镜像会打印出根据提供的环境变量生成的配置文件。

bash
# 3.9及以上版本中不可用
RABBITMQ_DEFAULT_PASS_FILE
RABBITMQ_DEFAULT_USER_FILE
RABBITMQ_MANAGEMENT_SSL_CACERTFILE
RABBITMQ_MANAGEMENT_SSL_CERTFILE
RABBITMQ_MANAGEMENT_SSL_DEPTH
RABBITMQ_MANAGEMENT_SSL_FAIL_IF_NO_PEER_CERT
RABBITMQ_MANAGEMENT_SSL_KEYFILE
RABBITMQ_MANAGEMENT_SSL_VERIFY
RABBITMQ_SSL_CACERTFILE
RABBITMQ_SSL_CERTFILE
RABBITMQ_SSL_DEPTH
RABBITMQ_SSL_FAIL_IF_NO_PEER_CERT
RABBITMQ_SSL_KEYFILE
RABBITMQ_SSL_VERIFY
RABBITMQ_VM_MEMORY_HIGH_WATERMARK

设置默认用户和密码

如果希望更改默认的guest/guest用户名和密码，可以使用RABBITMQ_DEFAULT_USER和RABBITMQ_DEFAULT_PASS环境变量。这些变量以前在Docker特定的入口点shell脚本中可用，现在直接在RabbitMQ中支持。

console
$ docker run -d --hostname my-rabbit --name some-rabbit -e RABBITMQ_DEFAULT_USER=user -e RABBITMQ_DEFAULT_PASS=password arm32v6/rabbitmq:3-management

然后，你可以在浏览器中访问http://localhost:8080或[***]，使用user/password登录管理控制台。

设置默认虚拟主机

如果希望更改默认虚拟主机，可以使用RABBITMQ_DEFAULT_VHOST环境变量：

console
$ docker run -d --hostname my-rabbit --name some-rabbit -e RABBITMQ_DEFAULT_VHOST=my_vhost arm32v6/rabbitmq:3-management

内存限制

RabbitMQ包含显式跟踪和管理内存使用的功能，因此需要了解cgroup施加的限制（例如docker run --memory=..）。

上游配置中对应的设置是rabbitmq.conf中的vm_memory_high_watermark，在文档的“内存告警”“Memory Alarms”部分有描述。如果通过vm_memory_high_watermark.relative设置相对限制，RabbitMQ将基于主机的总内存而非容器运行时设置的限制计算其限制。

Erlang Cookie

有关Cookie及其必要性的更多信息，请参见RabbitMQ“集群指南”RabbitMQ "Clustering Guide"。要设置一致的Cookie（尤其对集群有用，也用于通过rabbitmqctl进行远程/跨容器管理），请提供一个Cookie文件（默认位置为/var/lib/rabbitmq/.erlang.cookie）。

例如，可以通过文件提供Cookie（如使用Docker Secrets）：

console
docker service create ... --secret source=my-erlang-cookie,target=/var/lib/rabbitmq/.erlang.cookie ... arm32v6/rabbitmq

（注意，可能还需要指定uid=XXX,gid=XXX,mode=0600，以便容器中的Erlang能够正确读取Cookie文件。有关更多详细信息，请参见Docker的--secret文档。）

管理插件

提供了第二组标签，默认安装并启用了管理插件，可通过标准管理端口***访问，默认用户名和密码为guest/guest：

console
$ docker run -d --hostname my-rabbit --name some-rabbit arm32v6/rabbitmq:3-management

你可以通过浏览器访问[***]，如果需要从主机外部访问，可以映射到8080端口：

console
$ docker run -d --hostname my-rabbit --name some-rabbit -p 8080:*** arm32v6/rabbitmq:3-management

然后，你可以在浏览器中访问http://localhost:8080或[***]。

启用插件

创建Dockerfile可在运行时启用插件。要查看镜像中存在的所有插件，执行rabbitmq-plugins list

Dockerfile
FROM rabbitmq:3.8-management
RUN rabbitmq-plugins enable --offline rabbitmq_mqtt rabbitmq_federation_management rabbitmq_stomp

你也可以挂载一个文件到/etc/rabbitmq/enabled_plugins，内容为以句点结尾的Erlang原子列表。

enabled_plugins示例：

bash
[rabbitmq_federation_management,rabbitmq_management,rabbitmq_mqtt,rabbitmq_stomp].

额外配置

如果需要配置，建议提供适当的/etc/rabbitmq/rabbitmq.conf文件（参见RabbitMQ文档的“配置文件”部分“Configuration File(s)” section了解更多详情），例如通过绑定挂载、Docker Configs或带有COPY指令的简短Dockerfile。

或者，可以使用RABBITMQ_SERVER_ADDITIONAL_ERL_ARGS环境变量，其语法在Erlang OTP设计原则用户指南的第7.8节“配置应用程序”section 7.8 ("Configuring an Application")中描述（-ApplName对应的正确值为-rabbit），此方法需要在rabbitmq.conf中等价条目的略微不同的重现。例如，配置channel_max类似于-e RABBITMQ_SERVER_ADDITIONAL_ERL_ARGS="-rabbit channel_max 4007"。其中变量channel_max与其值4007之间的空格在环境中转换时正确变为逗号。

健康/存活/就绪检查

有关此镜像未定义默认HEALTHCHECK的详细解释，以及实现自己的健康/存活/就绪检查的建议，请参见“***镜像”FAQ和docker-library/rabbitmq#174的讨论（特别是RabbitMQ上游的Michael Klishin的长篇评论）。

镜像变体

arm32v6/rabbitmq镜像有多种版本，每种版本设计用于特定用例。

arm32v6/rabbitmq:<version>

这是默认镜像。如果你不确定自己的需求，可能需要使用此版本。它设计为既可作为临时容器（挂载源代码并启动容器以运行应用），也可作为构建其他镜像的基础。

arm32v6/rabbitmq:<version>-alpine

此镜像基于流行的Alpine Linux项目，可在alpine***镜像中获取。Alpine Linux比大多数发行版基础镜像小得多（约5MB），因此通常会生成更精简的镜像。

当最终镜像大小尽可能小是你的主要关注点时，此变体非常有用。需要注意的主要问题是它使用musl libc而非glibc及相关库，因此软件可能会因对libc的依赖/假设深度而遇到问题。有关可能出现的问题以及使用Alpine-based镜像的优缺点比较，请参见此Hacker News评论线程。

为最小化镜像大小，Alpine-based镜像中通常不包含其他相关工具（如git或bash）。以此镜像为基础，可在自己的Dockerfile中添加所需工具（如果你不熟悉如何安装软件包，请参见alpine镜像描述中的示例）。

许可证

查看此镜像中包含的软件的许可证信息。

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

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

对于任何预