qdonl/rocketmq

RocketMQ Docker镜像文档

镜像概述

本镜像基于Alpine系统构建，包含RocketMQ 4.9.4版本的核心组件（NameServer、Broker）及4.5.0版本的管理控制台，提供开箱即用的消息队列服务部署方案，适用于快速搭建分布式消息传递系统。

核心功能与特性

• NameServer：提供服务发现与路由功能，维护Broker集群元数据
• Broker：消息存储与转发核心组件，支持同步/异步刷盘、主从架构
• 管理控制台：Web可视化界面，支持集群监控、消息查询、配置管理
• 轻量级基础：基于Alpine系统，镜像体积小，资源占用低
• 灵活配置：支持通过挂载配置文件自定义Broker参数

使用场景

• 分布式系统中的异步通信与服务解耦
• 高并发场景下的流量削峰与缓冲
• 微服务架构中的跨服务消息传递
• 日志收集、数据同步等异步处理场景

使用方法

前提条件

• 已安装Docker Engine（20.10+）
• 已安装Docker Compose（2.0+）

部署步骤

1. 准备项目目录结构

bash
mkdir -p rocketmq-demo/{conf,console/data}
cd rocketmq-demo

2. 创建Broker配置文件

在conf目录下创建broker.conf：

conf
brokerClusterName = DefaultCluster
brokerName = broker-b
brokerId = 0
deleteWhen = 04
fileReservedTime = 48
brokerRole = ASYNC_MASTER
flushDiskType = ASYNC_FLUSH
# 替换为实际服务器IP地址
brokerIP1=你的服务器IP地址

3. 创建Docker Compose配置

在项目根目录创建docker-compose.yaml：

yaml
version: '3'
services:
  namesrv:
    image: qdonl/rocketmq:4.9.4-alpine
    container_name: rmqnamesrv
    ports:
      - 9876:9876  # NameServer默认端口
    command: sh mqnamesrv  # 启动NameServer服务

  broker:
    image: qdonl/rocketmq:4.9.4-alpine
    container_name: rmqbroker
    ports:
      - 10909:10909  # 客户端通信端口
      - 10911:10911  # 主从同步端口
      - 10912:10912  # 控制台端口
    volumes:
      - ./conf/broker.conf:/home/rocketmq/rocketmq-4.9.4/conf/broker.conf  # 挂载自定义配置
    command: sh mqbroker -n namesrv:9876 -c /home/rocketmq/rocketmq-4.9.4/conf/broker.conf  # 启动Broker并指定NameServer地址
    depends_on:
      - namesrv  # 依赖NameServer服务

  mqconsole:
    image: qdonl/rocketmq-console:4.5.0
    container_name: rmqconsole
    volumes:
      - ./console/data:/tmp/rocketmq-console/data  # 控制台数据持久化
    ports:
      - 9300:8080  # 控制台Web端口
    environment:
      JAVA_OPTS: -Drocketmq.config.namesrvAddr=namesrv:9876 -Drocketmq.config.isVIPChannel=false  # 配置NameServer地址及VIP通道
    depends_on:
      - namesrv  # 依赖NameServer服务

4. 启动服务

bash
docker-compose up -d

5. 验证部署

• NameServer：访问 http://服务器IP:9876，返回rocketmq-nameserver即正常
• 控制台：访问 http://服务器IP:9300，可查看集群状态和消息数据

配置说明

Broker核心配置参数（broker.conf）

控制台环境变量

停止服务

bash
docker-compose down