moscajs/aedes

Aedes MQTT Broker 镜像文档

镜像概述

Aedes是一个轻量级的MQTT代理(broker)，基于https://github.com/moscajs/aedes%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E6%8F%90%E4%BE%9B%E4%BA%86%E4%BE%BF%E6%8D%B7%E7%9A%84MQTT%E6%B6%88%E6%81%AF%E4%BB%A3%E7%90%86%E6%9C%8D%E5%8A%A1%EF%BC%8C%E6%94%AF%E6%8C%81%E5%A4%9A%E7%A7%8D%E7%A1%AC%E4%BB%B6%E6%9E%B6%E6%9E%84%EF%BC%8C%E5%8F%AF%E9%80%9A%E8%BF%87%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E8%87%AA%E5%AE%9A%E4%B9%89%E5%8A%9F%E8%83%BD%E3%80%82%E5%AE%8C%E6%95%B4%E9%85%8D%E7%BD%AE%E9%80%89%E9%A1%B9%E5%8F%AF%E5%8F%82%E8%80%83https://github.com/moscajs/aedes-cli%E9%A1%B9%E7%9B%AE%E6%96%87%E6%A1%A3%E3%80%82

支持的架构包括：amd64, arm64v8, arm32v6, arm32v7, i386。

核心功能与特性

• 轻量级设计：资源占用低，适合嵌入式设备及服务器环境
• 多架构支持：覆盖主流硬件架构，适配不同部署环境
• 灵活配置：通过配置文件自定义代理行为，支持--config参数加载自定义配置
• 持久化能力：可集成MongoDB等存储服务实现消息持久化
• 易于部署：支持Docker快速部署，可通过容器卷挂载本地配置文件

使用场景

• 物联网(IoT)设备间的消息通信
• 作为消息代理服务连接分布式设备
• 需要轻量级MQTT协议支持的嵌入式系统
• 开发/测试环境中的MQTT协议调试

使用方法

基本使用说明

若需使用本地credentials.json文件或自定义配置文件（通过--config选项），需通过Docker卷将本地包含这些文件的目录挂载到容器内目录。

Docker Run 示例

bash
docker run --rm -it -p 1883:1883 -v $(pwd):/data moscajs/aedes:latest --config /data/myConfig.js

参数说明：

• -v $(pwd):/data：将当前本地目录挂载到容器内/data目录，用于访问本地配置文件
• --config /data/myConfig.js：指定容器内配置文件路径，加载自定义配置
• -p 1883:1883：映射MQTT默认端口1883

Docker Compose 示例（带MongoDB持久化）

以下示例使用MongoDB作为持久化存储，通过Docker Compose部署Aedes：

yml
version: '3.7'
services:
  aedes:
    container_name: aedes
    image: moscajs/aedes:latest
    restart: always
    stop_signal: SIGINT
    networks:
      - mqtt
    command: --config /data/mongodbConfig.js  # 传递Aedes配置选项
    volumes:
      - ./:/data  # 挂载本地目录到容器/data，用于访问配置文件
    ports:
      - '1883:1883'  # MQTT默认端口
      - '3000:3000'  # 可选API端口
      - '4000:4000'  # 可选WebSocket端口
      - '8883:8883'  # 可选SSL端口
  mongo:
    container_name: mongo
    networks:
      - mqtt
    logging:
      driver: none  # 禁用MongoDB日志
    image: mvertes/alpine-mongo
    volumes:
      - db-data:/data/db  # 持久化MongoDB数据
    ports:
      - "27017:27017"  # MongoDB默认端口

volumes:
  db-data:
    name: db-data

networks:
  mqtt:

注意：使用持久化服务（如MongoDB）时，数据库连接URL需使用Docker Compose服务名，例如mongodb://mongo/dbName（其中mongo为MongoDB服务名）。

核心功能与特性

1. 多架构支持：兼容amd64、arm64v8、arm32v6、arm32v7、i386架构，适配不同硬件环境
2. 灵活配置：通过--config选项加载自定义配置文件，支持功能扩展
3. 轻量级设计：资源占用低，适合边缘设备及嵌入式系统
4. 持久化选项：可集成MongoDB等数据库实现消息持久化
5. 协议支持：支持MQTT标准协议，可选WebSocket、SSL等扩展

配置说明

Aedes支持通过配置文件自定义行为，配置选项详情可参考https://github.com/moscajs/aedes-cli%E3%80%82%E4%BD%BF%E7%94%A8%E8%87%AA%E5%AE%9A%E4%B9%89%E9%85%8D%E7%BD%AE%E6%97%B6%EF%BC%8C%E9%9C%80%E7%A1%AE%E4%BF%9D%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E9%80%9A%E8%BF%87%E5%8D%B7%E6%8C%82%E8%BD%BD%E5%88%B0%E5%AE%B9%E5%99%A8%E5%86%85%EF%BC%8C%E5%B9%B6%E9%80%9A%E8%BF%87%60--config%60%E5%8F%82%E6%95%B0%E6%8C%87%E5%AE%9A%E5%AE%B9%E5%99%A8%E5%86%85%E8%B7%AF%E5%BE%84%E3%80%82

使用场景

• 物联网(IoT)设备间的消息通信枢纽
• 分布式系统中的轻量级消息代理服务
• 开发环境中的MQTT协议测试与调试
• 边缘计算场景下的本地消息处理