Traefik 安装配置选项

安装配置选项参考

本页提供 Traefik 安装（启动）配置中所有可用选项的参考信息。

提示

完整的最新配置选项列表可在 Traefik 官方 GitHub 仓库 中找到。

使用 JSON Schema 验证你的配置：Traefik v3 JSON Schema。

主要选项分类

accesslog

控制 Traefik 的访问日志。详见 访问日志参考。

主要选项：

• accesslog.enabled - 启用访问日志
• accesslog.filepath - 日志文件路径
• accesslog.format - 日志格式（common/json/logfmt）
• accesslog.filters.statuscodes - 状态码过滤器
• accesslog.fields.defaultmode - 字段默认模式

api

配置 API 与仪表盘。详见 API & Dashboard。

主要选项：

• api.insecure - 启用不安全模式
• api.dashboard - 启用仪表盘
• api.basepath - 自定义 API 路径

certificatesresolvers

配置 TLS 证书解析器。详见 证书解析器。

主要选项：

• certificatesresolvers.<name>.acme - ACME 解析器
• certificatesresolvers.<name>.tailscale - Tailscale 解析器

entryPoints

配置入口点。详见 入口点。

主要选项：

• entryPoints.<name>.address - 监听地址
• entryPoints.<name>.http.tls - TLS 配置
• entryPoints.<name>.http.redirections - HTTP 重定向

experimental

实验性功能。详见 实验性特性。

主要选项：

• experimental.plugins - 插件
• experimental.fastproxy - FastProxy

global

全局配置选项。

主要选项：

• global.checknewversion - 检查新版本
• global.sendanonymoususage - 发送匿名使用数据

log

控制 Traefik 自身日志。详见 日志与访问日志。

主要选项：

• log.level - 日志级别
• log.format - 日志格式
• log.filepath - 日志文件路径

metrics

配置指标。详见 指标参考 和 指标指南。

主要选项：

• metrics.prometheus - Prometheus 指标
• metrics.otlp - OpenTelemetry 指标
• metrics.datadog - Datadog 指标
• metrics.influxdb2 - InfluxDB 2.X 指标
• metrics.statsD - StatsD 指标

ping

配置健康检查端点。详见 Health Check。

主要选项：

• ping.enabled - 启用 ping
• ping.entryPoint - ping 入口点

providers

配置动态配置 Provider。详见 Providers 概览。

可用 Provider：

• providers.docker
• providers.swarm
• providers.kubernetesingress
• providers.kubernetescrd
• providers.kubernetesgateway
• providers.kubernetesingressnginx
• providers.knative
• providers.ecs
• providers.nomad
• providers.consulcatalog
• providers.consul
• providers.etcd
• providers.redis
• providers.zookeeper
• providers.file
• providers.http

tracing

配置链路追踪。详见 链路追踪参考 和 链路追踪指南。

主要选项：

• tracing.otlp - OpenTelemetry 追踪
• tracing.datadog - Datadog 追踪

配置格式

Traefik 接受以下配置格式：

• YAML (.yml/.yaml) - 推荐
• TOML (.toml) - 替代选择
• CLI 参数 - 命令行覆盖
• 环境变量 - 容器化部署

注意

三种配置方式（文件、CLI、环境变量）可以混用，但不能同时为同一选项提供不同的值。

配置选项的优先级为：CLI 参数 > 环境变量 > 配置文件。

配置验证

可以使用 JSON Schema 验证你的配置：

• Traefik v3 JSON Schema

例如，在 VS Code 中，配置文件中 // $schema 注释可以启用自动验证。

完整参考

完整的最新配置选项列表，请参阅 Traefik 官方文档。

---

在生产环境使用 Traefik OSS？

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

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