openocta 基础设施巡检 (server-patrol)
面向 Linux 服务器 与 网络设备（路由器、交换机、防火墙等）的只读巡检 Skill。
| 对象 | 检查项 |
|---|---|
| Linux | uptime、负载、CPU、内存、磁盘、systemd 服务、Docker |
| 网络设备 | Ping 连通、TCP 端口、SNMP（可选）、SSH 只读命令（Cisco / 华为 / H3C） |
何时使用
- 「服务器巡检」「网络设备巡检」「路由器状态」「交换机健康」「定时巡检」
- 不适用：改配置、重启设备、下发 ACL 等写操作
用户目标
- 一份报告汇总 Linux 与网络设备的 OK / WARN / CRIT
- 明确 unreachable、高 CPU、端口不通等风险及处理建议
Agent 执行规则（必读）
巡检目标与凭证由 OpenOcta 平台在运行 patrol.sh 前注入进程环境（来自 Skill 包内 config.env + Config Vault），不对大模型暴露。
- 直接运行脚本，不要预先检查环境变量：
- 禁止
env、printenv、echo $PATROL_*、grep PATROL - 禁止
cat/read_file读取config.env - 禁止在对话中复述密码、密钥、community 等敏感值
- 禁止
- 进入 Skill 目录后执行（路径以实际挂载为准）：
chmod +x scripts/patrol.sh
./scripts/patrol.sh --list # 查看已配置目标（无目标时再报错）
./scripts/patrol.sh --all # 批量 Linux + 网络
./scripts/patrol.sh --servers # 仅 Linux
./scripts/patrol.sh --network # 仅网络设备
./scripts/patrol.sh --network --tag core
./scripts/patrol.sh --all --format json
- 若
--list为空或脚本报「未配置目标」，告知用户：需在控制台 Config Vault / Skillconfig.env中配置巡检目标，不要自行构造export PATROL_*。 - 根据脚本 stdout /
reports/下报告解读结果，按下方「处理思路」给出建议。
分析思路
- 运行
./scripts/patrol.sh --list或./scripts/patrol.sh --all - Linux：磁盘/内存/负载超阈值 → WARN/CRIT（逻辑见脚本）
- 网络：Ping 丢包、RTT、端口、SSH 采集 CPU/内存 → WARN/CRIT
- 报告分「Linux 服务器」「网络设备」两节呈现
处理思路
| 发现 | 建议 |
|---|---|
| Ping CRIT | 查链路、ARP、ACL、设备电源 |
| 端口 closed | 确认服务监听、防火墙、安全组 |
| Cisco/华为 CPU 高 | 查会话数、路由震荡、广播风暴 |
| 接口 down | 查物理链路、光模块、对端端口 |
| Linux 磁盘/内存 CRIT | 同服务器巡检常规处理 |
| SSH/SNMP 失败 | 查凭证、SNMP ACL、管理 VLAN（勿向用户索要明文密码） |
输出要求
- 以脚本输出为准，分 Linux / 网络两节
- CRIT/WARN 项附简短 remediation
- SSH/SNMP 失败单独说明，不阻塞其他目标
注意事项
- 只读：禁止配置写入、reload、reboot
- 网络设备 SSH 命令集因厂商/版本而异
- 运维配置格式（
PATROL_*列表、Config Vault 引用）见 README.md 与 config.env，Agent 无需阅读
能力依赖
- bash、ping、ssh；密码认证时需 sshpass（由运维在 Runtime 镜像中安装）
- 可选：python3、nc、snmpwalk