emqx-5.1.4开源版使用记录

小灰灰 2024-03-23 21:18 19阅读 0赞

## emqx-5.1.4开源版使用记录 ##

### windows系统安装eqmx ###

#### 去官网下载 emqx-5.1.4-windows-amd64.zip，然后找个目录解压 ####

![在这里插入图片描述][61e5ab1d39624ecf88fa796a88861f9b.png_pic_center]

#### 进入bin目录,执行命令启动emqx ####

![在这里插入图片描述][4dc3a44a408444baaf17776599723ffa.png_pic_center]

执行命令
    emqx.cmd start

![在这里插入图片描述][5306d337387d4a4091ede1e47bc58ac9.png_pic_center]

### 使用emqx ###

#### 访问内置的web管理页面 ####

浏览器访问地址

http://localhost:18083/#/dashboard/overview

默认登录账户admin 密码public ，第一次登录后会提示要求更改密码

![在这里插入图片描述][0c9c85f2f80d428cab533c9dd626bae0.png_pic_center]

#### 设置客户端认证(mqtt账密) ####

##### 进入客户端认证菜单，创建认证 #####

![在这里插入图片描述][d5ae18568d464efe8001f8b2e83ef917.png_pic_center]

创建mqtt用户名/密码认证

![在这里插入图片描述][487fbf53d7a447c38898b60bb1119de0.png_pic_center]

使用内置数据库

![在这里插入图片描述][9855c7ae11b44fdcbb366ba5306e60a0.png_pic_center]

设置账号类型username，密码加密方式 sha256,加盐方式suffix

![在这里插入图片描述][989ab854082a4cbf96a7e2a507f7b6ec.png_pic_center]

进入用户管理tab，添加mqtt连接的账号密码，

建议设置1个超级用户和多个普通用户，

超级用户可以用来订阅/管理或监控其他用户 （详见客户端授权配置）

![在这里插入图片描述][74c1fe623af44abb819d7e14753e0c44.png_pic_center]

##### 使用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账密，看看是否能登录连接成功，登录成功则说明账户是可用的

<table> 
 <thead> 
  <tr> 
   <th></th> 
   <th>mqtt账号</th> 
   <th>mqtt密码</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>管理员</td> 
   <td>admin</td> 
   <td>emqx</td> 
  </tr> 
  <tr> 
   <td>普通1</td> 
   <td>c01</td> 
   <td>123456</td> 
  </tr> 
  <tr> 
   <td>普通2</td> 
   <td>c02</td> 
   <td>123456</td> 
  </tr> 
 </tbody> 
</table>

![在这里插入图片描述][6dc9110eb5d6404aa64c0a0028555694.png_pic_center]

#### 设置客户端授权(acl管控) ####

##### 进入客户端授权菜单，创建acl授权 #####

![在这里插入图片描述][a8e420c25e4c46b4a306b12a2923284c.png_pic_center]

创建acl授权信息使用的数据源，这里我继续使用内置数据库

![在这里插入图片描述][beba891a087f4940a09a778d1845a32c.png_pic_center]

![在这里插入图片描述][ba9c93d633814f6a841a061a834b9ec5.png_pic_center]

修改权限管理tab页面，按用户名设置ACL权限信息

![在这里插入图片描述][d6b6bc2f0b41445980f972f45058ff0a.png_pic_center]

![在这里插入图片描述][68d08685ac1848359d1883630993a9b8.png_pic_center]

![在这里插入图片描述][1ca53a5f95d64553a16ef2df7077f8bb.png_pic_center]

![在这里插入图片描述][70bedde3847c4e89965bc2f545614733.png_pic_center]

这里我分别对admin , c01 ,c02 这3个用户设置了ACL权限，如下表

<table> 
 <thead> 
  <tr> 
   <th>用户</th> 
   <th>允许</th> 
   <th>禁止</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>admin</td> 
   <td>允许对 # 发布和订阅</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>c01</td> 
   <td>允许订阅up/cck/stat/cck2 ，允许发布up/cck/stat/cck1</td> 
   <td>禁止订阅$SYS/#</td> 
  </tr> 
  <tr> 
   <td>c02</td> 
   <td>允许订阅up/cck/stat/cck1 ，允许发布up/cck/stat/cck2</td> 
   <td>禁止订阅$SYS/#</td> 
  </tr> 
 </tbody> 
</table>

##### 同使用时MQTTX、MQTT Explorer 和通信猫工具来测试ACL权限 #####

先使用 通信猫 工具登陆c01用户，订阅up/cck/stat/cck2 ，向up/cck/stat/cck1发布消息

![在这里插入图片描述][3d58718088a848878e8a3e1473595aac.png_pic_center]

然后使用 MQTTX 工具 登陆c02用户，订阅up/cck/stat/cck1 ，向up/cck/stat/cck2发布消息

