安装

为满足客户需求，Neuron 分成两个安装包，

• NeuronEX：集成 eKuiper，携带数据流处理引擎功能，用户可以在采集数据的同时对数据进行处理；
• Neuron：不集成 eKuiper，主要实现工业数据的采集；

用户可以根据自身需求选择。

下载

Neuron 软件包可从 Neuron 官网 https://neugates.io/zh/downloads (opens new window) 上下载。官网下载的安装包适配的系统较新，更多系统版本包及适配老系统的版本包请到 Github 仓库 (opens new window) 下载。

版本号 x.y.z 说明：

• x 为主要版本号：一般情况下，该版本会引入一些重大功能，如引入架构性的更改，主版本升级不保证与老版本之间的兼容性；
• y 是次要版本号：一般情况下，该类型版本会引入一些新功能，但是会保证在该主要版本号下的兼容性；
• z 是维护版本号：一般情况下，该版本只包含软件中错误修复的补丁等。

安装条件

提示

rpm/deb package 中使用了 systemd 管理 neuron 进程，建议优先使用 rpm/deb package。

使用 deb 包安装

安装

根据不同版本及架构安装，例如：

$ sudo dpkg -i neuron-2.3.0-linux-armhf.deb

为避免 ubuntu 系统自动更新时替换 neuron 包，还需要执行以下命令使 neuron 软件包在 apt 升级中保留。

$ sudo apt-mark hold neuron

提示

成功安装 deb 包后，自动启动 Neuron

卸载

$ sudo dpkg -r neuron

使用 rpm 安装包

安装

根据不同版本及架构安装，例如：

$ sudo rpm -i neuron-2.3.0-linux-armhf.rpm

提示

成功安装 rpm 包后，自启动 Neuron。

卸载

$ sudo rpm -e neuron

使用 .tar.gz 安装包

下载安装包

根据不同的版本及架构下载，例如：

$ wget https://www.emqx.com/en/downloads/neuron/2.3.0/neuron-2.3.0-linux-armhf.tar.gz

解压

$ sudo tar -zxvf neuron-2.3.0-linux-armhf.tar.gz
$ cd neuron-2.3.0-linux-armhf

启动

执行如下命令启动 Neuron：

$ ./neuron

使用 Docker 运行

获取镜像

neuron docker 镜像请从 docker hub (opens new window) 网站下载。

## pull Neuron
$ docker pull emqx/neuron:latest

支持更小占用的 alpine 镜像，请从 docker hub (opens new window) 网站下载。

## pull Neuron
$ docker pull emqx/neuron:2.3.0-alpine

NeuronEX docker 镜像请从 docker hub (opens new window) 网站下载。

## pull NeuronEX
$ docker pull emqx/neuronex:latest

启动

启动 Neuron:

## run Neuron
$ docker run -d --name neuron -p 7000:7000 --privileged=true --restart=always emqx/neuron:latest

启动 NeuronEX:

## run NeuronEX
$ docker run -d --name neuronex -p 7000:7000 --privileged=true --restart=always emqx/neuronex:latest

• tcp 7000: 用于访问 web 和 http api 端口。
• --restart=always: docker 进程重启时，自动重启 neuron 容器。
• --privileged=true: 可选参数，便于排查问题。
• --env DISABLE_AUTH=true: 可选参数，用于关闭鉴权。
• -v /host/dir:/opt/neuron/persistence: 用于将 docker 中 Neuron 配置信息存放在本地目录（例如，/host/dir）。
• --device /dev/ttyUSB0:/dev/ttyS0: 用于映射串口到 docker。

Neuron 操作

用 rpm 和 deb 方式安装的都可以通过以下指令查看/起停 Neuron：

查看 Neuron 状态

$ sudo systemctl status neuron

停止 Neuron

$ sudo systemctl stop neuron

重启 Neuron

$ sudo systemctl restart neuron