server-health

🖥️ 轻量级服务器健康监控专家

开源服务器监控脚本,实时查看系统资源、进程及 OpenClaw 状态,数据本地处理不上传,支持 CLI 巡检与 JSON 自动化。

收藏
9k
安装
2.4k
版本
v1.0.0
CLS 安全性认证2026-05-01
点击查看完整报告 >

使用说明

Server Health Skill 是一款专为系统管理员和开发者设计的轻量级服务器健康监控工具,通过简洁的命令行界面提供全面的系统状态概览。该技能以 Bash 脚本形式实现,能够实时采集并展示 CPU、内存、磁盘使用率等关键系统指标,同时深度集成 OpenClaw 网关状态监控,为使用 OpenClaw 服务的用户提供一站式运维视图。

核心用法方面,该技能提供四种运行模式以满足不同场景需求:标准模式(./server-health.sh)快速展示系统概况与关键进程;详细模式(--verbose)追加温度、网络流量及磁盘 I/O 等深度信息;JSON 模式(--json)输出结构化数据,便于集成到自动化监控体系或 Telegram 机器人;警报模式(--alerts)则仅显示异常指标(磁盘占用>90%、内存>80%等),适合用于定时巡检与异常通知。

显著优点体现在其极简的依赖设计与本地化处理原则。脚本仅依赖系统标准工具(bash、jq、systemctl 等),无需安装额外的 Python 包或数据库,在资源受限的边缘服务器上也能流畅运行。特别值得一提的是其数据隐私保护机制——所有监控数据均在本地处理并直接输出至标准输出,不存在任何数据上传至远程服务器的风险,这对于注重数据主权的企业环境尤为重要。此外,对 OpenClaw 网关的原生支持(显示模型配置、上下文使用率、会话状态)使其成为 OpenClaw 生态用户的理想运维 companion。

潜在缺点主要包括权限要求与来源可信度限制。由于需要读取 /root/.openclaw/openclaw.json 配置文件及执行 systemctldocker 等系统命令,脚本通常需要 root 或特定用户组权限,在多租户或严格 RBAC 环境中部署可能存在不便。作为 T3 级个人开源项目(作者 muslimalfatih),虽代码完全透明可审计,但缺乏企业级维护背书,长期更新与漏洞响应能力有待观察。功能层面,其定位为"快速检查"工具,不具备历史数据存储、趋势分析或分布式集群监控能力,不适合作为企业级监控体系的唯一解决方案。

适合的目标群体涵盖:中小团队运维人员,需要快速登录服务器排查问题;OpenClaw 网关使用者,希望实时监控网关状态与模型配置;DevOps 工程师,需要将基础监控集成到 CI/CD 流程或自动化脚本中;以及个人开发者维护的 VPS/独立服务器场景。对于需要轻量化监控、厌恶重型监控代理(如 Prometheus Node Exporter)资源占用的用户尤为合适。

使用风险方面,常规风险包括:权限配置不当可能导致敏感配置信息泄露(如 OpenClaw 配置文件包含端口与模型信息,需确保文件权限为 600/644);长期以 root 身份运行脚本可能带来权限扩大风险,建议配置 sudo 特定命令白名单;若将输出重定向至日志文件,需注意日志轮转与权限管理,避免磁盘空间耗尽;此外,脚本依赖 jq 解析 JSON,若系统未预装可能导致运行失败,需在部署前确认依赖完整性。

安全解读

核心用法

server-health 是一个纯 Bash 编写的本地服务器监控脚本,主打零依赖、零外连、开箱即用。通过 ./server-health.sh 可直接查看 CPU、内存、磁盘、运行进程、OpenClaw 网关状态等关键指标;--verbose 追加温度、网络、I/O 细节;--json 输出结构化数据供自动化集成;--alerts 则仅显示警告/错误(如磁盘>90%、内存>80%)。

显著优点

  • 极致轻量:仅 298 行 Shell 代码,无第三方包,依赖系统内置工具(ps, df, free, systemctl 等)
  • 隐私友好:零网络请求,所有数据本地读取不外传
  • OpenClaw 原生集成:深度绑定 OpenClaw 生态,自动检测网关运行状态、模型配置、会话数量,适合 OpenClaw 用户一站式监控
  • 多模态输出:支持交互式终端、JSON、告警筛选三种模式,覆盖人工巡检与自动化脚本场景

潜在缺点与局限性

  • T3 来源风险:社区项目/OpenClaw 生态,无商业背书,需关注后续更新
  • 权限依赖:读取 /root/.openclaw/ 配置及系统级服务状态需要 root 或相应权限
  • 平台局限:依赖 Linux /proc 文件系统及 systemctl,macOS/Windows 需适配
  • 输入校验薄弱:当前参数解析较简单,存在误输入风险(建议补充 --help 及严格校验)
  • 隐私合规提示不足:虽无数据外传,但未主动告知用户会读取 OpenClaw 配置与会话信息

适合人群

  • OpenClaw 网关自托管用户,需快速查看网关健康状态
  • 运维人员通过 Telegram/CLI 进行服务器日常巡检
  • 自动化告警系统(配合 --json--alerts 模式)
  • 追求极简、无依赖、本地优先的监控方案用户

常规风险

| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 信息泄露 | 低 | 仅本地读取配置,无外传,但建议明确告知数据收集范围 |
| 权限提升 | 低 | 需 root 读取系统级信息,属功能必需 |
| 供应链攻击 | 极低 | 无第三方依赖,但 T3 来源需关注更新 |
| 运行时篡改 | 低 | 纯脚本无编译,建议校验 SHA256 后使用 |

server-health 内容

手动下载zip · 5.1 kB
README.mdtext/markdown
请选择文件