![在这里插入图片描述][6712168b9ec14b1b873835f8896d0f92.png_pic_center]

再使用 MQTT Explorer 工具 登陆admin用户 ，观察EMQX所有Topic主题情况

![在这里插入图片描述][97da0c546c2f4cceb3511afe03479b3a.png_pic_center]

### 使用emqx提供的swagger服务 ###

#### swagger访问地址 ####

http://localhost:18083/api-docs/index.html

![在这里插入图片描述][7e7f1158d41e44b9a3b3f70c31d72883.png_pic_center]

#### 通过api密钥使用emqx的开放api ####

##### eqmx新增API密钥 #####

![在这里插入图片描述][2e3e9661a6cc4ea5823afb755b58822a.png_pic_center]

![在这里插入图片描述][d4df5df62b0d41c395ba69cf1f123f69.png_pic_center]

记下emqx页面上生成的api密钥对信息，后面java代码http调用emqx时会用到这个api密钥对

![在这里插入图片描述][3da3e017055a4eb682684fb44cdf630b.png_pic_center]

##### swagger在线测试刚刚的API密钥对 #####

![在这里插入图片描述][6ff63120fb324ec690ee6249bc493dcf.png_pic_center]

![在这里插入图片描述][f429d1ba89a64ec197d40d598c14f833.png_pic_center]

swagger在线接口文档使用API密钥登录后，即可在线测试EQMX开放的这些接口

实际开发中，如 java开发 IOT云平台，可以从emqx 开放的api 中获取mqtt服务器 所有暴露出的信息指标

[61e5ab1d39624ecf88fa796a88861f9b.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/3af9688814684d47b96ee5255af05403.png
[4dc3a44a408444baaf17776599723ffa.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/96a8320e753a46adbf17df8b863a3f2e.png
[5306d337387d4a4091ede1e47bc58ac9.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/4bb64399ba9c41a5affb53c671fce73a.png
[0c9c85f2f80d428cab533c9dd626bae0.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/a16e58a2e07c4c2ea8dfdc1f7c34c49e.png
[d5ae18568d464efe8001f8b2e83ef917.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/d7ed60d7f33f47a1ba5f0c034d5d579e.png
[487fbf53d7a447c38898b60bb1119de0.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/62ceed8195734c71934b95a109318a43.png
[9855c7ae11b44fdcbb366ba5306e60a0.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/e1609418a5464df6bd1b68ac6ba48e37.png
[989ab854082a4cbf96a7e2a507f7b6ec.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/7f406f7f35a64edfaddd9cf7ca851cbf.png
[74c1fe623af44abb819d7e14753e0c44.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/55c682aae1184094b8125613d7e95f39.png
[6dc9110eb5d6404aa64c0a0028555694.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/571128ca409345a2a03d7114dcb3a4e3.png
[a8e420c25e4c46b4a306b12a2923284c.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/9ff2f94c45d24934b2b4ef39b5536d2b.png
[beba891a087f4940a09a778d1845a32c.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/dad872499f47460a9020d1a67a380210.png
[ba9c93d633814f6a841a061a834b9ec5.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/a795fff897034b80bd48bb191e3bb4ac.png
[d6b6bc2f0b41445980f972f45058ff0a.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/5fe496c442404db68632a1bdd1525d5b.png
[68d08685ac1848359d1883630993a9b8.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/73c578330f3348d7be8234e8dc3d6553.png
[1ca53a5f95d64553a16ef2df7077f8bb.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/0ff2ed200fc44564ae37e147c2ddeb60.png
[70bedde3847c4e89965bc2f545614733.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/19845cfe913c4c3b99a24ce519bf8658.png
[3d58718088a848878e8a3e1473595aac.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/fedae246804f4e24a4b1b9eae4db1a69.png
[6712168b9ec14b1b873835f8896d0f92.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/cf54ed12dc554de6aa6530d6fc3e2ca2.png
[97da0c546c2f4cceb3511afe03479b3a.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/3245ddd61b6a4defbb68db7ab1076c78.png
[7e7f1158d41e44b9a3b3f70c31d72883.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/4ed39fcfafa248da9df168344e02e899.png
[2e3e9661a6cc4ea5823afb755b58822a.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/ff77357d73ae449abdb2473b19563546.png
[d4df5df62b0d41c395ba69cf1f123f69.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/1b829bd4436c46ec941ac975eb7d7935.png
[3da3e017055a4eb682684fb44cdf630b.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/fcb4a8ea0bda4b5e9f05d67bc1cbe308.png
[6ff63120fb324ec690ee6249bc493dcf.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/304652ea4c124f6489c5e7569c4f06a8.png
[f429d1ba89a64ec197d40d598c14f833.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/1b4ad42b1caa4a2d9fc4b618491f82a2.png