白皮书
车云灵活数采方案:释放数据价值,加速智能创新 →

Raspbian 安装 EMQX 服务器指南

EMQX Team
2019-7-5
Raspbian 安装 EMQX 服务器指南

系统要求

  • Stretch (Raspbian 9)
  • Jessie (Raspbian 8)

安装 EMQX Edge

您可以根据需要以不同方式安装 EMQX Edge :

  • 设置 EMQX Edge 的镜像库并从中进行安装,以便于安装和升级任务。
  • 手动下载软件包并安装。

使用镜像库安装 EMQX Edge

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

设置镜像库

1.更新 apt 包索引:

$ sudo apt update

2.安装必要的软件:

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

3.添加 EMQX 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 <support@emqx.io>

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

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

安装 EMQX Edge

  1. 1.更新 apt 包索引:

    $ sudo apt update
    

    2.安装最新版本的 EMQX Edge ,或者转到下一步安装特定版本:

    $ sudo apt install emqx
    

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

    3.要安装特定版本的 EMQX Edge ,需要列出可用版本,然后选择并安装:

    查询可用版本

    $ sudo apt-cache madison emqx
        emqx |   3.1-rc.1 | https://repos.emqx.io/emqx-edge/deb/raspbian stretch/unstable armhf Packages
        emqx | 3.1-beta.3 | https://repos.emqx.io/emqx-edge/deb/raspbian stretch/unstable armhf Packages
        emqx | 3.1-beta.2 | https://repos.emqx.io/emqx-edge/deb/raspbian stretch/unstable armhf Packages
        emqx | 3.1-beta.1 | https://repos.emqx.io/emqx-edge/deb/raspbian stretch/unstable armhf Packages
        emqx |     3.1.0 | https://repos.emqx.io/emqx-edge/deb/raspbian stretch/stable armhf Packages
        emqx |     3.0.1 | https://repos.emqx.io/emqx-edge/deb/raspbian stretch/stable armhf Packages
    

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

    $ sudo apt install emqx=3.1.0
    

    4.启动 EMQX Edge

    $ 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
    

    5.EMQX 启动成功,如何使用请参考官方文档https://developer.emqx.io/docs/broker/v3/cn/getstarted.html)

使用安装包安装 EMQX Edge

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

.deb 文件安装

1.转到 emqx.io 或 github,选择 Raspbian 版本,然后下载要安装的 EMQX Edge 版本的 .deb 文件。

2.安装 EMQX Edge ,将下面的路径更改为下载 EMQX Edge 软件包的路径。

$sudo dpkg -i /path/to/emqx-raspbian9-v3.1.0_armhf.deb

3.启动 EMQX Edge

$ 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.EMQX 启动成功,如何使用请参考官方文档https://developer.emqx.io/docs/broker/v3/cn/getstarted.html)

.zip 文件安装

1.转到 emqx.io 或 github,选择Raspbian版本,然后下载要安装的 EMQX Edge 版本的 .zip 文件。

2.解压压缩包,将下面的路径更改为下载 EMQX Edge 软件包的路径。

$ unzip /path/to/emqx-raspbian9-v3.1.0.zip

3.启动 EMQX Edge

$ 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.EMQX 启动成功,如何使用请参考官方文档

免费试用 EMQX Cloud
全托管的云原生 MQTT 消息服务
开始试用 →

推荐阅读