技能介绍

你在边缘代理上常卡在哪

502/503/504 上来时，很多人先在应用层打转，其实要先分清是上游不可用、连接失败、超时还是应用自己吐 500。证书快过期时，Traefik/Caddy 走 ACME 还好，HAProxy 往往是磁盘上的 .pem，工具和 API 能看到的面不一样。路由「明明配了却打到错后端」，多半是优先级、影子路由或死路由——需要能回答「这个 host/path 到底匹配哪条规则」，而不是只看配置片段。

技能怎么帮你做这件事

Proxy AIops 用同一套 MCP 工具对接 Traefik（API + /metrics）、Caddy（Admin API）和 HAProxy（Data Plane API v2），通过 platform 字段选 API 形态；不支持的操作会走支持矩阵直接报错，避免静默空操作。

读路径：概览与版本、list_routes / find_route、服务与上游、证书列表、流量与错误计数、配置快照与搜索。
flagship 分析（启发式、会给出数字，不是黑盒结论）：backend_health_rca 按健康检查失败类型归类原因；error_rate_rca 按 5xx 占比相对基线排序并映射主导状态码；cert_expiry_sweep 按到期天数分桶；route_conflict_analysis 找影子路由、死路由与重定向环。
写路径（有治理 harness）：本地统一审计 ~/.proxy-aiops/audit.db、策略与 token/失控预算熔断、风险分级；可逆写操作记录 undo 描述符。Caddy 支持 set_config_value / delete_config_path / load_config（高风险需 dry-run 与二次确认）；HAProxy 支持 set_server_state、set_server_weight。Traefik 目标不接受通过本技能的写操作——文档会引导你去改 provider 源配置。
凭据经 Fernet + scrypt 加密存于 ~/.proxy-aiops/secrets.enc，不落盘明文。

典型排障链：先确认 API 可达 → overview 看范围 → error_rate_rca 定位服务与主导 5xx → backend_health_rca 看上游；若是个别 HAProxy 节点问题，可 drain 并依赖 undo 回滚。

适用边界

只适用于 Traefik / Caddy / HAProxy 反向代理；防火墙/NAT 用 firewall-aiops，虚拟机、存储、集群等应路由到同系列的其它 AIops 技能。
托管云负载均衡不在范围内；技能不替你决定是否允许写操作，审计不可绕过，但授权仍取决于你连接的 API 账号权限与 Agent 判断。
HAProxy 证书到期扫描会提示教学说明（证书多在文件侧）；非 443 监听需对端口单独 sweep。