sheepyu/rocketmq

sheepyu/rocketmq 镜像文档

镜像概述

sheepyu/rocketmq是一个简化配置的RocketMQ Docker镜像，内置Dashboard管理界面，具有体积极小、内存占用低、运行简便等特点。镜像标签版本与RocketMQ版本对应（如标签4.9.8对应RocketMQ 4.9.8版本），适用于快速部署RocketMQ服务。

核心功能与特性

• 内置Dashboard：集成管理界面，无需额外部署，通过8080端口访问
• 简化配置：无需复杂的配置文件修改，通过环境变量即可完成基础配置
• 轻量级：体积极小，内存占用低，资源消耗少
• 快速部署：支持单命令启动，也可通过docker-compose实现完整配置

使用场景

• 开发测试环境快速搭建RocketMQ服务
• 小型生产环境的消息队列部署
• 需要快速验证RocketMQ功能的场景

使用方法

极简运行

通过以下命令可快速启动RocketMQ服务：

bash
docker run -d \
-p 8080:8080 \ 
-p 9876:9876 \
-p 10909:10909 \
-p 10911:10911 \
-p 10912:10912 \
-e BROKER_IP=宿主机IP \ 
docker.xuanyuan.run/sheepyu/rocketmq:4.9.8

端口说明：

• 8080：Dashboard管理界面端口
• 9876：Namesrv服务端口
• 、、***：Broker服务端口

环境变量：

• BROKER_IP：必填，需设置为宿主机IP，否则外部程序无法访问RocketMQ服务

完整配置（docker-compose）

通过docker-compose可实现数据持久化和配置自定义，示例配置如下：

yaml
version: '3'
services:
  rocketmq:
    image: docker.xuanyuan.run/sheepyu/rocketmq:4.9.8
    container_name: rocketmq
    restart: always
    ports:
      - 9876:9876
      - 10909:10909
      - 10911:10911
      - 10912:10912
      - 18080:8080  # 可修改宿主机端口映射
    volumes:
      - ./rocketmqlogs:/root/logs  # 日志目录挂载
      - ./rocketmqstore:/root/store  # 数据存储目录挂载
      - ./broker.conf:/root/rocketmq-4.9.8/conf/broker.conf  # 自定义broker配置
    environment:
      - BROKER_IP=宿主机IP

卷挂载说明：

• ./rocketmqlogs:/root/logs：存储Dashboard、Namesrv和Broker的日志
• ./rocketmqstore:/root/store：存储Broker的数据文件
• ./broker.conf:/root/rocketmq-4.9.8/conf/broker.conf：挂载自定义的broker配置文件，实现高级配置

配置说明

自定义broker.conf

如需自定义Broker配置，可创建broker.conf文件并挂载，配置项参考RocketMQ官方文档，常用配置包括：

• brokerName：Broker名称
• namesrvAddr：Namesrv地址
• storePathRootDir：数据存储根目录
• storePathCommitLog：提交日志存储路径

访问Dashboard

服务启动后，通过http://宿主机IP:8080访问Dashboard管理界面，可查看集群状态、消息统计等信息。