Fedora RabbitMQ Docker镜像文档

1. 镜像概述和主要用途

本镜像基于Fedora操作系统构建，用于快速部署RabbitMQ消息队列服务。镜像内置用户管理机制，自动创建admin用户并分配随机密码（密码需通过容器日志获取），支持默认端口映射及管理插件，可直接用于消息队列服务的搭建与测试。

2. 核心功能和特性

• 基础环境：基于Fedora操作系统，提供稳定的运行环境
• 用户管理：自动创建admin用户，密码随机生成（通过容器日志查看）
• 端口暴露：默认开放RabbitMQ核心端口
  • 5672：AMQP协议通信端口（消息队列服务端口）
  • ***：Web管理界面端口（集成RabbitMQ管理插件）
• 即开即用：内置必要插件，启动后自动完成服务初始化，无需额外配置

3. 使用场景和适用范围

• 开发环境中快速搭建RabbitMQ服务进行功能验证
• 测试环境中部署消息队列服务，用于应用集成测试
• 临时场景下需要快速启动RabbitMQ服务的场景（如演示、本地调试）

4. 使用方法和配置说明

4.1 构建镜像

从源码构建镜像的步骤如下：

bash
# 克隆或下载镜像源码后，进入源码目录执行构建命令
docker build --rm -t <username>/rabbitmq .

参数说明：

• --rm：构建过程中自动删除临时容器
• -t <username>/rabbitmq：指定镜像标签（<username>替换为实际Docker用户名）

4.2 运行容器

通过以下命令启动RabbitMQ容器，映射默认端口：

bash
docker run -d -p 5672:5672 -p ***:*** <username>/rabbitmq

参数说明：

• -d：后台运行容器
• -p 5672:5672：映射AMQP协议端口（宿主机端口:容器端口）
• -p ***:***：映射Web管理界面端口

4.3 确认服务启动

通过容器日志验证RabbitMQ是否成功启动：

bash
docker logs <container_id>  # <container_id>替换为实际容器ID

成功启动日志示例：

            RabbitMQ 3.1.5. Copyright (C) 2007-2013 GoPivotal, Inc.
##  ##      Licensed under the MPL.  See [***]
##  ##
##########  Logs: /var/log/rabbitmq/rabbit@<container_id>.log
######  ##        /var/log/rabbitmq/rabbit@<container_id>-sasl.log
##########
              Starting broker... completed with 6 plugins.

4.4 查看端口映射

通过docker ps命令确认容器端口映射状态：

bash
docker ps

输出示例（包含端口映射信息）：

CONTAINER ID        IMAGE                      COMMAND                CREATED             STATUS              PORTS                                              NAMES
01ad9b20d68e        <username>/rabbitmq        /usr/sbin/rabbitmq-s   9 minutes ago       Up 9 minutes        0.0.0.0:***->***/tcp, 0.0.0.0:5672->5672/tcp   <container_name>

4.5 测试连接

通过rabbitmqadmin工具测试服务连接，步骤如下：

1. 从Web管理界面下载工具：

   bash
   wget localhost:***/cli/rabbitmqadmin
   

2. 赋予执行权限：

   bash
   chmod +x rabbitmqadmin
   

3. 查看用户列表（验证服务可用性）：

   bash
   ./rabbitmqadmin list users
   

   输出示例（默认包含guest用户）：

   +-------+------------------------------+---------------+
   | name  |        password_hash         |     tags      |
   +-------+------------------------------+---------------+
   | guest | CkDOzIkuFmtJNeg2AL6T1LiUfmQ= | administrator |
   +-------+------------------------------+---------------+
   

5. 注意事项

• 用户密码获取：admin用户随机密码需通过容器日志查看（执行docker logs <container_id>）。
• 端口冲突处理：若宿主机5672/***端口已被占用，启动容器时需修改端口映射（如-p 5673:5672）。
• 安全建议：生产环境中建议自定义admin用户密码，并限制端口访问权限。