核心用法
server-health 是一款面向 Linux 服务器的本地化健康监控脚本,通过纯 Shell 实现,无需外部依赖。提供四种运行模式:
| 模式 | 用途 |
|------|------|
| 标准模式(默认) | 系统核心指标 + Top进程 + OpenClaw状态 + 服务概览 |
| `--verbose` | 额外显示温度、网络流量、磁盘I/O、详细服务信息 |
| `--json` | 结构化输出,便于接入自动化监控流水线 |
| `--alerts` | 仅输出警告/错误(磁盘>90%、内存>80%、CPU>90%) |
典型输出示例
- 系统资源:CPU进度条、内存/磁盘使用率、运行时长
- Top进程:按CPU/内存排序的前3-5个进程
- OpenClaw网关:运行状态、PID、端口、模型配置、上下文占用、活跃会话数
- 服务矩阵:Docker容器数、PostgreSQL等服务状态
显著优点
1. 零依赖设计:仅使用系统内置工具(top、free、df、systemctl等),无Python/Node依赖,适合精简容器环境
2. OpenClaw原生集成:深度对接 OpenClaw 网关,可直接读取 openclaw.json 配置,显示模型上下文占用、Token消耗等特有指标
3. 多端适配:ASCII进度条+Emoji标识,在 Telegram/CLI/Web 终端均有良好可读性
4. 安全意识内置:使用 set -euo pipefail,命令失败时终止而非继续执行;错误输出重定向避免信息泄露
潜在缺点与局限性
| 局限 | 说明 |
|------|------|
| Linux专属 | 依赖 `systemctl`、`/proc` 文件系统,macOS/Windows 需移植 |
| 硬编码路径 | OpenClaw配置固定为 `/root/.openclaw/`,非root安装或自定义路径需手动修改 |
| 无历史数据 | 纯即时快照,无趋势分析、无持久化存储 |
| 权限敏感 | 读取系统级配置和服务状态,需在目标服务器本地执行,无法远程无代理监控 |
| 参数校验宽松 | 传入未定义参数时可能产生非预期行为 |
适合人群
- 个人开发者/小团队:管理1-5台VPS/云服务器,需要轻量级监控替代重型方案(Zabbix/Prometheus)
- OpenClay用户:需要同时关注系统健康和AI网关运行状态的部署场景
- Telegram运维场景:通过 bot 定时推送服务器日报,快速掌握状态
常规风险
- T3来源风险:个人开发者/社区项目,建议关注GitHub更新动态,生产环境使用前应人工审查代码
- 权限风险:需访问
/root目录和系统服务信息,误用可能暴露配置细节 - 无加密传输:JSON输出若通过Webhook/HTTP发送,需自行配置TLS
合规状态
通过 CLS-Certify v2.1.0 扫描,安全等级A,评分78分。无高危漏洞、无硬编码凭证、无数据外泄风险,GDPR数据最小化原则合规。