跳到主要内容

状态栏快捷操作

在网关 Web UI 的所有页面左下角状态栏中，有 7 个快捷操作图标。它们可以将重新启动操作系统/应用程序、磁盘清理/备份/升级等操作员常用的操作一键完成。

容器模式 (2026.05+) 的内部行为

重启 / 重新启动 / 临时清理 / 升级 / 固件按钮在容器模式下通过信号文件工作。 UI 不直接调用 bash 脚本，而是写入 /etc/kopens/upgrade.request 或 /etc/kopens/host-action.request 后，由主机的 kopens-upgrade.path / kopens-host-action.path (inotify) 检测并执行相应的操作（Pattern B 安全性 — 确保容器 不具有与主机 root 同等的权限）。执行结果记录在 /etc/kopens/upgrade.status / host-action.status JSON 中，UI 通过轮询进行显示。

┌──────────────────────────────────────────────────────────────┐
│ … 페이지 컨텐츠 …                                              │
├──────────────────────────────────────────────────────────────┤
│ KOPENS Edge  | 🎬 🔁 🗑 ⏱ 📄 🔌 ☁  | 버전 V2026.05.10        │
└──────────────────────────────────────────────────────────────┘

每个图标点击后，会弹出一次确认模态框，需要再点击一次[确认]才会执行（防止误操作）。部分操作还会同时显示红色「注意」徽章，以提示风险等级。

1. 🎬 系统重启 (fa-projector)​

重新启动操作系统本身。这是最强烈的操作 — 请勿在日常使用。

项目值
调用bootbox.confirm → 后端 reboot 端点
实际动作操作系统 reboot
所需时间3 ~ 5 分钟 (BIOS POST + OS 启动 + Tomcat 启动 + Cassandra)
PLC 采集期间完全中断
外部连接网关 IP 无法 ping 通，直至重启后恢复
使用时机OS 补丁后 / 内核模块加载 / 硬件巡检后
注意标签🔴 注意 (红色徽章)

2. 🔁 应用程序重启 (fa-repeat-1-alt)​

仅重启 Tomcat (网关软件)。操作系统保持不变。

项目值
实际动作restart.sh (/opt/kopens/plantpulse-edge/bin/restart.sh)
所需时间约 30 ~ 60 秒
PLC 采集期间暂时中断 — 启动后自动恢复
使用时机应用 app.properties 更改 / OPC-UA 服务器重新绑定 / 内存累积清理

重启竞争: 在某些环境中，ServerStartListener 会静默失败，导致 monitor=null — 此时再次调用 ./restart.sh (或再点击此按钮一次) 即可正常启动。

3. 🗑 临时文件清理 (fa-trash)​

清除日志/缓存/上传残留，以释放磁盘空间。

项目值
实际动作clean.sh (针对磁盘使用率高的网关工作目录前缀进行限定清理)
所需时间数秒至数十秒
PLC 采集无影响 (仅文件清理)
使用时机主界面磁盘卡片超过 90% 时 / 升级前 / 长期运行后
相关卡片

当主页 磁盘 卡片 显示为红色时，此按钮是第一应对手段。

4. ⏱ 备份 (fa-stopwatch)​

将网关的配置 + 运营数据保存为备份文件。

项目值
实际动作backup.sh
输出/opt/kopens/.../backup/<timestamp>.tar.gz
包含范围app.properties，部分 Cassandra 键空间，Node-RED userDir，OPC/标签定义
恢复方法备份 / 恢复 — 单独流程
使用时机升级前 / 环境迁移 / 定期备份

5. 📄 日志下载 (fa-file-alt)​

立即下载用于诊断的日志包。

项目值
调用location.href = "/log-download" (GET 请求，服务器以 zip 流式传输)
输出最近的网关日志 + 诊断信息 zip
使用时机向系统管理员报告问题时附上 / 请求原因分析

如需在日志正文中搜索，使用系统日志查看 (/system/log/list) 更方便 — 支持按特定时间段/级别/关键词过滤。

6. 🔌 操作系统及固件升级 (fa-microchip)​

升级操作系统 / BIOS / 设备固件。风险最高的操作。

项目值
实际动作OS 包管理器 + 供应商固件更新脚本
所需时间数分钟至数十分钟
PLC 采集期间完全中断
外部连接部分阶段会断开
注意标签🔴 注意 (红色徽章)
使用时机安全补丁 / 供应商建议 / KOPENS 通知
包含无法回滚的步骤

固件升级可能包含无法回滚的步骤。请务必在非运营时间进行，并先执行备份 (第 4 项)。

7. ☁ 软件升级 (fa-cloud-download)​

从下载服务器获取网关软件 (即此 Web UI) 并进行升级。

项目值
下载服务器product.kopens.io (或公司内部镜像)
实际动作upgrade.sh — 下载新构建 → SHA256 验证 → swap → 重启
所需时间1 ~ 3 分钟 (下载速度 + 重启)
PLC 采集1 分钟以内的短暂中断
右上角徽章红色 可升级! = 下载服务器上有新版本 / 灰色 未连接 = 无法访问下载服务器 / 无徽章 = 已是最新
使用时机新构建发布 / 应用错误修复 / 添加新驱动
未连接下载服务器

如果 AVA_VERSION 为空 (= 无法连接到下载服务器)，点击按钮时会弹出无法连接到下载服务器 模态框并强制退出 — 不会尝试新下载，因此是安全的。

8. 总结: 何时使用哪个按钮？​

症状 / 意图推荐
仅更改了 app.properties🔁 应用程序重启
OS 补丁后 / 固件应用后🎬 系统重启
磁盘 90% 红色🗑 临时文件清理
环境迁移 / 升级前⏱ 备份
问题分析请求📄 日志下载
新构建发布☁ 软件升级
操作系统安全补丁🔌 操作系统及固件升级

9. 相关文档​