Ubuntu 16.04 下 MQTT 服务器搭建之Mosquitto

冷不防 2022-02-03 01:04 606阅读 0赞

Mosquitto 是一款实现了消息推送协议MQTT v3.1的开源消息代理软件，提供轻量级的、支持可发布/可订阅的消息推送模式

**1、安装编译**  
(1)安装 libwebsockets-2.0.2.tar.gz  
解压：

tar -zxvf libwebsockets-2.0.2

进入该目录:

cd libwebsockets-2.0.2/

新建目录 build

mkdir build

进入 build

cd build

cmake ..

make

make install

这里需要注意，cmake .. 提示 程序“cmake”尚未安装

安装 sudo apt-get install cmake

**2、安装 mosquitto**  
解压：mosquitto-1.4.14

tar -zxvf mosquitto-1.4.14.tar.gz

进入该目录：

cd mosquitto-1.4.14/

更改config.mk 让其支持 websockets  
WITH\_WEBSOCKETS:=no  
为  
WITH\_WEBSOCKETS:=yes

编译：

make

make install

**这里会出现两处错误：**

error: openssl/opensslv.h: No such file or directory  
解决方法：

sudo apt-get install libssl-dev

**3、修正链接库路径**  
由于操作系统版本及架构原因，很容易出现安装之后的链接库无法被找到，如启动mosquitto客户端可能出现找不到  
libmosquitto.so.1或libwebsockets.so，因此需要添加链接库路径

修正链接库  
vim /etc/ld.so.conf.d/libc.conf

添加：  
/usr/local/lib64  
/usr/local/lib  
再执行 ldconfig

**4、修改mosquitto.conf文件**

cd** **/etc/mosquitto/

cp mosquitto.conf.example mosquitto.conf

在 /etc/mosquitto/mosquitto.conf 的 Default Listener 一节添加如下几行：

\# =================================================================  
\# Default listener  
\# =================================================================  
   
\# IP address/hostname to bind the default listener to. If not  
\# given, the default listener will not be bound to a specific   
\# address and so will be accessible to all network interfaces.  
\# bind\_address ip-address/host name  
\#bind\_address  
   
\# Port to use for the default listener.  
pid\_file /var/run/mosquitto.pid  
user hugo  
port 1883  
max\_connections -1  
allow\_anonymous true  
listener 8080  
protocol websockets

**注意：上述添加的内容最后不要加空格，否则报错**

这里有出现两个问题：

Error: Invalid user 'mosquitto'.

解决方法：修改配置文件 mosquitto.conf ，增加登录的用户，例如当前登录用户为root

因此在上面添加  user hugo

但是运行 mosquitto 时会出现警告

1502156001: Warning: Mosquitto should not be run as root/administrator.

所以改为普通用户 user hugo  （改成你自己的）

**5、测试**

（1）打开mosquitto  
 打开一个终端输入

mosquitto -c /etc/mosquitto/mosquitto.conf

\# mosquitto -c /etc/mosquitto/mosquitto.conf  
1502159482: mosquitto version 1.4.14 (build date 2017-08-07 15:54:10+0800) starting  
1502159482: Config loaded from /etc/mosquitto/mosquitto.conf.  
1502159482: Opening websockets listen socket on port 8080.  
1502159482: Opening ipv4 listen socket on port 1883.  
1502159482: Opening ipv6 listen socket on port 1883.  
mosquitto 选项介绍：

参看：mosquitto Options

\-c，--config文件  
    从文件加载配置。 如果没有给出，则使用mosquitto.conf（5）中描述的默认值。  
\-d，--daemon  
    在后台运行蚊子作为守护进程。 所有其他行为保持不变。  
\-p，--port  
    在指定的端口上监听，而不是默认的1883.除了配置文件中的端口设置外，还会起作用。 可以指定多次以打开在不同端口上侦听的多个套接字。 该套接字将绑定到所有网络接口。  
\-v，--verbose  
    使用详细日志记录。 这相当于在配置文件中将log\_type设置为全部。 这种覆盖和记录选项在配置文件中给出。

（2）订阅主题  
打开另一个终端输入：

mosquitto\_sub -t test

此时第一个终端多了一行信息  
\# mosquitto -c /etc/mosquitto/mosquitto.conf  
1502159482: mosquitto version 1.4.14 (build date 2017-08-07 15:54:10+0800) starting  
1502159482: Config loaded from /etc/mosquitto/mosquitto.conf.  
1502159482: Opening websockets listen socket on port 8080.  
1502159482: Opening ipv4 listen socket on port 1883.  
1502159482: Opening ipv6 listen socket on port 1883.  
1502159601: New connection from 127.0.0.1 on port 1883.  
1502159601: New client connected from 127.0.0.1 as mosqsub|2431-ubuntu (c1, k60)  
mosquitto\_sub 选项介绍

