一、安装步骤
1、EMQX-RPM包-下载地址
https://www.emqx.io/cn/downloads
1.1、EMQX下载版本注意事项
两个版本机制:4.0以上和4.0以下,下载4.0以上,4.0一下版本老化以及配置参数低,且用户账号和密码后期维护复杂
版本参照:emqx-centos7-v4.0.7.x86_64
2、安装指令
rpm -ivh rpm安装包
3、EMQX启动和停止
启动: systemctl start emqx 或者 systemctl enable emqx
停止:systemctl stop emqx
4、EMQX查看启动成功状态
命令:emqx_ctl status
成功则显示下面两段:
Node 'emqx@127.0.0.1' is started
emqx 4.0.7 is running
5、安装成功之后的路径
路径:/etc/emqx
路径内容:
acl.conf certs emqx.conf lwm2m_xml plugins psk.txt ssl_dist.conf vm.args
主要路径解释:
acl.conf:添加系统主题配置文件即携带 sys 主题则为系统主题
emqx.conf:emqx配置文件,设置消息是否保留以及开启用户密码连接
plugins:emqx各类插件文件包括身份权限验证
二、EMQX安装成功之后优化及配置
1、系统主题配置-(acl.conf)
举例:
{allow, all subscribe, ["$SYS/brokers/+/clients/#"]}.
2、关闭保留消息及关闭匿名(账号和密码)登录-(emqx.conf)
关闭保留消息:mqtt.retain_available = true 改为false
注意:如果为true 则如果mq有未及时处理的消息或者重复消息,下次连接就会再次发送出来
允许匿名:allow_anonymous = true 改为false
注意:改为false不允许匿名,必须使用账号和密码连接
三、创建用户和密码连接
1、plugins目录找到emqx_auth_username.conf设置用户和密码
命令:cd /etc/emqx/plugins/ 然后:vim emqx_auth_username.conf
或者:vim /etc/emqx/plugins/emqx_auth_username.conf
2、设置账号和密码(可以是单个,可以是多个)
## 第一组认证数据
auth.user.1.username = 账号(自定义)
auth.user.1.password = 密码(自定义)
## 第二组认证数据
auth.user.2.username = 账号(自定义)
auth.user.2.password = 密码(自定义)
3、命令方式添加用户和密码以及删除用户
3.1、添加用户
users add <Username> <Password>
3.2、更新用户
users update <Username> <NewPassword>
3.3、删除用户
users del <Username>
**4、查看EMQX所有命令以及查看当前设置的用户****
查看EMQX所有命令:emqx_ctl list
查看当前设置的用户:emqx_ctl users list
四、打开EMQX后台管理
4.1、 登录地址及默认账号和密码
网址:ip :18083
默认登录账号和密码: 用户名 admin 密码public
4.2 、设置中文
在ADMIN模块下的Settings中切换中文显示
五、设置完账号和密码连接注意事项
注意:打开后台管理在管理模块下的插件中开启emqx_auth_username 否则设置的用户名和密码不起作用