Mosquitto的搭建（websocket、ssl、auth-plug）及坑点总结

Mosquitto的搭建及坑点总结

　　主要讲述的是eclipse-mosquitto的C语言版本的搭建，主要是为了从1.4.15版本升级到1.6.9，为解决一些webSocket和数据格式问题。

　　因为根据不同的业务和使用方式，需要不同的插件配合，本次在centos7搭建主要是需要WebSocket、SSL和mosquitto-auth-plug等一些插件组合

---

搭建准备工具

1. centos7环境
2. 安装WebSocket
3. 安装Openssl，创建CA和SSL证书
4. 下载编译mosquitto的环境
5. 安装mosquitto-auth-plug插件，主要为了给mysql鉴权插件

---

搭建步骤

　　1、首先下载相关必要的插件，避免在下面安装中出现的问题

yum install gcc gcc-c++ -y
yum install c-ares-devel -y
yum install uuid-devel -y
yum install libuuid-devel -y

#mosquittos所需插件
yum install libxslt -y
yum install docbook-style-xsl -y
yum install crypto-utils -y

#安装openssl相关插件
yum install openssl -y
yum install openssl-devel -y

#安装git
yum install git -y

#安装编译工具
yum install cmake -y

yum install vim -y
 #安装mysql插件
yum install mariadb-devel -y

---

　2、安装Websocket，主要是github上的源代码编译

git clone https://github.com/warmcat/libwebsockets.git
cd libwebsockets
mkdir build
cd build
cmake ..
make
make install

 　　libwebsockets自身提供测试方法，在测试程序在编译目录build/bin中，libwebsockets-test-client 和 libwebsockets-test-server 

• 运行服务端：libwebsockets-test-server
• 运行客户端：libwebsockets-test-client 127.0.0.1 --port=7681   

---

　3、mosquitto安装，github最新代码，可自行checkout tag修改版本

 git clone https://github.com/eclipse/mosquitto.git

 cd mosquitto
#修改 支持websockets
 sed -i 's/WITH_WEBSOCKETS:=no/WITH_WEBSOCKETS:=yes/g'  config.mk 
 make
 make install
 adduser mosquitto

#启动可能会报错找不到链接库
 echo "/usr/local/lib64" >> /etc/ld.so.conf.d/liblocal.conf
 echo "/usr/local/lib" >> /etc/ld.so.conf.d/liblocal.conf
 ldconfig

　　不同的版本make编译的时候可能需要安装相关配置

　　例如：mosquitto的1.4.15安装的时候，有docbook相关的问题存在： xsltParseStylesheetProcess : document is not a stylesheet

　　解决办法：安装yum -y install docbook-style-xsl ，还会发现 在man/manpage.xsl文件中docbook的地址不对应，需要找到对应的docbook地址（find / -name docbook.xsl）替换

　　还有一些相关的问题可在这几个博主中得到解决：

1. https://blog.csdn.net/houjixin/article/details/46711547
2. https://blog.csdn.net/u013414502/article/details/79175871

　　一般来说，安装完之后，mosquitto的配置文件目录是在/etc/mosquitto/下，可将mosquitto.conf.example 复制cp一份为mosquitto.conf 可以使用命令：mosquitto -c mosquitto.conf 测试是否启动成功

---

　　4、mosquitto-auth-plug安装，需先安装完mosquitto

git clone https://github.com/jpmens/mosquitto-auth-plug.git
cd mosquitto-auth-plug/
cp config.mk.in config.mk

#修改config.mk 其他为no 默认BACKEND_MYSQL ?= yes 

#mosquitto源码位置
sed -i 's/MOSQUITTO_SRC =/MOSQUITTO_SRC = /build/mosquitto/g'  config.mk

#openssl位置，openssl version -a 查看 默认/etc/pki/tls
sed -i 's/OPENSSLDIR = /usr/OPENSSLDIR = /etc/pki/tls/g'  config.mk

#修改mosquitto-auth-plug的一些错误
sed -i "s/const struct mosquitto /struct mosquitto /g" /build/mosquitto-auth-plug/auth-plug.c 

make 
mv auth-plug.so /etc/mosquitto 

　　　　

---

　5、SSL的安装配置

　　在最开始已经将openssl安装好了，直接自己配置好证书文件就好

• CA证书签发

openssl req -new -x509 -days 36500 -extensions v3_ca -keyout ca.key -out ca.crt

• 为mosquitto产生服务端的私钥文件“server.key”和证书文件”server.crt”

#产生一个私钥文件server.key
openssl genrsa -out server.key 2048

#签发证书的请求文件“server.csr”
openssl req -out server.csr -key server.key -new

#证书文件server.crt
openssl x509 -req -in server.csr -CA ca.crt-CAkey ca.key -CAcreateserial -out server.crt -days 36500

　　客户端的证书也是一样的流程，不同的名字而已，具体可以参考：https://mosquitto.org/man/mosquitto-tls-7.html

---

 　　以上五个步骤操作完成，就可以使用了，可能会根据不同的环境出现一些其他问题，可以多看看错误提示，一般性问题都是可以解决的，剩下的就是具体配置mosquitto.conf文件，根据不同的业务要求配置。