vimagick/mosquitto

Mosquitto

Mosquitto是一个开源（BSD许可）的消息代理，实现了MQ遥测传输（MQTT）协议版本3.1和3.1.1，支持设备间的消息发布与订阅，广泛应用于物联网（IoT）场景。

核心功能和特性

• 支持MQTT v3.1和v3.1.1协议标准
• 提供TCP/IP网络连接支持
• 集成TLS加密传输，保障数据传输安全
• 支持用户认证机制，通过密码文件管理访问权限
• 消息持久化存储，确保系统重启后消息不丢失
• 轻量级设计，资源占用低，适用于嵌入式设备和服务器环境

使用场景和适用范围

• 物联网设备间通信（如传感器数据上报、智能家居控制）
• 实时数据监控与传输系统
• 分布式应用中的消息传递
• 低带宽、高延迟网络环境下的可靠通信

详细使用方法和配置说明

Docker Compose配置

创建docker-compose.yml文件，配置如下：

yaml
mosquitto:
  image: vimagick/mosquitto
  ports:
    - "1883:1883"  # MQTT默认端口（非加密）
    - "8080:8080"  # WebSocket端口（如需）
    - "8883:8883"  # MQTT TLS加密端口
  volumes:
    - ./data/mosquitto.conf:/etc/mosquitto/mosquitto.conf  # 配置文件挂载
    - ./data/pwfile:/etc/mosquitto/pwfile  # 密码文件挂载
    - ./data:/var/lib/mosquitto  # 持久化数据目录
  restart: always  # 容器自动重启

配置文件说明（mosquitto.conf）

创建./data/mosquitto.conf配置文件，示例配置：

ini
port 1883  # 非加密MQTT端口
log_dest stdout  # 日志输出到标准输出
allow_anonymous false  # 禁用匿名访问
password_file /etc/mosquitto/pwfile  # 指定密码文件路径
persistence true  # 启用消息持久化
persistence_location /var/lib/mosquitto  # 持久化数据存储路径

###### 启用TLS ######
listener 8883  # TLS加密端口
protocol mqtt  # 协议类型
capath /etc/ssl/certs  # CA证书路径（用于验证服务器证书）
certfile /var/lib/mosquitto/fullchain.pem  # 服务器证书文件
keyfile /var/lib/mosquitto/privkey.pem  # 服务器私钥文件
require_certificate false  # 是否要求客户端提供证书

密码文件管理

pwfile通过mosquitto_passwd工具管理，用于添加或修改用户密码。

TLS支持方法

• Let's Encrypt证书：获取免费TLS证书，需配置capath
• 自签名证书：使用openssl生成，需配置cafile

重要提示：自签名CA、服务器和客户端的证书主题参数必须不同。

服务器部署步骤

1. 创建数据目录并设置权限：

   bash
   mkdir -m 777 data
   

2. 创建配置文件和密码文件：

   bash
   touch data/mosquitto.conf data/pwfile
   

3. 编辑配置文件（根据需求修改data/mosquitto.conf）：

   bash
   vi data/mosquitto.conf
   

4. 启动容器：

   bash
   docker-compose up -d
   

5. 进入容器添加用户（替换username和password为实际值）：

   bash
   docker-compose exec mosquitto sh
   >>> cd /etc/mosquitto
   >>> mosquitto_passwd -b pwfile username password
   >>> exit
   

6. 重启容器使配置生效：

   bash
   docker-compose restart
   

7. 查看运行日志：

   bash
   docker-compose logs -f
   

客户端使用示例

订阅消息

bash
mosquitto_sub -d -h 192.168.31.231 -p 8883 --cafile ca.crt --insecure -u username -P password -t hello

• -d：启用调试模式
• -h：MQTT服务器地址
• -p：端口（8883为TLS端口）
• --cafile：CA证书文件路径
• --insecure：忽略证书验证（仅测试用）
• -u/-P：认证用户名/密码
• -t：订阅主题

发布消息

bash
mosquitto_pub -d -h 192.168.31.231 -p 8883 --cafile ca.crt --insecure -u username -P password -t hello -m world

• -m：消息内容