zhanyifan1997/rocketmq-console-ng

RocketMQ Console 镜像文档

镜像概述

本镜像为RocketMQ消息队列的管理控制台（rocketmq-console-ng），提供Web界面用于监控和管理RocketMQ集群。支持通过环境变量灵活配置NameServer地址、VIP通道等参数，便于快速部署和集成到RocketMQ集群环境中。

核心功能和特性

• 提供直观的Web界面，支持RocketMQ集群状态监控、主题管理、消费者组管理等功能
• 通过环境变量配置NameServer地址，适配不同集群环境
• 支持设置VIP通道开关，优化网络连接
• 默认暴露8180端口，可通过端口映射灵活调整访问端口

使用场景

• RocketMQ集群的日常监控与管理
• 开发环境中快速搭建RocketMQ管理界面
• 运维场景下查看消息队列状态、排查问题

使用方法

Docker Run 部署

通过docker run命令快速启动控制台：

bash
docker run -e "JAVA_OPTS=-Drocketmq.config.namesrvAddr=127.0.0.1:9876 -Drocketmq.config.isVIPChannel=false" -p 8080:8180 -t styletang/rocketmq-console-ng

参数说明：

• -e "JAVA_OPTS=..."：设置Java环境变量，配置RocketMQ相关参数
  • rocketmq.config.namesrvAddr：指定NameServer地址（格式：ip:port，多个地址用逗号分隔）
  • rocketmq.config.isVIPChannel：是否启用VIP通道（true/false）
• -p 8080:8180：端口映射，将容器内8180端口映射到主机8080端口
• -t styletang/rocketmq-console-ng：指定使用的镜像

Docker Compose 部署

在多容器环境中（如与RocketMQ NameServer联动），可使用docker-compose配置：

yaml
mqconsole:
    image: zhanyifan1997/rocketmq-console-ng
    container_name: mqconsole
    ports:
      - 19876:8180  # 主机端口19876映射到容器8180端口
    environment:
      JAVA_OPTS: -Drocketmq.config.namesrvAddr=mqnamesrv:9876 -Drocketmq.config.isVIPChannel=false
    depends_on:
      - mqnamesrv  # 依赖mqnamesrv服务（需确保mqnamesrv服务已定义）

访问控制台

部署成功后，通过http://主机IP:映射端口访问控制台（如http://127.0.0.1:8080或http://127.0.0.1:19876，具体取决于端口映射配置）。

注意事项

• 镜像来源：示例中使用了styletang/rocketmq-console-ng和zhanyifan1997/rocketmq-console-ng两个镜像，实际使用时需确认镜像版本与兼容性
• NameServer地址配置：需确保配置的NameServer地址可被容器访问（跨容器环境可使用服务名或容器IP）
• 端口冲突：若主机8180端口已被占用，需通过-p参数调整映射端口