emqx学习笔记

最新推荐文章于 2024-06-19 00:09:11 发布
最新推荐文章于 2024-06-19 00:09:11 发布
阅读量1.4w 收藏 97
点赞数 7
分类专栏： work
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_43871650/article/details/113103156
版权

文章目录

一、emqx安装

参考官网教程：官网安装教程

https://www.emqx.cn/downloads#broker在这里插入图片描述

1.1 emqx启动

安装完成后，执行以下命令尝试运行：

//
# 启动emqx
./bin/emqx start
//or
emqx start


# 检查运行状态
./bin/emqx_ctl status
//or
 emqx_ctl status


# 停止emqx
./bin/emqx stop
//or
emqx stop

在这里插入图片描述

开启之后可以打开控制台查看具体信息，控制台地址: http://127.0.0.1:18083，默认用户: admin，密码：public
打开控制台之后界面如下：
在这里插入图片描述
左侧可以对EMQX设置，其中plugins可以管理插件，具体内容自行查看
https://developer.emqx.io/docs/emq/v3/cn/plugins.html
或者
https://docs.emqx.io/en/broker/latest/

可以用./bin/emqx_ctl plugins load 插件名字安装插件

打开MQTT.fx进行emqx服务器的mqtt客户端测试：

打开MQTT.fx后，进入设置界面。

输入emqx服务器的地址，本emqx是运行在虚拟机上的，Broker Address地址为192.168.237.131,Broker Port 为1883

其他配置随便，然后Apply之后，返回主页点击Connect 。

Connect成功后，说明emqx服务器开始成功。

1.2 基本命令

在这里插入图片描述

二、分布式集群

2.1 Erlang/OTP 分布式编程

EMQ X 使用Erlang/OTP 平台。Erlang/OTP 最初是为了开发电信设备系统而设计的编程语言平台，在设计时就将集群特性作为一项重要的特性纳入考虑，以 Erlang/OTP 实现的分布式系统在集群上基本都是简单易用而又高效可靠，EMQ X 也不例外。
在这里插入图片描述
当某个客户端连接到 EMQ X 集群的一个节点后，他所订阅的主题会被通知到其他节点，他所发布的消息也会被所有节点上订阅了相应主题的客户端收到。用户无需关心其中的实现细节。对于用户而言，这一切都是透明和自动的。

Erlang/OTP 语言平台的分布式程序，由分布互联的 Erlang 运行系统组成，每个 Erlang 运行系统被称为节点(Node)，节点(Node) 间通过 TCP 互联，消息传递的方式通信:

节点(Node)

集群中的每台 EMQ X 服务器就是一个节点。？？？？？
在集群内部的通讯中，节点由一个唯一的节点名标识。节点名的格式为 name@host，其中name由用户指定，host是IP地址或者全程域名(FQDN，Fully Qualified Domain Name)。比如：

emqx1@192.168.1.165
emqx2@broker1.emqx.io

节点间通过名称进行通信寻址。 例如在本机启动四个 Erlang 节点，节点名称分别为:

erl -name node1@127.0.0.1
erl -name node2@127.0.0.1
erl -name node3@127.0.0.1
erl -name node4@127.0.0.1

node1@127.0.0.1 控制台下建立与其他节点的连接:

(node1@127.0.0.1)1> net_kernel:connect_node('node2@127.0.0.1').
true
(node1@127.0.0.1)2> net_kernel:connect_node('node3@127.0.0.1').
true
(node1@127.0.0.1)3> net_kernel:connect_node('node4@127.0.0.1').
true
(node1@127.0.0.1)4> nodes().
['node2@127.0.0.1','node3@127.0.0.1','node4@127.0.0.1']

2.2 EMQ X 分布集群设计

EMQ X 消息服务器集群基于 Erlang/OTP 分布式设计，集群原理可简述为下述两条规则:

  • MQTT 客户端订阅主题时，所在节点订阅成功后广播通知其他节点：某个主题(Topic)被本节点订阅。
  • MQTT 客户端发布消息时，所在节点会根据消息主题(Topic)，检索订阅 并 路由消息到相关节点。

