使用 Podman 在 PLCnext 上安装 Node-RED 分步指南

如何用 Podman 在 PLCnext 安装 Node-RED

固件 2023.0 起 PLCnext 操作系统预装 Podman (https://podman.io/)。Podman 功能同 Docker。此实现保证终端用户更简单的 Node-RED 安装。

重要：因 PLCnext 随固件更新变化，这些过程未来可能失效。若发生将更新本文档。

创建 05-03-2024

最后修改 11-03-2024

要求

控制器： AXC F 1152 - AXC F 2152 - AXC F 3152

存储： AXC F 1152 / 2152 需 2GB 或更高 SD 内存

固件： 2023.0 LTS 或更高

1. 安装步骤：

1.1. 通过 SSH 客户端访问：

• 必须用 Putty 或喜欢的 SSH 客户端 用 PLC IP 访问。默认 IP 为 192.168.1.10。

• 用用户名 admin 和 PLCnext 密码登录。

1.2. 以 root 用户访问：

• 登录 PLCnext 后，用命令 su 以 root 用户访问

su 

• 若未创建 root 密码，用命令 sudo passwd root 创建

sudo passwd root 

注意： admin 和 root 用户不同。设置 root 不同密码不影响 "admin" 用户。

1.3. 安装 Node-RED：

• 以 root 用户登录后，用以下命令安装官方 Node-RED 镜像 2.2.2 版：

podman run -d -p 1880:1880 --name nodered --restart always docker.io/nodered/node-red:2.2.2 

1.4. 安装示例：

• 我为 PLCnext AXC F 1152 / 2152 创建含 PLCnext 库的 Node-RED 容器。这些容器也含发送告警、OPC UA 读写示例。安装任意示例用以下命令：

• 安装"告警发送"示例：

podman run -d -p 1880:1880 --name nodered --restart always docker.io/fellipem/noderedpxc:alarms 

• 安装"OPC UA 读写"示例：

podman run -d -p 1880:1880 --name nodered --restart always docker.io/fellipem/noderedpxc:opcua 

1.5. 访问 Node-RED：

• 完成后在浏览器输入 IP_PLC:1880 使用 Node-RED。例 PLC IP 为 192.168.1.10 输入 192.168.1.10:1880。

警告：与 Docker 不同，Podman 不在 PLCnext 作为服务运行。因此 Node-RED 不随 PLC 开机自启。要让 Node-RED 随 PLC 启动，按以下步骤：

2. Node-RED 自启动步骤：

2.1. 创建启动脚本：

• 在 PLC 用以下命令下载此项目：

git clone https://github.com/Fellipem1/PLCnext_Node-RED.git 

2.2. 移动文件：

• 用以下命令将 nodered.sh 移至 /etc/init.d/ 路径：

mv /opt/plcnext/PLCnext_Node-RED/nodered.sh /etc/init.d/ 

2.3. 修改文件权限：

• 运行以下命令修改 nodered.sh 权限：

chmod +x /etc/init.d/nodered.sh 

2.4. 添加脚本到启动项：

• 添加脚本到启动项方法因 Linux 发行版不同。PLCnext 应用以下命令：

update-rc.d nodered.sh defaults 

• 按上述步骤，Node-RED 将每次关闭或重启 PLCnext 自动启动。

注意：始终用 root 用户执行这些步骤。

3. Node-RED 安装库步骤：

3.1. 启动 Node-RED 并进入容器：

• 以 root 用户访问并输入：

podman start nodered 

podman exec -it nodered /bin/bash 

cd /data 

3.2. 安装库：

• 现在可用 npm 安装任意库，例：

npm i node-red-contrib-iiot-opcua@3.11.1-4 

3.3. 退出容器并重启 Node-RED：

• 完成后输入 Exit 并用以下命令重启：

podman stop nodered 

podman start nodered 

4. 常见错误

4.1. 错误 1: mkdir no such file or directory

• 因 admin 用户权限不足无法安装 Node-RED。解决：必须以 root 用户登录。

4.2. 错误 2: Certificate Expired

• 因 PLCnext 时间日期配置错误。可用 date 命令检查。
• 修改 PLCnext 时间用命令：

date -s “29 FEB 2024 11:25:39” 

• 请用当前 UTC 时间修改命令：https://time.is/es/UTC

4.3. 错误 3: Failed, retrying timeout

• 因 PLCnext 无互联网访问。可用 ping 检查，例：

ping google.cl 

• 若显示 bad address，须从 Web 服务器网络部分验证 PLCnext IP、掩码、网关配置。

更多信息： https://github.com/Fellipem1/PLCnext_Node-RED