文章目录
前言:
本文将基于 Ubuntu 24 操作系统(已预装 JDK 17),详细讲解 EMQX 5.3.2 版本的完整安装、配置与测试流程,帮助开发者快速搭建稳定的 MQTT 服务端。
安装方式绿色解压安装;
绿色版的核心特点是 “解压即能用、无需系统级安装、可自由迁移”,更适合开发测试环境或需要灵活部署的场景。本文将详细讲解 EMQX 5.3.2 绿色版在 Ubuntu 24 系统下的完整安装与配置流程,保持与之前文档一致的 “架构师视角”,确保步骤可落地、配置可优化。
一、 环境介绍:明确基础配置,规避兼容性风险
在开始安装前,先梳理当前环境的核心配置,确保各组件版本兼容,这是保障服务稳定运行的基础(我始终强调 “环境先行” 的原则,避免因版本不匹配导致后期排查问题的繁琐)。
| 组件 / 环境 | 版本 / 配置 | 说明 |
|---|---|---|
| 操作系统 | Ubuntu 24.04 LTS | 长期支持版本,稳定性强,适合生产环境部署,内核版本默认≥5.15 |
| JDK | OpenJDK 17 / Oracle JDK 17 | EMQX 5.x 版本对 JDK 11 + 兼容,本文基于已预装的 JDK 17,无需额外安装 |
| MQTT 服务端 | EMQX 5.3.2 | 开源 MQTT 3.1.1/5.0 broker,支持百万级并发连接,提供完善的监控与管理功能 |
| MQTT 协议版本 | 支持 MQTT 3.1.1 / MQTT 5.0 | 覆盖主流客户端需求,5.0 版本新增会话过期、消息延迟等高级特性 |
| 服务器架构 | x86_64 (AMD64) | 本文以主流 64 位架构为例,ARM 架构可参考 EMQX 官方文档调整下载包 |
兼容性验证:执行以下命令确认操作系统架构和 JDK 环境,确保与 EMQX 要求匹配:
执行以下命令,确认操作系统架构和 JDK 环境(EMQX 5.x 依赖 JDK 11+,本文基于已预装的 JDK 17):
# 查看操作系统架构(需输出 x86_64)
uname -m
# 查看JDK版本(需输出 17.x.x)
java -version
二、下载
安装依赖库:
不安装依赖,是停止stop命令会报错!
Ubuntu/Debian 系统:
sudo apt-get update
sudo apt-get install libtinfo5
CentOS/RHEL 系统:
sudo yum install ncurses-libs
# 或者如果上面的命令不行,尝试:
sudo yum install libtinfo5
安装完后,要把库的路径指向系统:
1、先查看安装的库的位置
sudo find / -name "libtinfo.so.5" 2>/dev/null
显示:
/usr/allsoft/emqx-5.3.2/dynlibs/libtinfo.so.5
指向/usr/lib/libtinfo.so.5:
sudo ln -s /usr/allsoft/emqx-5.3.2/dynlibs/libtinfo.so.5 /usr/lib/libtinfo.so.5
sudo ln -s /usr/allsoft/emqx-5.3.2/dynlibs/libtinfo.so.5 /usr/lib/libtinfo.so.5
1、下载地址:
EMQX 5.3.2 官方下载页 https://www.emqx.com/zh/downloads/broker/5.3.2
2、下载方式:
下载 tar.gz 压缩包(两种方式)
方式 1:服务器命令行直接下载(推荐,无图形界面适用)
切换到自定义目录(如 /opt,后续解压也在此目录,便于管理),通过 wget 下载:
# 1. 切换到目标目录
cd /usr/allsoft/
# 2. 下载 EMQX 5.3.2 绿色版(x86_64 架构,Ubuntu 通用)
wget https://www.emqx.com/zh/downloads/broker/5.3.2/emqx-5.3.2-el7-amd64.tar.gz
方式 2:本地下载后上传服务器
本地访问 EMQX 5.3.2 下载页,选择 “Linux” → “x86_64”,下载 emqx-5.3.2-el7-amd64.tar.gz。
通过 scp 上传到服务器(以 /usr/allsoft 目录为例):
scp /本地路径/emqx-5.3.2-el7-amd64.tar.gz 用户名@服务器IP:/opt/
3、校验压缩包完整性(避免解压失败)
与 deb 包一致,通过 SHA256 校验值确认文件未损坏:
在 EMQX 下载页找到对应压缩包的 “SHA256” 值(如 f471d8a…)。
在服务器执行以下命令,对比输出值与官网一致则完整:
------

最低0.47元/天 解锁文章
830

被折叠的 条评论
为什么被折叠?



