使用 Docker 部署 EMQX Edge

本指南介绍如何使用官方 Docker 镜像部署 EMQX Edge。你将了解如何快速启动 EMQX Edge，并在需要时通过自定义配置文件启动容器。

前置条件

开始前，请确保：

• 主机已安装并运行 Docker。
• 主机可以访问互联网，以便从 Docker Hub 拉取镜像。

拉取 EMQX Edge Docker 镜像

以下命令以 1.3.0 为例。请将该版本号替换为你希望部署的具体 EMQX Edge 版本。

docker pull emqx/emqx-edge:1.3.0

启动 EMQX Edge 容器

要使用默认设置启动 EMQX Edge，请运行以下命令：

docker run -d -it --name emqx-edge \
  -p 1883:1883 \
  -p 8081:8081 \
  -p 8083:8083 \
  -p 8086:8086 \
  -p 8883:8883 \
  emqx/emqx-edge:<version>

该命令会执行以下操作：

• 创建并运行一个名为 emqx-edge 的后台容器。
• 将 EMQX Edge 默认服务端口映射到主机系统。
• 使用镜像标签 <version>，你需要将其替换为要运行的版本。

可以通过以下命令检查 EMQX Edge 是否正在运行：

docker ps

预期输出中应显示 emqx-edge 容器，且状态为 Up。

注意：如果部署在 arm64 设备上，且 EMQX Edge 版本早于 1.2.1，请使用以下命令：

docker run -d -it --name emqx-edge \
  -p 1883:1883 \
  -p 8081:8081 \
  -p 8083:8083 \
  -p 8086:8086 \
  -p 8883:8883 \
  emqx/emqx-edge:<version>-arm64

使用自定义配置文件启动 EMQX Edge

EMQX Edge 在容器内将配置文件存储在 /opt/emqx-edge 目录下。主配置文件为：

/opt/emqx-edge/nanomq.conf

注意：配置文件详情请参见配置章节。

要使用当前目录中的自定义配置文件启动 EMQX Edge，请运行：

docker run -d -it --name emqx-edge \
  -v ./nanomq.conf:/opt/emqx-edge/nanomq.conf \
  -p 1883:1883 \
  -p 8081:8081 \
  -p 8083:8083 \
  -p 8086:8086 \
  -p 8883:8883 \
  emqx/emqx-edge:<version>

该命令会使用以下配置启动 EMQX Edge：

• 将本地 nanomq.conf 文件挂载到容器内 /opt/emqx-edge/nanomq.conf，该路径是 EMQX Edge 使用的稳定配置路径。
• 确保自定义配置覆盖容器内的默认设置。
• 启动 EMQX Edge，并暴露所需的 MQTT 和 HTTP 服务端口。

验证部署

容器成功启动后，可以通过以下方式验证 EMQX Edge 状态：

1. Docker logs

   docker logs emqx-edge

2. Web Dashboard 打开浏览器并访问：http://localhost:8081。使用默认凭据登录：

   • Username：admin
   • Password：public

如果可以访问 Dashboard，或看到正常启动日志，则说明 EMQX Edge 部署成功。