symptoma/activemq 镜像文档

镜像概述和主要用途

本镜像基于 bellsoft/liberica-openjdk-alpine:17 构建，旨在提供轻量级且支持多架构（包括 Apple M1 芯片/aarch64 架构）的 Apache ActiveMQ 容器化部署方案。镜像已发布至 Docker Hub，可直接用于快速部署 ActiveMQ 消息队列服务。

Docker Hub 地址：[***]

核心功能和特性

• 轻量级基础：基于 Alpine Linux，镜像体积小，资源占用低
• 多架构支持：兼容 linux/amd64 和 linux/arm64（如 Apple M1/M2 设备）
• 版本稳定：当前集成 Apache ActiveMQ 5.18.0 版本
• 灵活配置：通过环境变量自定义安全凭证、Web 控制台访问控制等核心参数
• 多协议支持：暴露 MQTT、AMQP、STOMP 等多种消息协议端口
• Web 控制台控制：可配置 Web 控制台监听地址及访问路径

使用场景和适用范围

适用于需要快速部署 ActiveMQ 消息队列服务的场景，包括：

• 开发/测试环境中快速搭建消息代理进行功能验证
• 生产环境中部署轻量级、可定制的 ActiveMQ 服务
• 需多架构支持（如 ARM64 服务器或开发设备）的部署场景
• 需要自定义管理员账户、Web 控制台权限的安全需求场景

快速开始

基础启动命令

通过以下命令快速启动 ActiveMQ 服务，映射默认端口：

bash
docker run -it -p 61616:61616 -p 8161:8161 symptoma/activemq:latest

• 61616：OpenWire 协议端口（ActiveMQ 核心协议）
• 8161：Web 控制台端口

详细配置说明

环境变量配置

可通过以下环境变量控制 ActiveMQ 行为，配置项如下表所示：

暴露端口

容器暴露以下端口，可根据需求映射到主机：

使用示例

带环境变量的启动命令

自定义安全凭证及 Web 控制台配置：

bash
docker run -it \
  -p 61616:61616 \
  -p 8161:8161 \
  -e ACTIVEMQ_USERNAME=myactivemquser \
  -e ACTIVEMQ_PASSWORD=myactivemquserpass \
  -e ACTIVEMQ_WEBADMIN_USERNAME=roos \
  -e ACTIVEMQ_WEBADMIN_PASSWORD=TestTest \
  symptoma/activemq:latest

Docker Compose 配置示例

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  activemq:
    image: symptoma/activemq:latest
    ports:
      - "61616:61616"  # OpenWire
      - "8161:8161"    # Web Console
      - "5672:5672"    # AMQP
      - "1883:1883"    # MQTT
    environment:
      - ACTIVEMQ_USERNAME=appuser
      - ACTIVEMQ_PASSWORD=apppass123
      - ACTIVEMQ_WEBADMIN_USERNAME=admin
      - ACTIVEMQ_WEBADMIN_PASSWORD=admin@123
      - ACTIVEMQ_ENABLE_SCHEDULER=true
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

注意事项

ActiveMQ 版本说明

当前镜像集成的 ActiveMQ 版本为 5.18.0（***下载地址）。

Web 控制台访问限制

自 ActiveMQ 5.16.0 起，Web 控制台默认仅监听容器内 127.0.0.1 地址，导致外部无法访问（详见 AMQ-8018）。本镜像通过默认设置 ACTIVEMQ_WEBCONSOLE_USE_DEFAULT_ADDRESS=false 解决此问题，使 Web 控制台监听 0.0.0.0，允许外部访问。

构建镜像（开发者参考）

本地构建

bash
./build.sh

多架构构建与发布

1. 准备 buildx 构建上下文：

bash
BUILDER_NAME=$(docker buildx create) && docker buildx use $BUILDER_NAME

2. 构建并推送多架构镜像：

bash
# 构建指定版本
docker buildx build --push --platform linux/arm64,linux/amd64 --tag symptoma/activemq:5.18.0 .

# 同时标记为 latest
docker buildx build --push --platform linux/arm64,linux/amd64 --tag symptoma/activemq:latest .