EMQX 安装

本文介绍在 Linux 操作系统中安装 EMQ X 的几种方式,包括 apt 镜像、deb 和 zip 包,以及 docker 安装方式。

Ubuntu 安装 EMQ X

在 Ubuntu 中安装 EMQ X 有多种方式,下面介绍使用镜像库安装和使用安装包安装两种方式。

使用镜像库安装

在新主机上首次安装 EMQ X 之前,需要设置 EMQ X 镜像库。之后,你就可以从镜像库安装和更新 EMQ X。

设置镜像库

1、更新 apt 包索引

$ sudo apt update

2、安装必要的软件

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

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

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

验证密钥

$ 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>

4、使用以下命令设置 stable 镜像库。要添加 unstable 的镜像库,请在以下命令中的单词 stable 之后添加单词 unstable。

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

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

安装 EMQ X

1、更新 apt 包索引

$ sudo apt update

2、安装最新版本的 EMQ X,或者转到下一步安装特定版本

$ sudo apt install emqx

如果启用了多个 EMQ X 镜像库,则在 apt installapt update 命令中未指定版本的情况下将始终安装尽可能高的版本,这可能不适合稳定性需求。

3、要安装特定版本的 EMQ X ,需要列出可用版本,然后选择并安装

查询可用版本

$ sudo apt-cache madison emqx

emqx |  4.3.5 | https://repos.emqx.io/emqx-ce/deb/ubuntu focal/stable amd64 Packages
emqx |  4.3.4 | https://repos.emqx.io/emqx-ce/deb/ubuntu focal/stable amd64 Packages
emqx |  4.3.3 | https://repos.emqx.io/emqx-ce/deb/ubuntu focal/stable amd64 Packages

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

$ sudo apt install emqx=4.3.5

4、启动 EMQ X

$ sudo emqx start
EMQ X Broker 4.3.5 is started successfully!
$ emqx_ctl status
Node 'emqx@127.0.0.1' 4.3.5 is started

5、EMQ X 启动成功,如何使用请参考官方文档

使用安装包安装

如果无法使用 EMQ X 的镜像库来安装 EMQ X ,则可以下载 .deb 文件或 .zip 文件并手动安装。

从 deb 文件安装

1、转到 emqx.iogithub,选择 Ubuntu 版本,然后下载要安装的 EMQ X 版本的 .deb 文件。

2、安装 EMQ X ,将下面的路径更改为下载 EMQ X 软件包的路径。

$ sudo dpkg -i /path/to/emqx-ubuntu18.04-v3.1.0_amd64.deb

3、启动 EMQ X

$ emqx start emqx 3.1 is started successfully! $ emqx_ctl status Node 'emqx@127.0.0.1' is started emqx v3.1.0 is running

4、EMQ X 启动成功,如何使用请参考官方文档

从 zip 文件安装

1、转到 emqx.iogithub,选择 Ubuntu 版本,然后下载要安装的 EMQ X 版本的 .zip 文件。

2、解压压缩包,将下面的路径更改为下载 EMQ X 软件包的路径。

$ unzip /path/to/emqx-ubuntu18.04-v3.1.0.zip

3、启动 EMQ X

$ cd emqx $ ./bin/emqx start emqx 3.1 is started successfully! $ ./bin/emqx_ctl status Node 'emqx@127.0.0.1' is started emqx v3.1.0 is running

4、EMQ X 启动成功,如何使用请参考官方文档

Docker 安装

镜像地址为 https://hub.docker.com/r/emqx/emqx

拉取 Docker 镜像

docker pull emqx/emqx

启动 EMQX 容器

docker run -d --name emqx -p 1883:1883 -p 8081:8081 -p 8083:8083 -p 8084:8084 -p 8883:8883 -p 18083:18083 emqx/emqx:latest

为了方便起见,可以以自动删除容器的方式启动

docker run -it --rm -d --name emqx -p 1883:1883 -p 8081:8081 -p 8083:8083 -p 8084:8084 -p 8883:8883 -p 18083:18083 emqx/emqx:latest

启动成功,查看 emqx 容器的状态

docker ps

进入 emqtt docker 命令

docker exec -it emqtt /bin/sh

重启 emqtt docker 命令

docker restart emqtt

浏览器打开 http://localhost:18083 访问 EMQT web 管理页面(默认账号 admin,密码 public)

Leave a Reply