{"id":15163362,"url":"https://github.com/emqx/mqttx","last_synced_at":"2026-01-23T09:28:05.276Z","repository":{"id":37303483,"uuid":"188391577","full_name":"emqx/MQTTX","owner":"emqx","description":"A Powerful and All-in-One MQTT 5.0 client toolbox for Desktop, CLI and WebSocket.","archived":false,"fork":false,"pushed_at":"2025-04-18T01:28:07.000Z","size":105106,"stargazers_count":4265,"open_issues_count":98,"forks_count":478,"subscribers_count":67,"default_branch":"main","last_synced_at":"2025-05-08T02:54:06.902Z","etag":null,"topics":["cli","cross-platform","electron","electron-app","emqx","iot","iot-application","linux","macos","mosquitto","mqtt","mqtt-cli","mqtt-client","mqtt-client-gui","mqtt-protocol","mqtt-smarthome","mqtt-tool","mqtt-websocket","mqtt5","vue"],"latest_commit_sha":null,"homepage":"https://mqttx.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/emqx.png","metadata":{"files":{"readme":"README-CN.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-05-24T09:16:00.000Z","updated_at":"2025-05-08T02:10:40.000Z","dependencies_parsed_at":"2024-02-05T04:21:23.294Z","dependency_job_id":"c93be66e-aa02-46c1-b4a1-b4bfb089be50","html_url":"https://github.com/emqx/MQTTX","commit_stats":{"total_commits":1675,"total_committers":41,"mean_commits":"40.853658536585364","dds":0.657910447761194,"last_synced_commit":"72c434143414f5d2d362742eca8e2bc3b944854d"},"previous_names":[],"tags_count":53,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emqx%2FMQTTX","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emqx%2FMQTTX/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emqx%2FMQTTX/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emqx%2FMQTTX/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/emqx","download_url":"https://codeload.github.com/emqx/MQTTX/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254010811,"owners_count":21998993,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","cross-platform","electron","electron-app","emqx","iot","iot-application","linux","macos","mosquitto","mqtt","mqtt-cli","mqtt-client","mqtt-client-gui","mqtt-protocol","mqtt-smarthome","mqtt-tool","mqtt-websocket","mqtt5","vue"],"created_at":"2024-09-27T02:40:23.687Z","updated_at":"2026-01-23T09:28:05.215Z","avatar_url":"https://github.com/emqx.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"./assets/mqttx-logo.png\" width=\"480\" alt=\"MQTTX Logo\" /\u003e\n\n[![GitHub Release](https://img.shields.io/github/release/emqx/mqttx?color=brightgreen)](https://github.com/emqx/mqttx/releases)\n![Support Platforms](https://camo.githubusercontent.com/a50c47295f350646d08f2e1ccd797ceca3840e52/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f706c6174666f726d2d6d61634f5325323025374325323057696e646f77732532302537432532304c696e75782d6c69676874677265792e737667)\n![build packages](https://github.com/emqx/MQTTX/workflows/build%20packages/badge.svg)\n[![Total Downloads](https://img.shields.io/github/downloads/emqx/mqttx/total.svg)](https://github.com/emqx/mqttx/releases)\n[![Slack](https://img.shields.io/badge/Slack-EMQX-39AE85?logo=slack)](https://slack-invite.emqx.io/) [![Discord](https://img.shields.io/discord/931086341838622751?label=Discord\u0026logo=discord)](https://discord.gg/xYGf3fQnES)\n[![社区](https://img.shields.io/badge/Community-MQTTX-yellow?logo=github)](https://github.com/emqx/MQTTX/discussions)\n[![YouTube](https://img.shields.io/badge/Subscribe-EMQ%20中文-FF0000?logo=youtube)](https://www.youtube.com/channel/UCir_r04HIsLjf2qqyZ4A8Cg)\n[![Twitter](https://img.shields.io/badge/Follow-EMQ-1DA1F2?logo=twitter)](https://twitter.com/EMQTech)\n\n---\n\n[MQTTX](https://mqttx.app/zh) 是 [EMQ](https://www.emqx.com/zh) 开源的一款跨平台 [MQTT 5.0](https://www.emqx.com/zh/blog/introduction-to-mqtt-5) 客户端工具，它支持 macOS, Linux, Windows，并且支持 MQTT 消息格式转换。\n\n[MQTTX](https://mqttx.app/zh) 的用户界面借助聊天软件的形式简化了页面的操作逻辑，用户可以快速创建连接保存并同时建立多个连接客户端，方便用户快速测试 MQTT/TCP、MQTT/TLS、MQTT/WebSocket 的 **连接/发布/订阅** 功能及其他特性。\n\n\u003e [MQTT](https://www.emqx.com/zh/blog/the-easiest-guide-to-getting-started-with-mqtt) 全称为 Message Queuing Telemetry Transport（消息队列遥测传输）是一种基于 发布/订阅 范式的“轻量级”消息协议，旨在用于受限设备和低带宽，高延迟或不可靠的网络，由 IBM 发布。\n\n## 功能预览\n\n![mqttx-preview](./assets/mqttx-preview.png)\n\n## 安装\n\n当前可从以下应用商店进行快速下载安装\n\n### macOS App Store\n\n[![Download on the Mac App Store](./assets/app-store-download.svg)](https://apps.apple.com/cn/app/mqttx/id1514074565?mt=12)\n\n### Homebrew\n\nmacOS 的用户还可以选择使用 [brew cask](https://formulae.brew.sh/cask/mqttx) 来安装 MQTTX\n\n```shell\nbrew install --cask mqttx\n```\n\n### Linux\n\n[![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-black.svg)](https://snapcraft.io/mqttx)\n\u003ca href='https://flathub.org/apps/details/com.emqx.MQTTX'\u003e\u003cimg height='56' alt='Download on Flathub' src='https://flathub.org/assets/badges/flathub-badge-en.png'/\u003e\u003c/a\u003e\n\n### 发行包\n\n请从 [GitHub Releases](https://github.com/emqx/MQTTX/releases) 下载符合您的版本并安装使用。\n\n国内用户也可以从 [这里](https://www.emqx.com/zh/downloads/MQTTX/) 下载。\n\n## 使用\n\n详细使用，请查看我们的 [文档](https://mqttx.app/zh/docs) 或 [使用手册](./docs/manual.md)\n\n1. MQTT Broker 准备。\n\n   - 如果您不需要在本地部署 MQTT Broker，那么可以使用由 [EMQX Cloud](https://www.emqx.com/zh/cloud) 提供的[公共 MQTT 5.0 服务器](https://www.emqx.com/zh/mqtt/public-mqtt5-broker)来进行测试：\n\n      ```shell\n      Broker 地址: broker.emqx.io\n      Broker TCP 端口: 1883\n      Broker SSL 端口: 8883\n      ```\n\n   - 如果您打算部署一个本地运行的 MQTT Broker，那么我们推荐您 [下载 EMQX](https://www.emqx.com/zh/products/emqx) 进行安装和使用。EMQX 是一款开源云原生分布式物联网 MQTT 消息服务器。\n\n2. 连接配置。点击左侧菜单栏里的 `+` 号按钮，并填写表单中相应的必填项。\n\n3. 连接信息配置完成后，点击右上角的 `Connect` 按钮就可以创建一个连接并连接至 MQTT Broker。\n\n4. MQTT 连接成功后，就可以进行 MQTT 的发布与订阅测试。\n\n![mqttx-gif](./assets/mqttx-gif.gif)\n\n## 与 EMQX 更好的合作\n\nMQTTX 为连接测试 EMQX 等 MQTT 消息服务器而生，一键式的连接方式和简洁的图形界面可以帮助您快速连接到 EMQX 或 EMQX Cloud 调试并探索其功能特性。\n\n[注册 EMQX Cloud 可以享受 14 天免费试用](https://www.emqx.com/zh/try?product=cloud)\n\n[现在就本地下载并安装 EMQX](https://www.emqx.com/zh/try?product=enterprise)\n\n## 社区\n\n- 访问 [EMQ 问答社区](https://askemq.com/) 以获取帮助，也可以分享您的想法或项目。\n- 添加小助手微信号 `emqmkt`，加入 EMQ 微信技术交流群。\n- 加入我们的 [Discord](https://discord.gg/xYGf3fQnES)，参于实时讨论。\n- 关注我们的 [bilibili](https://space.bilibili.com/522222081)，获取最新物联网技术分享。\n- 关注我们的 [微博](https://weibo.com/emqtt) 或 [Twitter](https://twitter.com/EMQTech)，获取 EMQ 最新资讯。\n\n## 开发\n\nNode 环境的推荐版本:\n\n- v18.\\*.\\*\n\n``` shell\n# 克隆项目\ngit clone git@github.com:emqx/MQTTX.git\n\n# 安装依赖\ncd MQTTX\nyarn install\n\n# 编译和热重载以进行开发\nyarn run electron:serve\n\n# 编译和压缩以构建生产版本\nyarn run electron:build\n```\n\n构建成功后，会在 `dist_electron` 目录里出现构建成功的相应的安装文件。\n\n如果需要打包为独立操作系统的安装包，请参考以下命令：\n\n```shell\n# For Windows\nyarn run electron:build-win\n\n# For Linux\nyarn run electron:build-linux\n\n# For macOS\nyarn run electron:build-mac\n```\n\n## 贡献\n\n请确保在发出 PR 请求前， 已经仔细阅读过了[贡献指南](https://github.com/emqx/MQTTX/blob/main/.github/CONTRIBUTING_CN.md)\n\n## 技术栈\n\n- [Electron](https://electronjs.org/)\n- [Vue](https://vuejs.org/) + [Element](https://element.eleme.io)\n- [TypeScript](https://www.typescriptlang.org/)\n- [TypeORM](https://github.com/typeorm/typeorm)\n- [sqlite3](https://github.com/mapbox/node-sqlite3)\n- [MQTT.js](https://github.com/mqttjs/MQTT.js)\n\n## 相关资源\n\n- [MQTT 入门及进阶](https://www.emqx.com/zh/mqtt)\n\n  EMQ 提供了通俗易懂的技术文章及简单易用的客户端工具，帮助您学习 MQTT 并快速入门 MQTT 客户端编程。\n\n- [MQTT SDKs](https://www.emqx.com/zh/mqtt-client-sdk)\n\n  我们选取了各个编程语言中热门的 MQTT 客户端 SDK，并提供代码示例，帮助您快速掌握 MQTT 客户端库的使用。\n\n## License\n\nApache License 2.0, see [LICENSE](https://github.com/emqx/MQTTX/blob/main/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femqx%2Fmqttx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Femqx%2Fmqttx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femqx%2Fmqttx/lists"}