bytebeamio/rumqttd

rumqttd

镜像概述

rumqttd是一款用Rust编写的高性能MQTT代理，具有轻量级和可嵌入特性，允许将其作为库在代码中使用并扩展功能。

核心功能和特性

• 高性能：基于Rust构建，提供高效的消息处理能力
• 轻量级：资源占用低，适合资源受限环境
• 可嵌入：支持作为库集成到应用程序中，扩展自定义功能
• 灵活配置：通过TOML配置文件自定义代理行为
• TLS支持：提供安全的MQTT连接加密

使用场景和适用范围

• 物联网(IoT)设备消息通信
• 嵌入式系统中的消息代理
• 需要轻量级消息中间件的应用
• 自定义消息处理逻辑的场景
• 对性能和资源占用有要求的MQTT部署

快速链接

• GitHub仓库：https://github.com/bytebeamio/rumqtt
• 问题反馈：https://github.com/bytebeamio/rumqtt/issues/new

使用方法和配置说明

拉取镜像

bash
docker pull bytebeamio/rumqttd

基本使用

使用默认配置文件demo.toml并暴露必要端口：

bash
docker run -p 1883:1883 -p 1884:1884 -it bytebeamio/rumqttd -c demo.toml

挂载自定义配置

将本地配置目录挂载为卷并使用自定义配置文件：

bash
docker run -v /path/to/configs:/configs -p 1883:1883 -it bytebeamio/rumqttd -c /configs/config.toml

TLS配置

生成证书

使用https://github.com/bytebeamio/provision%E5%B7%A5%E5%85%B7%E7%94%9F%E6%88%90%E6%89%80%E9%9C%80%E8%AF%81%E4%B9%A6%EF%BC%9A

bash
# 生成CA证书
provision ca  # 生成ca.cert.pem和ca.key.pem

# 生成服务器证书
provision server --ca ca.cert.pem --cakey ca.key.pem --domain localhost  # 生成localhost.cert.pem和localhost.key.pem

# 生成客户端证书
provision client --ca ca.cert.pem --cakey ca.key.pem --device 1 --tenant a  # 生成1.cert.pem和1.key.pem

也可使用https://github.com/minio/certgen%E3%80%81https://github.com/rabbitmq/tls-gen%E6%88%96openssl%E7%94%9F%E6%88%90%E8%87%AA%E7%AD%BE%E5%90%8D%E8%AF%81%E4%B9%A6%EF%BC%8C%E4%BD%86%E6%8E%A8%E8%8D%90%E4%BD%BF%E7%94%A8provision%E3%80%82

配置TLS

更新配置文件（确保证书路径在Docker容器中可访问）：

toml
[v4.2.tls]
    certpath = "path/to/localhost.cert.pem"  # 服务器证书路径
    keypath = "path/to/localhost.key.pem"    # 服务器私钥路径
    capath = "path/to/ca.cert.pem"          # CA证书路径

运行TLS配置的容器

挂载证书目录和配置文件：

bash
docker run -v /path/to/certificates:/certs -v /path/to/configs:/configs -p 8883:8883 -it bytebeamio/rumqttd -c /configs/tls_config.toml

注意：确保配置文件中使用证书的绝对路径，并且证书目录已正确挂载到Docker容器中。