消息队列 / 系统课时
使用 Docker 启动 RabbitMQ
使用 Docker 启动 RabbitMQ
本节用 Docker 启动一个可持久化的 RabbitMQ 4.3 节点,开放 AMQP 与管理界面端口,并完成节点与管理 API 验证。最终你会得到一个可重复启停、数据不随容器删除而丢失的本地实验实例。
学习目标
- 使用
rabbitmq:4.3-management创建 RabbitMQ 容器。 - 正确配置
5672、15672端口与/var/lib/rabbitmq数据卷。 - 验证节点存活状态和 Management UI 是否可访问。
检查 Docker 环境
先确认 Docker Engine 可以正常响应。只要服务端能返回版本号,就可以继续创建 RabbitMQ 节点。
docker version --format '{{.Server.Version}}'预期输出:
<VALUE>实际版本号会因本机 Docker 安装而不同。如果这里直接报无法连接 Docker daemon,应先启动 Docker Desktop 或系统中的 Docker 服务,而不是继续排查 RabbitMQ。
创建带数据卷的 RabbitMQ 节点
management 镜像已经包含管理插件,适合本地学习和管理验证。下面同时固定容器名与 hostname,并把 RabbitMQ 数据目录挂载到命名卷中。
docker volume create rabbitmq-data
docker run -d \
--name rabbitmq-43 \
--hostname rabbitmq-node \
--restart unless-stopped \
-p 5672:5672 \
-p 15672:15672 \
-v rabbitmq-data:/var/lib/rabbitmq \
-e RABBITMQ_DEFAULT_USER=app \
-e RABBITMQ_DEFAULT_PASS=change-me-local \
rabbitmq:4.3-management预期输出:
rabbitmq-data
<ID>第二行是新容器的 ID,实际值不同。4.3-management 会跟随 4.3 系列的补丁更新;需要严格可重复部署时,应改为明确的补丁版本标签。
理解端口与持久化位置
端口映射左侧是宿主机端口,右侧是容器内端口。命名卷则独立于容器生命周期,因此删除容器后,只要没有删除 rabbitmq-data 卷,RabbitMQ 的持久化数据仍然保留。
| 配置 | 容器内用途 | 本机访问方式 |
|---|---|---|
5672:5672 |
AMQP 0-9-1 / AMQP 1.0 客户端连接 | localhost:5672 |
15672:15672 |
Management UI 与 HTTP API | http://localhost:15672 |
rabbitmq-data:/var/lib/rabbitmq |
节点数据目录 | 由 Docker 命名卷保存 |
这里不需要额外执行 rabbitmq-plugins enable rabbitmq_management,因为选择的就是带管理插件的镜像变体。
验证容器与 RabbitMQ 节点
先确认容器处于运行状态,再从容器内部执行 RabbitMQ 的轻量存活检查。
docker ps --filter name=rabbitmq-43 --format '{{.Names}} | {{.Image}} | {{.Status}}'
docker exec rabbitmq-43 rabbitmq-diagnostics -q ping预期输出:
rabbitmq-43 | rabbitmq:4.3-management | Up <TIME>
Ping succeeded<TIME> 表示容器实际运行时长。若容器存在但 ping 失败,先执行 docker logs rabbitmq-43 查看启动日志,重点检查数据目录权限、节点启动失败或资源不足等错误。
验证管理界面
浏览器访问 http://localhost:15672,使用前面设置的 app 与 change-me-local 登录。也可以直接请求 HTTP API,以避免把“网页打不开”和“RabbitMQ 本身没启动”混为一谈。
curl -u app:change-me-local -o /dev/null -s -w "%{http_code}\\n" http://localhost:15672/api/overview预期输出:
200返回 200 说明管理插件、端口映射和账号认证都已生效。若返回 401,优先检查用户名和密码;若连接被拒绝,则检查容器状态以及 15672 是否正确映射。