logo

开发者热搜

EMQX在Linux下的完整部署指南：从安装到运维

作者：问答酱2025.09.19 11:11浏览量：94

简介：本文详细介绍EMQX在Linux系统下的部署流程，涵盖环境准备、安装方式、配置优化及运维管理，帮助开发者快速构建高可靠的MQTT消息服务平台。

一、部署前环境准备

1.1 系统要求验证

EMQX 5.x版本对Linux系统有明确要求：

  • 内核版本：建议4.15+（可通过uname -r查看）
  • 内存：基础版至少4GB，生产环境建议16GB+
  • 磁盘空间：/var分区至少保留10GB可用空间
  • 依赖检查：
    1. # 安装必要工具
    2. sudo apt update && sudo apt install -y curl wget tar gzip
    3. # 验证Java环境（如使用插件）
    4. java -version 2>/dev/null || echo "Java未安装"

1.2 网络配置要点

  • 端口开放：默认监听1883(MQTT)、8083(WebSocket)、8883(SSL)、18083(Dashboard)
  • 防火墙规则（以UFW为例）：
    1. sudo ufw allow 1883/tcp
    2. sudo ufw allow 8083/tcp
    3. sudo ufw allow 8883/tcp
    4. sudo ufw allow 18083/tcp
  • SELinux策略（CentOS/RHEL需注意）：
    1. sudo setsebool -P httpd_can_network_connect 1

二、三种主流安装方式

2.1 DEB/RPM包安装（推荐生产环境）

Ubuntu/Debian系统：

  1. # 添加EMQX官方仓库
  2. curl -s https://assets.emqx.com/scripts/install-emqx-deb.sh | sudo bash
  3. # 安装指定版本
  4. sudo apt install emqx=5.4.0-1.amd64

CentOS/RHEL系统：

  1. # 添加RPM仓库
  2. sudo rpm --import https://repos.emqx.io/gpg.key
  3. sudo yum install -y https://repos.emqx.io/emqx-5.4.0-1.el7.x86_64.rpm

2.2 二进制包直接部署（适合测试环境）

  1. # 下载最新版本
  2. wget https://www.emqx.io/downloads/broker/v5.4.0/emqx-5.4.0-ubuntu22.04-amd64.tar.gz
  3. # 解压安装
  4. tar -zxvf emqx-*.tar.gz
  5. cd emqx
  6. # 启动服务（前台模式）
  7. ./bin/emqx console
  8. # 后台启动
  9. ./bin/emqx start

2.3 Docker容器化部署（快速验证方案）

  1. # 拉取官方镜像
  2. docker pull emqx/emqx:5.4.0
  3. # 运行容器
  4. docker run -d --name emqx \
  5.   -p 1883:1883 -p 8083:8083 -p 8883:8883 -p 18083:18083 \
  6.   -e EMQX_LOADED_PLUGINS="emqx_management,emqx_dashboard" \
  7.   emqx/emqx:5.4.0

三、核心配置优化

3.1 主配置文件详解

路径：/etc/emqx/emqx.conf（包安装）或./etc/emqx.conf（二进制）

关键参数配置示例：

  1. # 集群节点发现（使用静态节点列表）
  2. cluster.discovery = static
  3. cluster.static.seeds = emqx@node1.example.com,emqx@node2.example.com
  5. # 连接数限制
  6. listener.tcp.external.max_connections = 1000000
  8. # 内存阈值设置（单位：MB）
  9. sysmon.os_mon.mem_check_interval = 60s
  10. sysmon.os_mon.sysmem_high_watermark = 0.8

3.2 认证插件配置

以内置MySQL认证为例：

  1. # 创建认证表
  2. CREATE TABLE mqtt_user (
  3.   id INT AUTO_INCREMENT PRIMARY KEY,
  4.   username VARCHAR(255) NOT NULL UNIQUE,
  5.   password VARCHAR(255) NOT NULL,
  6.   salt VARCHAR(40)
  7. );
  9. # 配置emqx.conf
  10. authentication = [
  11.   {
  12.     emqx_auth_mysql,
  13.     server = "127.0.0.1:3306",
  14.     database = "mqtt",
  15.     username = "emqx_user",
  16.     password = "securepassword",
  17.     query = "SELECT password FROM mqtt_user WHERE username = '%u' LIMIT 1"
  18.   }
  19. ]

