页面保活（pagekeep）

功能与检测机制

• 按目标间隔定时 GET 拉取页面，校验 HTTP 状态码等于期望值（默认 200，可配 100–599）。
• 每次检测记录：响应字节数、延迟、状态码，并缓存响应内容前 2KB 快照（悬停可见），持久化保存 —— 服务重启后界面仍能显示上次快照。
• 读取响应最多 4MB；连续失败达阈值（默认 3 次）判定 down，恢复自动上报。
• 检测间隔最小 5 秒（API 层强制钳制），避免把目标站拉挂。

全局配置

字段	默认	说明
启用保活	启用	总开关（pagekeep.enabled）
默认检测间隔(秒)	30（最小 5）	目标未单独填写时使用
默认超时(毫秒)	5000（最小 500）	同上
异常目标数	只读	当前 down 状态目标数（红色）

目标管理与快照

点击「添加目标」填写：

字段	说明	默认
名称	如「官网首页」，必填	—
URL	http/https 完整地址，必填	—
期望状态码	100–599，越界将被拒绝	200
间隔 / 超时 / 阈值	留空使用全局默认	30s / 5000ms / 3 次

目标表格列：状态 / 名称 / URL / 期望状态 / 间隔 / 超时 / 阈值 / 上次检测 / 延迟 / 响应长度 / 快照（有错误显示错误摘要；正常显示「HTTP 状态 · 延迟」，鼠标悬停显示缓存的页面快照前 800 字符）/ 操作。

操作按钮

操作	行为
检测	立即拉取一次并 toast 结果（「HTTP 正常 · 大小 · 延迟」/「检测失败 · HTTP xxx · …」），不改动状态机与快照
停用 / 启用	暂停 / 恢复该目标检测
编辑 / 删除	修改参数；删除需确认（历史事件保留）

事件与状态机

• down：连续失败达阈值（网络错误或状态码 ≠ 期望）→ 上报 warning（含原因与响应字节数）+ 事件 + 审计；仅状态跳变时上报。
• recovered：down 后任一次成功 → 上报 info + 事件。
• 「最近事件」面板显示最近 20 条（含状态码 / 响应大小 / 延迟 / 详情）；完整历史在「系统日志 → 页面保活」。

注意事项

• 「页面可用」的判定就是状态码等于期望值：需要校验页面内容关键词的场景暂不支持，可用期望码（如 204 / 302）覆盖部分需求。
• 对启用了客户端证书（mTLS）的站点会检测失败 —— 拉取器不带客户端证书，属预期行为。
• 响应长度变化（如首页被篡改导致体积突变）可通过「响应长度」列人工比对发现；模块本身不做内容差异告警。
• 监控自己机器上的服务时，目标填写 http://127.0.0.1:端口/ 即可。