[{"data":1,"prerenderedAt":521},["Reactive",2],{"VEb9Nnn1YX":3,"cli,faq":26},{"items":4,"meta":23},[5,8,11,14,17,20],{"title":6,"titleUrl":7},"如何在 Python3 中使用 MQTT 客户端库 Paho Client","how-to-use-mqtt-in-python",{"title":9,"titleUrl":10},"MQTT服务器（MQTT Broker）：工作原理与快速入门指南","the-ultimate-guide-to-mqtt-broker-comparison",{"title":12,"titleUrl":13},"MQTT QoS 0、1、2 解析：快速入门指南","introduction-to-mqtt-qos",{"title":15,"titleUrl":16},"在 ESP32 上使用 MQTT：入门指南","esp32-connects-to-the-free-public-mqtt-broker",{"title":18,"titleUrl":19},"MQTT 主题与通配符（Topics & Wildcards）入门手册","advanced-features-of-mqtt-topics",{"title":21,"titleUrl":22},"车联网 CAN Bus 协议介绍与数据实时流处理","can-bus-how-it-works-pros-and-cons",{"count":24,"limit":24,"page":25},6,1,{"_path":27,"_dir":28,"_draft":29,"_partial":29,"_locale":30,"title":31,"description":30,"body":32,"_type":516,"_id":517,"_source":518,"_file":519,"_extension":520},"/zh/cli/faq","cli",false,"","FAQ",{"type":33,"children":34,"toc":502},"root",[35,43,50,65,71,76,88,110,116,129,138,149,155,160,169,181,187,293,299,336,342,376,382,409,415,443,449,468,474],{"type":36,"tag":37,"props":38,"children":40},"element","h1",{"id":39},"faq",[41],{"type":42,"value":31},"text",{"type":36,"tag":44,"props":45,"children":47},"h2",{"id":46},"什么是-mqttx-cli",[48],{"type":42,"value":49},"什么是 MQTTX CLI？",{"type":36,"tag":51,"props":52,"children":53},"p",{},[54,56,63],{"type":42,"value":55},"MQTTX CLI（",{"type":36,"tag":57,"props":58,"children":60},"code",{"className":59},[],[61],{"type":42,"value":62},"mqttx",{"type":42,"value":64},"）是 EMQ 开源（Apache-2.0）的免费 MQTT 5.0 命令行客户端，支持 Windows、macOS 和 Linux。无需图形界面，即可在终端中连接 MQTT Broker、发布和订阅消息、进行性能测试以及模拟 IoT 数据。",{"type":36,"tag":44,"props":66,"children":68},{"id":67},"如何安装-mqttx-cli",[69],{"type":42,"value":70},"如何安装 MQTTX CLI？",{"type":36,"tag":51,"props":72,"children":73},{},[74],{"type":42,"value":75},"在 macOS 和 Linux 上运行：",{"type":36,"tag":77,"props":78,"children":83},"pre",{"className":79,"code":81,"language":82,"meta":30},[80],"language-shell","curl -fsSL https://emqx.sh/mqttx | sh\n","shell",[84],{"type":36,"tag":57,"props":85,"children":86},{"__ignoreMap":30},[87],{"type":42,"value":81},{"type":36,"tag":51,"props":89,"children":90},{},[91,93,99,101,108],{"type":42,"value":92},"在 Windows 上，于 PowerShell 中运行 ",{"type":36,"tag":57,"props":94,"children":96},{"className":95},[],[97],{"type":42,"value":98},"irm https://emqx.sh/mqttx.ps1 | iex",{"type":42,"value":100},"。Homebrew、NPM、Docker 等其他方式请参阅",{"type":36,"tag":102,"props":103,"children":105},"a",{"href":104},"/zh/docs/cli/downloading-and-installation",[106],{"type":42,"value":107},"安装",{"type":42,"value":109},"。",{"type":36,"tag":44,"props":111,"children":113},{"id":112},"在中国大陆下载很慢怎么办",[114],{"type":42,"value":115},"在中国大陆下载很慢怎么办？",{"type":36,"tag":51,"props":117,"children":118},{},[119,121,127],{"type":42,"value":120},"设置 ",{"type":36,"tag":57,"props":122,"children":124},{"className":123},[],[125],{"type":42,"value":126},"MQTTX_REGION=cn",{"type":42,"value":128}," 即可从 EMQ 的中国大陆镜像下载。",{"type":36,"tag":77,"props":130,"children":133},{"className":131,"code":132,"language":82,"meta":30},[80],"curl -fsSL https://emqx.sh/mqttx | MQTTX_REGION=cn sh\n",[134],{"type":36,"tag":57,"props":135,"children":136},{"__ignoreMap":30},[137],{"type":42,"value":132},{"type":36,"tag":77,"props":139,"children":144},{"className":140,"code":142,"language":143,"meta":30},[141],"language-powershell","$env:MQTTX_REGION = \"cn\"; irm https://emqx.sh/mqttx.ps1 | iex\n","powershell",[145],{"type":36,"tag":57,"props":146,"children":147},{"__ignoreMap":30},[148],{"type":42,"value":142},{"type":36,"tag":44,"props":150,"children":152},{"id":151},"如何在命令行中测试-mqtt-broker",[153],{"type":42,"value":154},"如何在命令行中测试 MQTT Broker？",{"type":36,"tag":51,"props":156,"children":157},{},[158],{"type":42,"value":159},"在一个终端中订阅，在另一个终端中发布：",{"type":36,"tag":77,"props":161,"children":164},{"className":162,"code":163,"language":82,"meta":30},[80],"mqttx sub -t 'hello' -h 'broker.emqx.io' -p 1883\nmqttx pub -t 'hello' -h 'broker.emqx.io' -p 1883 -m 'from MQTTX CLI'\n",[165],{"type":36,"tag":57,"props":166,"children":167},{"__ignoreMap":30},[168],{"type":42,"value":163},{"type":36,"tag":51,"props":170,"children":171},{},[172,174,180],{"type":42,"value":173},"如果只需检查 Broker 能否连接，运行 ",{"type":36,"tag":57,"props":175,"children":177},{"className":176},[],[178],{"type":42,"value":179},"mqttx conn -h 'broker.emqx.io' -p 1883",{"type":42,"value":109},{"type":36,"tag":44,"props":182,"children":184},{"id":183},"如何通过-tls-或-websocket-连接",[185],{"type":42,"value":186},"如何通过 TLS 或 WebSocket 连接？",{"type":36,"tag":51,"props":188,"children":189},{},[190,192,198,200,206,208,214,215,221,223,229,231,237,239,245,247,253,254,260,262,268,270,276,278,284,286,292],{"type":42,"value":191},"使用 ",{"type":36,"tag":57,"props":193,"children":195},{"className":194},[],[196],{"type":42,"value":197},"-l, --protocol",{"type":42,"value":199}," 选择 ",{"type":36,"tag":57,"props":201,"children":203},{"className":202},[],[204],{"type":42,"value":205},"mqtt",{"type":42,"value":207},"、",{"type":36,"tag":57,"props":209,"children":211},{"className":210},[],[212],{"type":42,"value":213},"mqtts",{"type":42,"value":207},{"type":36,"tag":57,"props":216,"children":218},{"className":217},[],[219],{"type":42,"value":220},"ws",{"type":42,"value":222}," 或 ",{"type":36,"tag":57,"props":224,"children":226},{"className":225},[],[227],{"type":42,"value":228},"wss",{"type":42,"value":230},"。TLS 连接通过 ",{"type":36,"tag":57,"props":232,"children":234},{"className":233},[],[235],{"type":42,"value":236},"--ca",{"type":42,"value":238}," 指定 CA 证书，双向 TLS 还需要 ",{"type":36,"tag":57,"props":240,"children":242},{"className":241},[],[243],{"type":42,"value":244},"--cert",{"type":42,"value":246}," 和 ",{"type":36,"tag":57,"props":248,"children":250},{"className":249},[],[251],{"type":42,"value":252},"--key",{"type":42,"value":109},{"type":36,"tag":57,"props":255,"children":257},{"className":256},[],[258],{"type":42,"value":259},"--insecure",{"type":42,"value":261}," 会跳过服务器证书校验，仅建议在测试时使用。WebSocket 连接可通过 ",{"type":36,"tag":57,"props":263,"children":265},{"className":264},[],[266],{"type":42,"value":267},"--path",{"type":42,"value":269}," 设置路径（默认 ",{"type":36,"tag":57,"props":271,"children":273},{"className":272},[],[274],{"type":42,"value":275},"/mqtt",{"type":42,"value":277},"），通过 ",{"type":36,"tag":57,"props":279,"children":281},{"className":280},[],[282],{"type":42,"value":283},"-wh",{"type":42,"value":285}," 添加请求头。全部参数请参考",{"type":36,"tag":102,"props":287,"children":289},{"href":288},"/zh/docs/cli/get-started",[290],{"type":42,"value":291},"开始使用",{"type":42,"value":109},{"type":36,"tag":44,"props":294,"children":296},{"id":295},"mqttx-cli-支持哪些-mqtt-版本",[297],{"type":42,"value":298},"MQTTX CLI 支持哪些 MQTT 版本？",{"type":36,"tag":51,"props":300,"children":301},{},[302,304,310,312,318,320,326,328,334],{"type":42,"value":303},"支持 MQTT 5.0、3.1.1 和 3.1，默认使用 MQTT 5.0，可通过 ",{"type":36,"tag":57,"props":305,"children":307},{"className":306},[],[308],{"type":42,"value":309},"-V, --mqtt-version",{"type":42,"value":311}," 切换。MQTT 5.0 特性均以参数形式提供，例如用户属性（",{"type":36,"tag":57,"props":313,"children":315},{"className":314},[],[316],{"type":42,"value":317},"-up",{"type":42,"value":319},"）、会话过期间隔（",{"type":36,"tag":57,"props":321,"children":323},{"className":322},[],[324],{"type":42,"value":325},"-se",{"type":42,"value":327},"）以及订阅时的 Retain Handling（",{"type":36,"tag":57,"props":329,"children":331},{"className":330},[],[332],{"type":42,"value":333},"-rh",{"type":42,"value":335},"）。",{"type":36,"tag":44,"props":337,"children":339},{"id":338},"mqttx-cli-能对-mqtt-broker-进行性能测试吗",[340],{"type":42,"value":341},"MQTTX CLI 能对 MQTT Broker 进行性能测试吗？",{"type":36,"tag":51,"props":343,"children":344},{},[345,347,353,354,360,361,367,369,375],{"type":42,"value":346},"可以。",{"type":36,"tag":57,"props":348,"children":350},{"className":349},[],[351],{"type":42,"value":352},"mqttx bench conn",{"type":42,"value":207},{"type":36,"tag":57,"props":355,"children":357},{"className":356},[],[358],{"type":42,"value":359},"mqttx bench sub",{"type":42,"value":246},{"type":36,"tag":57,"props":362,"children":364},{"className":363},[],[365],{"type":42,"value":366},"mqttx bench pub",{"type":42,"value":368}," 分别使用大量并发客户端测试连接、订阅和发布性能，例如 ",{"type":36,"tag":57,"props":370,"children":372},{"className":371},[],[373],{"type":42,"value":374},"mqttx bench pub -c 5000 -t bench/%i",{"type":42,"value":109},{"type":36,"tag":44,"props":377,"children":379},{"id":378},"mqttx-cli-能生成模拟-iot-数据吗",[380],{"type":42,"value":381},"MQTTX CLI 能生成模拟 IoT 数据吗？",{"type":36,"tag":51,"props":383,"children":384},{},[385,386,392,394,400,402,408],{"type":42,"value":346},{"type":36,"tag":57,"props":387,"children":389},{"className":388},[],[390],{"type":42,"value":391},"mqttx simulate",{"type":42,"value":393}," 可以使用内置场景（通过 ",{"type":36,"tag":57,"props":395,"children":397},{"className":396},[],[398],{"type":42,"value":399},"mqttx ls -sc",{"type":42,"value":401}," 查看）或自定义 JavaScript 脚本发布数据，例如 ",{"type":36,"tag":57,"props":403,"children":405},{"className":404},[],[406],{"type":42,"value":407},"mqttx simulate -sc tesla -c 10",{"type":42,"value":109},{"type":36,"tag":44,"props":410,"children":412},{"id":411},"如何避免重复输入相同的参数",[413],{"type":42,"value":414},"如何避免重复输入相同的参数？",{"type":36,"tag":51,"props":416,"children":417},{},[418,419,425,427,433,435,441],{"type":42,"value":191},{"type":36,"tag":57,"props":420,"children":422},{"className":421},[],[423],{"type":42,"value":424},"-so, --save-options",{"type":42,"value":426}," 将参数保存为 JSON 或 YAML 文件，之后通过 ",{"type":36,"tag":57,"props":428,"children":430},{"className":429},[],[431],{"type":42,"value":432},"-lo, --load-options",{"type":42,"value":434}," 加载。运行 ",{"type":36,"tag":57,"props":436,"children":438},{"className":437},[],[439],{"type":42,"value":440},"mqttx init",{"type":42,"value":442}," 可以创建默认配置文件。",{"type":36,"tag":44,"props":444,"children":446},{"id":445},"ai-编码-agent-可以使用-mqttx-cli-吗",[447],{"type":42,"value":448},"AI 编码 Agent 可以使用 MQTTX CLI 吗？",{"type":36,"tag":51,"props":450,"children":451},{},[452,453,459,461,467],{"type":42,"value":346},{"type":36,"tag":102,"props":454,"children":456},{"href":455},"/zh/docs/cli/agent-skill",[457],{"type":42,"value":458},"mqttx-cli Agent Skill",{"type":42,"value":460}," 可以让 Claude Code、Cursor 等 AI 编码 Agent 正确使用 MQTTX CLI 完成连接检查、发布订阅往返验证、性能测试和故障排查。安装命令为 ",{"type":36,"tag":57,"props":462,"children":464},{"className":463},[],[465],{"type":42,"value":466},"npx skills add emqx/MQTTX --skill mqttx-cli",{"type":42,"value":109},{"type":36,"tag":44,"props":469,"children":471},{"id":470},"如何检查更新",[472],{"type":42,"value":473},"如何检查更新？",{"type":36,"tag":51,"props":475,"children":476},{},[477,479,485,487,493,495,501],{"type":42,"value":478},"运行 ",{"type":36,"tag":57,"props":480,"children":482},{"className":481},[],[483],{"type":42,"value":484},"mqttx check",{"type":42,"value":486}," 即可检查是否有新版本的 MQTTX CLI。从 v1.13.3 起，可运行 ",{"type":36,"tag":57,"props":488,"children":490},{"className":489},[],[491],{"type":42,"value":492},"mqttx update",{"type":42,"value":494}," 安装最新版本，详情请参阅",{"type":36,"tag":102,"props":496,"children":498},{"href":497},"/zh/docs/cli/get-started#%E6%9B%B4%E6%96%B0",[499],{"type":42,"value":500},"更新",{"type":42,"value":109},{"title":30,"searchDepth":503,"depth":503,"links":504},2,[505,506,507,508,509,510,511,512,513,514,515],{"id":46,"depth":503,"text":49},{"id":67,"depth":503,"text":70},{"id":112,"depth":503,"text":115},{"id":151,"depth":503,"text":154},{"id":183,"depth":503,"text":186},{"id":295,"depth":503,"text":298},{"id":338,"depth":503,"text":341},{"id":378,"depth":503,"text":381},{"id":411,"depth":503,"text":414},{"id":445,"depth":503,"text":448},{"id":470,"depth":503,"text":473},"markdown","content:zh:cli:faq.md","content","zh/cli/faq.md","md",1794381308720]