mochimqtt/server

mochi-mqtt/server 镜像文档

概述

mochi-mqtt/server 是一个用 Go 语言开发的高性能 MQTT v5 服务器，完全符合 MQTT v5 规范。该服务器设计为轻量级且可嵌入，具备出色的性能和可扩展性，适用于物联网（IoT）、智能家居、实时数据发布订阅等场景，提供可靠的消息传输服务。

核心功能与特性

• MQTT v5 完全兼容：全面支持 MQTT v5 协议规范，包括会话过期、消息属性、主题别名等新特性，同时向下兼容 MQTT v3.1.1。
• 高性能：基于 Go 语言并发模型，实现高吞吐量和低延迟消息处理，支持大规模并发连接。
• 可嵌入性：提供 Go 语言 API，可无缝集成到现有 Go 应用中，无需独立部署服务器实例。
• 多传输协议支持：原生支持 TCP、WebSocket 传输，可通过配置启用 TLS/SSL 加密通信。
• 可扩展插件系统：支持通过插件扩展功能，包括认证授权、消息持久化、钩子回调等。
• 轻量级设计：资源占用低，适合在嵌入式设备或资源受限环境中部署运行。
• 安全机制：支持 TLS/SSL 加密、客户端证书认证、用户名/密码认证等安全策略。

使用场景

• 物联网设备通信：连接各类 IoT 传感器与执行设备，实现设备间实时数据交互。
• 智能家居系统：支持智能家电、安防设备等的状态同步与远程控制。
• 实时数据发布订阅：用于监控系统、日志收集、实时通知等场景的消息传输。
• 嵌入式系统集成：作为嵌入式设备本地消息中枢，处理设备本地通信需求。
• 微服务通信：在分布式系统中作为轻量级消息中间件，实现服务间异步通信。

使用方法

基本 Docker 运行

启动默认配置的 MQTT 服务器，监听 TCP 端口 1883：

bash
docker run -d -p 1883:1883 --name mochi-mqtt-server mochi-mqtt/server

自定义配置文件挂载

将本地配置文件挂载到容器中实现自定义配置：

bash
docker run -d \
  -p 1883:1883 \
  -v /path/to/local/config.yaml:/etc/mochi-mqtt/config.yaml \
  --name mochi-mqtt-server \
  mochi-mqtt/server

Docker Compose 配置

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  mochi-mqtt:
    image: mochi-mqtt/server
    ports:
      - "1883:1883"  # TCP 端口
      - "8883:8883"  # TLS 端口（若启用）
      - "8080:8080"  # WebSocket 端口（若启用）
    volumes:
      - ./config.yaml:/etc/mochi-mqtt/config.yaml
      - ./certs:/etc/mochi-mqtt/certs  # TLS 证书目录（若启用）
      - ./data:/var/lib/mochi-mqtt     # 持久化数据目录
    environment:
      - LOG_LEVEL=info
      - MAX_CONNECTIONS=10000
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

配置参数

环境变量配置

配置文件示例

完整 config.yaml 配置示例：

yaml
listeners:
  tcp:
    addr: ":1883"
    enabled: true
    read_buffer_size: 4096
    write_buffer_size: 4096
  websocket:
    addr: ":8080"
    path: "/mqtt"
    enabled: true
  tls:
    addr: ":8883"
    cert_file: "/etc/mochi-mqtt/certs/server.crt"
    key_file: "/etc/mochi-mqtt/certs/server.key"
    enabled: true

persistence:
  type: "file"
  dir: "/var/lib/mochi-mqtt"
  clean_interval: "30s"

auth:
  allow_anonymous: false
  password_file: "/etc/mochi-mqtt/passwd"  # 格式：username:hashed_password

plugins:
  - name: "metrics"
    path: "/etc/mochi-mqtt/plugins/metrics.so"

注意事项

• 启用 TLS 时需确保证书文件正确挂载到容器内指定路径
• 高并发场景下建议调整系统文件描述符限制（ulimit -n）
• 更多配置细节请参考 https://github.com/mochi-mqtt/server