// the find
mcxiaoke/mqtt
MQTT协议3.1.1中文翻译版，IoT，物联网
A Chinese translation of the MQTT 3.1.1 protocol specification, covering the full spec from control packet formats to QoS flows and WebSocket usage. It's a reference document, not a library — useful for Chinese-speaking developers implementing MQTT from scratch or trying to understand the wire protocol without reading the OASIS English spec.
The translation covers the full spec chapter by chapter, including the fiddly QoS 2 multi-step handshake packets that trip up implementors. Available in multiple formats (PDF, ePub, HTML) which is genuinely useful offline. Has 5k stars suggesting it filled a real gap when it was written. The chapter-per-file structure makes it easy to link to specific protocol sections.
This is MQTT 3.1.1 only — MQTT 5.0 added significant features (user properties, reason codes, shared subscriptions, message expiry) and none of that is here. Last updated in 2021, last pushed 2024 which is just a file touch, not real maintenance. No code examples anywhere — it's a raw spec translation, so if you're confused about how QoS 2 actually behaves in practice, this won't help. The GitBook platform it was hosted on has degraded; some of the hosted links in the README now go to paywalled or broken pages.