跳到主要内容

状态栏快捷操作（所有页面通用）

网关 Web UI 的所有页面左下角状态栏上都有 7 个快捷操作图标。可一键完成重启操作系统/应用、磁盘清理/备份/升级等运维人员常用的操作。

容器模式 (2026.05+) 的内部动作

重启 / 重启系统 / 临时清理 / 升级 / firmware 按钮在容器模式下通过 signal 文件工作。 UI 不直接调用 bash 脚本，而是写入 /etc/kopens/upgrade.request 或 /etc/kopens/host-action.request，由主机上的 kopens-upgrade.path / kopens-host-action.path (inotify) 检测并执行相应操作（Pattern B 安全机制 —— 避免容器 等同于 host 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 服务器重新绑定 / 清理内存累积

重启 race：在部分环境下 ServerStartListener 会静默失败导致监视器 = null —— 此时再执行一次 ./restart.sh（或再点击一次该按钮）即可正常启动。

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

删除日志/缓存/上传残留文件，以确保磁盘空余空间。

项目值
实际动作clean.sh（仅限磁盘占用较高的网关工作目录 prefix 范围内清理）
耗时数秒 ~ 数十秒
PLC 采集无影响（仅清理文件）
使用时机主界面磁盘卡片超过 90% 时 / 升级前 / 长期运行后
相关卡片

主页磁盘卡片 变红时，此按钮是首选处理方式。

4. ⏱ 备份 (fa-stopwatch)​

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

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

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

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

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

日志内容检索使用 查看系统日志 (/system/log/list) 更方便 —— 可按特定时间段/级别/关键词过滤。

6. 🔌 O/S 及固件升级 (fa-microchip)​

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

项目值
实际动作OS 包管理器 + 厂商固件更新脚本
耗时数分钟 ~ 数十分钟
PLC 采集期间完全中断
外部访问部分阶段会中断
注意标签🔴 注意（红色徽标）
使用时机安全补丁 / 厂商建议 / KOPENS 通知
存在无法回退的步骤

固件升级可能包含无法回滚的步骤。请务必在非运行时间进行，并事先完成备份（第 4 项）。

7. ☁ S/W 升级 (fa-cloud-download)​

从下载服务器获取网关软件（本 Web UI）并进行升级。

项目值
下载服务器product.kopens.io（或企业内部镜像）
实际动作upgrade.sh —— 下载新构建 → SHA256 校验 → swap → restart
耗时1 ~ 3 分钟（下载速度 + restart）
PLC 采集1 分钟以内的短暂中断
右上角徽标红色 可升级！ = 下载服务器上有新版本 / 灰色 未连接 = 无法访问下载服务器 / 无徽标 = 已是最新
使用时机发布新构建 / 应用缺陷修复 / 新增驱动
下载服务器未连接

若 AVA_VERSION 为空（= 无法连通下载服务器），点击按钮时会弹出无法连接到下载服务器对话框并强制结束 —— 不会尝试新的下载，因此是安全的。

8. 小结：什么情况用哪个按钮？​

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

9. 相关文档​