frodenas/rabbitmq

RabbitMQ Docker镜像文档

镜像概述和主要用途

本Docker镜像用于部署RabbitMQ消息队列系统。RabbitMQ是一个开源的消息代理，实现了高级消息队列协议(AMQP)，支持多种消息传递模式，适用于分布式系统中服务间的异步通信。

核心功能和特性

• 基于RabbitMQ构建，提供可靠的消息传递能力
• 支持标准AMQP协议，兼容多种客户端
• 可选暴露RabbitMQ Management管理界面（端口***）
• 自动生成随机用户凭据（首次运行时）
• 支持通过环境变量自定义用户凭据

RabbitMQ版本

master分支当前包含RabbitMQ 3.3版本。其他版本可在GitHub仓库的https://github.com/frodenas/docker-rabbitmq/branches%E4%B8%AD%E6%89%BE%E5%88%B0%E3%80%82

使用场景和适用范围

• 分布式系统中的服务间异步通信
• 微服务架构下的消息传递
• 需要可靠消息队列的应用场景
• 开发和测试环境的快速部署

使用方法和配置说明

构建镜像

在docker-rabbitmq目录下执行以下命令，创建frodenas/rabbitmq镜像：

bash
$ docker build -t frodenas/rabbitmq .

运行镜像

基本运行（仅消息队列功能）

运行容器并绑定主机5672端口（RabbitMQ默认端口）：

bash
$ docker run -d --name rabbitmq -p 5672:5672 frodenas/rabbitmq

运行并暴露管理界面

如需使用RabbitMQ Management管理界面，需额外暴露***端口：

bash
$ docker run -d --name rabbitmq -p 5672:5672 -p 15672:15672 frodenas/rabbitmq

凭据管理

随机生成凭据

首次运行容器时，会自动创建用户rabbitmq（拥有所有权限）并生成随机密码。通过以下命令查看密码：

bash
docker logs <CONTAINER_ID>

日志输出示例：

========================================================================
RabbitMQ User: "rabbitmq"
RabbitMQ Password: "8psfzXmp6t23rKr6"
========================================================================

自定义凭据

通过环境变量预设用户名和密码：

• RABBITMQ_USERNAME: 设置自定义用户名
• RABBITMQ_PASSWORD: 设置自定义密码

示例（使用自定义凭据运行）：

bash
$ docker run -d \
    --name rabbitmq \
    -p 5672:5672 \
    -e RABBITMQ_USERNAME=myusername \
    -e RABBITMQ_PASSWORD=mypassword \
    frodenas/rabbitmq

版权信息

版权所有 (c) 2014 Ferran Rodenas。详情参见https://github.com/frodenas/docker-rabbitmq/blob/master/LICENSE%E3%80%82