创建连接与字段说明
逐项配置地址、端口、Client ID、认证与 Keep Alive。
浏览全部手册
本页目录
打开连接表单
在连接栏点击加号，或在空工作台点击「新建连接」。先保存配置，再在状态栏点击「连接」。保存成功不代表网络已建立。
0.1.0 开发版 · 2026-09-21 实机采集 · 点击查看原图 ↗
字段速查
| 字段 | 示例 / 范围 | 含义 |
|---|---|---|
| 连接名称 | 本地开发 Broker | 用于区分环境，必填 |
| 协议 | mqtt:// | 选择实际 broker 的传输方式 |
| 主机地址 | localhost / 127.0.0.1 | 只填主机，必填；不要带协议、端口和路径 |
| 端口 | 1–65535 | 以 broker 实际监听配置为准 |
| Client ID | ineed-demo-client | broker 用来识别客户端；留空由运行时生成 |
| 用户名 | 测试账号或留空 | 按 broker 认证策略填写 |
| 密码 | 对应密码或留空 | 密码输入框会遮挡显示 |
| Keep Alive（秒） | 建议 60；表单标示 10–3600 | MQTT 心跳参数，不是消息发送周期 |
当前主机输入校验面向域名/IPv4；IPv6 字面地址和带路径 URL 不属于当前表单可直接填写的方式。
建立连接
- 检查主机、端口、认证信息，点击保存。
- 选中该连接，点击「连接」。
- 等待「已连接」；若停留在连接中，可点击「终止」。
- 失败时查看当前连接的日志，优先核对 DNS、端口、协议和认证。
Client ID 的常见问题
同一个 broker 上，不要让两个并发客户端使用相同 Client ID，否则 broker 可能断开旧连接。克隆配置后尤其要检查这一项。
只有需要服务端会话关联时才考虑固定 Client ID；当前会话设置还有实现边界，见会话与重连。
Keep Alive 与全局默认值
新建连接会读取设置中的 Keep Alive 默认值；已保存连接保留自己的值。修改全局默认值不意味着现有连接会立即重新协商。
连接协议及加密限制见传输协议。
仍有疑问？按反馈清单整理复现信息 →