N8N中文教程
集成节点/Built in_nodes/Credentials

MQTT 凭据#

你可以使用这些凭据来认证以下节点:

  • MQTT
  • MQTT Trigger

前提条件#

安装一个 MQTT 代理(broker)。 MQTT 在 MQTT 软件列表 中提供了可用的服务器/代理列表。

支持的认证方式#

  • 代理连接(Broker connection)

相关资源#

更多关于 MQTT 协议的信息,请参考 MQTT 官方文档。 有关详细配置和说明,请查阅你的代理服务提供商的文档。

使用代理连接#

要配置此凭据,你需要准备以下信息:

  • MQTT 代理的 协议(Protocol)
  • 主机地址(Host)
  • 端口(Port)
  • 用于认证的 用户名(Username)密码(Password)
  • 如果你使用 SSL,还需要相应的证书和密钥

配置步骤如下:

  1. 选择代理的 协议(Protocol),该选项将决定 n8n 使用的 URL 格式。可选项包括:
    • Mqtt :URL 以标准的 mqtt: 协议开头。
    • Mqtts :URL 以安全的 mqtts: 协议开头。
    • Ws :URL 以 WebSocket 的 ws: 协议开头。
  2. 输入你的代理 主机地址(Host)
  3. 输入 n8n 连接代理时应使用的 端口号(Port)
  4. 输入用于登录代理的 用户名(Username)
  5. 输入该用户的 密码(Password)
  6. 如果你希望在离线期间也能接收 QoS 1 和 QoS 2 消息,请关闭 Clean Session 开关。
  7. 输入你希望凭据使用的 客户端 ID(Client ID)。如果留空,n8n 将自动生成一个。你可以使用固定的或基于表达式的 Client ID。
    • Client ID 可用于识别和追踪连接访问。n8n 建议使用包含 n8n 字样的标识,便于审计。
  8. 如果你的 MQTT 代理启用了 SSL,请打开 SSL 开关。开启后需要配置以下内容:
  9. 选择是否使用基于证书的 无密码(Passwordless) 连接,类似于 SASL 的 EXTERNAL 机制。若启用:
  10. 选择是否 拒绝未经授权的证书(Reject Unauthorized Certificate):若关闭,即使证书验证失败,n8n 仍会尝试连接。
  11. 添加 SSL 客户端证书(Client Certificate)
  12. 为客户端证书添加对应的 SSL 客户端密钥(Client Key)
  13. 添加一个或多个 SSL CA 证书(CA Certificates)

请参考您的 MQTT 代理服务器提供商的文档,以获取更详细的配置说明。