核心功能
- 双向 IoT 消息队列,支持多个服务质量(QoS)级别
- 支持 TLS 加密和客户端证书身份验证,并具备可配置的心跳(Keep-alive)间隔
- 基于主题(Topic)的过滤,支持通配符及遗嘱(Last Will)消息处理
概述
通过 MQTT 端口发送数据会将数据发布到配置的主题,并且在端口订阅的任何主题上接收的消息将放置在交易选项卡中。端口配置
本节包含所有可配置的端口属性。设置选项卡
主机配置
与远程MQTT服务器连接相关的设置。客户端身份验证
与对远程 MQTT 服务器进行身份验证相关的设置。TLS 设置
与通过 TLS 建立安全连接相关的设置。发布
与发布MQTT消息相关的设置。订阅
订阅MQTT消息相关的设置。高级选项卡
TLS 客户端身份验证
与需要双向 TLS 身份验证时的客户端身份验证相关的设置。
| 设置 | 描述 |
|---|---|
| 私有证书 | TLS 客户端身份验证期间提供的私有证书。 |
| 证书密码 | 访问 TLS 客户端证书所需的密码。 |
高级设置
未包含在先前类别中的设置。消息
消息设置确定端口如何搜索消息并在处理后管理它们。
| 设置 | 描述 |
|---|---|
| 保存到已发送文件夹 | 选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。 |
| 已发送文件夹方案 | 端口根据选定的时间间隔对 已发送 文件夹中的文件进行分组。例如,Weekly 选项指示端口每周创建一个新的子文件夹,并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 已发送 文件夹中。对于处理许多事务的端口,使用子文件夹可以帮助保持文件有序并提高性能。 |
日志
用于管理日志创建和存储的设置。
| 设置 | 描述 |
|---|---|
| 日志级别 | 指定要记录在端口日志目录中的信息类型:
|
| 日志文件夹结构 | 指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如,Weekly 选项指示端口每周创建一个新的子文件夹,并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口,使用子文件夹有助于保持日志的有序性并提高性能。 |
| 保留消息副本 | 指示端口在日志目录中保存最新消息副本的切换。请注意,端口每个子文件夹只保留一个消息,并且端口在再次运行时会覆盖以前保存的消息。 |
其他
特殊设置适用于特定用例。
| 设置 | 描述 |
|---|---|
| 其他设置 | 允许在以分号分隔的列表中配置隐藏的端口设置,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。 |
自动化选项卡
自动化设置
与端口自动处理文件相关的设置。性能
与端口资源分配相关的设置。
| 设置 | 描述 |
|---|---|
| 最大工作线程数 | 此端口上处理文件时从线程池中消耗的最大工作线程数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。 |
| 最大文件数 | 分配给端口的每个线程发送的最大文件数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。 |
通知选项卡
SLA 选项卡
建立连接
至少将设置选项卡上的远程主机设置为MQTT服务器的域名或IP地址。如果使用非标准端口,请设置远程端口。如果需要认证,请设置用户名和密码。 如果需要安全连接,请选中 使用 TLS,并可选择将 TLS 服务器证书 设置为服务器的公共证书,或选择_任何证书_ 接受服务器提供的任何证书。如果该字段使用不当,则会产生安全风险。设置此字段时要格外小心。发布
为了发布数据,将发布部分中的 主题 设置为端口应该发布消息的主题。服务质量(QoS) 取值范围为 0 到 2,含义如下:- 0 - 最多一次 - 发布的消息发送一次,如果没有到达则丢失。
- 1 - 至少一次 - 保证发布的消息到达,但可能有重复。
- 2 - 正好一次 - 保证发布消息到达并且没有重复。
订阅
在设置页面的订阅部分,可以选中 启用 MQTT 订阅 选项以指示端口也应该接收数据。选中时,端口将订阅在后台线程上指定的主题,传入的消息将自动放置在交易选项卡中,根据高级选项卡中 本地文件名格式 中指定的值命名。默认情况下,端口将使用消息的主题和数据包 ID 命名文件,使用%topic%_%packetid%.data 作为 本地文件名格式 的值。
主题过滤 可以设置为端口应订阅的主题过滤器的逗号分隔列表。某些字符在主题过滤器中具有特殊含义:
- / - 主题级别分隔符
- # - 多级通配符(零级或多级)
- + - 单级通配符(正好是一级)
- Leading $ - 表示”系统主题”