应用管理 (/ui/apps)
除 PLC 数据采集外，网关还可同时运行多个附属工具（仪表板、数据流、监控等）。在本页面可一览这些工具的状态，并完成启动/停止/重启/部署新应用等操作。
本页面显示宿主 docker 的容器（使用 /var/run/docker.sock 挂载）。
plantpulse-edge 自身为 self-exclude — 不会出现在列表中，且 start/stop/delete/
inspect/logs/stats/deploy 所有操作均以 IllegalStateException 拒绝（以防止关闭或删除自身）。
plantpulse-edge 的重启请通过 SSH 执行 systemctl restart plantpulse-edge.service
或使用状态栏的“重启”按钮（经由 signal file）。
1. 打开页面
点击主页面的 [应用程序] 卡片，或在地址栏直接输入 /ui/apps。
┌────────────────────────────────────────────────────────────┐
│ ⊙ 애플리케이션 — 엣지에 배포된 컨테이너 · 시작/중지/재시작 │
│ [↻ 새로고침] [+ 새 앱 배포] │
├────────────────────────────────────────────────────────────┤
│ ℹ 이 화면에서는 엣지에 설치된 애플리케이션의 현재 상태를 │
│ 한눈에 확인하고, 필요할 때 시작·중지·재시작 할 수 있습니다.│
├────────────────────────────────────────────────────────────┤
│ [앱 카드] [앱 카드] [앱 카드] │
│ [앱 카드] [앱 카드] ... │
└────────────────────────────────────────────────────────────┘
旧版本的 ← 返回 按钮已移除 — 请通过左侧边栏／点击 logo 切换到其他页面。
2. 顶部操作
| 按钮 | 动作 |
|---|---|
↻ 刷新 (fa-sync) | apps.refresh() — 立即重绘卡片 |
+ 部署新应用 (fa-plus) | apps.openDeploy() — 新容器定义 + 注册模态框（自定义镜像／端口映射／环境变量） |
页面右上角的小号灰色标签 (#apps_status_label) 会不时显示最后刷新时间，表明自动轮询处于活动状态。
3. 卡片结构
每个应用以圆角卡片（20px 圆角 + 灰色边框）呈现，悬停时会轻微浮起。
| 卡片项 | 含义 |
|---|---|
| 左侧大图标（方形，浅蓝背景） | 应用种类 — 基于容器镜像 |
| 应用名称 | docker 容器名称（例如：pp-grafana、pp-node-red） |
| 状态徽章（圆角胶囊） | running（绿色）／exited dead restarting（红色）／paused（橙色）／created（灰色） |
| 镜像 | 等宽字体 + 灰色框。当前使用的 docker 镜像（例如：grafana/grafana:10.3） |
| 端口 | 点击 → 在新窗口自动打开应用界面（例如：3000 → http://게이트웨이:3000/） |
| 创建 | 容器创建时间 |
| 资源 | CPU／内存（仅运行中的应用，docker stats 结果） |
| 操作区（卡片底部） | [启动] [停止] [重启] [日志] 按钮 — 依状态启用／禁用 |
页面每 10 秒自动刷新 — 调用后端 /apps/list 后重绘。
常见的附属应用
| 工具 | 作用 |
|---|---|
| Grafana | 时序图表／运行仪表板 |
| Node-RED | 无代码数据流／自动化 |
| HiveMQ (MQTT 代理) | 消息中转（Sparkplug B 发布端） |
| Cassandra | 时序存储 |
| Portainer | docker 容器可视化管理工具 |
| Uptime Kuma | 简易可用性监控（存活与否） |
| File Browser | Web 文件管理器 |
已安装的应用因环境而异。显示哪些应用取决于系统管理员从 IIoT 平台远程部署的结果。
常见操作
打开附属应用界面
点击卡片上的端口号，即可在新窗口打开该应用的界面。
- 通常以
http://게이트웨이IP:포트/形式自动连接 - 部分应用可能需要自行登录（例如：Grafana、Portainer）
启动／停止／重启附属应用
| 动作 | 方法 | 备注 |
|---|---|---|
| 启动 | 卡片的 [启动] 按钮 | 仅停止状态时可用 |
| 停止 | 卡片的 [停止] 按钮 | 仅运行／暂停状态时可用 |
| 重启 | [重启] 按钮 | 始终可用 |
会弹出一次确认窗口，即使误点也可 [取消]。
查看附属应用日志
点击卡片的 [日志] 按钮 → 在黑色界面显示最后 200 行。应用无法启动时可用于排查原因／提交给系统管理员。
刷新
点击左上角的 [刷新] 按钮可立即刷新（与 10 秒自动刷新相互独立）。
网关自身管理（状态栏快捷操作）
通过页面左下方状态栏的 7 个图标控制网关 OS／应用程序本身 — 所有页面通用。
详细动作／耗时／注意事项汇总在单独文档 状态栏快捷操作 中。
| 图标 | 动作 | 备注 |
|---|---|---|
🎬 (fa-projector) 系统重启 | OS 重启 | 约 3~5 分钟 — 全部 PLC 采集中断 |
🔁 (fa-repeat-1-alt) 应用程序重启 | 仅重启 Tomcat／网关软件 | 1 分钟以内 |
🗑 (fa-trash) 临时文件清理 | 清理临时／缓存 | 磁盘不足时 |
⏱ (fa-stopwatch) 备份 | 配置 + DB 备份 | 备份／恢复 |
📄 (fa-file-alt) 日志下载 | 诊断日志 zip | 报告问题时附上 |
🔌 (fa-microchip) O/S 及固件升级 | 固件更新 | 请谨慎操作 |
☁ (fa-cloud-download) S/W 升级 | 网关软件更新 (product.kopens.io) | 仅当右上角徽章显示*可升级！*时可用 |
在重启／升级期间，PLC 数值采集会暂时中断。建议在非运行时间进行。
网关自身安装
面向系统管理员 — 在新环境中首次安装时使用。
基础安装通常由系统管理员事先完成，但若需在新环境首次安装，可用以下单行命令一次性安装。
bash < <(curl -s http://product.kopens.io/plantpulse-edge/install.sh)
内部会安装 JDK／Tomcat／Cassandra／网关全部组件。
如需详细的构建／部署／环境配置步骤，请参阅 高级 — 配置文件指南 和 高级 — 开发者笔记。
常见问题
Q. 应用程序处于“已停止”状态，但无法启动
可能是 PC 资源不足（内存不足等）或端口冲突。
- 在主页面确认内存／磁盘仪表
- 尝试 [设置] → [临时文件清理]
- 仍无法解决时，用 [日志] 按钮查看错误信息并转交系统管理员
Q. 重启网关后，PLC 连接／标签会丢失吗？
不会。配置已安全保存，重启后会自动恢复，设置为“自动启动”的 PLC 会自动重新开始采集。
Q. 附属应用可以与网关分离，部署在其他 PC 上吗？
可以，但推荐配置是部署在同一台 PC。请与系统管理员商议。