参看：mosquitto\_sub Options

下面的选项可以在命令行中给出，但也可以放置在位于$ XDG\_CONFIG\_HOME / mosquitto\_sub或$ HOME / .config / mosquitto\_sub的配置文件中，每行一对 - 吸附值。配置文件中的值将被用作默认值，并且可以通过使用命令行来覆盖。这个例外是-t和-T，如果在配置文件中给出，将不会被覆盖。还要注意，目前一些选项不能被否定，例如-S。具有＃作为第一个字符的配置文件行将被视为注释，不会进一步处理。  
\-a  
将输出连接绑定到本地IP地址/主机名。如果需要将网络通信限制在特定接口上，请使用此参数。  
\-c，--disable-clean-session  
禁用“'clean session”标志。这意味着客户端的所有订阅将在断开连接后维护，以及到达的后续QoS 1和QoS 2消息。当客户端重新连接时，它将接收所有排队的消息。如果使用此选项，建议使用 -id 手动设置客户机ID  
\--cafile  
定义包含受信任的PEM编码的CA证书的文件的路径。用于启用SSL通信。另请参见--capath  
\--capath  
定义包含受信任的PEM编码的CA证书的目录的路径。用于启用SSL通信。  
为了--capath正常工作，证书文件必须具有“.crt”作为文件结束，您必须在每次添加/删除证书时运行“c\_rehash <path to capath>”。另请参见--cafile  
\--cert  
如果服务器需要，定义包含此客户端的PEM编码证书的文件的路径。另请参阅--key。  
\--ciphers  
在客户端支持的TLS密码的openssl兼容列表。有关详细信息，请参阅密码（1）。  
\-C  
在接收到给定的消息数后立即断开并退出程序。例如，在需要单个状态值的shell脚本中这可能很有用。  
结合-R来仅打印第一组新消息（即，没有设置保留标志），或者使用 -T 来过滤哪些主题被处理。  
\-d，--debug  
启用调试消息。  
\- help  
显示使用信息。  
\-h，--host  
指定要连接的主机。默认为localhost。  
\-i，--id  
该客户端使用的id。如果没有给出，默认为mosquitto\_sub\_附加客户端的进程ID。不能与-id-prefix参数同时使用。  
\-I，-id-prefix  
通过追加客户端的进程标识来提供客户端ID的前缀。这在代理使用clientid\_prefixes选项时很有用。不能与-id参数同时使用。  
\--insecure  
使用基于证书的加密时，此选项将禁用对服务器证书中服务器主机名的验证。这在测试初始服务器配置时可能很有用，但是通过DNS欺骗可以让恶意第三方冒充您的服务器。仅在测试中使用此选项。如果您需要在生产环境中使用此选项，则您的设置会出现故障，并且无需使用加密。  
\-k，--keepalive  
发送PING命令到经纪人以通知它之前的秒数仍然是连接和运行的。默认为60秒。  
\- key  
如果服务器需要，定义包含此客户端的PEM编码私钥的文件的路径。另请参见--cert。  
\-N  
打印时，不要在有效负载上附加行尾符号。这允许将来自多个消息的有效载荷数据直接传输到另一个应用程序。只有在不使用-v的时候才真正有意义。  
\-p，--port  
连接到指定的端口而不是默认端口1883。  
\-P， - pw  
提供用于与经纪人进行认证的密码。在不指定用户名的情况下使用此参数是无效的。这需要一个支持MQTT v3.1的代理。另请参阅--username选项。  
\- proxy  
指定要连接的SOCKS5代理。支持“无”和“用户名”身份验证类型。 socks-url必须是形式socks5h：// \[username \[：password\] @\] host \[：port\]。协议前缀socks5h表示主机名由代理解析。符号％25，％3A和％40分别被URL解码为％，...和@，如果存在于用户名或密码中。  
如果没有给出用户名，则不会尝试认证。如果没有给出端口，则使用默认值为1080。  
根据需求，将来可能会有更多SOCKS版本，并且将使用不同的协议前缀，如卷曲（1）所述。  
\--psk  
提供与代理使用的十六进制（无前导0x）预共享密钥，以使用TLS-PSK加密支持。还必须提供--psk身份以启用TLS-PSK。  
\--psk身份  
使用TLS-PSK支持的客户端身份。这可以用来代替用户名

（3）发布内容  
再打开一个终端输入：

mosquitto\_pub -t test -m "hello world"

此时第二个终端多了一行信息  
\# mosquitto\_sub -v -t test  
hello world  
mosquitto\_pub 选项介绍

