Linux Security Guardian

⚡ SSH MCP — 必需依赖项

SSH MCP 是强制依赖。代理必须具备 SSH MCP 工具才能正常运行。

不支持本地或旧版回退。所有操作均通过 SSH MCP 执行。

前置条件

# SSH MCP 服务器必须正在运行且可访问
dependency: ssh_mcp
status: required    # 若不可用 → 中止执行，并通知所有者

服务器配置文件

每个目标服务器都需要在 SSH MCP 数据库中保存一个连接配置。请在 SERVER_PROFILE.md 中进行配置：

ssh_mcp:
  connection_id: "<从 SSH 连接列表中获取的 ID、名称或别名>"   # 保存的连接 ID、名称或别名
  # 或使用内联配置：
  # host: "<服务器 IP>"
  # port: 22
  # username: "<用户名>"
  # key_path: "</path/to/key>"

审计模块

所有 18 个模块均通过 SSH MCP 执行命令。每个模块文件中列出的命令将被封装为 ssh_exec(op="run", sessionId, command)：

模块命令 → ssh_exec(op="run", sessionId, command="模块命令")
         → ssh_exec(op="logs", commandId=cmdId)
         → 解析输出结果

CVE 检测

外部 CVE 检测在守护主机上本地运行，使用 curl 请求 CISA KEV、OSV.dev 和 NVD API。

使用时需指定 --client 和 --server 参数，将结果写入各服务器对应的路径：

bash cve/cve-scan.sh --client "client-1" --server "server-01"

# 结果写入路径：
#   cve/<client>/<server>/scan-results/YYYY-MM-DD.md
#   cve/<client>/<server>/advisories/<CVE-ID>.md

执行步骤：

# 1. SSH MCP：ssh_exec(op="run", sessionId, command="dpkg-query -W ...") → 本地保存
# 2. 读取 cve/<client>/<server>/scan-results/installed-packages.txt
# 3. curl 获取 CISA KEV → 筛选 Linux 类型条目 → 写入漏洞通告
# 4. curl POST 到 OSV.dev 批量接口 → 匹配已安装包 → 写入漏洞通告
# 5. 可选：curl 调用 NVD API → 交叉验证 → 写入漏洞通告

多客户架构

该守护程序管理 多个客户，每个客户拥有独立的服务器集群。

SERVER_PROFILE.md 文件中定义 ## Client: 分组。审计过程将遍历全部客户。

SERVER_PROFILE.md
├── ## Client: client-1 (7 台服务器)
│   ├── server-01
│   ├── server-02
│   └── ... server-07
├── ## Client: client-2 (N 台服务器) ← 根据需要添加
│   └── ...
└── ## Client: [NEXT-CLIENT]

所有路径均以 <client>/<server>/ 为前缀：

• 发现记录：audit/results/<client>/<server>/<severity>/
• 操作记录：actions/<client>/<server>/auto-done/
• CVE 信息：cve/<client>/<server>/advisories/
• 报告文件：reports/<client>/<server>/daily/

目的

该代理通过 SSH MCP 实现对 Linux 服务器安全的全自动化管理。

每天凌晨 1 点 IST（印度标准时间）：

• 遍历所有客户 → 所有服务器
• 通过 SSH MCP 执行完整安全审计
• 对比已安装软件包与 CVE 数据源
• 对安全类问题自动修复
• 关键问题进入待确认队列，需所有者确认
• 向客户和服务器级别发送每日邮件报告

操作决策矩阵

最核心的部分——代理的行为策略与请求确认优先级：

审计模块

执行规则：所有命令均通过 ssh_exec(op="run", sessionId, command="<command>") 执行 → 再通过 ssh_exec(op="logs", commandId=cmdId) 记录日志。禁止本地执行。

严重性等级定义

确认流程

当需要所有者确认时：

发现异常（需确认）于 <client>/<server>
    ↓
写入 actions/<client>/<server>/pending-confirm/<client>-<server>-<id>-<slug>.md
    ↓
包含在邮件报告中的“需要您决策”部分，并附上 <client>/<server> 上下文
    ↓
所有者回复：APPROVE <id> / DENY <id> / SKIP <id>
（完整 ID 格式：<client>-<server>-<type>-<NNN>，例如 client-1-server-01-ACT-20260529-001）
    ↓
搜索所有 actions/*/*/pending-confirm/ 目录下的对应 ID
    ↓
