程序安装

EMQ X 消息服务器可跨平台运行在 Linux、FreeBSD、macOS、Windows 或 openSUSE 服务器上。

DANGER

产品部署建议 Linux 服务器，不推荐 Windows 服务器。

EMQ X License 文件获取

联系商务或登陆 https://emqx.io 注册账号获取免费的试用 License 文件

EMQ X 程序包下载

EMQ X 消息服务器每个版本会发布 CentOS、Ubuntu、Debian、FreeBSD、Windows 、openSUSE 平台程序包与 Docker 镜像。

下载地址: https://www.emqx.cn/downloads#enterprise

CentOS

CentOS6.X
CentOS7.X

使用储存库安装 EMQ X

删除旧的 EMQ X

bash

$ sudo yum remove emqx emqx-edge emqx-ee

安装所需要的依赖包

bash

$ sudo yum install -y yum-utils device-mapper-persistent-data lvm2

使用以下命令设置存储库，以 CentOS7 为例

bash

$ sudo yum-config-manager --add-repo https://repos.emqx.io/emqx-ee/redhat/centos/7/emqx-ee.repo

安装最新版本的 EMQ X

bash

$ sudo yum install emqx-ee

TIP

如果提示接受 GPG 密钥，请确认密钥符合 fc84 1ba6 3775 5ca8 487b 1e3c c0b4 0946 3e64 0d53，如果符合，则接受该指纹。

安装特定版本的 EMQ X

查询可用版本

bash

$ yum list emqx-ee --showduplicates | sort -r

emqx-ee.x86_64                    4.0.0-1.el7                     emqx-ee-stable

根据第二列中的版本字符串安装特定版本，例如 4.0.0
bash
```
$ sudo yum install emqx-ee-4.0.0
```

导入License文件:

bash

$ cp /path/to/emqx.lic /etc/emqx/emqx.lic

启动 EMQ X

直接启动

bash

$ emqx start
emqx v4.0.0 is started successfully!

$ emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx 4.0.0 is running

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

使用 rpm 包安装 EMQ X

通过 emqx.io 选择 CentOS 版本，然后下载要安装的 EMQ X 版本的 rpm 包。

安装 EMQ X

bash

$ sudo rpm -ivh emqx-ee-centos7-v4.0.0.x86_64.rpm

导入License文件:

bash

$ cp /path/to/emqx.lic /etc/emqx/emqx.lic

启动 EMQ X

直接启动

bash

$ emqx start
emqx  is started successfully!

$ emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx 4.0.0 is running

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

使用 zip 包安装 EMQ X

通过 emqx.io 选择 Centos 版本，然后下载要安装的 EMQ X 版本的 zip 包。
解压程序包
bash
```
$ unzip emqx-ee-centos7-v4.0.0.zip
```

导入License文件:

bash

$ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.lic

启动 EMQ X

bash

$ ./bin/emqx start
emqx v4.0.0 is started successfully!

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

Ubuntu

Bionic 18.04 (LTS)
Xenial 16.04 (LTS)
Trusty 14.04 (LTS)
Precise 12.04 (LTS)

使用储存库安装 EMQ X

删除旧的 EMQ X

bash

$ sudo apt remove emqx emqx-edge emqx-ee

安装所需要的依赖包

bash

$ sudo apt update && sudo apt install -y \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg-agent \
    software-properties-common

添加 EMQ X 的官方 GPG 密钥

bash

$ curl -fsSL https://repos.emqx.io/gpg.pub | sudo apt-key add -

验证密钥

bash

$ sudo apt-key fingerprint 3E640D53

pub   rsa2048 2019-04-10 [SC]
    FC84 1BA6 3775 5CA8 487B  1E3C C0B4 0946 3E64 0D53
uid           [ unknown] emqx team <support@emqx.io>

添加 EMQ X 存储库。

bash

$ sudo add-apt-repository \
    "deb [arch=amd64] https://repos.emqx.io/emqx-ee/deb/ubuntu/ \
    $(lsb_release -cs) \
    stable"

更新 apt 包索引

bash

$ sudo apt update

安装最新版本的 EMQ X

bash

$ sudo apt install emqx-ee

安装特定版本的 EMQ X

查询可用版本

bash

$ sudo apt-cache madison emqx-ee

emqx-ee |      4.0.0 | https://repos.emqx.io/emqx-ee/deb/ubuntu bionic/stable amd64 Packages

使用第二列中的版本字符串安装特定版本，例如

bash

$ sudo apt install emqx-ee=4.0.0

导入License文件:

bash

$ cp /path/to/emqx.lic /etc/emqx/emqx.lic

启动 EMQ X

直接启动

bash

$ emqx start
emqx v4.0.0 is started successfully!

$ emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx 4.0.0 is running

systemctl 启动

bash

$ sudo systemctl start emqx

service 启动

bash

$ sudo service emqx start

使用 deb 包安装 EMQ X

