AMQP网关 Docker镜像文档

镜像概述

AMQP网关是基于AMQP（Advanced Message Queuing Protocol）协议的消息网关服务，旨在作为消息中间件的桥梁，实现不同服务、系统间的消息路由、转换与集成。该镜像封装了AMQP网关核心功能，提供轻量级、可扩展的部署方式，简化分布式架构中消息流转的管理与控制。

核心功能和特性

主要功能

• 消息路由：支持基于交换机、队列、路由键等规则的消息转发，可配置静态路由或动态路由策略。
• 协议转换：实现AMQP与HTTP、MQTT等其他协议的双向转换，支持跨协议消息通信。
• 消息处理：提供消息过滤（基于内容或属性筛选消息）、格式转换（JSON/XML/二进制等格式互转）、数据脱敏等功能。
• 流量控制：支持消息限流、熔断、重试机制，保障系统稳定性。
• 负载均衡：自动将消息分发至多个消费者实例，实现负载分担。

关键特性

• 高可用性：支持集群部署，通过主从或分布式架构保障服务持续可用。
• 低延迟：轻量级设计，消息转发延迟低，适合实时性要求高的场景。
• 可配置性：通过环境变量、配置文件或API动态调整路由规则与系统参数。
• 监控集成：支持Prometheus、Grafana等监控工具，暴露消息吞吐量、延迟、错误率等指标。
• 日志审计：记录消息流转日志，支持日志分级与输出至文件/第三方日志系统。

使用场景和适用范围

典型使用场景

• 微服务通信：作为微服务架构中的消息枢纽，连接不同服务实例，实现松耦合通信。
• 跨系统集成：桥接不同技术栈的系统（如Java服务、Python服务、 legacy系统），统一消息交互标准。
• 流量治理：在高并发场景下控制消息流量，避免下游服务过载。
• 协议适配：为不原生支持AMQP的服务（如HTTP API）提供AMQP协议接入能力。
• 消息追溯：通过日志与监控，追踪消息从生产者到消费者的完整路径。

适用范围

• 基于AMQP协议的消息中间件（如RabbitMQ、Apache Qpid）环境。
• 微服务、分布式系统架构。
• 需要跨协议、跨系统消息集成的业务场景。
• 对消息可靠性、可观测性有较高要求的应用。

使用方法和配置说明

前置条件

• 已安装Docker Engine（20.10+）或Docker Desktop。
• 已部署AMQP消息服务器（如RabbitMQ），并获取连接地址、端口、认证信息。

Docker快速部署

基础部署（docker run）

docker run -d \
  --name amqp-gateway \
  -p 5672:5672 \  # AMQP服务端口
  -p 8080:8080 \  # 管理API/监控端口
  -e AMQP_HOST=rabbitmq-server \  # AMQP服务器地址
  -e AMQP_PORT=5672 \             # AMQP服务器端口
  -e AMQP_USER=guest \            # AMQP认证用户名
  -e AMQP_PASSWORD=guest \        # AMQP认证密码
  -e ROUTE_CONFIG=/etc/gateway/routes.yaml \  # 路由规则配置文件路径
  -v ./routes.yaml:/etc/gateway/routes.yaml \  # 挂载路由规则配置文件
  amqp-gateway:latest

docker-compose部署

version: '3.8'
services:
  amqp-gateway:
    image: amqp-gateway:latest
    container_name: amqp-gateway
    ports:
      - "5672:5672"  # AMQP服务端口
      - "8080:8080"  # 管理API端口
    environment:
      - AMQP_HOST=rabbitmq  # 关联RabbitMQ服务名（需在同一网络）
      - AMQP_PORT=5672
      - AMQP_USER=admin
      - AMQP_PASSWORD=admin123
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error
      - MAX_CONCURRENT=1000  # 最大并发消息处理数
    volumes:
      - ./routes.yaml:/etc/gateway/routes.yaml  # 路由规则配置
      - ./logs:/var/log/amqp-gateway  # 日志持久化
    depends_on:
      - rabbitmq
    restart: unless-stopped

  rabbitmq:
    image: rabbitmq:3-management
    container_name: rabbitmq
    ports:
      - "5672:5672"
      - "15672:15672"  # RabbitMQ管理界面
    environment:
      - RABBITMQ_DEFAULT_USER=admin
      - RABBITMQ_DEFAULT_PASS=admin123
    volumes:
      - rabbitmq-data:/var/lib/rabbitmq

volumes:
  rabbitmq-data:

配置说明

环境变量配置

路由规则配置文件示例（routes.yaml）

routes:
  - name: "order-service-route"  # 路由名称
    source:                      # 消息来源
      exchange: "order.exchange" # 源交换机
      routingKey: "order.created" # 源路由键
      queue: "order.queue"       # 绑定的源队列（可选）
    destination:                 # 消息目标
      exchange: "shipping.exchange" # 目标交换机
      routingKey: "shipping.request" # 目标路由键
    filters:                     # 消息过滤规则（可选）
      - type: "header"           # 基于消息头过滤
        key: "priority"
        operator: "gte"          # 大于等于
        value: 2
    transform:                   # 消息转换规则（可选）
      type: "json"               # JSON格式转换
      operations:
        - action: "add"          # 添加字段
          path: "$.timestamp"
          value: "{{timestamp}}" # 使用当前时间戳
        - action: "remove"       # 删除字段
          path: "$.internal_id"

验证部署

1. 启动容器后，通过管理API检查服务状态：

   curl http://localhost:8080/health
   

   预期返回：{"status":"UP"}

2. 发送测试消息至源交换机，检查目标队列是否接收到消息。

注意事项

• 路由规则配置文件需确保格式正确，否则可能导致网关启动失败。
• 高并发场景下建议调整MAX_CONCURRENT参数，并配置资源限制（如Docker内存、CPU限制）。
• 生产环境中建议启用TLS加密（通过环境变量AMQP_TLS_ENABLE=true及相关证书配置）。
• 集群部署时需确保路由规则在各节点间同步，避免消息路由不一致。