system-status

Ops-Agent im Stil von Hermes: überwacht Ubuntu / Docker / öffentliche IP und sendet Alarme an Feishu.

Funktionen

• 🐳 Docker-Überwachung: Containerstatus, Anzahl der Neustarts, CPU/RAM, Healthcheck

• 🖥️ System-Überwachung: CPU, RAM, Festplatte, Last

• 🌐 Erkennung öffentlicher IP-Wechsel: Mehrquellen-Validierung, Alarm bei Änderung

• 💬 Feishu-Alarme: Rich-Text-Karten + @ bestimmte Personen

• 📊 SQLite-Verlauf: Jede Messung wird in der Datenbank gespeichert, Standardaufbewahrung 7 Tage

• 🖼️ Web-Panel: Echtzeit-Dashboard + Trenddiagramme + Alarm-Feed

  • Einfach http://localhost:8080/web/ öffnen

• 🌐 HTTP / MCP-Schnittstelle: für Hermes / Clients

  • GET /health

  • GET /api/docker/containers

  • POST /api/docker/restart

  • GET /api/system

  • GET /api/ip

  • GET /api/dashboard

  • GET /api/history/system?minutes=60

  • GET /api/history/ip

  • GET /api/alerts/recent

  • GET /mcp/tools

Related MCP server: 6amdev-server-mcp

Schnellstart

1. Feishu-Bot erstellen

Gruppenchat → Einstellungen → Gruppen-Bot → Hinzufügen → Benutzerdefinierter Bot → Webhook und Secret abholen

2. Umgebungsvariablen konfigurieren

cp .env.example .env
# 编辑 .env,填入飞书 webhook 和 secret

3. Starten

docker compose up -d

4. Verifizieren

curl http://localhost:8080/health
curl http://localhost:8080/api/docker/containers
curl http://localhost:8080/api/system
curl http://localhost:8080/api/ip

Konfiguration

.env:

Hermes-Anbindung

Hermes kann diese Endpunkte direkt über HTTP MCP aufrufen. In der Hermes-Konfiguration hinzufügen:

mcp_servers:
  - name: system-status
    type: http
    base_url: http://localhost:8080
    tools:
      - name: list_containers
        method: GET
        path: /api/docker/containers
      - name: system_health
        method: GET
        path: /api/system
      - name: check_public_ip
        method: GET
        path: /api/ip
      - name: restart_container
        method: POST
        path: /api/docker/restart
        body_schema:
          type: object
          properties:
            name: { type: string }

Danach kannst du zu Hermes sagen:

"Liste alle beendeten Container auf" "Starte mysql-01 neu" "Wie ist die aktuelle öffentliche IP?" "Wie ist der Systemzustand?"

Projektstruktur

system-status/
├── src/
│   ├── index.ts            # 入口
│   ├── config.ts           # 配置加载
│   ├── mcp/server.ts       # HTTP / MCP 接口
│   ├── monitor/
│   │   ├── docker.ts       # Docker 监控
│   │   ├── system.ts       # 系统监控
│   │   ├── ip.ts           # 公网 IP 检测
│   │   └── loop.ts         # 监控主循环
│   └── alert/
│       ├── feishu.ts       # 飞书 Webhook + 签名
│       └── templates.ts    # 告警模板
├── config/rules.yaml       # 告警规则
├── Dockerfile
├── docker-compose.yml
└── .env.example

Alarm-Cooldown

Gleichtartige Alarme werden standardmäßig 5 Minuten nicht erneut gesendet (um Alarmstürme zu vermeiden). COOLDOWN_MS kann in src/monitor/loop.ts angepasst werden.

Sicherheitshinweise

• ⚠️ docker.sock entspricht Root-Rechten, daher unbedingt das Read-only-Mount (:ro) verwenden

• ⚠️ Container mit privileged: true → Produktionsrisiko prüfen

• ⚠️ Feishu-Webhook nicht in Git einchecken