消息队列 / 系统课时
用 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 账号的远程登录限制。
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预期输出
Ping succeededrabbitmq-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 连接端口。
验证容器仍在运行
可以再检查容器状态,确认前面的实例没有在启动后立即退出。
docker ps --filter name=rabbitmq-demo --format '{{.Names}} {{.Status}}'预期输出
rabbitmq-demo Up <TIME><TIME> 表示容器已运行时长,实际值会随执行时机变化。若命令没有输出,说明目标容器当前不在运行,应进一步检查是否发生端口冲突、容器创建失败或 RabbitMQ 启动异常。
常见启动问题
最常见的失败是容器名重复和宿主机端口冲突。容器名重复时,Docker 会拒绝再创建同名容器;端口被占用时,端口绑定阶段会失败。此时应先释放冲突资源,或者为宿主机选择其他端口映射,再重新启动。
如果管理页面一时打不开,但容器仍在启动,应先等待诊断命令通过再刷新页面。只有 Broker 完成启动、管理插件正常加载并且 15672 映射成功后,浏览器才能访问控制台。