opsxapi/homepage/dist/docs/mqtt/index.html

<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>MQTT · OpsxAPI 文档</title>
<meta name="description" content="OpsxAPI 接口工作台用户文档 — HTTP、GraphQL、WebSocket、SSE、Socket.IO、MQTT 一站式调试，支持 OpenAPI/Postman/cURL 等格式导入导出。">
<link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Crect width='32' height='32' rx='7' fill='%232563eb'/%3E%3Ctext x='16' y='22' font-size='18' font-weight='bold' fill='%23fff' text-anchor='middle' font-family='sans-serif'%3EO%3C/text%3E%3C/svg%3E">
<link rel="icon" type="image/svg+xml" href="data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%2064%2064%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%2264%22%20y2%3D%2264%22%20gradientUnits%3D%22userSpaceOnUse%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22%232563EB%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22%2306B6D4%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%2264%22%20height%3D%2264%22%20rx%3D%2214%22%20fill%3D%22url%28%23g%29%22%2F%3E%3Cg%20stroke%3D%22%23fff%22%20stroke-width%3D%225%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%20fill%3D%22none%22%3E%3Cpath%20d%3D%22M17%2025h26%22%2F%3E%3Cpath%20d%3D%22M37%2019l6%206-6%206%22%2F%3E%3Cpath%20d%3D%22M47%2039H21%22%2F%3E%3Cpath%20d%3D%22M27%2033l-6%206%206%206%22%2F%3E%3C%2Fg%3E%3C%2Fsvg%3E">
<link rel="stylesheet" href="/docs/assets/docs.css">
</head>
<body>
<svg xmlns="http://www.w3.org/2000/svg" style="display:none" aria-hidden="true">
<symbol id="i-menu" viewBox="0 0 24 24"><path d="M4 5h16" /> <path d="M4 12h16" /> <path d="M4 19h16" /></symbol>
<symbol id="i-search" viewBox="0 0 24 24"><path d="m21 21-4.34-4.34" /> <circle cx="11" cy="11" r="8" /></symbol>
</svg>
<header class="topbar">
  <div class="topbar-inner">
    <button class="menu-btn" id="menu-btn" aria-label="打开导航"><svg class="i"><use href="#i-menu"/></svg></button>
    <a class="brand" href="/docs">
      <span class="brand-logo"><svg width="28" height="28" viewBox="0 0 64 64" aria-label="OpsxAPI"><defs><linearGradient id="lg-docs" x1="0" y1="0" x2="64" y2="64" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#2563EB"/><stop offset="1" stop-color="#06B6D4"/></linearGradient></defs><rect width="64" height="64" rx="14" fill="url(#lg-docs)"/><g stroke="#fff" stroke-width="5" stroke-linecap="round" stroke-linejoin="round" fill="none"><path d="M17 25h26"/><path d="M37 19l6 6-6 6"/><path d="M47 39H21"/><path d="M27 33l-6 6 6 6"/></g></svg></span>
      <span class="brand-name">OpsxAPI <em>文档</em></span>
    </a>
    <span class="ver-badge">v1.0</span>
    <div class="search">
      <input id="search-input" type="search" placeholder="搜索文档…" autocomplete="off" spellcheck="false">
      <div class="search-panel" id="search-panel" hidden></div>
    </div>
    <nav class="top-links">
      <a href="/home">官网</a>
    </nav>
  </div>
</header>

