emqx-5.1.4开源版使用记录
windows系统安装eqmx
去官网下载 emqx-5.1.4-windows-amd64.zip，然后找个目录解压
进入bin目录,执行命令启动emqx
执行命令
emqx.cmd start
使用emqx
访问内置的web管理页面
浏览器访问地址
http://localhost:18083/#/dashboard/overview
默认登录账户admin 密码public ，第一次登录后会提示要求更改密码
设置客户端认证(mqtt账密)
进入客户端认证菜单，创建认证
创建mqtt用户名/密码认证
使用内置数据库
设置账号类型username，密码加密方式 sha256,加盐方式suffix
进入用户管理tab，添加mqtt连接的账号密码，
建议设置1个超级用户和多个普通用户，
超级用户可以用来订阅/管理或监控其他用户 （详见客户端授权配置）
使用MQTTX工具测试MQTT联通性
emqx提供的mqtt-server的端口和地址分别是第1种mqtt协议
url: mqtt://127.0.0.1
port: 1883
第2种websocket协议
url: ws://127.0.0.1:8083/mqtt
测试刚刚创建的3对mqtt账密，看看是否能登录连接成功，登录成功则说明账户是可用的
| mqtt账号 | mqtt密码 | |
|---|---|---|
| 管理员 | admin | emqx |
| 普通1 | c01 | 123456 |
| 普通2 | c02 | 123456 |
设置客户端授权(acl管控)
进入客户端授权菜单，创建acl授权
创建acl授权信息使用的数据源，这里我继续使用内置数据库
修改权限管理tab页面，按用户名设置ACL权限信息
这里我分别对admin , c01 ,c02 这3个用户设置了ACL权限，如下表
| 用户 | 允许 | 禁止 |
|---|---|---|
| admin | 允许对 # 发布和订阅 | |
| c01 | 允许订阅up/cck/stat/cck2 ，允许发布up/cck/stat/cck1 | 禁止订阅$SYS/# |
| c02 | 允许订阅up/cck/stat/cck1 ，允许发布up/cck/stat/cck2 | 禁止订阅$SYS/# |
同使用时MQTTX、MQTT Explorer 和通信猫工具来测试ACL权限
先使用 通信猫 工具登陆c01用户，订阅up/cck/stat/cck2 ，向up/cck/stat/cck1发布消息
然后使用 MQTTX 工具 登陆c02用户，订阅up/cck/stat/cck1 ，向up/cck/stat/cck2发布消息
再使用 MQTT Explorer 工具 登陆admin用户 ，观察EMQX所有Topic主题情况
使用emqx提供的swagger服务
swagger访问地址
http://localhost:18083/api-docs/index.html
通过api密钥使用emqx的开放api
eqmx新增API密钥
记下emqx页面上生成的api密钥对信息，后面java代码http调用emqx时会用到这个api密钥对
swagger在线测试刚刚的API密钥对
swagger在线接口文档使用API密钥登录后，即可在线测试EQMX开放的这些接口
实际开发中，如 java开发 IOT云平台，可以从emqx 开放的api 中获取mqtt服务器 所有暴露出的信息指标