参看：mosquitto\_pub Options

下面的选项可以在命令行中给出，但是也可以放置在位于$ XDG\_CONFIG\_HOME / mosquitto\_pub或$ HOME / .config / mosquitto\_sub的配置文件中，每行一对 - 吸附值。配置文件中的值将被用作默认值，并且可以通过使用命令行来覆盖。这个例外是消息类型选项，其中只能指定一个。还要注意，目前一些选项不能被否定，例如-S。具有＃作为第一个字符的配置文件行将被视为注释，不会进一步处理。  
\-a  
将输出连接绑定到本地IP地址/主机名。如果需要将网络通信限制在特定接口上，请使用此参数。  
\--cafile  
定义包含受信任的PEM编码的CA证书的文件的路径。用于启用SSL通信。另请参见--capath  
\--capath  
定义包含受信任的PEM编码的CA证书的目录的路径。用于启用SSL通信。  
为了--capath正常工作，证书文件必须具有“.crt”作为文件结束，您必须在每次添加/删除证书时运行“c\_rehash <path to capath>”。另请参见--cafile  
\--cert  
如果服务器需要，定义包含此客户端的PEM编码证书的文件的路径。另请参阅--key。  
\--ciphers  
在客户端支持的TLS密码的openssl兼容列表。有关详细信息，请参阅密码（1）。  
\-d，--debug  
启用调试消息。  
\-f，--file  
发送文件的内容作为消息。  
\- help  
显示使用信息。  
\-h，--host  
指定要连接的主机。默认为localhost。  
\-i，--id  
该客户端使用的id。如果没有给出，默认为mosquitto\_pub\_附加客户端的进程ID。不能与-id-prefix参数同时使用。  
\-I，-id-prefix  
通过追加客户端的进程标识来提供客户端ID的前缀。这在代理使用clientid\_prefixes选项时很有用。不能与-id参数同时使用。  
\--insecure  
使用基于证书的加密时，此选项将禁用对服务器证书中服务器主机名的验证。这在测试初始服务器配置时可能很有用，但是通过DNS欺骗可以让恶意第三方冒充您的服务器。仅在测试中使用此选项。如果您需要在生产环境中使用此选项，则您的设置会出现故障，并且无需使用加密。  
\-k，--keepalive  
发送PING命令到经纪人以通知它之前的秒数仍然是连接和运行的。默认为60秒。  
\-key  
如果服务器需要，定义包含此客户端的PEM编码私钥的文件的路径。另请参见--cert。  
\-l，--stdin-line  
发送从stdin读取的消息，将单独的行分成单独的消息。请注意，空行不会被发送。  
\-m， - 消息  
从命令行发送一条消息。  
\-n， - 消息  
发送null（零长度）消息。  
\-p，--port  
连接到指定的端口而不是默认端口1883。  
\-P， - pw  
提供用于与经纪人进行认证的密码。在不指定用户名的情况下使用此参数是无效的。这需要一个支持MQTT v3.1的代理。另请参阅--username选项。  
\-proxy  
指定要连接的SOCKS5代理。支持“无”和“用户名”身份验证类型。 socks-url必须是形式socks5h：// \[username \[：password\] @\] host \[：port\]。协议前缀socks5h表示主机名由代理解析。符号％25，％3A和％40分别被URL解码为％，...和@，如果存在于用户名或密码中。  
如果没有给出用户名，则不会尝试认证。如果没有给出端口，则使用默认值为1080。  
根据需求，将来可能会有更多SOCKS版本，并且将使用不同的协议前缀，如卷曲（1）所述。  
\--psk  
提供与代理使用的十六进制（无前导0x）预共享密钥，以使用TLS-PSK加密支持。还必须提供--psk身份以启用TLS-PSK。  
\--psk身份  
使用TLS-PSK支持的客户端身份。如果代理配置为这样做，则可以使用这可以替代用户名。  
\-q，--qos  
指定消息的使用质量，从0，1和2.默认为0。  
\- quiet  
如果给出此参数，则不会打印运行时错误。这排除了在无效用户输入的情况下给出的任何错误消息（例如使用 - 没有端口的端口）。  
\-r， - 保存  
如果保留被赋予，则该消息将被保留为经纪人的“最后已知的良好”值。有关更多信息，请参阅mqtt（7）。  
\-s，--stdin-file  
发送从stdin读取的消息，将整个内容作为单个消息发送。  
\-S  
使用SRV查找来确定要连接的主机。当我们执行查询\_mqtt.\_tcp

不过如果直接将第一个终端关闭再打开 mosquitto 会出现一个问题

Error: Address already in use

解决方法：重启...   别的方法暂时不知道呢