警告

This document is not updated for ESP32H21 yet, so some of the content may not be correct.

This warning was automatically inserted due to the source file being in the add_warnings_pages list.

# ESP-MQTT

[English]

## 概述

ESP-MQTT 是 MQTT 协议客户端的实现，属于轻量级发布/订阅消息协议。ESP-MQTT 现已支持 MQTT v5.0。

自 ESP-IDF v6.0 起，`ESP-MQTT` 组件已从 ESP-IDF 中移至独立仓库：

- esp-mqtt 组件仓库

如需在项目中添加 ESP-MQTT 组件，请运行 `idf.py add-dependency espressif/mqtt`。

## 托管文档

文档链接如下：

- esp-mqtt 文档

## 应用示例

ESP-IDF 中提供了两个参考示例：

- 基于 TLS 的 MQTT 通信（证书包模式）：`examples/protocols/mqtt`

  - 默认使用 ESP-IDF 证书包验证代理服务器。

  - 默认代理地址指向 `mqtts://test.mosquitto.org:8886` （采用 Let's Encrypt 证书链）。

  - 替代方案可配置 Mosquitto CA 证书并改用 `mqtts://test.mosquitto.org:8883` 地址。

- 基于 TLS 的 MQTT 5.0 通信（证书包模式）：`examples/protocols/mqtt5`

  - 使用 MQTT v5.0 协议，通过 TLS 传输并借助证书包完成验证。

  - 默认代理地址指向 `mqtts://test.mosquitto.org:8886`。

如需更多传输模式（TCP、WS/WSS、双向认证等）的示例，请参考 espressif/mqtt 组件仓库。

此文档对您有帮助吗？

- 反馈已收到，谢谢！
- 如果您有其他意见，欢迎填写乐鑫文档反馈表。

- 我们重视您的反馈。
- 您可以填写乐鑫文档反馈表告诉我们如何改进该文档。