四、运维管理最佳实践

4.1 服务状态监控

  1. # 查看运行状态
  2. systemctl status emqx
  3. # 检查监听端口
  4. netstat -tulnp | grep emqx
  5. # 日志分析
  6. tail -f /var/log/emqx/emqx.log.*.log

4.2 集群管理命令

  1. # 加入集群
  2. emqx_ctl cluster join emqx@node1.example.com
  3. # 查看集群状态
  4. emqx_ctl cluster status
  5. # 离开集群
  6. emqx_ctl cluster leave

4.3 性能调优建议

  • 连接数优化：
    1. # 调整连接进程数（根据CPU核心数）
    2. listener.tcp.external.num_acceptors = 32
    3. # 启用连接回收
    4. listener.tcp.external.force_shutdown = on
  • 消息缓存：
    1. # 队列长度设置
    2. mqtt.queue.max_length = 1000
    3. # 持久化配置
    4. broker.shared_subscription = true

五、故障排查指南

5.1 常见问题处理

问题1：端口冲突

  1. # 检查端口占用
  2. ss -tulnp | grep 1883
  3. # 修改监听端口
  4. sed -i 's/listener.tcp.external = 0.0.0.0:1883/listener.tcp.external = 0.0.0.0:11883/' /etc/emqx/emqx.conf

问题2：认证失败

  1. # 检查认证日志
  2. grep "Authentication failed" /var/log/emqx/emqx.log.*.log
  3. # 测试认证查询
  4. mysql -uemqx_user -p -e "SELECT password FROM mqtt_user WHERE username='testuser'"

5.2 性能瓶颈诊断

  1. # 使用emqx内置诊断工具
  2. emqx_ctl broker metrics
  3. emqx_ctl broker stats
  4. # 生成诊断报告
  5. emqx_ctl admin report --path /tmp/emqx_report

六、升级与回滚方案

6.1 平滑升级流程

  1. # 备份配置
  2. cp -r /etc/emqx /etc/emqx.bak
  3. # 停止服务
  4. systemctl stop emqx
  5. # 安装新版本
  6. apt install emqx=5.5.0-1.amd64
  7. # 验证配置兼容性
  8. emqx check-config
  9. # 启动服务
  10. systemctl start emqx

6.2 回滚操作指南

  1. # 卸载新版本
  2. apt remove emqx
  3. # 恢复旧版本包
  4. dpkg -i emqx_5.4.0-1.amd64.deb
  5. # 恢复配置
  6. cp -r /etc/emqx.bak/* /etc/emqx/
  7. # 重启服务
  8. systemctl restart emqx

七、安全加固建议

7.1 传输层安全

  1. # 生成SSL证书
  2. openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -nodes
  3. # 配置SSL监听
  4. listener.ssl.external = 0.0.0.0:8883
  5. listener.ssl.external.keyfile = /etc/emqx/certs/key.pem
  6. listener.ssl.external.certfile = /etc/emqx/certs/cert.pem

7.2 访问控制

  1. # 限制IP访问
  2. allow_anonymous = false
  3. zone.external.access_rules = [
  4.   {"allow", "192.168.1.0/24"},
  5.   {"deny", "all"}
  6. ]

通过以上系统化的部署方案，开发者可以在Linux环境下快速构建稳定高效的EMQX消息服务平台。建议生产环境采用包安装方式，配合集群部署和完善的监控体系，可实现日均十亿级消息吞吐的可靠传输。实际部署时需根据具体业务场景调整内存分配、连接数限制等关键参数。

相关文章推荐

发表评论

最热文章

关于作者

  • 被阅读数
  • 被赞数
  • 被收藏数
活动
咨询