通过 emqx.io 选择 Ubuntu 版本，然后下载要安装的 EMQ X 版本的 deb 包。
安装 EMQ X

bash

$ sudo dpkg -i emqx-ee-ubuntu18.04-v3.1.0_amd64.deb

导入License文件:

bash

$ cp /path/to/emqx.lic /etc/emqx/emqx.lic

启动 EMQ X

直接启动

bash

$ emqx start
emqx  is started successfully!

$ emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx 4.0.0 is running

systemctl 启动

bash

$ sudo systemctl start emqx

service 启动

bash

$ sudo service emqx start

使用 zip 包安装 EMQ X

通过 emqx.io 选择 Ubuntu 版本，然后下载要安装的 EMQ X 版本的 zip 包。
解压程序包

bash

$ unzip emqx-ee-ubuntu18.04-v4.0.0.zip

导入License文件:

bash

$ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.lic

启动 EMQ X

bash

$ ./bin/emqx start
emqx v4.0.0 is started successfully!

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

Debian

Stretch (Debian 9)
Jessie (Debian 8)

使用储存库安装 EMQ X

删除旧的 EMQ X

bash

$ sudo apt remove emqx emqx-edge emqx-ee

安装所需要的依赖包

bash

$ sudo apt update && sudo apt install -y \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg-agent \
    software-properties-common

添加 EMQ X 的官方 GPG 密钥

bash

$ curl -fsSL https://repos.emqx.io/gpg.pub | sudo apt-key add -

验证密钥

bash

$ sudo apt-key fingerprint 3E640D53

pub   rsa2048 2019-04-10 [SC]
    FC84 1BA6 3775 5CA8 487B  1E3C C0B4 0946 3E64 0D53
uid           [ unknown] emqx team <support@emqx.io>

设置 EMQ X 存储库。

bash

$ sudo add-apt-repository \
    "deb [arch=amd64] https://repos.emqx.io/emqx-ee-ce/deb/debian/ \
    $(lsb_release -cs) \
    stable"

更新 apt 包索引

bash

$ sudo apt update

安装最新版本的 EMQ X

bash

$ sudo apt install emqx-ee

安装特定版本的 EMQ X

查询可用版本

bash

$ sudo apt-cache madison emqx-ee

emqx-ee |      4.0.0 | https://repos.emqx.io/emqx-ee/deb/ubuntu bionic/stable amd64 Packages

使用第二列中的版本字符串安装特定版本，例如
bash
```
$ sudo apt install emqx-ee=4.0.0
```

导入License文件:

bash

$ cp /path/to/emqx.lic /etc/emqx/emqx.lic

启动 EMQ X

直接启动

bash

$ emqx start
emqx v4.0.0 is started successfully!

$ emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx 4.0.0 is running

systemctl 启动

bash

$ sudo systemctl start emqx

service 启动

bash

$ sudo service emqx start

使用 deb 包安装 EMQ X

通过 emqx.io 选择 Debian 版本，然后下载要安装的 EMQ X 版本的 deb 包。

安装 EMQ X

bash

$ sudo dpkg -i emqx-ee-debian9-v3.1.0_amd64.deb

导入License文件:

bash

$ cp /path/to/emqx.lic /etc/emqx/emqx.lic

启动 EMQ X

直接启动

bash

$ emqx start
emqx v4.0.0 is started successfully!

$ emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx 4.0.0 is running

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

使用 zip 包安装 EMQ X

通过 emqx.io 选择 Debian 版本，然后下载要安装的 EMQ X 版本的 zip 包。
解压程序包
bash
```
$ unzip emqx-ee-debian9-v4.0.0.zip
```

导入License文件:

bash

$ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.lic

启动 EMQ X

bash

$ ./bin/emqx start
emqx v4.0.0 is started successfully!

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

macOS

使用 ZIP 包安装 EMQ X

通过 emqx.io ，选择 EMQ X 版本，然后下载要安装的 zip 包。
解压压缩包
bash
```
$ unzip emqx-ee-macos-v4.0.0.zip
```

导入License文件:

bash

$ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.li

启动 EMQ X

bash

$ ./bin/emqx start
emqx v4.0.0 is started successfully!

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

Windows

通过 emqx.io 下载 .zip 包。
解压压缩包

导入License文件:

bash

$ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.lic

打开 Windows 命令行窗口，cd 到程序目录，启动 EMQ X。
bash
```
cd /path/to/emqx/bin
emqx start
```

openSUSE

openSUSE leap

使用储存库安装 EMQ X

删除旧的 EMQ X

bash

$ sudo zypper remove emqx emqx-edge emqx-ee

下载 GPG 公钥并导入。

bash

$ curl -L -o /tmp/gpg.pub https://repos.emqx.io/gpg.pub
$ sudo rpmkeys --import /tmp/gpg.pub

添加储存库地址

bash

$ sudo zypper ar -f -c https://repos.emqx.io/emqx-ee/redhat/opensuse/leap/stable emqx-ee

