程序安装

    Tip

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

    登陆 注册账号获取免费的试用 License 文件

    EMQ X 程序包下载

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

    下载地址: https://www.emqx.io/cn/downloads#enterprise 程序安装 - 图1 (opens new window)

    CentOS

    • CentOS6.X
    • CentOS7.X

    1. 删除旧的 EMQ X

    2. 安装所需要的依赖包

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

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

    4. 安装最新版本的 EMQ X

      1. $ sudo yum install emqx-ee

    Tip

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

    1. 安装特定版本的 EMQ X

      1. 查询可用版本

        1. $ yum list emqx-ee --showduplicates | sort -r
        3. emqx-ee.x86_64 3.2.0-1.el7 emqx-ee-stable

      2. 根据第二列中的版本字符串安装特定版本，例如 3.2.0

        1. $ sudo yum install emqx-ee-3.2.0

    2. 导入 License 文件:

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

    3. 启动 EMQ X

      • 直接启动

        1. $ emqx start
        2. emqx v3.2.0 is started successfully!
        4. $ emqx_ctl status
        5. Node 'emqx@127.0.0.1' is started
        6. emqx 3.2.0 is running

      • systemctl 启动

        1. $ sudo systemctl start emqx

      • service 启动

        1. $ sudo service emqx start

    使用 rpm 包安装 EMQ X

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

    2. 安装 EMQ X

      1.  $ sudo rpm -ivh emqx-ee-centos7-v3.2.0.x86_64.rpm

    3. 导入 License 文件:

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

    4. 启动 EMQ X

      • 直接启动

        1. $ emqx start
        2. emqx is started successfully!
        4. $ emqx_ctl status
        5. Node 'emqx@127.0.0.1' is started
        6. emqx 3.2.0 is running

      • systemctl 启动

        1. $ sudo systemctl start emqx

      • service 启动

        1. $ sudo service emqx start

    使用 zip 包安装 EMQ X

    1. 通过 emqx.io 程序安装 - 图2 (opens new window) 选择 Centos 版本，然后下载要安装的 EMQ X 版本的 zip 包。

    2. 解压程序包

      1.  $ unzip emqx-ee-centos7-v3.2.0.zip

    3. 导入 License 文件:

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

    4. 启动 EMQ X

      1.  $ ./bin/emqx start
      2.  emqx v3.2.0 is started successfully!
      4.  $ ./bin/emqx_ctl status
      5.  Node 'emqx@127.0.0.1' is started
      6.  emqx 3.2.0 is running
    • Bionic 18.04 (LTS)
    • Xenial 16.04 (LTS)
    • Trusty 14.04 (LTS)
    • Precise 12.04 (LTS)

    使用储存库安装 EMQ X

    1. 删除旧的 EMQ X

      1. $ sudo apt remove emqx emqx-edge emqx-ee

    2. 安装所需要的依赖包

      1. $ sudo apt update && sudo apt install -y \
      2. apt-transport-https \
      3. ca-certificates \
      4. curl \
      5. gnupg-agent \
      6. software-properties-common

    3. 添加 EMQ X 的官方 GPG 密钥

      1. $ curl -fsSL https://repos.emqx.io/gpg.pub | sudo apt-key add -
      3. 验证密钥
      5. $ sudo apt-key fingerprint 3E640D53
      7. pub rsa2048 2019-04-10 [SC]
      8. FC84 1BA6 3775 5CA8 487B 1E3C C0B4 0946 3E64 0D53
      9. uid [ unknown] emqx team \<support@emqx.io>

    4. 添加 EMQ X 存储库。

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

    5. 更新 apt 包索引

      1. $ sudo apt update

    6. 安装最新版本的 EMQ X

      1. $ sudo apt install emqx-ee

    7. 安装特定版本的 EMQ X

      1. 查询可用版本

        1. $ sudo apt-cache madison emqx-ee
        2. emqx-ee | 3.2.0 | https://repos.emqx.io/emqx-ee/deb/ubuntu bionic/stable amd64 Packages

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

        1. $ sudo apt install emqx-ee=3.2.0
      1. $ cp /path/to/emqx.lic /etc/emqx/emqx.lic

    9. 启动 EMQ X

      • 直接启动

        1. $ emqx start
        2. emqx v3.2.0 is started successfully!
        4. $ emqx_ctl status
        5. Node 'emqx@127.0.0.1' is started
        6. emqx 3.2.0 is running

      • systemctl 启动

        1. $ sudo systemctl start emqx

      • service 启动

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

    2. 安装 EMQ X

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

    3. 导入 License 文件:

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

    4. 启动 EMQ X

      • 直接启动

        2. emqx  is started successfully!
        4. $ emqx_ctl status
        5. Node 'emqx@127.0.0.1' is started
        6. emqx 3.2.0 is running

      • systemctl 启动

        1. $ sudo systemctl start emqx

      • service 启动

        1. $ sudo service emqx start

    使用 zip 包安装 EMQ X

    1. 通过 emqx.io 程序安装 - 图3 (opens new window) 选择 Ubuntu 版本，然后下载要安装的 EMQ X 版本的 zip 包。

    2. 解压程序包

      1. $ unzip emqx-ee-ubuntu18.04-v3.2.0.zip

    3. 导入 License 文件:

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

    4. 启动 EMQ X

      1. $ ./bin/emqx start
      2. emqx v3.2.0 is started successfully!
      4. $ ./bin/emqx_ctl status
      5. Node 'emqx@127.0.0.1' is started
      6. emqx 3.2.0 is running

    Debian

    • Stretch (Debian 9)
    • Jessie (Debian 8)

    使用储存库安装 EMQ X

    1. 删除旧的 EMQ X

      1. $ sudo apt remove emqx emqx-edge emqx-ee

    2. 安装所需要的依赖包

      1. $ sudo apt update && sudo apt install -y \
      2. apt-transport-https \
      3. ca-certificates \
      4. curl \
      5. gnupg-agent \
      6. software-properties-common

    3. 添加 EMQ X 的官方 GPG 密钥

      1. $ curl -fsSL https://repos.emqx.io/gpg.pub | sudo apt-key add -
      3. 验证密钥
      5. $ sudo apt-key fingerprint 3E640D53
      7. pub rsa2048 2019-04-10 [SC]
      8. FC84 1BA6 3775 5CA8 487B 1E3C C0B4 0946 3E64 0D53
      9. uid [ unknown] emqx team \<support@emqx.io>

    4. 设置 EMQ X 存储库。

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

    5. 更新 apt 包索引

      1. $ sudo apt update

    6. 安装最新版本的 EMQ X

      1. $ sudo apt install emqx-ee

    7. 安装特定版本的 EMQ X

      1. 查询可用版本

        1. $ sudo apt-cache madison emqx-ee
        3. emqx-ee | 3.2.0 | https://repos.emqx.io/emqx-ee/deb/ubuntu bionic/stable amd64 Packages

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

        1. $ sudo apt install emqx-ee=3.2.0

    8. 导入 License 文件:

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

    9. 启动 EMQ X

      • 直接启动

        1. $ emqx start
        2. emqx v3.2.0 is started successfully!
        4. $ emqx_ctl status
        5. Node 'emqx@127.0.0.1' is started
        6. emqx 3.2.0 is running

      • systemctl 启动

        1. $ sudo systemctl start emqx

      • service 启动

        1. $ sudo service emqx start

    使用 deb 包安装 EMQ X

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

    2. 安装 EMQ X

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

    3. 导入 License 文件:

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

    4. 启动 EMQ X

      • 直接启动

        1. $ emqx start
        2. emqx v3.2.0 is started successfully!
        4. $ emqx_ctl status
        5. Node 'emqx@127.0.0.1' is started
        6. emqx 3.2.0 is running

      • systemctl 启动

        1. $ sudo systemctl start emqx

      • service 启动

        1. $ sudo service emqx start

    1. 通过 emqx.io 程序安装 - 图4 (opens new window) 选择 Debian 版本，然后下载要安装的 EMQ X 版本的 zip 包。

    2. 解压程序包

      1. $ unzip emqx-ee-debian9-v3.2.0.zip

    3. 导入 License 文件:

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

    macOS

    使用 zip 包安装 EMQ X

    1. 通过 ，选择 EMQ X 版本，然后下载要安装的 zip 包。

    2. 解压压缩包

    3. 导入 License 文件:

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

    4. 启动 EMQ X

      2. emqx v3.2.0 is started successfully!
      4. $ ./bin/emqx_ctl status
      5. Node 'emqx@127.0.0.1' is started
      6. emqx 3.2.0 is running

    1. 通过 emqx.io 程序安装 - 图5 (opens new window) 下载 .zip 包。

    2. 解压压缩包

    3. 导入 License 文件:

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

    4. 打开 Windows 命令行窗口，cd 到程序目录， 启动 EMQ X。

      1. cd /path/to/emqx/bin
      2. emqx start

    openSUSE

    • openSUSE leap

    使用储存库安装 EMQ X

    1. 删除旧的 EMQ X

      1. $ sudo zypper remove emqx emqx-edge emqx-ee

    2. 下载 GPG 公钥并导入。

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

    3. 添加储存库地址

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

    4. 安装最新版本的 EMQ X

      1. $ sudo zypper in emqx-ee

    5. 安装特定版本的 EMQ X

      1. 查询可用版本

        1. $ sudo zypper pa emqx-ee
        3. Loading repository data...
        4. Reading installed packages...
        5. S | Repository | Name    | Version | Arch
        6. --+------------+---------+---------+-------
        7.   | emqx-ee    | emqx-ee | 3.2.0-1 | x86_64

      2. 使用 Version 安装特定版本，例如

        1. $ sudo zypper in emqx-ee-3.2.0

    6. 导入 License 文件:

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

    7. 启动 EMQ X

      • 直接启动

        1. $ emqx start
        2. emqx v3.2.0 is started successfully!
        4. $ emqx_ctl status
        5. Node 'emqx@127.0.0.1' is started
        6. emqx 3.2.0 is running

      • systemctl 启动

        1. $ sudo systemctl start emqx

      • service 启动

        1. $ sudo service emqx start

    使用 rpm 包安装 EMQ X

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

    2. 安装 EMQ X，将下面的路径更改为您下载 EMQ X 软件包的路径。

      1. $ sudo rpm -ivh emqx-ee-opensuse-v3.2.0.x86_64.rpm

    3. 导入 License 文件:

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

    4. 启动 EMQ X

      • 直接启动

        1. $ emqx start
        2. emqx v3.2.0 is started successfully!
        4. $ emqx_ctl status
        5. Node 'emqx@127.0.0.1' is started
        6. emqx 3.2.0 is running

      • systemctl 启动

        1. $ sudo systemctl start emqx

      • service 启动

        1. $ sudo service emqx start

    1. 通过 emqx.io 程序安装 - 图6 (opens new window) 选择 openSUSE，然后下载要安装的 EMQ X 版本的 zip 包。

    2. 解压压缩包

      1. $ unzip emqx-ee-opensuse-v3.2.0.zip

    3. 导入 License 文件:

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

    4. 启动 EMQ X

      1. $ ./bin/emqx start
      2. emqx v3.2.0 is started successfully!
      4. $ ./bin/emqx_ctl status
      5. Node 'emqx@127.0.0.1' is started
      6. emqx 3.2.0 is running

    FreeBSD

    • FreeBSD 12

    使用 zip 包安装 EMQ X

    1. 通过 选择 FreeBSD，然后下载要安装的 EMQ X 版本的 zip 包。

    2. 解压压缩包

      1. $ unzip emqx-ee-freebsd12-v3.2.0.zip

    3. 导入 License 文件:

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

    4. 启动 EMQ X

      1. $ ./bin/emqx start
      2. emqx v3.2.0 is started successfully!
      4. $ ./bin/emqx_ctl status
      5. Node 'emqx@127.0.0.1' is started
      6. emqx 3.2.0 is running

    1. 获取 docker 镜像

      • 通过 Docker Hub 程序安装 - 图7 (opens new window) 获取

        1. $ docker pull emqx/emqx-ee:v3.2.0

      • 通过 手动下载 docker 镜像，并手动加载

        1. $ wget -O emqx-ee-docker-v3.2.0.zip https://www.emqx.io/downloads/enterprise/v3.2.0/emqx-ee-docker-v3.2.0-amd64.zip
        2. $ unzip emqx-ee-docker.zip
        3. $ docker load \< emqx-ee-docker-v3.2.0

    2. 启动 docker 容器

      1. $ docker run -d -\
      2.  -name emqx-ee \
      3.  -p 1883:1883 \
      4.  -p 8083:8083 \
      5.  -p 8883:8883 \
      6.  -p 8084:8084 \
      7.  -p 18083:18083 \
      8.  -v /path/to/emqx.lic:/opt/emqx/etc/emqx.lic
      9. emqx/emqx-ee:v3.2.0