跳到主要内容

安装 — 从选型到验证

PlantPulse Edge 的安装从选择部署模式开始。 2026.05 之后新装机器的标准方案是单一 Docker 容器 + install.sh。 原有的 native 安装文档予以保留，但不再推荐用于新设备。

请勿混用 native 与容器模式

容器模式使用 plantpulse-edge.service，legacy native 模式使用 plantpulse.service。若在同一台设备上同时启动两个服务， 80/443/1880/9042 等端口以及数据路径将发生冲突。

1. 该选择哪种安装方式​

场景选择理由
现场单台网关，可连接互联网快速安装 (install.sh)一次性完成 OS 软件包、Docker、sysctl、firewall、chrony、SSL、systemd 及镜像 pull
量产线上重复安装 100 台以上量产线 (factory.sh)以 prompt 驱动方式处理 EDGE_ID/hostname/凭据/标记/清单
断网、安全站点、USB 带入离线 / 隔离网络安装在外部预先准备 install bundle 与 container image tar.zst
VMware / Hyper-V / KVM / 云端 VMVM / 云端安装基础同为 install.sh，仅针对 VM 网络与资源差异做调整
需先完成 PLC 网 / WAN 网 / VLAN 设计网络配置指南预先梳理 NIC 角色、static IP、routing、firewall
安装完成后需要向运维团队移交的判定标准生产移交标准涵盖 health、备份、重启、安全及证据文件的 Go/No-Go 判定
维护 2026.05 以下版本的 native 设备(legacy) 硬件完整安装保留基于旧版 tools/setup.sh 的 native 安装流程
即使是新硬件，也请先查看快速安装

旧文档中的 tools/setup.sh 是 native 时代的完整安装工具。 2026.05+ 的新设备在 Linux 启动后，请以快速安装为准执行； 如需 NIC static 配置，可通过 LAN1_* / LAN2_* env 传递给 install.sh。

2. 标准安装完成的工作​

快速安装中的 install.sh 以幂等方式整理以下项目。

领域处理内容
OS 准备必需软件包、Docker、chrony、firewall、sysctl/limits
网络可选的 nmcli static IP 配置，WAN/PLC NIC env override
安全每台设备随机生成的 admin/MQTT/OPC-UA/API key，基于 CERT_PASS 的 TLS material
运行时/etc/kopens/app.properties、/data1/pp-data、container image pull/load
systemdplantpulse-edge.service、OTA path/service、host action path/service
验证/api/v1/system/version、/api/v1/system/health、基于工具的状态检查

安装后的初始凭据会一次性保存到 /etc/kopens/credentials.txt。 该文件请以 root 专属权限保管，并在出货/移交时安全交付。

3. 安装前确认​

项目标准
OSLinux。推荐 RHEL/Fedora/Rocky/CentOS 系列，VM 亦可
权限root 或 sudo -i
网络可访问 product.kopens.io / product.kopens.io
磁盘/opt/kopens 3GB+，/data1 数据用建议 100GB+
内存最低 8GB，建议 16GB 以上
运行模式新建运行/量产使用容器模式。legacy native 仅用于既有设备维护

若为隔离网络，则无需确认互联网，改为参照离线 / 隔离网络安装准备 bundle 与 image tar.zst。

4. 标准安装摘要​

sudo -i
curl -fsSL https://product.kopens.io/plantpulse-edge/install.sh | bash

如果偏好单行执行：

sudo -i
bash < <(curl -fsSL https://product.kopens.io/plantpulse-edge/install.sh)

详细选项、env override 及预期输出请参见快速安装。

5. 安装后的正常判定标准​

# 한 줄 상태 점검
sudo bash /opt/kopens/install/bin/status.sh

# 버전 / 컨테이너 모드 확인
curl -ks https://127.0.0.1/api/v1/system/version | python3 -m json.tool

# 전체 컴포넌트 health
curl -ks https://127.0.0.1/api/v1/system/health | python3 -m json.tool

正常判定标准：

  • plantpulse-edge.service 为 active
  • /api/v1/system/version 的 container_mode=true
  • /api/v1/system/health HTTP 200，主要 components UP
  • 通过生产移交标准中的 Go / No-Go 项目
  • Web UI：https://<gateway-ip>/ui/main
  • Node-RED：https://<gateway-ip>/ui/flow/

如有问题，请先查看安装故障排查或 容器模式运维指南。

6. 后续文档​