端口守护（portguard）

功能与检测机制

• 对登记的主机 + 端口做 TCP 拨号连通性检测，记录延迟。
• 每个目标可独立设置：检测间隔（默认 30 秒，最小 5 秒）、超时（默认 3000ms）、连续失败告警阈值（默认 3 次）。
• 主循环每秒扫描到期目标逐个检测；成功重置失败计数，连续失败达阈值判定 down，恢复自动上报。

全局配置

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

目标管理

点击「添加目标」填写：

字段	说明	默认
名称	如「Web 服务」，必填	—
主机(IP/域名)	如 127.0.0.1 或 example.com，必填	—
端口	1–65535，必填	—
检测间隔 / 超时 / 阈值	留空使用全局默认	30s / 3000ms / 3 次

目标表格列：状态（异常红 / 正常绿 / 停用灰）/ 名称 / 地址 host:port / 间隔 / 超时 / 阈值 / 上次检测 / 延迟 / 最近错误（截断显示，悬停看全文）。

操作按钮

操作	行为
检测	立即拨测一次并 toast 结果（「连通正常，延迟 Xms」/「连接失败 …」），不影响状态机
停用 / 启用	暂停 / 恢复该目标检测
编辑 / 删除	修改参数；删除需确认

事件与状态机

• down：连续失败达阈值 → 上报 warning + 事件 + 审计；仅状态跳变时上报，down 期间不刷屏。
• recovered：down 后任一次成功 → 上报 info + 事件。
• 「最近事件」面板显示最近 20 条；完整历史在「系统日志 → 端口守护」。
• 本页每 60 秒自动刷新。