EMQ X 消息服务器同一集群的所有节点，都会复制一份主题(Topic) -> 节点(Node)映射的路由表，例如:

topic1 -> node1, node2
topic2 -> node3
topic3 -> node2, node4

主题树(Topic Trie)与路由表(Route Table)

EMQ X 消息服务器每个集群节点，都保存一份主题树(Topic Trie)和路由表。

例如下述主题订阅关系:
在这里插入图片描述
最终会生成如下主题树(Topic Trie)和路由表(Route Table):
在这里插入图片描述

订阅(Subscription)与消息派发

客户端的主题订阅(Subscription)关系，只保存在客户端所在节点，用于本节点内派发消息到客户端。

例如client1向主题’t/a’发布消息，消息在节点间的路由与派发流程:

title: Message Route and Deliver

client1 -> node1: Publish[t/a]
    node1 --> node2: Route[t/#]
        node2 --> client2: Deliver[t/#]
    node1 --> node3: Route[t/a]
        node3 --> client3: Deliver[t/a]

在这里插入图片描述

节点发现与自动集群

EMQ X 支持基于 Ekka 库的集群自动发现 (Autocluster)。Ekka 是为 Erlang/OTP 应用开发的集群管理库，支持 Erlang 节点自动发现 (Service Discovery)、自动集群 (Autocluster)、脑裂自动愈合 (Network Partition Autoheal)、自动删除宕机节点 (Autoclean)。

EMQ X 支持多种节点发现策略:
在这里插入图片描述

手动(manual) 方式管理集群介绍

假设要在两台服务器 s1.emqx.io, s2.emqx.io 上部署 EMQ X 集群:
在这里插入图片描述
注意： 节点名格式为 Name@Host, Host 必须是 IP 地址或 FQDN (主机名。域名)

  • 配置 emqx@s1.emqx.io 节点
    emqx/etc/emqx.conf:node.name = emqx@s1.emqx.io 或 node.name = emqx@192.168.0.10
    在这里插入图片描述
    也可通过环境变量:export EMQX_NODE_NAME=emqx@s1.emqx.io && ./bin/emqx start
    在这里插入图片描述
    注意: 节点启动加入集群后，节点名称不能变更。
  • 配置 emqx@s2.emqx.io 节点
    emqx/etc/emqx.conf:
    在这里插入图片描述
  • 节点加入集群
    启动两台节点后，在 s2.emqx.io 上执行:$ ./bin/emqx_ctl cluster join emqx@s1.emqx.io
    在这里插入图片描述
    注意: s2.emqx.io加入集群后会清除本身全部的数据，同步s1.emqx.io节点的数据。如果还有s3.emqx.io节点，那么需要在s3.emqx.io节点去执行命令加入emqx@s1.emqx.io或者emqx@s2.emqx.io， 已经在集群的节点不能在join到其他节点，否则会退出当前集群和join的节点组成一个新的集群
  • 在任意节点上查询集群状态:
    命令：$ ./bin/emqx_ctl cluster status
    在这里插入图片描述
  • 退出集群
    节点退出集群，两种方式:
      1.leave: 让本节点退出集群
      2.force-leave: 从集群删除其他节点
    让 emqx@s2.emqx.io 主动退出集群:$ ./bin/emqx_ctl cluster leave
    在这里插入图片描述
    或在 s1.emqx.io 上，从集群删除 emqx@s2.emqx.io 节点:$ ./bin/emqx_ctl cluster force-leave emqx@s2.emqx.io
    在这里插入图片描述

2.3 防火墙设置

若预先设置了环境变量 WITH_EPMD=1, 启动 emqx 时会使用启动 epmd (监听端口 4369) 做节点发现。称为 epmd 模式。 若环境变量 WITH_EPMD 没有设置，则启动 emqx 时不启用 epmd，而使用 emqx ekka 的节点发现，这也是 4.0 之后的默认节点发现方式。称为 ekka 模式。

epmd 模式： 如果集群节点间存在防火墙，防火墙需要开启 TCP 4369 端口和一个 TCP 端口段。4369 由 epmd 端口映射服务使用，TCP 端口段用于节点间建立连接与通信。

防火墙设置后，需要在 emqx/etc/emqx.conf 中配置相同的端口段:

## Distributed node port range
node.dist_listen_min = 6369
node.dist_listen_max = 7369

ekka 模式（4.0 版本之后的默认模式）：

如果集群节点间存在防火墙，默认情况下，只需要开启 TCP 4370 端口。

但如果 node.name 配置制定的节点名字里，带有数字后缀(Offset)，则需要开启 4370 + Offset 端口。

比如：

node.name = emqx-1@192.168.0.12

则需要开启 4371 端口。

三、EMQX目录结构

不同安装方式得到的 EMQ X 其目录结构会有所不同，具体如下:
在这里插入图片描述
以上目录中，用户经常接触与使用的是 bin、etc、data、log 目录。

3.1 bin 目录

emqx、emqx.cmd

EMQ X 的可执行文件，具体使用可以查看 基本命令。

emqx_ctl、emqx_ctl.cmd

EMQ X 管理命令的可执行文件，具体使用可以查看

四、COAP插件的使用

参考页面：https://github.com/emqx/emqx-coap
https://docs.emqx.cn/cn/broker/latest/modules/coap_protocol.html#%E4%BD%BF%E7%94%A8%E7%A4%BA%E4%BE%8B

4.1 开启 emqx_coap 插件

首先需要安装好emqx，并运行emqx。
打开Dashboard,端口号为18083
开启 emqx_coap 插件时，需要同时开启 emqx_lwm2m 插件，然后再关闭emqx_lwm2m，不然会出现网络不可达的错误（可能是个人原因）
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

4.2 安装libcoap

安装如下步骤操作即可。
略
使用上述的 ./configure --enable-documentation=no --enable-tests=no命令会遇到需要依赖tls,下面命令取消安装tls相关的内容。

 ./configure --enable-documentation=no --enable-tests=no --prefix=$(pwd)/ISVP_lib --disable-dtls

4.3 开启libcoap客户端 订阅

libcoap使用的示例格式

libcoap使用的示例格式如下：

  • Publish example:
    libcoap/examples/coap-client -m put -e 1234 "coap://127.0.0.1/mqtt/topic1?c=client1&u=tom&p=secret"
      topic name is “topic1”, NOT “/topic1”
      client id is client1
      username is tom
      password is secret
      payload is a text string “1234”
    A mqtt message with topic=“topic1”, payload=“1234” has been published. Any mqtt client or coap client, who has subscribed this topic could receive this message immediately.
  • Subscribe example:
    libcoap/examples/coap-client -m get -s 10 "coap://127.0.0.1/mqtt/topic1?c=client1&u=tom&p=secret"
      topic name is “topic1”, NOT “/topic1”
      client id is client1
      username is tom
      password is secret
      subscribe time is 10 seconds
    And you will get following result if any mqtt client or coap client sent message with text “1234567” to “topic1”:
  • Publish、Subscribe 最后一个字段的格式
    coap://localhost/mqtt/{topicname}?c={clientid}&u={username}&p={password}
      路径中的 "mqtt "为必填项
      将 {topicname}、{clientid}、{username} 和 {password} 替换为你的真实值
      {topicname} 和 {clientid} 为必填项
      如果 clientid 不存在，将返回 “bad_request”
      URI 中的 {topicname} 应该用 percent-encoded，以防止特殊字符，如 + 和 #
      {username} 和 {password} 是可选的
      如果 {username} 和 {password} 不正确，将返回一个 uauthorized 错误
      订阅的 QoS 等级恒定为 1

开启一个libcoap监听订阅消息的client

./coap-client -m get -s 10000 "coap://127.0.0.1/mqtt/topic1?c=client1"

博主这里是打开了一个coap CLient，监听订阅报文的时间为10000s。

主题为topic1,(注意了,是topic1,不是/topic1)

client为client1,(这个client不需要预先定义，直接使用就行)
在这里插入图片描述

开启一个libcoap发布消息的client并发布消息

./coap-client -m put -e 1234  "coap://127.0.0.1/mqtt/topic1?c=client1"

在这里插入图片描述
发布消息的内容为 1234
发送的主题为topic1
clientId为client1，clientId相同也无冲突！！！

发布消息后，可以观察到订阅topic1的客户端接收到了发布的消息。
在这里插入图片描述

在主机打开mqtt.fx实验

在这里插入图片描述

在这里插入图片描述
在这里插入图片描述
这就利用emqx 的 emqx_coap 插件 实现了coap协议的报文转换成mqtt类型的报文。

./coap-client -m get -s 10000 "coap://47.111.181.157/mqtt/topic/lonn?c=client1"

./coap-client -m put -e 1234  "coap://47.111.181.157/mqtt/topic/lonn?c=client001"
某风吾起
关注
  • 7
    点赞
  • 踩
  • 97
    收藏
    觉得还不错? 一键收藏
  • 6
    评论
专栏目录
EMQX开源版持久化尝试
qq_45894067的博客
05-30 6099
EMQX Webhook+java+MySQL曲折的持久化尝试 背景：EMQX开源版不提供数据持久化插件使用，可能不好应用到实际，就随意写个demo 环境：Ubuntu 20.0.4（测试） ​ IDEA 2021.2.2 ​ Mysql 8.0.26 ​ EMQ X 4.4.3 ​ JDK 1.8（开发） Web服务器用到的框架SpringBoot、Mybatis 可能存在问题：存储数据的延迟较高，不支持大数据量等等 Tips：如果会用PHP（可惜我不会） 可以参考B站视频教程利用web
EMQX简介
qq_27749613的博客
07-10 6074
EMQX 是一款大规模可弹性伸缩的云原生分布式物联网 MQTT 消息服务器。支持亿级的MQTT服务订阅。是目前相对性能较好的MQTT Broker，提供三种服务：1.云服务版本；2.商业版；3.开源版。
EMQX 安装使用和部分坑
卷心菜投手
09-27 1万+
emqx 安装，数据挂载，在 springboot 中使用
Linux环境（Ubuntu）上搭建MQTT服务器（EMQX ）
最新发布
kk1kk2kk3kk4的博客
06-19 413
本文主要介绍EMQX 的一些内容，终端介绍如何在Ubuntu上安装EMQX，并可以在第三方电脑上访问该服务器。本文通过实际操作方式，详细记录每个步骤应该注意的要点。
学习笔记 | EMQX
suweijie的博客
03-04 3971
在配置代理订阅的主题时，EMQ X 提供了 %c 和 %u 两个占位符供用户使用，EMQ X 会在执行代理订阅时将配置中的 %c 和 %u 分别替换为客户端的 Client ID 和 Username，需要注意的是，%c 和 %u 必须占用一整个主题层级。MQTT X 的 UI 采用了聊天界面形式，简化了页面操作逻辑，用户可以快速创建连接，允许保存多个客户端，方便用户快速测试 MQTT/MQTTS 连接，及 MQTT 消息的订阅和发布。当两个通配符在一个主题中出现的时候，主题层次分隔符的使用是很重要的。
MQTT服务器(EMQX)使用方法
kevin1499的博客
06-17 1万+
在进行MQTT客户端开发时，我们往往需要先在本地进行MQTT功能的测试。这里介绍一个本地MQTT服务器（EMQX）的使用方法，它可以大大加快MQTT客户端的开发调试过程。
MQTT——EMQX学习笔记01——EMQX安装使用
a123123sdf的博客
10-25 1万+
目录标题一、MQTT协议介绍（一）什么是MQTT（二）MQTT角色组成（三）三种消息发布服务质量：QoS（四）消息的组成（五） MQTT协议数据包结构二、安装EMQX（一）安装单机版（二）集群 一、MQTT协议介绍 （一）什么是MQTT MQTT 是基于 Publish/Subscribe（发布/订阅） 模式的物联网通信协议，凭借简单易实现、支持 QoS、报文小等特点，占据了物联网协议的半壁江山。 简单来说：MQTT是一种通讯协议，不能直接使用，如果需要使用这个协议就需要使用实现了这种协议的组件，比如：EM
atacseq的学习笔记
acetyl_coa1741的博客
08-02 428
ATACSEQ的学习笔记
QoS学习笔记
热门推荐
NowOrNever
08-25 3万+
相关协议 1) 802.1Q Virtual Bridged Local Area Networks 2) MEF5 Traffic Management 3) MEF10.2 Ethernet Services Attributes 4) RFC2697 srTCM - Single Rate Three Color Marker 5) RFC2698  trTCM - Two Rat
java学习笔记总结
04-02
这份“java学习笔记总结”涵盖了作者在深入学习Java过程中积累的知识点和实践经验，旨在帮助读者理解和掌握Java的核心概念。 首先，Java的基础部分包括语法、变量、数据类型、运算符和流程控制。Java支持八种基本...
学习笔记学习笔记学习笔记
01-29
学习笔记学习笔记学习笔记
GCC 学习 笔记GCC学习笔记
04-22
GCC学习笔记
MAKE 学习 笔记make
04-22
MAKE学习笔记
MySQL进阶篇学习笔记
05-14
黑马MySQL课程总结的学习笔记
【MQTT服务器】（一）EMQX平台搭建
xanadw的博客
05-04 1万+
系列文章目录 【MQTT服务器】（一）EMQX平台搭建 【MQTT服务器】（二）数据库存储消息 【MQTT服务器】（三）MQTT终端设备 【MQTT服务器】（四）搭建网页 前言 现在网上的物联网平台还是挺多的，比如国外开源的homeassistant，阿里云的物联网平台，其它云也有对应的物联网平台就不一一说了。在物联网设备中，最重要的就是联网通讯了，上报设备的状态或者信息，接收指令等等。物联网的通讯协议常见的有下面七种:MQTT、 DDS、 AMQP、XMPP、 JMS、 RE....
中间件系列——EMQX 的集群搭建
ITLWJ的博客
04-06 1万+
上节我们介绍了 EMQX 的快速上手，但是如果想要将 EMQX 投入生产环境，我们还要考虑非常多的东西。这节我们就来让 EMQX 高可用，也就是集群搭建和负载均衡配置
EMQ X 快速入门
qq_35701988的博客
03-16 2486
MQTT（Message Queuing Telemetry Transport，消息队列遥测传输协议）是一种轻量级的、基于发布/订阅（publish-subscribe）模式的消息中间件通信协议，特别适合于资源有限的设备和网络带宽受限的环境。该协议由IBM公司在1998年设计并开发，现已成为物联网（IoT）、机器对机器（M2M）通信、移动应用以及实时数据传输等领域广泛应用的标准之一。主要用于物联网（IoT）、移动互联网以及远程传感器等低带宽、高延迟、不可靠网络环境下的通信。轻量级协议。
windows10-EMQX与MQTTX的安装及配置使用教程
weixin_44462773的博客
12-18 2万+
win10系统下emqx与mqttx的安装、配置及连接教程
EMQX基础功能
一切总会归于平淡
04-01 1万+
EMQX 提供了 Dashboard 以方便用户管理设备与监控相关指标。通过 Dashboard可以查看服务器基本信息、负载情况和统计数据，可以查看某个客户端的连接状态等信息甚至断开其连接，也可以动态加载和卸载指定插件。除此之外，EMQ X Dashboard 还提供了规则引擎的可视化操作界面，同时集成了一个简易的 MQTT 客户端工具供用户测试使用。
hbuilderx学习笔记
01-26
以下是关于HBuilderX学习的一些笔记： 1. 在HTML中插入图片，可以使用`<img>`标签的`src`属性来指定图片的路径。例如： ```html <img src="image.jpg"> ``` 其中，`src`属性的值是图片文件的路径，可以是相对路径或绝对路径。 2. 如果在HBuilderX中写的HTML无法在浏览器上运行，可能是因为缺少外部web服务支持。解决方法是在HBuilderX中启动一个web服务。另外，如果更改了HBuilderX的文件路径，需要重启HBuilderX以重新生成新的目录。 请注意，以上是一些基本的笔记，如果你有更具体的问题或需要更详细的学习资料，请提供更多的信息。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 6
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值