CLI 与 Ping¶

检查 Traefik 实例的健康状态

CLI¶

可以使用 CLI 向 /ping 端点发送请求，检查 Traefik 的健康状态。Traefik 健康时退出状态为 0，否则为 1。

可以与 HEALTHCHECK 指令或其他健康检查编排机制配合使用。

用法¶

traefik healthcheck [command] [flags] [arguments]

示例：

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

Ping¶

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

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

路径	方法	说明
`/ping`	`GET`, `HEAD`	检查 Traefik 进程是否存活的端点。返回状态码 `200`，内容为 `OK`

配置示例¶

启用 API 处理器：

文件 (YAML)

ping: {}

文件 (TOML)

[ping]

CLI

--ping=true

配置选项¶

字段	说明	默认值	必填
`ping.entryPoint`	在专用入口点上启用 `/ping`。	traefik	否
`ping.manualRouting`	设为 `true` 时禁用默认内部路由器，以便为 `ping@internal` 服务创建自定义路由器。	false	否
`ping.terminatingStatusCode`	定义优雅关闭期间 ping 处理器使用的状态码。更多信息参见此处	503	否

`terminatingStatusCode`¶

Traefik 优雅关闭期间，ping 处理器默认返回 503 状态码。
例如，当 Traefik 位于执行健康检查的负载均衡器之后（如 Kubernetes LivenessProbe）时，可能需要另一个状态码作为优雅终止的信号。
此时，可以使用 terminatingStatusCode 设置 ping 处理器在终止期间返回的状态码。