Raspbian 安装 EMQ X 服务器指南

　　系统要求
　　
　　Stretch (Raspbian 9)
　　
　　Jessie (Raspbian 8)
　　
　　安装 EMQ X Edge
　　
　　您可以根据需要以不同方式安装 EMQ X Edge ：
　　
　　设置 EMQ X Edge 的镜像库并从中进行安装，以便于安装和升级任务。
　　
　　手动下载软件包并安装。
　　
　　使用镜像库安装 EMQ X Edge
　　
　　在新主机上首次安装 EMQ X Edge 之前，需要设置 EMQ X Edge 镜像库。之后可以从镜像库安装和更新 EMQ X Edge 。
　　
　　设置镜像库
　　
　　1.更新 apt 包索引：
　　
　　$ sudo apt update
　　
　　2.安装必要的软件：
　　
　　$ sudo apt install -y \
　　
　　apt-transport-https \
　　
　　ca-certificates \
　　
　　curl \
　　
　　gnupg-agent \
　　
　　software-properties-common
　　
　　3.添加 EMQ X Edge 的官方 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 <[email protected]>
　　
　　4.使用以下命令设置 stable 镜像库。要添加 unstable 的镜像库，请在以下命令中的单词 stable 之后添加单词 unstable。
　　
　　$ sudo add-apt-repository \
　　
　　"deb [arch=armhf] https://repos.emqx.io/emqx-edge/deb/raspbian/ \
　　
　　$(lsb_release -cs) \
　　
　　stable"
　　
　　安装 EMQ X Edge
　　
　　1.更新 apt 包索引：
　　
　　$ sudo apt update
　　
　　2.安装最新版本的 EMQ X Edge ，或者转到下一步安装特定版本：
　　
　　$ sudo apt install emqx
　　
　　如果启用了多个 EMQ X Edge 镜像库，则在 apt install 或 apt update 命令中未指定版本的情况下将始终安装尽可能高的版本，这可能不适合稳定性需求。
　　
　　3.要安装特定版本的 EMQ X Edge ，需要列出可用版本，然后选择并安装：
　　
　　查询可用版本
　　
　　$ sudo apt-cache madison emqx
　　
　　emqx | 3.1-rc.1 | https://www.chaoyul.com repos.emqx.io/emqx-edge/deb/raspbian stretch/unstable armhf Packages
　　
　　emqx | 3.1-beta.3 | https://hengxuangyul.com repos.emqx.io/emqx-edge/deb/raspbian stretch/unstable armhf Packages
　　
　　emqx | 3.1-beta.2 | https://www.shengrenpt.com .emqx.io/emqx-edge/deb/raspbian stretch/unstable armhf Packages
　　
　　emqx | 3.1-beta.1 | https://www.cmylwg.com repos.emqx.io/emqx-edge/deb/raspbian stretch/unstable armhf Packages
　　
　　emqx | 3.1.0 | https://kunlunyule.com repos.emqx.io/emqx-edge/deb/raspbian stretch/stable armhf Packages
　　
　　emqx | 3.0.1 | https://www.qunfenyul.com repos.emqx.io/emqx-edge/deb/raspbian stretch/stable armhf Packages
　　
　　使用第二列中的版本字符串安装特定版本，例如 3.1.0
　　
　　$ sudo apt install emqx=3.1.0
　　
　　4.启动 EMQ X Edge
　　
　　$ emqx start
　　
　　emqx 3.1 is started successfully!
　　
　　$ emqx_ctl status
　　
　　Node '[email protected]' is started
　　
　　emqx v3.1.0 is running
　　
　　5.EMQ X 启动成功，如何使用请参考官方文档https://developer.emqx.io/docs/broker/v3/cn/getstarted.html)
　　
　　使用安装包安装 EMQ X Edge
　　
　　如果无法使用 EMQ X Edge 的镜像库来安装 EMQ X Edge ，则可以下载 .deb 文件或 .zip 文件并手动安装。
　　
　　从 .deb 文件安装
　　
　　1.转到 emqx.io 或 github，选择 Raspbian 版本，然后下载要安装的 EMQ X Edge 版本的 .deb 文件。
　　
　　2.安装 EMQ X Edge ，将下面的路径更改为下载 EMQ X Edge 软件包的路径。
　　
　　$sudo dpkg -i /path/to/emqx-raspbian9-v3.1.0_armhf.deb
　　
　　3.启动 EMQ X Edge
　　
　　$ emqx start
　　
　　emqx 3.1 is started successfully!
　　
　　$ emqx_ctl status
　　
　　Node '[email protected]' is started
　　
　　emqx v3.1.0 is running
　　
　　4.EMQ X 启动成功，如何使用请参考官方文档https://developer.emqx.io/docs/broker/v3/cn/getstarted.html)
　　
　　从 .zip 文件安装
　　
　　1.转到 emqx.io 或 github，选择Raspbian版本，然后下载要安装的 EMQ X Edge 版本的 .zip 文件。
　　
　　2.解压压缩包，将下面的路径更改为下载 EMQ X Edge 软件包的路径。
　　
　　$ unzip /path/to/emqx-raspbian9-v3.1.0.zip
　　
　　3.启动 EMQ X Edge
　　
　　$ cd emqx
　　
　　$ ./bin/emqx start
　　
　　emqx 3.1 is started successfully!
　　
　　$ ./bin/emqx_ctl status
　　
　　Node '[email protected]' is started
　　
　　emqx v3.1.0 is running
　　
　　4.EMQ X 启动成功，如何使用请参考官方文档