Docker 部署指南

本章节将指导您使用官方 Docker 镜像快速安装和运行 EMQX，并使用 Docker Compose 实现集群搭建。

Docker 部署注意事项

  1. 如需保留数据，请将 EMQX 数据目录 /opt/emqx/data 挂载在容器外部，这样即使容器被删除数据也不会丢失。

  2. Docker 内的 localhost 或 127.0.0.1 指向的是容器内部地址，如需访问宿主机地址请使用宿主机的真实 IP 或使用 host 网络模式Docker 部署指南 - 图1 (opens new window)。如果您使用的是 Docker for Mac 或 Docker for Windows，可以使用 host.docker.internal 作为宿主机地址。

通过 Docker 运行单个 EMQX 节点

本节主要介绍如何通过 Docker 镜像安装最新版本的 EMQX，如希望体验其他版本，可以前往 EMQX 下载页面Docker 部署指南 - 图2 (opens new window)。

  1. 运行以下命令获取 Docker 镜像：
  1. docker pull emqx/emqx:5.1.0
  1. 运行以下命令启动 Docker 容器
  1. docker run -d --name emqx -p 1883:1883 -p 8083:8083 -p 8084:8084 -p 8883:8883 -p 18083:18083 emqx/emqx:5.1.0

有关 EMQX 官方镜像的更多信息，请查看 Docker Hub - emqxDocker 部署指南 - 图3 (opens new window)。

通过 Docker Compose 构建 EMQX 集群

Docker Compose 是一个用于编排和运行多容器的工具，下面将指导您通过 Docker Compose 创建简单的 EMQX 静态集群。

提示

目前 Docker Compose 已经包含在 Docker 安装包中无需单独安装，如果您的 Docker 中没有包含 Compose 请参考 Install Docker ComposeDocker 部署指南 - 图4 (opens new window) 进行安装。

  1. 在任意目录创建 docker-compose.yml 文件，内容如下：
  1. version: '3'
  3. services:
  4.   emqx1:
  5.     image: emqx:5.1.0
  6.     container_name: emqx1
  7.     environment:
  8.     - "EMQX_NODE_NAME=emqx@node1.emqx.io"
  9.     - "EMQX_CLUSTER__DISCOVERY_STRATEGY=static"
  10.     - "EMQX_CLUSTER__STATIC__SEEDS=[emqx@node1.emqx.io,emqx@node2.emqx.io]"
  11.     healthcheck:
  12.       test: ["CMD", "/opt/emqx/bin/emqx_ctl", "status"]
  13.       interval: 5s
  14.       timeout: 25s
  15.       retries: 5
  16.     networks:
  17.       emqx-bridge:
  18.         aliases:
  19.         - node1.emqx.io
  20.     ports:
  21.       - 1883:1883
  22.       - 8083:8083
  23.       - 8084:8084
  24.       - 8883:8883
  25.       - 18083:18083 
  26.     # volumes:
  27.     #   - $PWD/emqx1_data:/opt/emqx/data
  29.   emqx2:
  30.     image: emqx:5.1.0
  31.     container_name: emqx2
  32.     environment:
  33.     - "EMQX_NODE_NAME=emqx@node2.emqx.io"
  34.     - "EMQX_CLUSTER__DISCOVERY_STRATEGY=static"
  35.     - "EMQX_CLUSTER__STATIC__SEEDS=[emqx@node1.emqx.io,emqx@node2.emqx.io]"
  36.     healthcheck:
  37.       test: ["CMD", "/opt/emqx/bin/emqx_ctl", "status"]
  38.       interval: 5s
  39.       timeout: 25s
  40.       retries: 5
  41.     networks:
  42.       emqx-bridge:
  43.         aliases:
  44.         - node2.emqx.io
  45.     # volumes:
  46.     #   - $PWD/emqx2_data:/opt/emqx/data
  48. networks:
  49.   emqx-bridge:
  50.     driver: bridge
  1. 通过命令行切换 docker-compose.yml 文件所在目录，然后输入以下命令启动 EMQX 集群：
  1. docker-compose up -d
  1. 查看集群状态
  1. $ docker exec -it emqx1 sh -c "emqx_ctl cluster status"
  2. Cluster status: #{running_nodes => ['emqx@node1.emqx.com','emqx@node2.emqx.com'],
  3.                   stopped_nodes => []}

下一步

使用客户端连接到 EMQX，进行消息收发请参考 发布订阅操作。

配置 EMQX 参数及其他功能请参考 配置文件手册。

将多个 EMQX 节点组建为一个集群请参考 构建集群。