安装最新版本的 EMQ X
bash
```
$ sudo zypper in emqx-ee
```

安装特定版本的 EMQ X

查询可用版本

bash

$ sudo zypper pa emqx-ee

Loading repository data...
Reading installed packages...
S | Repository | Name    | Version | Arch
--+------------+---------+---------+-------
  | emqx-ee    | emqx-ee | 4.0.0-1 | x86_64

使用 Version 安装特定版本，例如
bash
```
$ sudo zypper in emqx-ee-4.0.0
```

导入License文件:

bash

$ cp /path/to/emqx.lic /etc/emqx/emqx.lic

启动 EMQ X

直接启动

bash

$ emqx start
emqx v4.0.0 is started successfully!

$ emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx 4.0.0 is running

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

使用 rpm 包安装 EMQ X

通过 emqx.io 选择 openSUSE，然后下载要安装的 EMQ X 版本的 rpm 包。
安装 EMQ X，将下面的路径更改为您下载 EMQ X 软件包的路径。
bash
```
$ sudo rpm -ivh emqx-ee-opensuse-v4.0.0.x86_64.rpm
```

导入License文件:

bash

$ cp /path/to/emqx.lic /etc/emqx/emqx.lic

启动 EMQ X

直接启动

bash

$ emqx start
emqx v4.0.0 is started successfully!

$ emqx_ctl status
Node 'emqx@127.0.0.1' is started
emqx 4.0.0 is running

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

使用 zip 包安装 EMQ X

通过 emqx.io 选择 openSUSE，然后下载要安装的 EMQ X 版本的 zip 包。
解压压缩包
bash
```
$ unzip emqx-ee-opensuse-v4.0.0.zip
```

导入License文件:

bash

$ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.lic

启动 EMQ X

bash

$ ./bin/emqx start
emqx v4.0.0 is started successfully!

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

FreeBSD

FreeBSD 12

使用 zip 包安装 EMQ X

通过 emqx.io 选择 FreeBSD，然后下载要安装的 EMQ X 版本的 zip 包。
解压压缩包
bash
```
$ unzip emqx-ee-freebsd12-v4.0.0.zip
```

导入License文件:

bash

$ cp /path/to/emqx.lic /path/to/emqx/etc/emqx.lic

启动 EMQ X

bash

$ ./bin/emqx start
emqx v4.0.0 is started successfully!

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

Docker

获取 docker 镜像

通过 Docker Hub 获取

bash

$ docker pull emqx/emqx-ee:v4.0.0

通过 emqx.io 手动下载 docker 镜像，并手动加载

bash

$ wget -O emqx-ee-docker-v4.0.0.zip https://www.emqx.cn/downloads/enterprise/v4.0.0/emqx-ee-docker-v4.0.0-amd64.zip
$ unzip emqx-ee-docker.zip
$ docker load < emqx-ee-docker-v4.0.0

启动 docker 容器

bash

$ docker run -d -\
    -name emqx-ee \
    -p 1883:1883 \
    -p 8083:8083 \
    -p 8883:8883 \
    -p 8084:8084 \
    -p 18083:18083 \
    -v /path/to/emqx.lic:/opt/emqx/etc/emqx.lic
    emqx/emqx-ee:v4.0.0

更多关于 EMQ X Docker 的信息请查看 Docker Hub

程序安装 ​

EMQ X License 文件获取 ​

EMQ X 程序包下载 ​

CentOS ​

使用储存库安装 EMQ X ​

使用 rpm 包安装 EMQ X ​

使用 zip 包安装 EMQ X ​

Ubuntu ​

使用储存库安装 EMQ X ​

使用 deb 包安装 EMQ X ​

使用 zip 包安装 EMQ X ​

Debian ​

使用储存库安装 EMQ X ​

使用 deb 包安装 EMQ X ​

使用 zip 包安装 EMQ X ​

macOS ​

使用 ZIP 包安装 EMQ X ​

Windows ​

openSUSE ​

使用储存库安装 EMQ X ​

使用 rpm 包安装 EMQ X ​

使用 zip 包安装 EMQ X ​

FreeBSD ​

使用 zip 包安装 EMQ X ​

Docker ​

程序安装

EMQ X License 文件获取

EMQ X 程序包下载

CentOS

使用储存库安装 EMQ X

使用 rpm 包安装 EMQ X

使用 zip 包安装 EMQ X

Ubuntu

使用储存库安装 EMQ X

使用 deb 包安装 EMQ X

使用 zip 包安装 EMQ X

Debian

使用储存库安装 EMQ X

使用 deb 包安装 EMQ X

使用 zip 包安装 EMQ X

macOS

使用 ZIP 包安装 EMQ X

Windows

openSUSE

使用储存库安装 EMQ X

使用 rpm 包安装 EMQ X

使用 zip 包安装 EMQ X

FreeBSD

使用 zip 包安装 EMQ X

Docker