mosquitto_sub - 云端在线

程序：

您的姓名

mosquitto_sub - 用于订阅主题的 MQTT 3.1 版客户端

概要

蚊子子 [-A 绑定地址[-c[-C 味精 数[-d[-h 主机[-i CLIENT_ID]
[-I 客户 id 字首[-k 活着 次[-p 端口 数[-q 消息 服务质量]
[-R[-S[-N[- 安静的[-v] [[-u 用户名[-P 密码]]
[--将主题 主题 [--将有效负载 有效载荷[--will-qos 服务质量[--将保留]]
[[{--cafile 文件 | --卡帕斯 DIR} [--证书 文件[- 钥匙 文件[--tls-版本 版本[--不安全]]
| [--psk 十六进制密钥 --psk-身份 身分 [--tls-版本 版本]]]
[- 代理 袜子网址[-V 协议版本[-T 过滤掉...]
-t 消息主题...

蚊子子 [ - 帮帮我]

商品描述

蚊子子 是一个简单的 MQTT 3.1 版客户端，它将订阅一个主题并打印
它收到的消息。

配置

下面的选项可以在命令行上给出，但也可以放在配置中
文件位于 $XDG_CONFIG_HOME/mosquitto_sub or $HOME/.config/mosquitto_sub 一个人
双 -选项 折扣值 每行。 配置文件中的值将用作默认值和
可以使用命令行覆盖。 例外情况是 -t 和 -T，这
如果在配置文件中给出，则不会被覆盖。 另请注意，目前一些选项
不能被否定，例如 -S. 配置文件行具有 # 因为第一个字符是
视为评论，不再进一步处理。

-A
将传出连接绑定到本地 IP 地址/主机名。 如果您使用此参数
需要将网络通信限制在特定接口上。

-c, --禁用清理会话
禁用“干净会话”标志。 这意味着所有订阅
客户端断开连接后将继续维护，以及后续的 QoS 1 和 QoS 2
到达的消息。 当客户端重新连接时，它将接收所有排队的
消息。

如果使用此选项，建议手动设置客户端 ID - ID

--cafile
定义包含受信任的 PEM 编码 CA 证书的文件的路径。
用于启用 SSL 通信。

参见 --卡帕斯

--卡帕斯
定义包含 PEM 编码的 CA 证书的目录的路径，这些证书是
信任。 用于启用 SSL 通信。

对于 --卡帕斯 要正常工作，证书文件必须以“.crt”作为文件
结束，你必须运行“c_rehash " 每次添加/删除
证书。

参见 --cafile

--证书
定义包含此客户端 PEM 编码证书的文件的路径，如果
服务器需要。

参见 - 钥匙.

--密码
客户端支持的 TLS 密码的 openssl 兼容列表。 看 密码（1）
更多信息。

-C
在给定的消息计数后立即断开并退出程序
已收到。 这在 shell 脚本中可能很有用，其中单个状态值是
需要，例如。

结合 -R 只打印第一组新消息（即没有
保留的标志集），或 -T 过滤处理哪些主题。

-d, -调试
启用调试消息。

- 帮帮我
显示使用信息。

-h, - 主持人
指定要连接的主机。 默认为本地主机。

-i, - ID
用于此客户端的 ID。 如果没有给出，默认为 mosquitto_sub_ 附加
客户端的进程ID。 不能同时使用 --id-前缀
论据。

-I, --id-前缀
提供一个前缀，通过附加进程 ID 来构建客户端 ID
客户端。 这在代理使用 clientid_prefixes 选项的情况下很有用。
不能同时使用 - ID 论据。

--不安全
使用基于证书的加密时，此选项禁用验证
服务器证书中的服务器主机名。 这在测试初始时很有用
服务器配置，但使恶意第三方有可能冒充
例如，您的服务器通过 DNS 欺骗。 在测试中使用此选项 仅由。 如果您
需要在生产环境中使用此选项，您的设置位于
错误，使用加密没有意义。

-k, - 活着
出于以下目的向代理发送 PING 命令之间的秒数
通知它我们仍然连接和运行。 默认为 60 秒。

- 钥匙
定义包含此客户端的 PEM 编码私钥的文件的路径，如果
服务器需要。

参见 --证书.

-N
打印时不要将行尾字符附加到有效负载。 这允许
将有效载荷数据从多条消息直接流式传输到另一个应用程序
未修改。 只有在不使用时才真正有意义 -v.

-p, - 港口
连接到指定的端口而不是默认的 1883。

-P, --密码
提供用于与代理进行身份验证的密码。 使用这个参数
没有同时指定用户名是无效的。 这需要一个支持
MQTT v3.1。 另见 - 用户名 选项。

- 代理
指定要连接的 SOCKS5 代理。 “无”和“用户名”身份验证类型
支持。 这 袜子网址 必须是形式
socks5h://[用户名[:密码]@]主机[:端口]. 协议前缀 袜子5小时 意思是
主机名由代理解析。 符号 %25、%3A 和 %40 被 URL 解码为
%、: 和 @，如果出现在用户名或密码中。

如果没有给出用户名，则不会尝试进行身份验证。 如果端口不是
给定，则使用默认值 1080。

未来可能会提供更多 SOCKS 版本，具体取决于需求，并将使用
中描述的不同协议前缀 卷曲（1）。

--psk
提供与主机上使用的匹配的十六进制（无前导 0x）预共享密钥
代理使用 TLS-PSK 加密支持。 --psk-身份 还必须提供给
启用 TLS-PSK。

--psk-身份
与 TLS-PSK 支持一起使用的客户端身份。 这可以用来代替
用户名（如果代理配置为这样做）。

-q, --服务质量
从 0、1 和 2 中指定传入消息所需的服务质量。
默认为 0。见 MQTT(7) 有关 QoS 的更多信息。

在单个实例中订阅的所有主题的 QoS 是相同的
mosquitto_sub。

- 安静的
如果给出此参数，则不会打印运行时错误。 这排除了任何错误
在用户输入无效的情况下给出的消息（例如使用 - 港口 没有端口）。

-R
如果给出此参数，则接收到的设置了保留位的消息
不会被打印。 带有保留集的消息是“陈旧的”，因为它是未知的
当它们最初出版时。 订阅通配符主题时，可能会出现
大量保留的消息。 这个论点抑制了它们的显示。

-S
使用 SRV 查找来确定要连接到的主机。 执行查找
_mqtt._tcp。 当与 -h, 否则使用 _mqtt._tcp。
DNS 域>.

-t, - 话题
要订阅的 MQTT 主题。 看 MQTT(7) 有关 MQTT 主题的更多信息。

可以重复此选项以订阅多个主题。

-T, - 过滤掉
禁止打印与过滤器匹配的主题。 这允许订阅
通配符主题，仅打印部分通配符层次结构。

例如，订阅 BBC 树，但禁止广播 3 的输出：

· mosquitto_sub -t bbc/# -T bbc/radio3

可以重复此选项以过滤掉多个主题或主题树。

--tls-版本
选择与代理通信时要使用的 TLS 协议版本。 有效的
选项是 TLSV1.2, TLSV1.1 和 TLSV1. 默认值为 TLSV1.2. 如果安装了
openssl 版本太旧，只有 TLSV1 将可用。 必须符合协议
经纪人使用的版本。

-u, - 用户名
提供用于与代理进行身份验证的用户名。 这需要一个
支持 MQTT v3.1 的代理。 另见 --密码 论据。

-v, --详细
详细打印收到的消息。 使用此参数，消息将打印为
“主题有效载荷”。 当未给出此参数时，消息将打印为
“有效载荷”。

-V, --协议版本
指定连接到 MQTT 协议时应使用的版本
远程经纪人。 可 MQTTV31 or MQTTV311. 默认为 MQTTV31.

--将有效负载
指定将由代理存储并在此客户端发送的消息
意外断开连接。 这必须与 --将主题.

--will-qos
用于遗嘱的 QoS。 默认为 0。这必须与
--将主题.

--将保留
如果给定，如果客户端意外断开连接，发送的消息将被处理
作为保留消息。 这必须与 --将主题.

--将主题
在客户端断开连接的情况下发送遗嘱的主题
不料。

遗嘱

mosquitto_sub 可以向代理注册一条消息，如果它被发送出去
意外断开连接。 看 MQTT(7) 了解更多信息。

对此的最低要求是使用 --将主题 指定遗嘱的主题
应该发出去。 这将导致 QoS 为 0 的非保留、零长度消息。

使用 --将保留, --将有效负载 和 --will-qos 修改另一个意志的论据
参数。

示例

请注意，这些确实是示例 - 如果您将它们作为
显示，但必须有一些发布关于这些主题的消息供您接收
任何东西。

使用 QoS 1 订阅 localhost 上的温度信息：

· mosquitto_sub -t 传感器/温度 -q 1

订阅多台机器/硬盘驱动器上的硬盘驱动器温度更新。 这期望
每台机器将其硬盘驱动器温度发布到
传感器/机器/主机名/温度/HD_NAME。

· mosquitto_sub -t 传感器/机器/+/温度/+

订阅所有代理状态消息：

· mosquitto_sub -vt \$SYS/#

使用 onworks.net 服务在线使用 mosquitto_sub