Ubuntu 22.04下EMQX Broker启动失败求助

第一步：配置安全的Erlang Cookie #

先处理警告提示的默认Erlang Cookie问题：

• 打开EMQX配置文件：sudo nano /etc/emqx/emqx.conf
• 找到node.cookie项，取消注释并设置自定义随机字符串（如emqx_secure_cookie_987），集群节点需使用相同Cookie
• 保存后设置文件只读权限：sudo chmod 400 /etc/emqx/emqx.conf

第二步：查看日志定位核心失败原因 #

failed 120 probes是健康检查未通过，需查看日志获取具体错误：

• 查看主日志：sudo tail -n 50 /var/log/emqx/emqx.log
• 查看控制台日志：sudo tail -n 50 /var/log/emqx/console.log
  常见诱因包括端口被占用、系统资源不足、依赖缺失等。

第三步：针对性修复常见问题 #

端口占用排查 #

检查EMQX默认端口是否被占用：

sudo lsof -i :1883
sudo lsof -i :8083
sudo lsof -i :8883
sudo lsof -i :8084

若端口被占，可停止占用进程，或修改/etc/emqx/emqx.conf中的端口配置（如listeners.tcp.default.bind = 1884）。

系统资源检查 #

• 检查内存：free -h，EMQX 5.x建议至少2GB可用内存
• 检查文件描述符：ulimit -n，建议设置为65535以上，可修改/etc/security/limits.conf添加：

  emqx soft nofile 65535
  emqx hard nofile 65535
  

  重启系统或重新登录生效。

清理旧版本残留（针对曾安装V2.0的情况） #

彻底卸载残留文件后重装V5：

sudo apt purge emqx -y
sudo rm -rf /etc/emqx /var/lib/emqx /var/log/emqx
sudo apt autoremove -y
curl -s https://assets.emqx.com/scripts/install-emqx-deb.sh | sudo bash
sudo apt-get install emqx -y

第四步：重启验证 #

• 启动服务：sudo emqx start
• 检查状态：sudo emqx status
• 验证Dashboard：访问http://<服务器IP>:18083，默认账号admin、密码public

内容的提问来源于stack exchange，提问作者ochieno Eliud