安装概述
Edge 以 单个 Docker 容器 的形式部署，install.sh 可一次性处理从 OS 准备到 systemd 注册等全部流程。本节将介绍该流程及其周边事项。
如需按顺序阅读
大多数现场，按以下三项即可完成。
- 安装（
install.sh) — 部署一台网关 - 安装后检查 — 健康检查 · 密码修改 · 备份
- 生产验收标准 — 转交运维团队前的 Go/No-Go
如果情况不同
| 情况 | 参阅 |
|---|---|
| 量产线上需重复安装 100 台以上 | 量产线（factory.sh) — 涵盖 ID · 凭据 · 标签 · 清单 |
| 互联网隔离 · USB 导入 | 隔离网络安装 |
| VMware · Hyper-V · KVM · 云端 VM | 虚拟机 · 云端安装 — 仅网络与资源差异 |
| 需先设计 PLC 网络 / WAN 网络 | 网络配置 — NIC 角色 · 静态 IP · 防火墙 |
| 必须修改密码 | 初始密码修改 — 调试必需 |
| 安装受阻 | 安装故障排查 — 按症状分类 |
| 需了解 systemd 单元 · 挂载 · OTA | Docker 安装 — 参考文档 |
安装所完成的工作
一键安装 的 install.sh 会以幂等方式整理以下项目。
| 领域 | 处理内容 |
|---|---|
| OS 准备 | 必要软件包、Docker、chrony、firewall、sysctl/limits |
| 网络 | 可选 nmcli 静态 IP 设置、WAN/PLC NIC env 覆盖 |
| 安全 | 每台设备独立的随机 admin/MQTT/OPC-UA/API 密钥，基于 CERT_PASS 的 TLS 材料 |
| 运行时 | /etc/kopens/app.properties、/data1/pp-data、容器镜像拉取/加载 |
| systemd | plantpulse-edge.service、OTA 路径/服务、主机操作路径/服务 |
| 验证 | /api/v1/system/version、/api/v1/system/health、基于工具的状态检查 |
安装后，初始凭据将一次性存储在 /etc/kopens/credentials.txt 中。
此文件仅供 root 使用，请妥善保管，并在发货/验收时安全传递。
安装前确认
| 项目 | 标准 |
|---|---|
| OS | Linux。推荐 RHEL/Fedora/Rocky/CentOS 系列，也支持 VM |
| 权限 | root 或 sudo -i |
| 网络 | 可访问 product.kopens.io · docker.kopens.io |
| 磁盘 | /opt/kopens 3GB 以上，/data1 数据推荐 100GB 以上 |
| 内存 | 最小 8GB，推荐 16GB 以上 |
如果是隔离网络，请勿进行互联网检查，改为在 隔离网络安装 中准备 bundle 和 image tar.zst。
安装完成的标准
# 한 줄 상태 점검
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/healthHTTP 200，主要组件UP- 通过 生产验收标准 的 Go/No-Go 项
- Web UI：
https://<gateway-ip>/ui/main - Node-RED：
https://<gateway-ip>/ui/flow/
安装完成后，请继续执行 安装后检查 — 其中包含 初始密码修改。