1. EMQX V5.0.X 部署准备在开始部署EMQX V5.0.X之前我们需要先了解一些基础知识。EMQX是一款开源的MQTT消息服务器专门为物联网场景设计能够处理海量设备连接和消息传递。V5.0.X版本在性能、稳定性和功能上都有显著提升特别适合需要高可靠性的物联网应用。1.1 系统环境检查我建议在CentOS 7.9系统上进行部署这是经过充分测试的稳定环境。首先检查系统基本信息# 查看系统版本 cat /etc/redhat-release # 查看CPU架构 uname -m确保系统已经安装了必要的依赖# 安装基础依赖 yum install -y openssl openssl-devel ncurses-devel bc unzip内存和磁盘空间也很重要EMQX运行至少需要2GB内存和10GB磁盘空间。可以通过以下命令检查# 查看内存 free -h # 查看磁盘 df -h1.2 安装方式选择EMQX V5.0.X提供两种主要安装方式RPM和TAR。RPM方式适合生产环境管理方便TAR方式更灵活适合开发和测试。我建议生产环境优先选择RPM安装因为自动配置服务管理标准化安装路径便于后续升级维护集成系统日志管理2. 详细安装步骤2.1 RPM方式安装首先从官网下载RPM包选择与系统匹配的版本。我推荐使用wget直接下载wget https://www.emqx.com/zh/downloads/broker/5.0.9/emqx-5.0.9-el7-amd64.rpm安装RPM包时我习惯加上--nodeps参数避免不必要的依赖冲突rpm -ivh emqx-5.0.9-el7-amd64.rpm --nodeps安装完成后系统会自动创建emqx用户和必要的目录结构。检查安装是否成功rpm -qa | grep emqx2.2 TAR方式安装对于TAR安装先创建专用目录mkdir -p /opt/emqx cd /opt/emqx下载并解压TAR包wget https://www.emqx.com/zh/downloads/broker/5.0.9/emqx-5.0.9-el7-amd64.tar.gz tar -zxvf emqx-5.0.9-el7-amd64.tar.gzTAR安装的一个优势是可以自定义路径但需要手动管理服务。启动方式也不同# 启动 ./bin/emqx start # 查看状态 ./bin/emqx_ctl status3. 服务启动与配置3.1 初始化启动RPM安装后使用systemctl管理服务systemctl start emqx systemctl enable emqx检查服务状态时我习惯用详细输出systemctl status emqx -l首次启动后访问管理控制台http://服务器IP:18083。默认账号admin/public记得第一时间修改密码。3.2 防火墙配置很多新手会卡在防火墙问题上。CentOS 7使用firewalld需要开放以下关键端口firewall-cmd --permanent --add-port{18083,1883,8083,8084}/tcp firewall-cmd --reload1883是MQTT标准端口18083是管理界面8083/8084用于WebSocket和HTTP API。4. 常见问题排查4.1 OpenSSL缺失问题这是最常见的启动错误之一。症状是启动时报openssl not found。解决方法# 确认openssl版本 openssl version # 如果版本低于1.1.1建议升级 yum install -y openssl11然后设置环境变量export LD_LIBRARY_PATH/usr/lib64/openssl11:$LD_LIBRARY_PATH4.2 端口冲突处理当遇到端口占用时我的排查步骤是确认具体哪个端口被占netstat -tulnp | grep emqx查找占用进程lsof -i :4370根据情况决定是终止进程还是修改EMQX配置4.3 依赖库问题libatomic.so.1 not found这类错误通常是因为64位系统缺少32位库。解决方法yum install -y libatomic如果仍然报错可以手动创建软链接ln -s /usr/lib64/libatomic.so.1 /usr/lib/libatomic.so.15. 数据桥接实战5.1 配置TDengine桥接将EMQX数据写入TDengine是常见场景。首先在TDengine创建接收表CREATE DATABASE IF NOT EXISTS iot; USE iot; CREATE TABLE IF NOT EXISTS device_data ( ts TIMESTAMP, device_id NCHAR(64), temperature FLOAT, humidity FLOAT );然后在EMQX中配置Webhook桥接进入管理控制台 - 数据集成 - 数据桥接选择Webhook类型填写TDengine RESTful接口地址http://TDengineIP:6041/rest/sql设置认证头Basic cm9vdDp0YW9zZGF0YQ5.2 创建规则引擎规则引擎是EMQX的强大功能。我们创建一个规则将温度数据写入TDengine在规则引擎中新建规则使用SQL语句筛选数据SELECT payload.temp as temperature, payload.hum as humidity, clientid as device_id FROM temperature/#关联之前创建的Webhook桥接配置动作参数将SQL结果转换为TDengine的INSERT语句5.3 测试数据流使用MQTT客户端发布测试消息mosquitto_pub -t temperature/1 -m {temp:25.5,hum:60}然后在TDengine中查询数据SELECT * FROM iot.device_data;6. 运维管理技巧6.1 日志管理EMQX日志是排查问题的重要依据。生产环境建议调整日志配置# 修改日志级别为info emqx_ctl log set-level info # 限制日志大小 emqx_ctl log handlers set-level file --size 50MB --count 10关键日志文件位置/var/log/emqx/emqx.log.NRPM安装./log/emqx.log.NTAR安装6.2 性能监控EMQX内置了Prometheus监控支持。启用方法# 修改配置文件 vim /etc/emqx/emqx.conf # 找到prometheus部分并启用 prometheus.enabled true然后可以通过http://EMQXIP:18083/api/v5/prometheus/stats获取监控数据。6.3 集群部署生产环境建议至少3节点集群。配置步骤确保节点间网络通畅设置相同的集群cookievim /etc/emqx/emqx.conf node.cookie emqxsecretcookie手动加入集群emqx_ctl cluster join emqxnode17. 安全加固建议7.1 修改默认密码安装后首要任务是修改默认admin密码emqx_ctl admins passwd admin 新密码7.2 启用SSL/TLS生产环境必须启用MQTT over SSL# 生成自签名证书 openssl req -x509 -newkey rsa:2048 -keyout key.pem -out cert.pem -days 365 -nodes然后在EMQX配置中启用SSL监听器。7.3 访问控制合理配置ACL限制客户端权限# 示例ACL规则 {allow, {user, dashboard}, subscribe, [$SYS/#]}. {allow, {ipaddr, 192.168.0.1}, all, [$SYS/#, #]}.8. 升级与维护8.1 版本升级小版本升级相对简单rpm -Uvh emqx-5.0.10-el7-amd64.rpm大版本升级建议先备份配置和数据在测试环境验证选择业务低峰期操作准备好回滚方案8.2 数据备份关键数据包括/etc/emqx/emqx.conf 主配置文件/etc/emqx/acl.conf ACL规则/var/lib/emqx/mnesia/ 集群数据如果使用内置数据库建议编写定期备份脚本tar -czvf emqx_backup_$(date %Y%m%d).tar.gz /etc/emqx /var/lib/emqx/mnesia9. 性能调优9.1 系统参数优化调整内核参数提升性能# 增加文件描述符限制 echo fs.file-max 1000000 /etc/sysctl.conf # 增加TCP连接数 echo net.ipv4.ip_local_port_range 1024 65535 /etc/sysctl.conf sysctl -p9.2 EMQX参数调优关键配置项# 修改/etc/emqx/emqx.conf # 增加最大连接数 node.max_connections 1000000 # 调整MQTT协议栈 zone.external.max_packet_size 10MB # 优化消息吞吐 listener.tcp.external.max_connections 50000010. 实战案例智能家居平台以一个智能家居平台为例演示完整数据流设备通过MQTT发布数据到主题home/livingroom/temperatureEMQX规则引擎处理消息SELECT payload.temp as temperature, timestamps as ts, clientid as device_id FROM home//temperature通过数据桥接写入InfluxDBGrafana展示实时数据这个案例中EMQX处理了设备连接、消息路由、数据转换和存储集成展现了完整的物联网数据管道能力。
从零到一：EMQX V5.0.X 部署、运维与数据桥接实战
发布时间：2026/5/16 5:24:08
1. EMQX V5.0.X 部署准备在开始部署EMQX V5.0.X之前我们需要先了解一些基础知识。EMQX是一款开源的MQTT消息服务器专门为物联网场景设计能够处理海量设备连接和消息传递。V5.0.X版本在性能、稳定性和功能上都有显著提升特别适合需要高可靠性的物联网应用。1.1 系统环境检查我建议在CentOS 7.9系统上进行部署这是经过充分测试的稳定环境。首先检查系统基本信息# 查看系统版本 cat /etc/redhat-release # 查看CPU架构 uname -m确保系统已经安装了必要的依赖# 安装基础依赖 yum install -y openssl openssl-devel ncurses-devel bc unzip内存和磁盘空间也很重要EMQX运行至少需要2GB内存和10GB磁盘空间。可以通过以下命令检查# 查看内存 free -h # 查看磁盘 df -h1.2 安装方式选择EMQX V5.0.X提供两种主要安装方式RPM和TAR。RPM方式适合生产环境管理方便TAR方式更灵活适合开发和测试。我建议生产环境优先选择RPM安装因为自动配置服务管理标准化安装路径便于后续升级维护集成系统日志管理2. 详细安装步骤2.1 RPM方式安装首先从官网下载RPM包选择与系统匹配的版本。我推荐使用wget直接下载wget https://www.emqx.com/zh/downloads/broker/5.0.9/emqx-5.0.9-el7-amd64.rpm安装RPM包时我习惯加上--nodeps参数避免不必要的依赖冲突rpm -ivh emqx-5.0.9-el7-amd64.rpm --nodeps安装完成后系统会自动创建emqx用户和必要的目录结构。检查安装是否成功rpm -qa | grep emqx2.2 TAR方式安装对于TAR安装先创建专用目录mkdir -p /opt/emqx cd /opt/emqx下载并解压TAR包wget https://www.emqx.com/zh/downloads/broker/5.0.9/emqx-5.0.9-el7-amd64.tar.gz tar -zxvf emqx-5.0.9-el7-amd64.tar.gzTAR安装的一个优势是可以自定义路径但需要手动管理服务。启动方式也不同# 启动 ./bin/emqx start # 查看状态 ./bin/emqx_ctl status3. 服务启动与配置3.1 初始化启动RPM安装后使用systemctl管理服务systemctl start emqx systemctl enable emqx检查服务状态时我习惯用详细输出systemctl status emqx -l首次启动后访问管理控制台http://服务器IP:18083。默认账号admin/public记得第一时间修改密码。3.2 防火墙配置很多新手会卡在防火墙问题上。CentOS 7使用firewalld需要开放以下关键端口firewall-cmd --permanent --add-port{18083,1883,8083,8084}/tcp firewall-cmd --reload1883是MQTT标准端口18083是管理界面8083/8084用于WebSocket和HTTP API。4. 常见问题排查4.1 OpenSSL缺失问题这是最常见的启动错误之一。症状是启动时报openssl not found。解决方法# 确认openssl版本 openssl version # 如果版本低于1.1.1建议升级 yum install -y openssl11然后设置环境变量export LD_LIBRARY_PATH/usr/lib64/openssl11:$LD_LIBRARY_PATH4.2 端口冲突处理当遇到端口占用时我的排查步骤是确认具体哪个端口被占netstat -tulnp | grep emqx查找占用进程lsof -i :4370根据情况决定是终止进程还是修改EMQX配置4.3 依赖库问题libatomic.so.1 not found这类错误通常是因为64位系统缺少32位库。解决方法yum install -y libatomic如果仍然报错可以手动创建软链接ln -s /usr/lib64/libatomic.so.1 /usr/lib/libatomic.so.15. 数据桥接实战5.1 配置TDengine桥接将EMQX数据写入TDengine是常见场景。首先在TDengine创建接收表CREATE DATABASE IF NOT EXISTS iot; USE iot; CREATE TABLE IF NOT EXISTS device_data ( ts TIMESTAMP, device_id NCHAR(64), temperature FLOAT, humidity FLOAT );然后在EMQX中配置Webhook桥接进入管理控制台 - 数据集成 - 数据桥接选择Webhook类型填写TDengine RESTful接口地址http://TDengineIP:6041/rest/sql设置认证头Basic cm9vdDp0YW9zZGF0YQ5.2 创建规则引擎规则引擎是EMQX的强大功能。我们创建一个规则将温度数据写入TDengine在规则引擎中新建规则使用SQL语句筛选数据SELECT payload.temp as temperature, payload.hum as humidity, clientid as device_id FROM temperature/#关联之前创建的Webhook桥接配置动作参数将SQL结果转换为TDengine的INSERT语句5.3 测试数据流使用MQTT客户端发布测试消息mosquitto_pub -t temperature/1 -m {temp:25.5,hum:60}然后在TDengine中查询数据SELECT * FROM iot.device_data;6. 运维管理技巧6.1 日志管理EMQX日志是排查问题的重要依据。生产环境建议调整日志配置# 修改日志级别为info emqx_ctl log set-level info # 限制日志大小 emqx_ctl log handlers set-level file --size 50MB --count 10关键日志文件位置/var/log/emqx/emqx.log.NRPM安装./log/emqx.log.NTAR安装6.2 性能监控EMQX内置了Prometheus监控支持。启用方法# 修改配置文件 vim /etc/emqx/emqx.conf # 找到prometheus部分并启用 prometheus.enabled true然后可以通过http://EMQXIP:18083/api/v5/prometheus/stats获取监控数据。6.3 集群部署生产环境建议至少3节点集群。配置步骤确保节点间网络通畅设置相同的集群cookievim /etc/emqx/emqx.conf node.cookie emqxsecretcookie手动加入集群emqx_ctl cluster join emqxnode17. 安全加固建议7.1 修改默认密码安装后首要任务是修改默认admin密码emqx_ctl admins passwd admin 新密码7.2 启用SSL/TLS生产环境必须启用MQTT over SSL# 生成自签名证书 openssl req -x509 -newkey rsa:2048 -keyout key.pem -out cert.pem -days 365 -nodes然后在EMQX配置中启用SSL监听器。7.3 访问控制合理配置ACL限制客户端权限# 示例ACL规则 {allow, {user, dashboard}, subscribe, [$SYS/#]}. {allow, {ipaddr, 192.168.0.1}, all, [$SYS/#, #]}.8. 升级与维护8.1 版本升级小版本升级相对简单rpm -Uvh emqx-5.0.10-el7-amd64.rpm大版本升级建议先备份配置和数据在测试环境验证选择业务低峰期操作准备好回滚方案8.2 数据备份关键数据包括/etc/emqx/emqx.conf 主配置文件/etc/emqx/acl.conf ACL规则/var/lib/emqx/mnesia/ 集群数据如果使用内置数据库建议编写定期备份脚本tar -czvf emqx_backup_$(date %Y%m%d).tar.gz /etc/emqx /var/lib/emqx/mnesia9. 性能调优9.1 系统参数优化调整内核参数提升性能# 增加文件描述符限制 echo fs.file-max 1000000 /etc/sysctl.conf # 增加TCP连接数 echo net.ipv4.ip_local_port_range 1024 65535 /etc/sysctl.conf sysctl -p9.2 EMQX参数调优关键配置项# 修改/etc/emqx/emqx.conf # 增加最大连接数 node.max_connections 1000000 # 调整MQTT协议栈 zone.external.max_packet_size 10MB # 优化消息吞吐 listener.tcp.external.max_connections 50000010. 实战案例智能家居平台以一个智能家居平台为例演示完整数据流设备通过MQTT发布数据到主题home/livingroom/temperatureEMQX规则引擎处理消息SELECT payload.temp as temperature, timestamps as ts, clientid as device_id FROM home//temperature通过数据桥接写入InfluxDBGrafana展示实时数据这个案例中EMQX处理了设备连接、消息路由、数据转换和存储集成展现了完整的物联网数据管道能力。
相关文章
别再手动算NDVI了！用GEE处理Landsat8/9数据，5分钟搞定区域植被指数统计
别再手动算NDVI了！用GEE处理Landsat8/9数据，5分钟搞定区域植被指数统计 植被指数分析是生态监测和农业评估的常规操作，但传统流程的繁琐程度足以让大多数研究者望而却步。想象一下：下载数十GB的遥感数据、处理云层遮挡、校正辐射…
从手绘草图到学术论文只需1次语音输入：NotebookLM建筑学本地化部署全链路指南，含ArchDaily/CAFA/ETH原始数据集适配方案
更多请点击： https://intelliparadigm.com 第一章：从手绘草图到学术论文只需1次语音输入：NotebookLM建筑学研究辅助 语音驱动的多模态研究工作流 NotebookLM（Google Labs 推出的实验性 AI 助手）现已支持建筑学场景下…
基于CircuitPython与PyPortal的嵌入式扫雷游戏开发实战
1. 项目概述如果你玩过Windows，那你大概率也玩过扫雷。这个诞生于上世纪90年代的经典游戏，以其简单的规则和烧脑的逻辑，成为了无数人的“摸鱼”启蒙。但你想过没有，如果把这个游戏从电脑屏幕里“抠”出来，塞进一块巴掌…
你应该知道的10个AI芯片术语
本文转自：半导体芯闻AI 芯片领域发展迅速，芯片是每一种AI体验的基础，理解软件背后的硬件从未像现在这样重要。以下是 10 个值得了解的术语：1. AI 加速器 (AI Accelerator)一类专门为 AI 工作负载而非通用计算构建的宽泛芯片类别。…
Seraphine：基于LCU API的英雄联盟战绩查询与智能决策系统技术解析
Seraphine：基于LCU API的英雄联盟战绩查询与智能决策系统技术解析 【免费下载链接】Seraphine 英雄联盟战绩查询工具 项目地址: https://gitcode.com/gh_mirrors/se/Seraphine Seraphine是一款基于英雄联盟客户端接口（LCU API）开发的免…
ChatMark：将LLM对话导出为Markdown，实现AI协作知识管理
1. 项目概述：ChatMark，一个让AI对话“看得见”的利器 如果你和我一样，经常和各类大语言模型（LLM）打交道，无论是用ChatGPT、Claude还是本地部署的开源模型，一个共同的痛点就是：对话记…
SOCD Cleaner终极指南：告别游戏输入冲突，开启精准操作新时代
SOCD Cleaner终极指南：告别游戏输入冲突，开启精准操作新时代 【免费下载链接】socd Key remapper for epic gamers 项目地址: https://gitcode.com/gh_mirrors/so/socd 你是否曾在《街头霸王6》中因为同时按下左右方向键而错失连招机会࿱…
GitHub Actions自动化代码审查：智能PR评论机器人实战指南
1. 项目概述：一个能自动“说话”的代码机器人最近在GitHub上看到一个挺有意思的项目，叫rokpiy/auto-commenter。光看名字，你可能会觉得这又是一个给代码批量加注释的工具，或者是个简单的评论机器人。但当我深入去研究它的源码和设…
Arduino IDE安装Adafruit SAMD板卡支持包与SAMD编程实战指南
1. 项目概述如果你正准备踏入基于ARM Cortex-M0/M4内核的微控制器世界，比如Adafruit那些性能强劲的Feather M0、Metro M4或者小巧的QT Py，那么第一步很可能就是卡在如何让Arduino IDE认识这块新板子上。我最初接触SAMD21时，也以为插上USB就能…
SD-PPP：在Photoshop中开启智能设计革命的终极AI插件
SD-PPP：在Photoshop中开启智能设计革命的终极AI插件 【免费下载链接】sd-ppp A Photoshop AI plugin 项目地址: https://gitcode.com/gh_mirrors/sd/sd-ppp 你是否厌倦了在Photoshop和AI工具之间频繁切换，打断了创意的流畅性？SD-PPP正…
NomNom存档编辑器：解放你的《无人深空》游戏体验终极指南
NomNom存档编辑器：解放你的《无人深空》游戏体验终极指南 【免费下载链接】NomNom NomNom is the most complete savegame editor for NMS but also shows additional information around the data youre about to change. You can also easily look up each item i…
5个专业策略：构建企业级本地漏洞情报分析平台
5个专业策略：构建企业级本地漏洞情报分析平台 【免费下载链接】cve-search cve-search - a tool to perform local searches for known vulnerabilities 项目地址: https://gitcode.com/gh_mirrors/cv/cve-search 在当今复杂的网络安全环境中，快速…
贾子理论与AI时代文明竞争：从暴力计算到本质贯通的范式重构
贾子理论与AI时代文明竞争：从暴力计算到本质贯通的范式重构摘要本文基于贾子理论的文明竞争视角，揭示中美AI战略差异的本质并非技术参数较量，而是“暴力计算”与“本质贯通”两种文明范式的根本对立。美国依赖算力堆叠与资本逻辑追求技术霸权…
2026年AI大模型API中转平台排名揭晓，诗云API(ShiyunApi)脱颖而出成省心之选
在AI开发领域，如何接入模型厂商的官方API是一个绕不开的现实问题。对于海外开发者来说，注册、绑卡、调用，三步即可轻松搞定。然而，国内开发者却面临着跨境网络波动、外币支付门槛、发票合规需求以及多厂商Key碎片化管理等诸多“非…
基于飞书与OpenAI构建企业级AI助手：架构、部署与深度优化指南
1. 项目概述：当飞书遇上AI，一个企业级智能助手的诞生 最近在折腾一个挺有意思的项目，叫“ConnectAI-E/feishu-openai”。简单来说，它就是一个桥梁，把飞书这个强大的企业协作平台，和以ChatGPT为代表的OpenA…
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案 【免费下载链接】MPC-BE MPC-BE – универсальный проигрыватель аудио и видеофайлов для операционной системы Windows. 项目地址:…
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南 【免费下载链接】STL-Volume-Model-Calculator STL Volume Model Calculator Python 项目地址: https://gitcode.com/gh_mirrors/st/STL-Volume-Model-Calculator 你是否曾经为3D打印项目…
通过Taotoken CLI工具一键配置团队开发环境与模型密钥
通过Taotoken CLI工具一键配置团队开发环境与模型密钥 1. CLI工具安装与基本使用 Taotoken提供的CLI工具可通过npm全局安装或直接使用npx运行。对于需要频繁使用CLI的团队，推荐全局安装： npm install -g taotoken/taotoken对于临时使用或项目级配置&a…