MQTT Broker
工作站自己的 MQTT Broker：它在通信栏里的那一行、打开和关闭、端口和已连接的设备、客户端认证、它交给 MQTT 驱动的条目“本工作站”，以及它不做的事。
MQTT Broker 接收你网络中设备发布的 MQTT 消息，这样试验台或小型实验室不用另装 Broker，就能读取 ESP32 板、网关和传感器。它是“服务器”文件夹的第三行，排在Modbus 服务器之后，它不是驱动：设备连到它并发布消息，工作站像读取任何 Broker 一样，通过 MQTT 驱动读取它们发布的内容。面板在标题下面这样写：“接收你网络中设备发布的 MQTT 消息，设备因此无需自备 Broker。它只接受连接，从不主动连接。”能查看 Connector 的人可以读这一页，能配置 Connector 的人可以修改它。
通信栏里的那一行
这一行位于通信栏树的“服务器”文件夹中，在 Modbus 服务器下面，驱动显示插头的位置上是一个集线器图标。每台工作站正好有一个，它从不被创建，也从不被删除。搜索框按名称找到它，状态筛选项按状态归类：关闭时归入已禁用，端口被占用或无法监听时归入有问题，其余情况归入正常。名称旁边显示 Broker 正在做什么，圆点对此做个概括：
| 这一行显示 | 圆点 | 何时 |
|---|---|---|
| “已关闭” | 灰色 | Broker 已关闭，每台工作站都从这里开始。 |
| “正在端口 1883 上监听”，然后是已连接设备的数量：“没有已连接的客户端”“已连接 1 个客户端”“已连接 3 个客户端” | 绿色 | Broker 已打开且运行时在运行：端口已打开。 |
| “端口 1883 已被占用” | 红色 | Broker 已打开，但另一个程序占用了端口。 |
| “无法在端口 1883 上监听” | 红色 | Broker 已打开，但 Windows 因其他原因拒绝打开端口。 |
| “运行时已停止” | 灰色 | Broker 已打开但运行时已停止：在运行时再次运行之前，端口保持关闭。 |
圆点只属于 Broker：它不计入“驱动”文件夹的汇总，也不计入状态栏，那两处说的是工作站所读取的设备。
打开和关闭
| 命令 | 作用 | 何时变灰 |
|---|---|---|
| 启用 | 打开 Broker：“打开 Broker：运行时运行期间，它在端口 1883 上监听，MQTT 驱动会获得本工作站读取它所用的条目。”操作记录条显示“MQTT Broker 已打开。” | Broker 已经打开（“Broker 已经打开。”）、有运行记录占用着工作站，或者运行时已停止。 |
| 禁用 | 关闭 Broker：“关闭 Broker：它关闭端口并断开所有客户端。”操作记录条显示“MQTT Broker 已关闭。” | Broker 已经关闭（“Broker 已经关闭。”）、有运行记录占用着工作站，或者运行时已停止。 |
不能配置 Connector 的角色不会被画出这两个命令。是否打开是工作站保存的一项设置，监听则跟随运行时：运行时一启动，Broker 就打开端口；运行时停止时，它关闭端口并断开所有设备；运行时恢复后，它再次打开端口。打不开的端口是 Broker 自己的状态，显示在这一行上和端口字段下方，工作站在没有它的情况下照常运行。
端口和客户端卡片
| 字段 | 作用 | 取值和默认值 |
|---|---|---|
| TCP 端口 | Broker 监听的端口，在这台计算机的所有地址上监听，包括 IPv4 和 IPv6，不使用 TLS。在 Broker 监听时修改它，会关闭旧端口、打开新端口，所有设备都会断开；操作记录条显示“MQTT Broker 已移到端口 1884。” | 1 到 65535。默认 1883，即不使用 TLS 的 MQTT 端口。 |
| 已连接的客户端 | 现在连接着多少台设备。只要有设备连接，表格就逐台列出 客户端 ID、客户端地址（它的 IP 地址和端口）和 连接时间。 | 只读。 |
Broker 无法改用的端口，在保存任何内容之前就会被拒绝，原因显示在字段下方，字段回到当前生效的端口：超出范围的数字（“端口必须在 1 到 65535 之间。”），Web 服务器、代理访问、OPC UA 服务器或 Modbus 服务器的端口（“端口 N 已经是 Modbus 服务器的端口。请另选一个端口，或者先移动 Modbus 服务器。”），以及被另一个程序占用的端口（“端口 N 在这台计算机上已被占用。请关闭占用它的程序，或者另选一个端口。”）。工作站的其他端口字段也会以同样方式拒绝 Broker 的端口：“端口 N 已经是 MQTT Broker 的端口。请另选一个端口，或者先移动 MQTT Broker。”
卡片下方有一条说明：“不使用 TLS：设备以普通 MQTT 连接，同时最多 100 台。只有 Windows 防火墙放行 TCP 端口 1883 的入站连接，其他计算机才能访问这个 Broker：是否放行由你决定，本工作站从不自行放行。保留消息会保存到工作站重新启动为止。”
同时连接的设备最多 100 台，工作站自己的会话也算在内：再多一台会因超出配额的 MQTT 原因被拒绝，而用自己的客户端 ID 重新连接的设备会拿回原来的位置。保留消息存放在内存中：运行时停止后再启动时它们还在，工作站重新启动后就没有了。
Windows 防火墙
工作站从不自行修改 Windows 防火墙。说明下方，一个圆点和一句话说明工作站为 Broker 设置的入站规则是否放行该端口：“端口 1883 上的入站 MQTT 连接对专用网络和域网络放行。”“网络客户端可能被阻止，因为没有本应用拥有的规则放行端口 1883。”，或者在不能管理防火墙的启动方式下，例如隔离的配置文件或不是已安装程序的副本，显示“这种启动方式无法管理 Windows 防火墙。如有需要，请在操作系统中配置入站访问。”只有在规则缺失时，放行本地网络 才会在你同意后向 Windows 申请一条名为“Ganter Lab MQTT broker”的规则：该端口的入站 TCP、专用网络和域网络、本地子网、本程序。它要在工作站自己的应用里按下（“防火墙规则只能从工作站本机的桌面应用中应用。”），操作记录条先显示“正在为 MQTT 端口 1883 申请 Windows 防火墙放行…”，再显示“Windows 防火墙现在允许端口 1883 上的 MQTT 连接。”
客户端认证
客户端认证 卡片决定谁可以连接：
| 选项 | 谁能连接 |
|---|---|
| 匿名 | “任何设备都能连接，无论是否提供用户名和密码。”每台工作站都从这里开始。 |
| 用户名和密码 | “所有设备都使用下面这一组用户名和密码登录。”使用其他用户名或密码的设备会被拒绝，诊断日志会记下这件事，并像任何重复的失败一样合并记录。 |
选项下方是 用户名 和密码，密码的标签只说明是否已保存密码：密码（已保存） 或 密码（尚未保存）。已保存的密码从不画回页面：字段一开始是空的，并且“留空就保留已保存的密码。”选项、用户名和密码通过 套用 一起生效，在没有任何改动时它是灰色的（“请先更改认证设置再套用。”）；套用后操作记录条显示“MQTT Broker 的认证已保存。”，并且正如按钮旁边那一行所提醒的，“新的认证不再接受的已连接设备会被断开。”
| 输入 | 拒绝时的提示 |
|---|---|
| 用户名或密码为空时选择了用户名和密码 | “在 Broker 要求之前，请先输入用户名和密码。” |
| 用户名和密码生效时清空了用户名 | “Broker 要求每台设备提供用户名，因此不能为空。要清除它，请先选择匿名。” |
| 超过 128 个字符的用户名或密码 | “用户名最多 128 个字符。” |
选择匿名时，用户名和密码仍然保存着，留待下次使用。密码的保存方式与工作站所读取 Broker 的密码相同，按这个 Windows 账户加以保护：在另一台计算机或另一个账户上打开的备份不含密码，重新输入之前没有任何设备能登录，卡片会显示“在这个 Windows 账户下无法读取：它只能在输入它的那台计算机和那个 Windows 账户上打开。请在这里重新输入。”
本工作站
面板的最后一张卡片 本工作站 说明 Broker 交给 MQTT 驱动的东西：“打开后，Broker 会在 MQTT 驱动下创建条目 本工作站，本工作站通过它读取向这里发布消息的设备：地址为 127.0.0.1，使用 Broker 的端口和认证。请通过扫描或手动在 本工作站 下添加这些设备。关闭 Broker 后，本工作站 及其设备保留原位，处于断开状态。”
| 时机 | 发生的事 |
|---|---|
| 打开 Broker 时，工作站还没有这个条目 | MQTT 驱动被添加到工作站，并多出 Broker 本工作站：127.0.0.1、Broker 的端口、不使用 TLS、已启用；认证为用户名和密码时，带有 Broker 的用户名和密码。 |
| 端口或认证改变时 | 条目随之改变：它的主机、端口和认证变成 Broker 的。名称、客户端 ID、保活时间以及是否启用，仍由你决定。条目自己的面板显示“本工作站通过这个条目读取自己的 MQTT Broker（服务器，MQTT Broker）：它的主机、端口和认证跟随该 Broker，Broker 打开期间它会一直保留。” |
| Broker 打开期间 | 条目不能删除：命令栏、右键菜单和驱动的表格里，删除 Broker 保持灰色，并显示“Broker‘本工作站’是本工作站读取自己 MQTT Broker 的途径，因此在该 Broker 打开期间会一直保留。请先在“服务器”下关闭 MQTT Broker。” |
| 关闭 Broker 时 | 条目及其设备留在原处，处于断开状态。这时删除它，下次打开 Broker 时会再次创建。 |
条目下面不会自动添加任何东西：请像在任何 MQTT 驱动的 Broker下一样，通过 Broker 的扫描或手动添加向 Broker 发布消息的设备。Broker 关闭期间，工作站自己的会话会拉长重试间隔，所以打开 Broker 后，条目可能要等最多 30 秒才显示为在线。本工作站也有每个 Broker 都有的发布卡片：工作站把自己的数据发布到它自己的 Broker。
代理访问
| 工具 | 作用 |
|---|---|
station_broker_status |
报告 Broker：是否打开、端口、状态、不含密码的认证、已连接的设备以及条目“本工作站”。运行时停止时也能使用。 |
station_broker_configure |
按面板的规则打开或关闭 Broker、改用其他端口、修改认证。 |
这两个名称都不以 mqtt_broker_ 开头，那是工作站所读取 Broker 的工具；两者都和其他所有工具一起在工具中说明。
它不做的事
- 没有 TLS，也没有 WebSocket：设备通过 TCP 以普通 MQTT 连接。
- 所有设备共用一组用户名和密码，从不每台设备各用一组。
- 没有持久会话，保留消息也不会在工作站重新启动后留下。
- 它随工作站一起停止：工作站关闭时仍要继续发布的设备，需要自己的 Broker（安装一个 Broker）。