ActiveMQ Docker镜像文档

1. 镜像概述与主要用途

本镜像为ActiveMQ 5.19.0版本的Docker化部署包，基于Islandora-DevOps/isle-buildkit activemq项目构建。ActiveMQ是一款开源的企业级消息代理（Message Broker），支持多种消息协议，提供可靠的异步消息传递能力，适用于分布式系统间的通信解耦。

2. 核心功能与特性

• 多协议支持：兼容MQTT、AMQP、STOMP、OpenWire、WS等多种消息协议，满足不同应用场景需求。
• Web控制台：内置Web管理界面（WebConsole），支持消息队列监控、配置管理等操作。
• 安全认证：可通过环境变量配置用户、密码及角色，支持多用户及分组管理。
• 日志管理：支持常规日志与审计日志分级配置，可通过环境变量调整日志级别。
• 消息持久化：消息存储目录支持卷挂载，确保消息数据持久化。

3. 使用场景与适用范围

• 企业应用集成：作为中间件实现不同系统间的异步消息通信，降低系统耦合度。
• 分布式系统通信：在微服务架构中提供跨服务的可靠消息传递，支持服务解耦与流量削峰。
• IoT设备数据传输：通过MQTT协议接入物联网设备，处理海量设备消息。
• 跨平台消息交互：支持多协议特性，适配Java、Python、Node.js等多语言客户端。

4. 使用方法

4.1 快速启动

通过以下命令可快速启动ActiveMQ实例，默认启用Web控制台（http://localhost:8161），默认登录凭据为admin/password：

bash
docker run --rm -ti -p 8161:8161 islandora/activemq

注意：若未配置凭据（环境变量），将无法登录Web控制台。

4.2 完整部署示例

4.2.1 Docker Run参数说明

bash
docker run -d \
  --name activemq \
  -p 1883:1883 \    # MQTT协议端口
  -p 5672:5672 \    # AMQP协议端口
  -p 8161:8161 \    # Web控制台端口
  -p 61613:61613 \  # STOMP协议端口
  -p 61614:61614 \  # WS协议端口
  -p 61616:61616 \  # OpenWire协议端口
  -v activemq-data:/opt/activemq/data \  # 挂载消息存储卷
  -e ACTIVEMQ_USER=admin \               # 消息服务用户名
  -e ACTIVEMQ_PASSWORD=Secure@123 \      # 消息服务密码
  -e ACTIVEMQ_LOG_LEVEL=DEBUG \          # 日志级别设为DEBUG
  islandora/activemq

4.2.2 Docker Compose配置示例

yaml
version: '3.8'
services:
  activemq:
    image: islandora/activemq
    container_name: activemq
    restart: always
    ports:
      - "8161:8161"   # Web控制台
      - "61616:61616" # OpenWire主力协议
      - "1883:1883"   # MQTT物联网协议
      - "5672:5672"   # AMQP协议
    volumes:
      - activemq-data:/opt/activemq/data  # 持久化消息存储
    environment:
      - ACTIVEMQ_USER=admin
      - ACTIVEMQ_PASSWORD=Secure@123
      - ACTIVEMQ_WEB_ADMIN_PASSWORD=Secure@123  # Web控制台密码
      - ACTIVEMQ_LOG_LEVEL=INFO                 # 常规日志级别
      - ACTIVEMQ_AUDIT_LOG_LEVEL=WARN           # 审计日志级别
volumes:
  activemq-data:  # 定义命名卷，确保数据持久化

5. 配置说明

5.1 端口映射

5.2 卷挂载

5.3 环境变量配置

5.3.1 基础环境变量（默认配置）

5.3.2 额外用户与组配置

可通过环境变量扩展用户、组及Web控制台用户，遵循以下命名规则：

示例：添加Web控制台用户operator（角色viewer）：

bash
-e ACTIVEMQ_WEB_USER_OPERATOR_NAME=operator \
-e ACTIVEMQ_WEB_USER_OPERATOR_PASSWORD=operator123 \
-e ACTIVEMQ_WEB_USER_OPERATOR_ROLES=viewer

6. 日志管理

6.1 日志类型

• 常规日志：记录服务运行状态、连接信息等，通过ACTIVEMQ_LOG_LEVEL控制级别。
• 审计日志：记录用户操作、权限变更等安全相关事件，通过ACTIVEMQ_AUDIT_LOG_LEVEL控制级别。

6.2 日志级别配置

日志级别按优先级从高到低为：OFF > FATAL > ERROR > WARN > INFO > DEBUG > TRACE > ALL。默认级别为INFO，可通过环境变量调整（如设为DEBUG用于问题排查）。

参考链接

• ActiveMQ***文档
• ActiveMQ安全配置
• Web控制台使用指南
• 消息存储机制