docker-activemq-jmx 镜像文档

镜像概述和主要用途

这是一个支持远程JMX访问的Apache ActiveMQ消息代理Docker镜像，基于rmohr/activemq构建，集成了hawtio Web控制台。解决了默认ActiveMQ镜像难以进行远程JMX访问的问题，方便用户通过JMX协议监控和管理ActiveMQ实例。

核心功能和特性

• 远程JMX访问支持：允许外部JMX客户端连接，实现对ActiveMQ的远程监控与管理
• 集成hawtio Web控制台：提供直观的Web管理界面，路径为/hawtio
• 多协议支持：内置OPENWIRE、AMQP、STOMP、MQTT等多种消息协议端口
• 环境变量配置：支持通过环境变量自定义关键参数，如RMI服务器主机名、数据存储路径等

使用场景和适用范围

• 需远程监控ActiveMQ消息代理的开发、测试及生产环境
• 通过JMX协议收集ActiveMQ运行指标的监控场景
• 需要使用hawtio Web控制台进行可视化管理的场景
• 与activemq-cli命令行工具配合使用的场景

使用方法和配置说明

基本运行命令

启动容器并映射必要端口：

bash
docker run -p 61616:61616 -p 8161:8161 -p 1099:1099 antonw/activemq-jmx

环境变量说明

端口映射说明

远程JMX访问配置

默认配置下，当JMX客户端与Docker主机均为localhost时可直接访问。若Docker主机为虚拟机或JMX客户端不在localhost，需设置ACTIVEMQ_RMI_SERVER_HOSTNAME为ActiveMQ服务器的外部可访问IP地址，示例：

bash
docker run -e ACTIVEMQ_RMI_SERVER_HOSTNAME='192.168.0.10' -p 61616:61616 -p 8161:8161 -p 1099:1099 antonw/activemq-jmx

与activemq-cli配合使用

activemq-cli是与JMX启用的ActiveMQ交互的命令行工具。当两者在localhost运行时，以下配置可实现连接：

broker {
    local {
        amqurl = "tcp://localhost:61616"
        jmxurl = "service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi"
        username = "amq"
        password = "amq"
        prompt-color = "light-blue" 
    }
}