使用安装包安装

本文介绍用 deb、rpm、tar.gz 三种安装包部署 EMQX Neuron。如不确定选用哪种格式，可使用一键安装脚本即可，它会自动判断并选择。

选择包格式

格式	适用系统	说明
.deb	Debian、Ubuntu、麒麟等 Debian 系	首选。装完自动注册 systemd 服务
.rpm	RedHat、CentOS、欧拉等 RPM 系	同上
.tar.gz	任意 Linux 发行版	不依赖包管理器。可解压即用，也可手动注册为 systemd 服务

下载

从 EMQ 官网下载页选择版本和架构，或直接用 wget：

# 以 3.9.2、amd64 为例，把扩展名换成 .rpm 或 .tar.gz 即可下载其他格式
wget https://www.emqx.com/zh/downloads/neuronex/3.9.2/neuronex-3.9.2-linux-amd64.deb

文件名格式为 neuronex-<版本号>-linux-<架构>.<格式>，架构可选 amd64、arm、arm64。

安装

格式	命令
.deb	sudo dpkg -i neuronex-3.9.2-linux-amd64.deb
.rpm	sudo rpm -ivh neuronex-3.9.2-linux-amd64.rpm
.tar.gz	tar -zxvf neuronex-3.9.2-linux-amd64.tar.gz && cd neuronex-3.9.2-linux-amd64

TIP

三种格式都要求 GLIBC 2.31 及以上。在较老的发行版上安装前先确认：ldd --version。

启动与管理

deb 和 rpm

安装包会自动注册 systemd 服务：

sudo systemctl start neuronex     # 启动
sudo systemctl status neuronex    # 查看状态
sudo systemctl stop neuronex      # 停止

tar.gz

解压后有两种用法。直接从解压目录运行：

./bin/neuronex start
./bin/neuronex stop

或者先注册成 systemd 服务，之后就和 deb/rpm 一样用 systemctl 管理：

./bin/neuronex install
sudo systemctl start neuronex

更多启动参数见启动参数与配置文件。

升级

三种格式的升级流程一致：停服务、装新包、再启动。配置和数据保存在 /opt/neuronex/data/，不会被覆盖。

sudo systemctl stop neuronex

# deb
sudo dpkg -i neuronex-<新版本>-linux-amd64.deb
# rpm
sudo rpm -Uvh neuronex-<新版本>-linux-amd64.rpm
# tar.gz：解压新包到原目录即可

sudo systemctl start neuronex

TIP

升级前建议备份 /opt/neuronex/data/ 目录。万一需要回滚，把备份复制回新版本的相同目录即可恢复配置。

卸载

格式	命令	说明
.deb	sudo dpkg -r neuronex	保留配置、日志和数据文件
	sudo dpkg -P neuronex	一并清除所有文件
.rpm	sudo rpm -e neuronex	也可用 sudo dnf remove neuronex 或 sudo yum remove neuronex
.tar.gz	rm -rf <解压目录>	解压即用的情况，先 ./bin/neuronex stop
	./bin/neuronex uninstall	注册过 systemd 服务的，先取消注册再删目录

卸载前先停止服务：

sudo systemctl stop neuronex || true

用一键脚本装的 tar.gz 还会在 /usr/local/bin 下留一个软链接，一并删除：

sudo rm -rf /opt/neuronex
sudo rm -f /usr/local/bin/neuronex