server-agent

CMDOP Skill — 安装和使用 CMDOP agent:

“

cmdop-skill install server-agent

“

Universal production server 监控、自愈和报告技能。

监视 Docker 容器，检测异常，自愈安全的容器，扫描漏洞，生成结构化 Markdown 报告 —— 由 cmdop agent 驱动。

快速入门

Bash

# 安装
pip install -e .

# 快速状态检查
server-agent status

# 全面健康检查（自愈安全问题）
server-agent check

# 安全扫描
server-agent scan

# 自愈特定容器
server-agent heal --container reforms-django

# 每日报告
server-agent report --type daily

Loading code...

命令

命令	描述
`check`	全面健康检查：容器、磁盘、Redis。自愈安全问题。
`scan`	安全扫描：trivy CVEs、开放端口、认证日志。
`heal`	目标修复特定容器。
`report`	生成结构化 MD 报告（每日、安全）。
`status`	快速服务器快照 —— 无文件写入。

所有命令支持 --json 为结构化输出和 --dry-run 预览动作而不执行。

环境变量

变量	必须	描述
`REPORTS_DIR`	是	绝对路径到报告目录
`TELEGRAM_BOT_TOKEN`	否	Telegram 通知机器人令牌
`TELEGRAM_CHAT_ID`	否	目标聊天/频道 ID

自治模型

安全（立即执行）： docker restart、docker system prune
升级（发送 Telegram 警报）：镜像重建、配置更改、容器 >2 重启、OOM
永不：数据库命令、rm -rf 外 /tmp、防火墙更改

受保护容器（永不自愈）： shared-db-redis、traefik

在生产服务器上设置

Bash

# 1. 安装
pip install server-agent

# 2. 设置环境
export REPORTS_DIR=/root/server-agent/reports
export TELEGRAM_BOT_TOKEN=<token>
export TELEGRAM_CHAT_ID=<chat_id>

# 3. 验证
server-agent status --json

# 4. 生成端口基线
server-agent scan --baseline
# 查看基线/ports.json，然后设置 reviewed: true

# 5. 启动 cmdop agent

# 6. 注册触发器

# 每 5 分钟触发

# 每 30 分钟触发

# 每天触发

Loading code...

两种操作模式

计划监控（Python CLI)

触发器直接调用 server-agent 二进制文件。无 LLM 在检查循环中 —— 快速、确定、廉价。

Bash

# 每 5 分钟触发
server-agent check

Loading code...

交互式调查（cmdop 能力)

使用时需要 agent 理解事件：

Bash

cmdop run server-agent "reforms-django 持续重启，调查并修复"

Loading code...

agent 读取 skill/readme.md 作为系统提示，并使用 server-agent CLI 作为工具来收集数据并采取行动。

报告结构

“

$REPORTS_DIR/
index.md
baseline/ports.json
2026-03-14/
10-23-incident-reforms-django.md
14-05-security-scan.md
daily-summary.md

“

server-agent

server-agent

快速入门

命令

环境变量

自治模型

在生产服务器上设置

两种操作模式

计划监控（Python CLI)

交互式调查（cmdop 能力)

报告结构

评价