如何暴露Traefik服务状态为HTTP端点供CDN健康检查使用

Traefik默认自带的/ping端点只能检测Traefik进程本身的存活状态，无法反映后端负载节点的健康情况，你可以通过以下三种方式实现面向CDN的聚合健康检测能力：

方案1：基于Metrics的轻量聚合（生产推荐） #

这是落地成本最低、逻辑可控性最强的方案：

• 首先在Traefik静态配置中开启Prometheus metrics采集，默认会在管理端口（通常是8082）暴露/metrics端点
• 指标traefik_service_server_up会实时标记每个后端节点的健康状态：值为1代表节点正常承接流量，值为0代表节点被健康检查判定为异常、已被移出负载池
• 部署一个极简的聚合服务（可以是sidecar容器、或者独立的轻量脚本），逻辑如下：
  • 定时拉取本地Traefik的/metrics接口
  • 筛选出你需要检测的所有业务Service对应的指标值
  • 按照你设定的阈值判断服务整体可用性：比如要求Service下至少有1个健康节点就判定为可用，或者要求健康节点占比高于50%才判定可用
  • 满足可用性阈值时返回HTTP 200，不满足时返回HTTP 503
• 把这个聚合服务的HTTP端点作为CDN的健康检查地址即可

极简聚合脚本示例：

from prometheus_client.parser import text_string_to_metric_families
import requests
from http.server import HTTPServer, BaseHTTPRequestHandler

# 配置项：替换为你需要检测的Traefik Service名称
CHECK_SERVICES = {"backend-a-service", "backend-b-service"}
TRAEFIK_METRICS_URL = "http://127.0.0.1:8082/metrics"
HEALTH_PORT = 8090
MIN_HEALTHY_NODE = 1 # 每个服务至少1个健康节点即判定整体可用

class CDNHealthHandler(BaseHTTPRequestHandler):
    def do_GET(self):
        if self.path != "/cdn-health":
            self.send_response(404)
            self.end_headers()
            return
        try:
            metrics_resp = requests.get(TRAEFIK_METRICS_URL, timeout=2)
            healthy_count = {svc:0 for svc in CHECK_SERVICES}
            for family in text_string_to_metric_families(metrics_resp.text):
                if family.name == "traefik_service_server_up":
                    for sample in family.samples:
                        svc = sample.labels.get("service")
                        if svc in CHECK_SERVICES and sample.value == 1:
                            healthy_count[svc] += 1
            all_available = all(cnt >= MIN_HEALTHY_NODE for cnt in healthy_count.values())
            self.send_response(200 if all_available else 503)
            self.end_headers()
            self.wfile.write(b"Service Healthy" if all_available else b"Service Unhealthy")
        except Exception as e:
            self.send_response(503)
            self.end_headers()
            self.wfile.write(b"Traefik unreachable")

if __name__ == "__main__":
    HTTPServer(("0.0.0.0", HEALTH_PORT), CDNHealthHandler).serve_forever()

方案2：基于Traefik原生路由的零代码方案 #

如果你不想额外开发聚合逻辑，可以直接利用Traefik本身的负载均衡健康检查能力实现：

• 给所有后端Service配置主动健康检查规则，Traefik会自动将异常节点移出负载池
• 新增一个专门用于CDN健康检测的聚合Service，把所有需要检测的后端节点都加入这个Service的后端池，配置和业务Service一致的健康检查规则
• 给这个聚合Service绑定一个专门的路由（比如单独的路径），作为CDN的健康检查地址
• 当所有后端节点都异常时，Traefik会自动给这个路由返回503状态码；只要还有至少1个节点健康，Traefik就会正常转发请求返回200，刚好匹配CDN流量调度的判定逻辑

配置示例：

# 动态路由配置
http:
  services:
    cdn-health-check-svc:
      loadBalancer:
        servers:
          - url: "http://backend-a/"
          - url: "http://backend-b/"
        healthCheck:
          path: /your-backend-health-path # 替换为后端服务本身的健康检查路径
          interval: 10s
          timeout: 3s
  routers:
    cdn-health:
      rule: "Path(`/__cdn_health`)"
      service: cdn-health-check-svc
      entryPoints:
        - web

注意：这个方案无法感知部分节点故障的场景，只要有节点存活就会返回200，不适合需要精细感知节点冗余度的场景，但完全满足CDN切流的需求。

方案3：基于Traefik API的聚合方案 #

开启Traefik的API能力后，可以通过/api/http/services接口拿到所有Service的完整状态，其中会明确标记每个后端节点的up/down状态。你可以参考方案1的逻辑，拉取API返回的JSON数据做状态聚合，返回对应状态码即可。

安全提示：不要将Traefik的原生API直接暴露到公网，所有自定义健康检查端点都需要配置访问控制，仅允许CDN的回源IP段访问。

内容的提问来源于stack exchange，提问作者Filip