消息队列 / 系统课时

用 Docker 启动 RabbitMQ

用 Docker 启动 RabbitMQ

本篇目标是在本机快速得到一个可用的 RabbitMQ:AMQP 服务通过 5672 端口对应用开放,管理控制台通过 15672 端口访问,并使用自定义账号登录。完成后还会用诊断命令确认 Broker 已真正启动,而不只是容器处于运行状态。

学习目标

  • 用 Docker 启动带 Management Plugin 的 RabbitMQ
  • 区分 5672 与 15672 两个端口的用途
  • 用 RabbitMQ 自带诊断命令验证实例可用

启动前检查

先确保 Docker Engine 或 Docker Desktop 已启动,并确认宿主机的 5672、15672 端口没有被其他服务占用。下面示例使用 Bash;如果端口已被占用,可以修改冒号左侧的宿主机端口,但容器内部端口仍保持 5672 和 15672。

启动带管理界面的容器

rabbitmq:4-management 镜像包含 RabbitMQ Broker 和 Management Plugin。下面的命令创建一个名为 rabbitmq-demo 的容器,并显式创建本地学习账号,避免依赖默认 guest 账号的远程登录限制。

bash
docker run -d \
  --name rabbitmq-demo \
  -e RABBITMQ_DEFAULT_USER=dev \
  -e RABBITMQ_DEFAULT_PASS=dev-password \
  -p 5672:5672 \
  -p 15672:15672 \
  rabbitmq:4-management >/dev/null

until docker exec rabbitmq-demo rabbitmq-diagnostics -q ping >/dev/null 2>&1; do
  sleep 2
done

docker exec rabbitmq-demo rabbitmq-diagnostics -q ping

预期输出

text
Ping succeeded

rabbitmq-diagnostics ping 成功表示 RabbitMQ 节点已经能够响应诊断请求,比只看到 Docker 容器处于 Up 状态更能说明 Broker 已完成启动。

看懂两个端口

容器启动后,两个映射端口承担不同职责:

  • 5672:AMQP 0-9-1 客户端连接端口,应用程序、SDK、生产者和消费者通常连接这里。
  • 15672:RabbitMQ Management HTTP 控制台端口,浏览器访问 http://localhost:15672,使用账号 dev 和密码 dev-password 登录。

Management 控制台用于查看 Connections、Channels、Exchanges、Queues 等运行信息,但业务程序不应该把 15672 当成 AMQP 连接端口。

验证容器仍在运行

可以再检查容器状态,确认前面的实例没有在启动后立即退出。

bash
docker ps --filter name=rabbitmq-demo --format '{{.Names}} {{.Status}}'

预期输出

text
rabbitmq-demo Up <TIME>

<TIME> 表示容器已运行时长,实际值会随执行时机变化。若命令没有输出,说明目标容器当前不在运行,应进一步检查是否发生端口冲突、容器创建失败或 RabbitMQ 启动异常。

常见启动问题

最常见的失败是容器名重复和宿主机端口冲突。容器名重复时,Docker 会拒绝再创建同名容器;端口被占用时,端口绑定阶段会失败。此时应先释放冲突资源,或者为宿主机选择其他端口映射,再重新启动。

如果管理页面一时打不开,但容器仍在启动,应先等待诊断命令通过再刷新页面。只有 Broker 完成启动、管理插件正常加载并且 15672 映射成功后,浏览器才能访问控制台。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 Docker 启动 RabbitMQ

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通