Traefik 健康检查文档

CLI & Ping（健康检查）

检查 Traefik 实例的健康状况。

CLI

CLI 可用于向 /ping 端点发出请求以检查 Traefik 的健康状况。如果 Traefik 健康，退出状态码为 0，否则为 1。

这可以与 HEALTHCHECK 指令或任何其他健康检查编排机制一起使用。

用法

traefik healthcheck [command] [flags] [arguments]

示例：

$ traefik healthcheck
OK: http://:8082/ping

Ping 端点

/ping 健康检查 URL 通过命令行 --ping 或配置文件选项 [ping] 启用。

/ping 活动所在的入口点可以通过 entryPoint 选项自定义，默认值为 traefik（端口 8080）。

路径	方法	描述
/ping	GET, HEAD	用于检查 Traefik 进程存活的端点。返回状态码 200，内容为：OK

配置示例

YAML 格式：

ping:
  entryPoint: "traefik"

TOML 格式：

[ping]
  entryPoint = "traefik"

CLI 格式：

--ping
--ping.entrypoint=traefik

Helm Chart Values：

ping:
  enabled: true
  entryPoint: traefik

适用场景

• 容器健康检查：在 Docker 中使用 HEALTHCHECK
• Kubernetes 探针：作为 Kubernetes liveness/readiness 探针
• 负载均衡器健康检查：在 AWS ELB、HAProxy 等前面
• 监控告警：作为健康监控的端点

最佳实践

1. 使用专用入口点：在内部接口启用 ping，不要暴露在公网
2. 配置多个健康检查点：除了 ping，还可以使用 metrics 端点
3. 监控 ping 状态：将 ping 状态接入监控告警

---

在生产环境使用 Traefik OSS？

如果你在工作中使用 Traefik，可以考虑为其添加企业级 API 网关能力或获取 Traefik OSS 的商业支持。

• 观看我们的 API 网关演示视频
• 申请 24/7/365 OSS 支持