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 install
或apt 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.io 或 github,选择 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.io 或 github,选择 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)