中间件 - Wizard Doc

最后修改人	孙荣利
最后修改时间	2026-10-03 15:28:00
创建人	孙荣利
创建时间	2026-10-03 15:28:00

该文档由孙荣利创建于 2026-10-03 15:28:00 ，孙荣利在 2026-10-03 15:28:00 修改了该文档。

[TOCM]

## 一、简介

```text
EMQX 是一个开源的高性能 MQTT 消息服务器（企业版），专为物联网（IoT）海量设备接入而设计，支持 MQTT 3.1/3.1.1/5.0 协议，提供设备接入、消息路由、规则引擎、数据桥接等能力。

本文记录 EMQX Enterprise 6.2.0 基于 docker-compose 的部署步骤，端口全部使用宿主机映射（21883/28083/28883/28084/18083）。
```

## 二、安装部署

#### 1. 目录结构

```shell
/data/emqx
├── data        # 数据持久化目录（消息、会话、内置配置等）
├── log         # 日志目录
└── docker-compose.yml
```

#### 2. 目录准备

```shell
# 创建部署目录
mkdir -p /data/emqx
mkdir -p /data/emqx/data
mkdir -p /data/emqx/log
cd /data/emqx

# 目录授权（注意：对 /data 整目录 chmod -R 777 会放开该目录下所有文件的权限，存在安全隐患；
# 建议只对本次部署的 data、log 子目录授权，即下面两行即可）
chmod -R 777 /data
chmod -R 777 log

# 创建编排文件
touch docker-compose.yml
```

#### 3. docker-compose.yml

```yaml
services:  # 服务定义
  emqx-enterprise:  # EMQX 企业版服务
    image: repo.358369.xyz/emqx/emqx-enterprise:6.2.0  # 私有仓库镜像（EMQX Enterprise 6.2.0）
    container_name: emqx-enterprises  # 容器名称
    restart: always  # 容器异常退出/主机重启后自动拉起
    ports:  # 端口映射（宿主机端口:容器端口）
      # MQTT TCP 端口
      - "21883:1883"  # 宿主机 21883 → 容器 1883（MQTT 标准 TCP 端口）
      # MQTT/WS 端口
      - "28083:8083"  # 宿主机 28083 → 容器 8083（MQTT over WebSocket）
      # MQTT/SSL 端口
      - "28883:8883"  # 宿主机 28883 → 容器 8883（MQTT over TLS/SSL）
      # MQTT/WSS 端口
      - "28084:8084"  # 宿主机 28084 → 容器 8084（MQTT over WSS）
      # Dashboard HTTP 管理后台
      - "18083:18083"  # Dashboard 管理后台端口（http://宿主机IP:18083）
    volumes:  # 数据卷挂载
      # 数据持久化
      - ./data:/opt/emqx/data  # 宿主机 ./data → 容器数据目录（消息/会话/配置持久化）
      # 日志持久化
      - ./log:/opt/emqx/log  # 宿主机 ./log → 容器日志目录（日志持久化）
      # 自定义配置文件挂载（可选）
      # - ./emqx/etc:/opt/emqx/etc  # 挂载自定义配置目录（按需启用）
    environment:  # 环境变量
      # EMQX 节点名称
      - EMQX_NODE_NAME=emqx@127.0.0.1  # 节点名称（集群内唯一标识，生产建议改为实际主机名/IP）
      # 控制台默认用户名
      - EMQX_DASHBOARD__DEFAULT_USERNAME=admin  # Dashboard 登录用户名
      # 控制台默认密码（建议自行修改）
      - EMQX_DASHBOARD__DEFAULT_PASSWORD=passwd  # Dashboard 登录密码（生产环境务必修改）
    networks:  # 容器网络
      - emqx_net  # 加入自定义网络
networks:  # 网络声明
  emqx_net:  # 自定义网络名称
    driver: bridge  # 桥接网络驱动
```

#### 4. 启动服务

```shell
# 启动 EMQX 容器（-d 后台运行）
docker compose up -d

# 查看容器运行状态
docker compose ps

# 实时查看日志
docker compose logs -f
```

#### 5. 访问与验证

```shell
# Dashboard 管理后台（默认账号 admin / passwd，生产建议修改密码）
http://<服务器IP>:18083

# MQTT 连接测试（客户端连宿主机 21883 端口）
mosquitto_pub -h <服务器IP> -p 21883 -t test -m hello
```