安装

EMQX 目前支持的操作系统:

CentOS 7 (EL7)
CentOS 8 (EL8)
Raspbian 10
Debian 9
Debian 10
Ubuntu 16.04
Ubuntu 18.04
Ubuntu 20.04
macOS 10
Windows Server 2019

RPM/DEB包安装 (Linux)

访问 emqx.com 或 Github 下载EMQX 版本的二进制包。

安装 EMQX Broker，将下面的路径更改为您下载 EMQX 软件包的路径。

RPM 包:

shell

$ sudo yum install emqx-cenots7-v4.0.0.x86_64.rpm

DEB 包:

# for ubuntu/debian
$ sudo apt install ./emqx-ubuntu18.04-v4.0.0_amd64.deb
$ sudo apt install ./emqx-debian10-v4.0.0_amd64.deb

启动 EMQX Broker

直接启动

$ emqx start
emqx 4.0.0 is started successfully!
$ emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx v4.0.0 is running

systemctl 启动
```
$ sudo systemctl start emqx
```
service 启动
```
$ sudo service emqx start
```

停止 EMQX Broker
```
$ emqx stop
ok
```

卸载 EMQX Broker

DEB 包:
```
$ sudo apt remove --purge emqx
```
RPM 包:
```
$ sudo yum remove emqx
```

ZIP 压缩包安装 (Linux、MacOS、Windows)

::: ZIP包适用于测试和热更，如果不知道如何手动安装所有可能的运行时依赖，请勿在生产环境中使用 :::

访问 emqx.com 或 Github 下载要安装的 EMQX 版本的 zip 包。
解压程序包
shell
```
$ unzip emqx-ubuntu18.04-v4.0.0.zip
```

启动 EMQX Broker

$ cd ./emqx
$ ./bin/emqx start
emqx 4.0.0 is started successfully!

$ ./bin/emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx v4.0.0 is running

停止 EMQX Broker
```
$ ./bin/emqx stop
ok
```
卸载 EMQX Broker
直接删除 EMQX 目录即可

通过 Docker 运行 (包含简单的 docker-compose 集群)

Docker 部署注意事项

如果需要持久 Docker 容器，请将以下目录挂载到容器外部，这样即使容器被删除数据也不会丢失：

bash

/opt/emqx/data
/opt/emqx/etc
/opt/emqx/log

Docker 内的 localhost 或 127.0.0.1 指向的是容器内部地址，如需访问宿主机地址请使用宿主机的真实 IP 或使用 host 网络模式。如果您使用的是 Docker for Mac 或 Docker for Windows，可以使用 host.docker.internal 作为宿主机地址。
由于 EMQX 使用 data/mnesia/<节点名> 作为数据存储目录，请使用 hostname 或者 FQDN 等固定的信息作为节点名，避免因为节点名称变动导致数据丢失。

运行单个容器

获取 docker 镜像
- 通过 Docker Hub 获取
```
$ docker pull emqx/emqx:v4.0.0
```

启动 docker 容器

$ docker run -d --name emqx -p 1883:1883 -p 8081:8081 -p 8083:8083 -p 8883:8883 -p 8084:8084 -p 18083:18083 emqx/emqx:v4.0.0

使用 docker-compose 创建简单的 static 集群

请注意，本章节中的 Docker Compose 示例文件仅适用于本地测试，如果您需要在生产环境中部署集群请参考分布式集群。

创建 docker-compose.yaml 文件

version: '3'

services:
  emqx1:
    image: emqx/emqx:v4.0.0
    environment:
    - "EMQX_NAME=emqx"
    - "EMQX_HOST=node1.emqx.io"
    - "EMQX_CLUSTER__DISCOVERY=static"
    - "EMQX_CLUSTER__STATIC__SEEDS=emqx@node1.emqx.io, emqx@node2.emqx.io"
    healthcheck:
      test: ["CMD", "/opt/emqx/bin/emqx_ctl", "status"]
      interval: 5s
      timeout: 25s
      retries: 5
    networks:
      emqx-bridge:
        aliases:
        - node1.emqx.io

  emqx2:
    image: emqx/emqx:v4.0.0
    environment:
    - "EMQX_NAME=emqx"
    - "EMQX_HOST=node2.emqx.io"
    - "EMQX_CLUSTER__DISCOVERY=static"
    - "EMQX_CLUSTER__STATIC__SEEDS=emqx@node1.emqx.io, emqx@node2.emqx.io"
    healthcheck:
      test: ["CMD", "/opt/emqx/bin/emqx_ctl", "status"]
      interval: 5s
      timeout: 25s
      retries: 5
    networks:
      emqx-bridge:
        aliases:
        - node2.emqx.io

networks:
  emqx-bridge:
    driver: bridge

启动 docker-compose 集群
```
$ docker-compose -p my_emqx up -d
```

查看集群

$ docker exec -it my_emqx_emqx1_1 sh -c "emqx_ctl cluster status"
Cluster status: #{running_nodes => ['emqx@node1.emqx.io','emqx@node2.emqx.io'],
                  stopped_nodes => []}

更多关于 EMQX Docker 的信息请查看 Docker Hub 或 Github

源码编译安装

获取源码

bash

$ git clone https://github.com/emqx/emqx.git

切换到最近的 Tag

bash

$ cd emqx
$ git checkout $(git describe --abbrev=0 --tags)

编译

bash

$ make

启动 EMQX Broker

bash

$ cd _build/emqx/rel/emqx

$ ./bin/emqx start
EMQX Broker 4.3-beta.1 is started successfully!

$ ./bin/emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx 4.3-beta.1 is running

安装 ​

RPM/DEB包安装 (Linux) ​

ZIP 压缩包安装 (Linux、MacOS、Windows) ​

通过 Docker 运行 (包含简单的 docker-compose 集群) ​

运行单个容器 ​

使用 docker-compose 创建简单的 static 集群 ​

源码编译安装 ​

安装

RPM/DEB包安装 (Linux)

ZIP 压缩包安装 (Linux、MacOS、Windows)

通过 Docker 运行 (包含简单的 docker-compose 集群)

运行单个容器

使用 docker-compose 创建简单的 static 集群

源码编译安装