程序安装 (Installation)

    注解

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

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

    下载地址:

    CentOS

    • CentOS6.X

    • CentOS7.X

    1. 安装所需要的依赖包

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

    3. 安装最新版本的 EMQ X

      1. $ sudo yum install emqx

      注解

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

    4. 安装特定版本的 EMQ X

      1. 查询可用版本

        1. $ yum list emqx --showduplicates | sort -r
        3. emqx.x86_64                     3.1.0-1.el7                        emqx-stable
        4. emqx.x86_64                     3.0.1-1.el7                        emqx-stable
        5. emqx.x86_64                     3.0.0-1.el7                        emqx-stable

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

        1. $ sudo yum install emqx-3.1.0

    5. 启动 EMQ X

      • 直接启动

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

      • systemctl 启动

        1. $ sudo systemctl start emqx

      • service 启动

        1. $ sudo service emqx start

    6. 配置文件路径

      • 配置文件路径：/etc/emqx

      • 日志文件路径：/var/log/emqx

      • 数据文件路径：/var/lib/emqx

    使用 rpm 包安装 EMQ X

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

    2. 安装 EMQ X

      1. $ sudo rpm -ivh emqx-centos7-v3.1.0.x86_64.rpm

    3. 启动 EMQ X

      • 直接启动

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

      • systemctl 启动

        1. $ sudo systemctl start emqx

      • service 启动

        1. $ sudo service emqx start

    4. 配置文件路径

      • 配置文件路径：/etc/emqx

      • 日志文件路径：/var/log/emqx

      • 数据文件路径：/var/lib/emqx

    使用 zip 包安装 EMQ X

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

    2. 解压程序包

      1. $ unzip emqx-centos7-v3.1.0.zip

    3. 启动 EMQ X

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

    Ubuntu

    • Bionic 18.04 (LTS)

    • Xenial 16.04 (LTS)

    • Trusty 14.04 (LTS)

    • Precise 12.04 (LTS)

    使用储存库安装 EMQ X

    1. 安装所需要的依赖包

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

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

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

      验证密钥

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

    3. 使用以下命令设置 stable 存储库。 如果要添加 unstable 存储库，请在以下命令中的单词 stable 之后添加单词 unstable。

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

      注解

      lsb_release -cs 子命令返回 Ubuntu 发行版的名称，例如 xenial。 有时，在像 Linux Mint 这样的发行版中，您可能需要将 $(lsb_release -cs) 更改为您的父 Ubuntu 发行版。 例如，如果您使用的是 Linux Mint Tessa，则可以使用 bionic。 EMQ X 不对未经测试和不受支持的 Ubuntu 发行版提供任何保证。

    4. 更新 apt 包索引

      1. $ sudo apt update

    5. 安装最新版本的 EMQ X

      1. $ sudo apt install emqx

      注解

      在启用了多个 EMQ X 仓库的情况下，如果 apt install 和 apt update 命令没有指定版本号，那么会自动安装最新版的 EMQ X。这对于有稳定性需求的用户来说是一个问题。

    6. 安装特定版本的 EMQ X

      1. 查询可用版本

        1. $ sudo apt-cache madison emqx
        3. emqx |      3.1.0 | https://repos.emqx.io/emqx-ce/deb/ubuntu bionic/stable amd64 Packages
        4. emqx |      3.0.1 | https://repos.emqx.io/emqx-ce/deb/ubuntu bionic/stable amd64 Packages
        5. emqx |      3.0.0 | https://repos.emqx.io/emqx-ce/deb/ubuntu bionic/stable amd64 Packages

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

        1. $ sudo apt install emqx=3.1.0

    7. 启动 EMQ X

      • systemctl 启动

        1. $ sudo systemctl start emqx
        1. $ sudo service emqx start

    8. 配置文件路径

      • 配置文件路径：/etc/emqx

      • 日志文件路径：/var/log/emqx

      • 数据文件路径：``/var/lib/emqx`

    使用 deb 包安装 EMQ X

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

    2. 安装 EMQ X

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

    3. 启动 EMQ X

      • 直接启动

        1. $ emqx start
        2. emqx 3.1.0 is started successfully!
        4. $ emqx_ctl status
        6. emqx v3.1.0 is running

      • systemctl 启动

      • service 启动

        1. $ sudo service emqx start

    4. 配置文件路径

      • 配置文件路径：/etc/emqx

      • 日志文件路径：/var/log/emqx

      • 数据文件路径：/var/lib/emqx`

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

    2. 解压程序包

      1. $ unzip emqx-ubuntu18.04-v3.1.0.zip

    3. 启动 EMQ X

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

    • Stretch (Debian 9)

    • Jessie (Debian 8)

    使用储存库安装 EMQ X

    1. 安装所需要的依赖包

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

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

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

      验证密钥

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

    3. 使用以下命令设置 stable 存储库。 如果要添加 unstable 的存储库，请在以下命令中的单词 stable 之后添加单词 unstable。

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

      注解

      lsb_release -cs 子命令返回 Debian 发行版的名称，例如 helium。 有时，在像 BunsenLabs Linux 这样的发行版中，您可能需要将 $(lsb_release -cs) 更改为您的父 Debian 发行版。 例如，如果您使用的是 BunsenLabs Linux Helium，则可以使用 stretch。 EMQ X 不对未经测试和不受支持的 Debian 发行版提供任何保证。

    4. 更新 apt 包索引

      1. $ sudo apt update

    5. 安装最新版本的 EMQ X

      1. $ sudo apt install emqx

      注解

      在启用了多个 EMQ X 仓库的情况下，如果 apt install 和 apt update 命令没有指定版本号，那么会自动安装最新版的 EMQ X。这对于有稳定性需求的用户来说是一个问题。

    6. 安装特定版本的 EMQ X

      1. 查询可用版本

        1. $ sudo apt-cache madison emqx
        3. emqx |      3.1.0 | https://repos.emqx.io/emqx-ce/deb/debian stretch/stable amd64 Packages
        4. emqx |      3.0.1 | https://repos.emqx.io/emqx-ce/deb/debian stretch/stable amd64 Packages
        5. emqx |      3.0.0 | https://repos.emqx.io/emqx-ce/deb/debian stretch/stable amd64 Packages

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

        1. $ sudo apt install emqx=3.1.0

    7. 启动 EMQ X

      • 直接启动

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

      • systemctl 启动

        1. $ sudo systemctl start emqx

      • service 启动

        1. $ sudo service emqx start

    8. 配置文件路径

      • 配置文件路径：/etc/emqx

      • 日志文件路径：/var/log/emqx

      • 数据文件路径：``/var/lib/emqx`

    使用 deb 包安装 EMQ X

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

    2. 安装 EMQ X

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

    3. 启动 EMQ X

      • 直接启动

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

      • systemctl 启动

        1. $ sudo systemctl start emqx

      • service 启动

        1. $ sudo service emqx start

    4. 配置文件路径

      • 配置文件路径：/etc/emqx

      • 日志文件路径：/var/log/emqx

      • 数据文件路径：/var/lib/emqx`

    使用 zip 包安装 EMQ X

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

    2. 解压程序包

      1. $ unzip emqx-debian9-v3.1.0.zip

    3. 启动 EMQ X

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

    macOS

    使用 Homebrew 安装

    1. 添加 EMQ X 的 tap

      1. $ brew tap emqx/emqx

    2. 安装 EMQ X

      1. $ brew install emqx
      1. emqx 3.1.0 is started successfully!
      3. $ emqx_ctl status
      4. Node 'emqx@127.0.0.1' is started
      5. emqx v3.1.0 is running

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

    2. 解压压缩包

      1. $ unzip emqx-macos-v3.1.0.zip

    3. 启动 EMQ X

      1. $ ./bin/emqx start
      2. emqx 3.1.0 is started successfully!
      4. $ ./bin/emqx_ctl status
      6. emqx v3.1.0 is running

    Windows

    1. 通过 emqx.io 或 选择 Windows 版本，然后下载要安装的 .zip 包。

    2. 解压压缩包

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

      1. cd emqx/bin
      2. emqx start
    • openSUSE leap

    使用储存库安装 EMQ X

    1. 下载 GPG 公钥并导入。

    2. 添加储存库地址

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

    3. 安装最新版本的 EMQ X

      1. $ sudo zypper in emqx

    4. 安装特定版本的 EMQ X

      1. 查询可用版本

        1. $ sudo zypper pa emqx
        3. Loading repository data...
        4. Reading installed packages...
        5. S | Repository | Name | Version  | Arch
        6. --+------------+------+----------+-------
        7.   | emqx       | emqx | 3.1.0-1  | x86_64
        8.   | emqx       | emqx | 3.0.1-1  | x86_64
        9.   | emqx       | emqx | 3.0.0-1  | x86_64

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

        1. $ sudo zypper in emqx-3.1.0

    5. 启动 EMQ X

      • 直接启动

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

      • systemctl 启动

        1. $ sudo systemctl start emqx

      • service 启动

        1. $ sudo service emqx start

    使用 rpm 包安装 EMQ X

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

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

      1. $ sudo rpm -ivh emqx-opensuse-v3.1.0.x86_64.rpm

    3. 启动 EMQ X

      • 直接启动

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

      • systemctl 启动

        1. $ sudo systemctl start emqx

      • service 启动

        1. $ sudo service emqx start

    4. 配置文件路径

      • 配置文件路径：/etc/emqx

      • 日志文件路径：/var/log/emqx

      • 数据文件路径：``/var/lib/emqx`

    使用 zip 包安装 EMQ X

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

    2. 解压压缩包

      1. $ unzip emqx-opensuse-v3.1.0.zip

    3. 启动 EMQ X

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

    FreeBSD

    • FreeBSD 12

    使用 zip 包安装 EMQ X

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

    2. 解压压缩包

      1. $ unzip emqx-freebsd12-v3.1.0.zip

    3. 启动 EMQ X

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

    Docker

    1. 获取 docker 镜像

      • 通过 获取

        1. $ docker pull emqx/emqx:v3.1.0

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

        1. $ wget -O emqx-docker.zip https://www.emqx.io/downloads/v3/latest/emqx-docker.zip
        2. $ unzip emqx-docker.zip
        3. $ docker load < emqx-docker-v3.1.0

    2. 启动 docker 容器

      1. $ docker run -d --name emqx31 -p 1883:1883 -p 8083:8083 -p 8883:8883 -p 8084:8084 -p 18083:18083 emqx/emqx:v3.1.0

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

    EMQ X 消息服务器基于 Erlang/OTP 平台开发，项目托管的 GitHub 管理维护，源码编译依赖 Erlang 环境和 git 客户端。

    注解

    EMQ X 依赖 Erlang R21.2+ 版本

    Erlang 安装: http://www.erlang.org/

    Git 客户端:

    编译安装EMQ X

    1. 获取源码

      1. $ git clone -b v3.2.0 https://github.com/emqx/emqx-rel.git

    2. 设置环境变量

      1. $ export EMQX_DEPS_DEFAULT_VSN=v3.2.0

    3. 编译

      1. $ cd emqx-rel && make

    4. 启动 EMQ X

      1. $ cd emqx-rel/_rel/emqx
      2. $ ./bin/emqx start
      3. emqx v3.2.0 is started successfully!
      5. $ ./bin/emqx_ctl status
      6. Node 'emqx@127.0.0.1' is started
      7. emqx 3.2.0 is running

    Windows 源码编译安装

    Erlang 安装: http://www.erlang.org/

    scoop 安装:

    scoop 安装完成后，使用 scoop 来安装 Git、 Make、curl、erlang

    1. scoop install git make curl erlang

    编译环境准备完成

    rebar3 安装:

    1. git clone https://github.com/erlang/rebar3.git
    3. cd rebar3
    5. bootstrap

    rebar3 编译完成后，在 windows 环境变量 PATH 中添加 rebar3 的路径

    构建环境准备之后，clone 代码开始构建 emqx

    1. git clone  -b v3.2.0 https://github.com/emqx/emqx-rel.git
    3. cd emqx-relx && make
    5. cd _build/emqx/rel/emqx && ./bin/emqx start

    控制台启动编译的 EMQ 程序包

    1. cd _build/emqx/rel/emqx

    注册 windows 服务