Skip to content

AstrBot Resource Monitor资源分发线路巡检与告警插件

基于客户端同一份校验口径,定时核查配置源、清单一致性、HTTP Range 分片、MD5 散列、热更包与 TLS 证书到期,经由多轮防抖与 QQ 官方人工确认闭环投递。

能力定位与明确边界 ​

能做到什么程度(已实现能力)

  • 10 项客户端一致性深度探针:不仅看 HTTP 200,更校验配置突降/版本回退、多数共识、HTTP 206 Range、32 位 MD5 分块轮转(7 天覆盖度)、热更包流式整包校验与 <14d/<3d TLS 证书到期。
  • 公网 SSRF 钉死与共享防线:PublicResolver 禁止内网/保留 IP(含 IPv4 映射 IPv6)与 trust_env 代理,锁定 64 MiB 缓冲天花板,配合 M-of-N 防抖、两级抑制、render.safe() 防注入与 QQ 官方 /线路 通知 + /线路 确认 闭环。
  • 快慢双锁隔离与可插拔 SPI:300s 快线与 3600s 慢线独立加锁不相互阻塞;Source 与 HttpClient 支持离线 FakeClient 无网全测。

明确不能做什么(非目标与硬限制)

  • 严格只读观察,不查宿主机也不自动切流:绝不采集 AstrBot 宿主机 CPU/内存,绝不回改上游配置或切换 CDN,也不提供长期 SLA 可用率历史报表。
  • 禁内网与群聊重放保护:强制拦截回环与私网目标且禁用环境代理;聊天指令强制 allow_heavy=False 跳过百 MB 整包,/线路 确认 始终只限管理员;仓库零内置默认源(必须手动配 entry_url 或 mirrors)。

架构拓扑概览 ​

插件宿主、守卫与告警投递交互拓扑(支持平移与缩放)

图表与源码实现对齐说明:上方拓扑图展示 AstrBot 宿主、插件核心、SSRF 守卫与告警通道之间的宏观交互关系(图中「资源统计与日志」节点标签为早期总览命名);当前 watch/ 代码实际执行的是外部资源分发线路的配置文件、清单、HTTP Range 分片 MD5、热更包与 TLS 证书巡检,并不采集宿主机 CPU 或内存占用。

本地快速检验 ​

sh
# 1. 在仓库根目录运行离线单元测试(共 252 项;系统 Python 未装 aiohttp 时跳过 5 项连接边界测试)
python3 -m unittest discover -s tests -t . -v

# 2. 运行地址与凭证防泄漏扫描
python3 tools/check-no-endpoints.py --verbose

文档分层导航 ​

按照读者需求快速跳转