跳到正文
Træfɪk

数据收集

了解 Traefik 共享的数据及其用途

简介

保护用户隐私对 Traefik Labs 至关重要,因此我们在设计每种数据共享机制时都坚持透明和最小化原则。 本页介绍 Traefik 交换的两类数据以及相应配置方式。

关于数据处理方式的更多详情,请参阅隐私与 Cookie 政策。

配置概览

Traefik 提供两种相互独立的机制:

  • checkNewVersion 默认启用,你可以随时关闭。
  • sendAnonymousUsage 需要显式选择启用。

以下示例展示如何启用或关闭这两种机制。

global:
  checkNewVersion: true      # set to false to disable
  sendAnonymousUsage: false  # set to true to enable
[global]
  checkNewVersion = true      # set to false to disable
  sendAnonymousUsage = false  # set to true to enable
--global.checkNewVersion=true      # set to false to disable
--global.sendAnonymousUsage=false  # set to true to enable

启动时的日志会明确指出这两个选项各自是启用还是关闭。

版本检查(checkNewVersion)——默认启用,可退出

Traefik 会定期联系 update.traefik.io,检查是否有更新的版本。 发出请求时,Traefik 会共享实例的运行版本和公网 IP。 IP 用于构建全局使用统计,不影响版本比较。

这项机制帮助你及时了解更新,也让 TraefikLabs 大致了解实际部署中的版本分布。

收集到的 IP 地址还会用于营销,具体包括识别正在运行 Traefik 的企业,并向它们提供适合的支持合同、企业功能和定制服务。

如果想了解实现,可以阅读版本检查源码:version.go。

匿名使用数据(sendAnonymousUsage)——主动选择启用

Traefik 还可以从启动后 10 分钟开始,每天收集一次匿名使用统计。 这些统计包括:

  • Traefik 版本;
  • 配置的哈希值;
  • 匿名化后的静态配置(移除所有敏感字段,包括令牌、密码、URL、IP 地址、域名、电子邮件地址等)。

这项功能源自这份公开提案。

这些信息帮助 TraefikLabs 了解 Traefik 的总体使用方式,从而安排功能和提供者支持的优先级。动态配置(路由器和服务)绝不会被收集。

启用数据收集

global:
  # Send anonymous usage data
  sendAnonymousUsage: true
[global]
  # Send anonymous usage data
  sendAnonymousUsage = true
# Send anonymous usage data
--global.sendAnonymousUsage

提示

  • 我们不收集动态配置信息(路由器和服务)。
  • 我们不会将此类数据用于投放广告计划。
  • 我们不会将此类数据出售给第三方。

收集数据示例

entryPoints:
  web:
  address: ":80"

api: {}

providers:
  docker:
    endpoint: "tcp://10.10.10.10:2375"
    exposedByDefault: true

    tls:
      ca: dockerCA
      cert: dockerCert
      key: dockerKey
      insecureSkipVerify: true
entryPoints:
  web:
  address: ":80"

api: {}

providers:
  docker:
    endpoint: "xxxx"
    exposedByDefault: true

    tls:
      ca: xxxx
      cert: xxxx
      key: xxxx
      insecureSkipVerify: true

匿名使用数据收集源码

如果想了解实现,可以阅读收集器源码: collector.go。

Traefik 默认会匿名化所有配置字段,只有显式标注 export=true 的字段除外。


版权所有 © 头文件软件工作室

文档由 HeadFile Studio 翻译。

Traefik v3.7 中文快照 · 原文版权归 Traefik Labs 及贡献者所有 · MIT 许可证