Skip to main content

MQTT服务器安装

MQTT（又名 MQ 遥测传输）是一种基于 TCP/IP 的机器对机器或“物联网”连接协议。它允许极其轻量级的发布/订阅消息传输。MQTT是一个非常通用的协议，使用它可以让我们非常方便接入自己的设备。关于核桃派MQTT详细教程可以参考：MQTT通讯

使用MQTT集成需要一个MQTT服务器。

提示

如果你使用的是核桃派Home Assistant镜像，那么这个镜像出厂已经安装好了MQTT服务器，并开机自启动。

如果你使用核桃派普通镜像安装的Home Assistant，那么就需要自己手动安装和配置MQTT服务器。安装教程如下：

安装​

打开核桃派终端, 使用apt指令安装：

sudo apt install mosquitto

设置开机自启动：

sudo service mosquitto start

常规配置​

这里可以配置mqtt服务器端口和绑定文件相关信息，在核桃派 /etc/mosquitto/conf.d 目录下用终端新建一个配置文件，名称随意，系统会自动检测，如default.conf :

sudo nano /etc/mosquitto/conf.d/default.conf

输入内容：

#修改端口
port 1883

# 不允许匿名访问，需要提供 用户名&密码 才能连接服务器
allow_anonymous false

# 指定要使用的 用户名&密码 文件，需手动创建该文件
password_file /etc/mosquitto/pwfile

# 指定权限控制文件存放路径，需手动创建该文件
acl_file /etc/mosquitto/aclfile

然后按ctrl+x保存退出。

新建账户​

这个账号和密码用于登录MQTT服务器。核桃派 /etc/mosquitto/ 目录使用下面指令新建一个文件，文件名称和前面配置的名称 pwfile要一致。

sudo touch /etc/mosquitto/pwfile

增加文件后需要使用mosquitto_passwd命令来创建账号密码：这里以新建一个账号：pi ，密码：pi 的账户来测试。

sudo mosquitto_passwd /etc/mosquitto/pwfile pi

然后后提示输入密码即可。

提示

密码不会显示，注意区分大小写，需要需要2次。

install

设定账号权限​

这个功能主要是让不同用户过滤掉MQTT服务器一些没用的信息。可选功能，如果不设置就表示接收全部主题信息。

在核桃派 /etc/mosquitto/ 目录使用下面指令新建一个账号权限文件，文件名称和前面配置的名称 aclfile要一致。

sudo nano /etc/mosquitto/aclfile

文件内输入：

user pi
topic #

表示然后按ctrl+x保存退出。

上面内容表示pi用户接收所有MQTT topic信息，如： topic walnutpi/# 则表示只接受walnutpi/开头的topic相关信息。其它主题会屏蔽。

所有配置完成后通过下面指令重启MQTT服务以生效：

配置完成后重启MQTT服务器以便配置生效：

sudo service mosquitto restart

测试MQTT服务器​

在核桃派上安装完MQTT服务器后可以使用MQTT助手测试，这里推荐一款功能比较齐全的测试助手，叫MQTTX，支持windows, mac, linux等平台，在今后MQTT实验里面会经常借助MQTT助手来调试。这里基于windows安装使用：

下载和安装MQTTX​

下载地址：https://mqttx.app/zh/downloads

选择自己电脑合适版本下载，下图是Windows 64位系统：

install

下载完成后直接安装即可。

连接核桃派MQTT服务器并测试​

打开安装好的MQTTX ，可以看到界面非常简洁：

install

点击连接旁边的 + 按钮，选 新建连接 新建一个链接：

install

输入核桃派MQTT服务器信息：

  • 名称：随意；
  • 服务器地址：填写核桃派的IP地址；
  • 用户名和密码：前面配置的用户名和密码，如果使用Home Assistant镜像，则默认用户名：pi；密码：pi。

其它信息默认即可。

install

然后点击连接，连接成功后会有提示：

install

连接成功后订阅一个测试的主题，点击添加主题：

install

在弹出窗口主题位置输入 ：walnutpi/1 ，这里的-walnutpi/1是主题名称，可以自己定义，点击确认。

install

然后回到主窗口，在右侧按下图选择数据类型和输入主题和信息，主题必须和订阅的一致，输入完成后按右下角发送按钮：

install

可以看到对话框出现了2条信息，右边为发送的内容，左边为接收内容。说明核桃派MQTT服务器收发正常。

install