附上:
喵了个咪的博客:w-blog.cn
EMQ官方地址:http://emqtt.com/
EMQ中文文档:http://emqtt.com/docs/v2/guide.html
1.TLS证书验证
为了保障安全.我们常常会使用HTTPS来保障请求不被篡改,作为MQTT使用TLS加密的方式来保障传输安全
EMQ默认使用的TLS加密的端口是8883端口,默认证书在EMQ目录下etc/certs:
对应的配置文件在emq.conf中,可以修改你的端口和配置文件路径
listener.ssl.external = 8883
listener.ssl.external.keyfile = etc/certs/key.pem
listener.ssl.external.certfile = etc/certs/cert.pem
PS:在链接的时候注意需要从之前的链接前缀做如此修改 tcp:// -> ssl://
2.使用Docker部署EMQ
使用Docker部署EMQ很方便版本升级,端口管理和单节点多EMQ等,对于性能来说基本没有带来额外的开销
但是官方并没有提供对于直接可以用的Docker镜像,但是提供的GIT大家可以自己打包以及压缩包,笔者因为使用这里打成了公共进行如下(2.3.5往上版本都会进维护):
registry.cn-hangzhou.aliyuncs.com/sunmi-base/sunmi-emq:2.3.5
registry.cn-hangzhou.aliyuncs.com/sunmi-base/sunmi-emq:2.3.6
registry.cn-hangzhou.aliyuncs.com/sunmi-base/sunmi-emq:2.3.7
当然更重要的一点就是关于配置,EMQ提供通过环境变量的方式影响配置文件,大家可以参考一下daocker-composer和Kubernetes的编排文件,通过环境变量的方式进行配置文件的修改,一下编排配置了mysql鉴权以及自定义鉴权语句和默认开启mysql鉴权插件
version: '2'
services:
emq:
image: 'registry.cn-hangzhou.aliyuncs.com/sunmi-base/sunmi-emq:2.3.7'
ports:
- '31883:1883'
- '31083:18083'
- '38883:8883'
environment:
- EMQ_MQTT__ALLOW_ANONYMOUS=false
- EMQ_AUTH__MYSQL__USERNAME=emq
- EMQ_AUTH__MYSQL__PASSWORD=Emq666
- EMQ_AUTH__MYSQL__DATABASE=emq
- "EMQ_AUTH__MYSQL__SERVER=xxxxxx:3306"
- "EMQ_AUTH__MYSQL__AUTH_QUERY=select password from mqtt_user where username = '%u' limit 1"
- "EMQ_AUTH__MYSQL__SUPER_QUERY=select is_superuser from mqtt_user where username = '%u' limit 1"
- "EMQ_AUTH__MYSQL__ACL_QUERY=select allow, ipaddr, username, clientid, access, REPLACE(topic,'$user','%u') from mqtt_acl where ipaddr = '%a' or username = '%u' or username = '$all' or clientid = '%c'"
- "EMQ_LOADED_PLUGINS=emq_auth_mysql,emq_recon,emq_modules,emq_retainer,emq_dashboard"
restart: always
以下是K8S编排文件:
apiVersion: extensions/v1beta1 # K8S对应的API版本
kind: Deployment # 对应的类型
metadata:
name: emq-deployment
labels:
name: emq-deployment
spec:
replicas: 1 # 镜像副本数量
template:
metadata:
labels: # 容器的标签 可和service关联
app: emq
spec:
containers:
- name: emq # 容器名和镜像
image: registry.cn-hangzhou.aliyuncs.com/sunmi-base/sunmi-emq:2.3.6
imagePullPolicy: Always
env: # 环境变量
- name: EMQ_MQTT__ALLOW_ANONYMOUS
value: "false"
- name: EMQ_AUTH__MYSQL__USERNAME
value: "emq"
- name: EMQ_AUTH__MYSQL__PASSWORD
value: "Emq666"
- name: EMQ_AUTH__MYSQL__DATABASE
value: "emq"
- name: EMQ_AUTH__MYSQL__SERVER
value: "xxxxxx:3306"
- name: EMQ_AUTH__MYSQL__AUTH_QUERY
value: "select password from mqtt_user where username = '%u' limit 1"
- name: EMQ_AUTH__MYSQL__SUPER_QUERY
value: "select is_superuser from mqtt_user where username = '%u' limit 1"
- name: EMQ_AUTH__MYSQL__ACL_QUERY
value: "select allow, ipaddr, username, clientid, access, REPLACE(topic,'$user','%u') from mqtt_acl where ipaddr = '%a' or username = '%u' or username = '$all' or clientid = '%c'"
- name: EMQ_LOADED_PLUGINS
value: "emq_auth_mysql,emq_recon,emq_modules,emq_retainer,emq_dashboard"
---
apiVersion: v1
kind: Service
metadata:
name: emq-service # 名称
labels:
name: emq-service
spec:
type: NodePort # 开发端口的类型
selector: # service负载的容器需要有同样的labels
app: emq
ports:
- name: emq-service-1883-30111
port: 1883 # 通过service来访问的端口
targetPort: 1883 # 对应容器的端口
nodePort: 30111
- name: emq-service-8883-30112
port: 8883 # 通过service来访问的端口
targetPort: 8883 # 对应容器的端口
nodePort: 30112
- name: emq-service-18083-30113
port: 18083 # 通过service来访问的端口
targetPort: 18083 # 对应容器的端口
nodePort: 30113
PS:需要在宿主机做好TCP链路优化
3.Goalng客户端
笔者这边使用的是gobot库基于https://github.com/eclipse/paho.mqtt.golang paho体系下的库,例子如下:
package main
import (
"gobot.io/x/gobot"
"gobot.io/x/gobot/platforms/mqtt"
"fmt"
"time"
)
func main() {
mqttAdaptor := mqtt.NewAdaptor("tcp://0.0.0.0:1883", "pinger")
work := func() {
mqttAdaptor.On("hello", func(msg mqtt.Message) {
fmt.Println(msg)
})
mqttAdaptor.On("hola", func(msg mqtt.Message) {
fmt.Println(msg)
})
data := []byte("o")
gobot.Every(1*time.Second, func() {
mqttAdaptor.Publish("hello", data)
})
gobot.Every(5*time.Second, func() {
mqttAdaptor.Publish("hola", data)
})
}
robot := gobot.NewRobot("mqttBot",
[]gobot.Connection{mqttAdaptor},
work,
)
robot.Start()
}
使用 mqttAdaptor.Publish可以发送消息 mqttAdaptor.On 可以订阅消息,如果有用户验证可以使用如下方式:
mqttAdaptor = mqtt.NewAdaptorWithAuth(
"EMQ.host",
"EMQ.clientID",
"EMQ.userName",
"EMQ.passWordActive",
)
断开也可以配置重连规则自动重连(默认未开启,作为服务端强烈建议开启)
mqttAdaptor.SetAutoReconnect(true)
以及消息清理机制(默认断开连接清理消息)
mqttAdaptor.SetCleanSession(false)
也可以指定使用TLS证书连接
mqttAdaptor.SetUseSSL(true)
# 下面可以指定证书(如果EMQ使用了标准的CA证书下面就不用配置了)
mqttAdaptor.SetClientKey(`/client/client-key.pem`)
mqttAdaptor.SetClientCert(`/client/client-cert.pem`)
4. 总结
在EMQ和MQTT使用过程中还有很多的细节需要注意,关注细节才能走的更远
注:笔者能力有限有说的不对的地方希望大家能够指出,也希望多多交流!