antonw/activemq-jmx

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 docker.xuanyuan.run/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 docker.xuanyuan.run/antonw/activemq-jmx

与activemq-cli配合使用

https://github.com/antonwierenga/activemq-cli%E6%98%AF%E4%B8%8EJMX%E5%90%AF%E7%94%A8%E7%9A%84ActiveMQ%E4%BA%A4%E4%BA%92%E7%9A%84%E5%91%BD%E4%BB%A4%E8%A1%8C%E5%B7%A5%E5%85%B7%E3%80%82%E5%BD%93%E4%B8%A4%E8%80%85%E5%9C%A8localhost%E8%BF%90%E8%A1%8C%E6%97%B6%EF%BC%8C%E4%BB%A5%E4%B8%8B%E9%85%8D%E7%BD%AE%E5%8F%AF%E5%AE%9E%E7%8E%B0%E8%BF%9E%E6%8E%A5%EF%BC%9A

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