应用程序管理
网关除了采集PLC数据之外，还可以同时运行多个辅助工具（仪表板、数据流、监控等）。在此页面，您可以一眼查看这些工具的状态，并进行启动/停止/重启/部署新应用等操作。
此页面显示主机 Docker 的容器（使用 /var/run/docker.sock 挂载）。
plantpulse-edge 自身会 self-exclude — 不会出现在列表中，并且所有操作（启动/停止/删除/
检查/日志/统计/部署）都会被 IllegalStateException 拒绝（以防止关闭或
删除自身）。
如需重启 plantpulse-edge，请通过 SSH 执行 systemctl restart plantpulse-edge.service
或使用状态栏中的“重启”按钮（通过信号文件）。
1. 打开页面
点击主页面上的 [应用程序] 卡片，或直接在地址栏输入 /ui/apps。
┌────────────────────────────────────────────────────────────┐
│ ⊙ 애플리케이션 — 엣지에 배포된 컨테이너 · 시작/중지/재시작 │
│ [↻ 새로고침] [+ 새 앱 배포] │
├────────────────────────────────────────────────────────────┤
│ ℹ 이 화면에서는 엣지에 설치된 애플리케이션의 현재 상태를 │
│ 한눈에 확인하고, 필요할 때 시작·중지·재시작 할 수 있습니다.│
├────────────────────────────────────────────────────────────┤
│ [앱 카드] [앱 카드] [앱 카드] │
│ [앱 카드] [앱 카드] ... │
└────────────────────────────────────────────────────────────┘
旧版本的 ← 返回 按钮已移除 — 请点击工具栏中的图标或徽标以切换到其他页面。
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 Broker) | 消息中继（Sparkplug B 发布端） |
| Cassandra | 时序数据存储 |
| Portainer | Docker 容器可视化管理系统 |
| Uptime Kuma | 简单可用性监控（检测存活状态） |
| File Browser | Web 文件管理器 |
已安装的应用因环境而异。具体显示哪些应用，取决于系统管理员从 IIoT 平台进行远程部署的结果。
常见操作
打开辅助应用页面
点击卡片上的端口号，即可在新窗口打开该应用的页面。
- 通常以
http://게이트웨이IP:포트/格式自动连接 - 部分应用可能需要单独登录（例如：Grafana、Portainer）
启动/停止/重启辅助应用
| 操作 | 方法 | 备注 |
|---|---|---|
| 启动 | 卡片上的 [启动] 按钮 | 仅在停止状态下可用 |
| 停止 | 卡片上的 [停止] 按钮 | 仅在运行/暂停状态下可用 |
| 重启 | [重启] 按钮 | 始终可用 |
操作时会弹出一个确认窗口，即使误点也可点击 [取消]。
查看辅助应用日志
点击卡片上的 [日志] 按钮 → 在黑色屏幕上显示最后 200 行。可用于排查应用无法启动的原因，或提供给系统管理员。
刷新
点击左上角的 [刷新] 按钮可立即更新（独立于自动 10 秒刷新）。
网关自身管理（状态栏快捷操作）
页面左下角的状态栏中有 7 个图标，用于控制网关操作系统 / 应用程序本身 — 所有页面通用。
详细操作 / 耗时 / 注意事项，请参阅单独文档 状态栏快捷操作。
| 图标 | 操作 | 备注 |
|---|---|---|
🎬 (fa-projector) 系统重启 | OS 重启 | 约 3~5 分钟 — 所有 PLC 采集将中断 |
🔁 (fa-repeat-1-alt) 应用程序重启 | 仅重启 Tomcat / 网关软件 | 1 分钟以内 |
🗑 (fa-trash) 临时文件清理 | 清理临时 / 缓存 | 磁盘空间不足时使用 |
⏱ (fa-stopwatch) 备份 | 备份配置 + 数据库 | 参考 备份/恢复 |
📄 (fa-file-alt) 日志下载 | 诊断日志 zip 包 | 报告问题时附带 |
🔌 (fa-microchip) 操作系统及固件升级 | 固件更新 | 请谨慎操作 |
☁ (fa-cloud-download) 软件升级 | 网关软件更新（product.kopens.io） | 仅在右上角显示 可升级！ 徽章时可用 |
重启 / 升级期间，PLC 数值采集会暂时中断。建议在非运营时段进行。
网关自身安装
供系统管理员使用 — 在新环境中首次安装时。
通常情况下，系统管理员会预先完成基础安装。但如果需要在新环境中首次安装，可以使用以下单行命令进行批量安装。
bash < <(curl -s http://product.kopens.io/plantpulse-edge/install.sh)
内部会安装 JDK / Tomcat / Cassandra / 网关等所有组件。
如需更详细的构建 / 部署 / 环境配置步骤，请参阅 app.properties 参考 以及高级 — 开发者笔记。
常见问题
Q. 应用程序处于“停止”状态，但无法启动
可能是 PC 资源不足（如内存不足）或端口冲突。
- 在主页面查看内存 / 磁盘指示器
- 尝试 [设置] → [临时文件清理]
- 若仍无法解决，请点击 [日志] 按钮查看错误信息，并提供给系统管理员
Q. 重启网关后，PLC 连接 / 标签会丢失吗？
不会。配置会安全保存，重启后会自动恢复，且设置为“自动启动”的 PLC 会自动重新开始采集。
Q. 辅助应用可以独立于网关，部署到其他 PC 上吗？
可以，但推荐的配置是部署在同一台 PC 上。请与系统管理员商议。