<div class="layout" id="layout">
  <aside class="sidebar" id="sidebar">
    
    <div class="nav-group">
      <div class="nav-group-title">开始使用</div>
      
      <a class="nav-link" href="/docs/intro">产品介绍</a>
      
      <a class="nav-link" href="/docs/interface">界面导览</a>
      
    </div>
    
    <div class="nav-group">
      <div class="nav-group-title">请求调试</div>
      
      <a class="nav-link" href="/docs/http">发送 HTTP 请求</a>
      
      <a class="nav-link" href="/docs/auth">接口鉴权</a>
      
      <a class="nav-link" href="/docs/env">环境与变量</a>
      
      <a class="nav-link" href="/docs/graphql">GraphQL</a>
      
      <a class="nav-link" href="/docs/websocket">WebSocket</a>
      
      <a class="nav-link" href="/docs/sse">SSE 事件流</a>
      
      <a class="nav-link" href="/docs/socketio">Socket.IO</a>
      
      <a class="nav-link active" href="/docs/mqtt">MQTT</a>
      
    </div>
    
    <div class="nav-group">
      <div class="nav-group-title">数据管理</div>
      
      <a class="nav-link" href="/docs/import">数据导入</a>
      
      <a class="nav-link" href="/docs/export">导出与代码生成</a>
      
      <a class="nav-link" href="/docs/mock">Mock 数据</a>
      
      <a class="nav-link" href="/docs/manage">集合与历史</a>
      
    </div>
    
    <div class="nav-group">
      <div class="nav-group-title">自动化测试与 AI</div>
      
      <a class="nav-link" href="/docs/testing">自动化测试</a>
      
      <a class="nav-link" href="/docs/ai">AI 助手</a>
      
    </div>
    
    <div class="nav-group">
      <div class="nav-group-title">账号与团队</div>
      
      <a class="nav-link" href="/docs/account">账号与团队</a>
      
    </div>
    
    <div class="nav-group">
      <div class="nav-group-title">参考</div>
      
      <a class="nav-link" href="/docs/license">授权与激活</a>
      
      <a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
      
      <a class="nav-link" href="/docs/faq">常见问题</a>
      
    </div>
    
    <div class="sidebar-foot">© 2026 OpsxAPI · 本地优先的接口工作台</div>
  </aside>

  <main class="content">
    <div class="breadcrumb">文档 <span>/</span> 请求调试 <span>/</span> MQTT</div>
    <h1 class="page-title">MQTT</h1>
    <div class="page-meta">更新于 2026-09-17</div>
    <article class="md">
<h2 id="sec-1">连接 Broker</h2>
<p>浏览器环境要求 <strong>WebSocket 形式</strong>的 Broker 地址：</p>
<pre><code class="language-text">wss://broker.emqx.io:8084/mqtt
</code></pre>
<table>
<thead>
<tr>
<th>配置</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>用户名 / 密码</td>
<td>可选，支持 <code>{{变量}}</code></td>
</tr>
<tr>
<td>ClientId</td>
<td>默认随机生成；同一 Broker 上必须唯一</td>
</tr>
<tr>
<td>QoS</td>
<td>0 至多一次 · 1 至少一次 · 2 恰好一次</td>
</tr>
</tbody>
</table>
<h2 id="sec-2">订阅</h2>
<p>「Broker / 订阅」中填写逗号分隔的主题，支持通配符：</p>
<pre><code class="language-text">opsxapi/demo, sensor/+, home/#
</code></pre>
<blockquote>
<p><strong>注意</strong>：订阅在<strong>建立连接时</strong>生效，修改主题后需断开重连。</p>
</blockquote>
<h2 id="sec-3">发布</h2>
<p>「发布」标签配置主题与 Payload（JSON / 纯文本），点击发布按钮即送达；已发布消息以蓝色出现在日志中并标注主题。</p>
<h2 id="sec-4">公共测试 Broker</h2>
<table>
<thead>
<tr>
<th>Broker</th>
<th>地址</th>
</tr>
</thead>
<tbody>
<tr>
<td>EMQX</td>
<td><code>wss://broker.emqx.io:8084/mqtt</code></td>
</tr>
<tr>
<td>HiveMQ</td>
<td><code>wss://broker.hivemq.com:8884/mqtt</code></td>
</tr>
</tbody>
</table>
<p>两个浏览器窗口连接同一主题，即可互相收发验证。</p>
<h2 id="sec-5">行为说明</h2>
<ul>
<li>断线自动重连（3 秒间隔），状态点显示「重连中」。</li>
<li>消息日志上限 500 条；QoS 与主题逐条标注。</li>
</ul>

    </article>

    <div class="pn-nav">
      
      <a class="pn prev" href="/docs/socketio"><span class="pn-label">← 上一页</span><span class="pn-title">Socket.IO</span></a>
      
      
      <a class="pn next" href="/docs/import"><span class="pn-label">下一页 →</span><span class="pn-title">数据导入</span></a>
      
    </div>


  </main>

  <aside class="toc">
    <div class="toc-title">本页目录</div>
    <nav class="toc-nav">
      <a class="toc-l2" href="#sec-1">连接 Broker</a>
      <a class="toc-l2" href="#sec-2">订阅</a>
      <a class="toc-l2" href="#sec-3">发布</a>
      <a class="toc-l2" href="#sec-4">公共测试 Broker</a>
      <a class="toc-l2" href="#sec-5">行为说明</a>
      
    </nav>
  </aside>
</div>

<script src="/docs/assets/docs.js" defer></script>
</body>
</html>