用途：在进行 Traefik 相关变更前，先识别会影响任务的行为变化，再查阅对应主题参考，然后才编辑静态配置、动态配置、Kubernetes 资源或部署清单。参考索引分为六类：HTTP 路由与中间件（路由层级、匹配、ForwardAuth、重试、压缩、编码路径、请求头与代理行为）；Kubernetes provider（Gateway API、Ingress NGINX、EndpointSlices、CRD、Knative 与服务发现）；可观测性与 API；运维与迁移（provider 运维、插件、socket 激活、迁移风险与安全维护）；服务、健康检查与负载均衡；TLS 与 ACME。
兼容性检查要点：Kubernetes CRD 与 RBAC 需同步升级，Gateway API 安装需匹配的 CRD，各 Kubernetes provider 现通过 EndpointSlices 发现后端；CRD 升级后需重新校验清单，CEL 与正则校验更严格且 CRD 不再提供默认负载均衡策略；Ingress Prefix 路由匹配改为 Kubernetes 语义，需重测；健康检查路径只接受路径，绝对 URL 会被拒绝；defaultRuleSyntax 与 ruleSyntax 已废弃；依赖 TrustForwardHeader 的 ForwardAuth 配置需替换，转发请求体时应显式设置请求体限制；追踪默认产生更少 span，需显式设置详细度；ingress-nginx 片段仅为受限翻译，只接受解析后的白名单指令；启用不安全操作或 syscall 访问前需审查插件清单。
用法示例：多层 HTTP 路由用 parentRefs 让父路由先应用共享中间件或 TLS；根路由挂到 entryPoints 且不带 service，中间路由有子路由，叶子路由放置所选 service。中间件可挂在 HTTP service 上，使选中该服务的所有路由获得相同处理，并允许 Gateway API 过滤器作用于 HTTP 后端。重试可按状态码配置，如 attempts、initialInterval、retryOn.statusCodes、timeout。健康检查可用原生 TCP 检查或被动检查，并设置不健康探测间隔。Kubernetes 方面可启用 kubernetesIngressNginx provider 并审计注解，或启用 Knative 并限定命名空间。TLS 可禁用会话票据、启用 X25519MLKEM768、通过 ServersTransport 限制上游套件。变更后需用与目标环境相同的 provider 组合校验配置，先应用 CRD 再应用自定义资源，并检查访问日志、追踪、路由状态与仪表盘。
限制：资料未提供具体版本号、价格或平台支持范围，片段兼容并非任意原始 NGINX 配置执行层，部分策略是否可用取决于所选 provider。