NcStatusCheck

对多个 Nextcloud 实例的集中监控

NcStatusCheck 是一款监控工具，让你通过单一 Web 界面跟踪多台 Nextcloud 服务器的健康状况：Nextcloud 和 PHP 版本与其安全底线、分支生命周期终止、可达性、配置警告、已安装应用、Docker 容器以及已知漏洞。

🎯 功能

监控

• 每台服务器支持三种数据采集模式：基础（仅 NC 版本）、扩展（通过 serverinfo API 获取完整数据）和推送（由远程实例发送数据）
• 针对 Nextcloud 和 PHP 的版本分析，对照安全底线（cron 会与官方发布保持同步），并带有宽限延迟（nc_update_grace_days），因此实例只会在补丁发布几天后才被标记
• 分支生命周期：每个 Nextcloud 分支的生命周期终止（官方时间表）、下一个发布日期，以及你有多少台服务器运行每个分支
• 在线/离线跟踪：当前可达性，加上一份有界的已确认状态转换日志，用于计算 30 天可用性百分比和事件列表
• SSL 证书到期，从现有的 HTTPS 探测中读取（无额外请求）
• 已知漏洞（可选启用）：将 Nextcloud、Collabora 和 OnlyOffice 的安全公告与你的机群实际运行的版本进行匹配
• 已安装应用审计：将 occ app:list 与 Nextcloud 应用商店交叉核对（阻止升级或不兼容的应用、可用更新、成熟度和动荡信号）
• Docker 容器：已停止、正在重启或不健康的容器，以及对照注册表标签目录检查镜像更新（你所在分支的补丁、更新的分支）。当多个被监视的实例共享一台机器时，容器会归属到各自的实例
• 主动告警（webhook 和/或电子邮件）：在线/离线状态变化，以及慢信号（SSL 到期、存在漏洞的版本、过期的推送探测、严重审计报告、阻断性应用发现、occ 损坏）。每个新状况只告警一次，不发送提醒垃圾信息
• 暂停服务器（迁移、退役）：探测和告警暂停，该行仍然可见
• 桌面客户端监视：当前版本、进行中的候选发布版本、实测发布节奏

仪表盘

• 机群表格（服务器 | Nextcloud | PHP | 健康）和分支生命周期表格在宽屏上并排显示
• 健康列遵循“沉默即一切正常”：仅在有需要处理的事项时显示徽章
• 综合卡片：待应用的更新、漏洞、分支生命周期终止、即将发布的版本、活动警告、应用、Docker、桌面客户端。每张卡片都会在窗口中打开其详情
• 针对应用和 Docker 镜像的机群监视，按你需要做的事情排序：待审查、待处理、待规划，以及一个折叠的上下文分组
• 筛选：按 Nextcloud 状态、PHP 状态、整体状态（离线、维护、警告、探测错误、Docker 更新……）、Docker 镜像和文本搜索
• 每个服务器名称下的标签，可点击筛选（多个标签 = 同时满足）：你自己的标签（client:durand、lab……），外加一个 🖥 标签，当多个被监视的实例运行在同一台服务器上时命名该机器（从推送检测，脚本 v12+），每台机器一种颜色。写成 type:value 的标签采用其类型的颜色，因此每个 client:… 标签共享同一种颜色
• 法语 / 英语 / 德语界面

详情页

• 选项卡上方的状态磁贴：可达性、30 天可用性（事件列表在窗口中）、SSL 证书、每个探测的新鲜度
• 概览：版本判定、已静默的告警（带有原因和到期时间的确认）、实例摘要（PHP、Web 服务器、数据库、缓存、部署，以及从应用和容器中看到的卫星工具，如办公套件、Talk HPB 或白板），然后是按区域分组的问题
• 选项卡：技术信息、应用程序、Docker 容器、探测
• URL 下的标签，可原地编辑，并显示运行在同一台机器上的其他实例
• 每个警告都可以被确认（原因 + 可选到期时间）
• 当实例推送其每月 nc-audit.sh 报告时，显示服务器审计报告

管理

• 服务器：通过 URL 添加服务器（https:// 可选），然后在其卡片上配置探测（带测试按钮的 serverinfo 令牌、推送令牌和即用型脚本生成器）、打标签、暂停或移除
• 共享主机：当多个被监视的 Nextcloud 共享一台机器时，说明哪个 Docker compose 栈属于哪个实例
• NC / PHP 版本：安全底线、状态规则、从官方发布重新同步
• 应用警告：手动维护的已知缺陷列表
• 通知：生效的告警配置（在 config.php 中设置，只读显示）和一个测试按钮
• IP 过滤：生成 nginx / Apache / ufw 允许列表规则
• 静默：审计整个机群中的每一次确认，以及哪些仍在隐藏问题
• 采集模式：三种探测的帮助说明
• 仪表盘上的 “触发推送” 按钮：要求每台推送服务器在其下次 cron 运行时发送数据

🏗️ 架构