liweigo/rocketmq-console-ng

RocketMQ服务及控制台Docker快速部署方案

概述

本方案提供通过docker-compose一键部署RocketMQ消息队列服务及管理控制台的完整流程，包含NameServer（服务注册与发现）、Broker（消息存储与转发）和RocketMQ控制台（可视化管理界面）三个核心组件，适用于快速搭建RocketMQ开发测试环境或小型生产环境。

核心功能与特性

• 完整组件集成：包含RocketMQ核心服务（NameServer、Broker）及官方管理控制台
• 配置自定义：支持通过broker.conf文件自定义Broker集群配置、存储策略等核心参数
• 数据持久化：通过容器卷挂载实现日志和消息数据的持久化存储
• 依赖管理：通过depends_on确保服务启动顺序，保障组件间通信正常
• 资源可控：支持通过环境变量调整JVM内存参数，适应不同环境资源需求

使用场景

• 开发测试环境快速搭建RocketMQ服务
• 学习RocketMQ消息队列的基础使用与配置
• 小型项目的RocketMQ服务部署
• 需要快速验证RocketMQ功能的场景

使用方法

1. 准备配置文件

1.1 创建broker.conf配置文件

创建./data/broker/conf/broker.conf文件，配置内容如下：

shell
# MQ集群名称
brokerClusterName = DefaultCluster

# Broker名称，主从节点使用相同名称
brokerName = broker-master

# 节点角色：0表示Master，大于0表示Slave
brokerId = 0

# 消息删除时间（默认凌晨4点）
deleteWhen = 04

# 消息在磁盘保留时长（小时）
fileReservedTime = 24

# Broker角色：SYNC_MASTER（同步主节点）、ASYNC_MASTER（异步主节点）、SLAVE（从节点）
brokerRole = ASYNC_MASTER

# 刷盘策略：SYNC_FLUSH（同步刷盘）、ASYNC_FLUSH（异步刷盘）
flushDiskType = ASYNC_FLUSH

# Broker所在服务器IP地址（需替换为实际主机IP）
brokerIP1 = 192.168.0.102

注意：brokerIP1需根据实际部署环境替换为主机公网或局域网IP

1.2 创建docker-compose.yml文件

在项目根目录创建docker-compose.yml文件，内容如下：

yaml
services:
  namesrv:
    image: liweigo/rocketmq:4.9.4
    container_name: rmqnamesrv
    ports:
      - 9876:9876  # NameServer默认端口
    volumes:
      - ./data/namesrv/logs:/home/rocketmq/logs  # 日志持久化
    command: sh mqnamesrv  # 启动NameServer命令

  broker:
    image: liweigo/rocketmq:4.9.4
    container_name: rmqbroker
    ports:
      - 10909:10909  # 客户端通信端口
      - 10911:10911  # 主从同步端口
      - 10912:10912  # 高可用端口
    volumes:
      - ./data/broker/logs:/home/rocketmq/logs  # 日志持久化
      - ./data/broker/store:/home/rocketmq/store  # 消息存储持久化
      - ./data/broker/conf/broker.conf:/home/rocketmq/rocketmq-4.9.4/conf/broker.conf  # 配置文件挂载
    environment:
      NAMESRV_ADDR: "namesrv:9876"  # NameServer地址
      JAVA_OPTS: " -Duser.home=/opt"  # Java环境配置
      JAVA_OPT_EXT: "-server -Xms128m -Xmx128m -Xmn128m"  # JVM内存参数
    command: sh mqbroker -n namesrv:9876 -c ../conf/broker.conf  # 启动Broker并指定配置文件
    depends_on:
      - namesrv  # 依赖NameServer服务

  rmqconsole:
    image: liweigo/rocketmq-console-ng
    container_name: rmqconsole
    ports:
      - 18080:8080  # 控制台访问端口
    environment:
        JAVA_OPTS: "-Drocketmq.namesrv.addr=namesrv:9876 -Dcom.rocketmq.sendMessageWithVIPChannel=false"  # 控制台配置
    depends_on:
      - namesrv  # 依赖NameServer服务

2. 启动服务

在docker-compose.yml文件所在目录执行以下命令启动服务：

shell
docker-compose up -d

-d参数表示后台运行容器

3. 验证服务

• NameServer：访问http://localhost:9876，返回RocketMQNameServer表示启动成功
• 控制台：访问http://localhost:18080，通过控制台界面验证Broker状态及消息队列信息

4. 停止服务

在docker-compose.yml文件所在目录执行以下命令停止服务：

shell
docker-compose down

配置说明

broker.conf核心参数说明

docker-compose环境变量说明