Server Health

🖥️ 一键透视服务器核心指标

轻量级服务器健康监控脚本,实时展示系统资源、Top进程、OpenClaw网关状态及服务运行情况,适合运维快速巡检

收藏
15.2k
安装
3.6k
版本
1.0.0
CLS 安全性认证2026-06-03
点击查看完整报告 >

使用说明

核心用法

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. 零依赖设计:仅使用系统内置工具(topfreedfsystemctl等),无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数据最小化原则合规。

安全解读

核心用法

server-health 是一款面向 Linux 服务器的轻量级健康监控脚本,提供三种输出模式:

  • 标准模式:展示 CPU、内存、磁盘使用率、系统运行时间、TOP 进程、OpenClaw 网关状态及运行服务
  • 详细模式--verbose):额外显示温度传感器、网络流量、磁盘 I/O 及交换分区使用情况
  • JSON 模式--json):结构化输出,便于自动化集成
  • 告警模式--alerts):仅显示超过阈值的异常指标(磁盘>90%、内存>80%、CPU>90%)

显著优点

1. 零依赖安全架构:仅使用系统自带命令(top/free/df/ps),无第三方库或网络请求,彻底杜绝供应链攻击
2. 多场景适配:CLI 直接执行、Telegram Bot 集成、自动化监控流水线均可无缝接入

3. OpenClaw 生态深度整合:原生支持网关状态、模型配置、会话数等专属指标监控

4. 视觉友好:ASCII 进度条 + Emoji 状态标识,终端与移动端阅读体验俱佳

潜在局限

1. 平台限制:依赖 Linux /proc 文件系统,Windows/macOS 无法直接运行
2. 硬件感知受限:温度监控需 lm-sensors 驱动支持,云服务器通常无法获取

3. 历史数据缺失:纯瞬时快照,无持久化存储与趋势分析能力

4. 权限边界:部分详细指标(如某些进程信息)需 root 权限才能完整获取

适合人群

  • 个人开发者管理 VPS/云服务器
  • 小型团队需要轻量级监控方案
  • OpenClaw 用户需要快速验证网关健康状态
  • 运维人员需快速生成可读性强的系统报告

常规风险

| 风险类型 | 评估 | 说明 |
|---------|------|------|
| 数据泄露 | 极低 | 仅读取系统公开状态,不接触业务数据 |
| 供应链攻击 | 无 | 零外部依赖 |
| 权限提升 | 无 | 不申请特殊权限 |
| 误操作风险 | 低 | 纯只读操作,无系统修改能力 |

建议:root 运行可获取最完整信息,普通用户运行亦可满足基础监控需求;不建议暴露于公网可访问路径。

Server Health 内容

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