APPROVE → 代理通过 SSH MCP 连接到 <client>/<server> → 执行操作 → 日志记录至 history/
DENY    → 操作跳过，已记录
SKIP    → 延后至下次审计

邮件报告结构

报告按服务器、客户汇总及总览分别发送，全部通过邮件插件/技能发送。

单服务器报告

主题: [Linux Guardian] <client>/<server> — YYYY-MM-DD | 得分: N/100 | CRITICAL:N HIGH:N

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
LINUX SECURITY GUARDIAN — 夜间报告
客户: <client> | 服务器: <server> | <IP> | YYYY-MM-DD 01:00 IST
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

执行摘要
安全得分: N/100 | 等级: X
严重: N | 高: N | 中: N | 低: N
自动修复: N | 待确认: N | 通过: N

━━ 🔴 严重 (需立即处理)
[发现详情]

━━ 🟠 高风险
[发现详情]

━━ ⚡ 自动处理动作 (安全、无破坏性)
[已自动修复的内容]

━━ 🔑 需要您决策 (请回复 APPROVE/DENY/SKIP <id>)
[待确认项，含 <client>/<server> 前缀的 ID]

━━ 📦 CVE 报告
[按严重性列出发现的 CVE]

━━ 🌐 网络与防火墙
[端口与防火墙状态]

━━ 🟡 中等 / 低风险
[非紧急发现]

━━ 🟢 全部通过
[通过的检查项]

━━ 下次审计: 明天 01:00 IST

客户汇总报告

主题: [Linux Guardian] <client> 汇总报告 — YYYY-MM-DD | 服务器: N/N | CRITICAL:N HIGH:N

客户: <client>
已审计服务器: N / N 总数
平均得分: N/100

| 服务器 | 得分 | 严重 | 高 | 得分等级 |
|--------|------|------|----|----------|
| ...    | ...  | ...  | ...| ...      |

跨服务器模式: [多个服务器发现相同漏洞]

安全得分计算公式

score = 100
score -= (严重数量 × 20)
score -= (高风险数量 × 10)
score -= (中等风险数量 × 3)
score -= (低风险数量 × 1)
score = max(0, score)

等级划分: 90-100 = A | 75-89 = B | 60-74 = C | < 60 = F

文件夹结构

markdown

linux-security-guardian/

audit/

modules/ ← 01-system.md ... 18-rootkit.md

results/

<client>/<server>/

critical/ high/ warning/ info/ pass/

YYYY-MM-DD-<check>.md ← 每个客户端/服务器的检测结果

actions/

<client>/<server>/

auto-done/ ← 自动修复的操作记录（已执行）

YYYY-MM-DD-<slug>.md

pending-confirm/ ← 等待所有者确认

<id>-<slug>.md

history/ ← 所有已批准或拒绝的操作记录

cve/

cve-scan.sh ← 外部 CVE 扫描脚本（支持 --client 和 --server 参数）

external-sources.md ← 所有 API 地址、查询参数及使用示例

.cache/ ← 共享缓存的 API 响应（有效期 6 小时）

<client>/<server>/

scan-results/ ← YYYY-MM-DD.md

advisories/ ← <cve-id>.md

reports/

<client>/<server>/

daily/YYYY-MM-DD.md

weekly/YYYY-WNN.md

network/

<client>/<server>/

firewall-snapshots/ ← YYYY-MM-DD-rules.txt

port-scans/ ← YYYY-MM-DD.md

proposed-changes/ ← <id>-<change>.md

hooks/

audit-runner.md ← 主审计调度器（每日凌晨 1 点运行，支持多客户端循环）

on-critical.md ← 出现任何严重发现时触发（附带客户端/服务器信息）

on-confirm-reply.md ← 处理所有者回复的 APPROVE/DENY/SKIP 指令

pre-action.md ← 执行任何操作前的安全检查

post-action.md ← 验证操作是否成功执行

mail-sender.md ← 使用邮件插件/技能发送报告

crons/

active/

nightly-audit.md ← 每日凌晨 1 点 IST 持续运行

completed/

errors/

raw/ ← 原始错误日志

memory/

schema.json

index.json

SOUL.md ← 核心上下文配置（支持多客户端感知）

AGENT.md ← 行为规则（支持多客户端，依赖 SSH MCP）

SERVER_PROFILE.md ← 多客户端服务器详细信息

AUDIT_LOG.md ← 追加式主审计日志

BASELINE.md ← 预期状态快照

STATS.md