Traefik 配置文档
配置简介
魔法是如何发生的
在 Traefik 中,"配置"一词可能指两种不同的东西:
- 安装(启动)配置(以前称为 静态配置(static configuration))
- 路由配置(以前称为 动态配置(dynamic configuration))
安装配置中的元素用于建立与 Provider 的连接,并定义 Traefik 将监听的入口点(这些元素通常不会频繁变化)。
路由配置则包含定义系统如何处理请求的所有内容。该配置可以变化,并且可以无缝地热加载 —— 不会中断任何请求,也不会丢失连接。
⚠️ 不兼容的配置
请注意,Traefik v1.x 的旧配置与 v2.x 配置不兼容。 如果你正在运行 v2,请确保使用的是 v2 配置。
路由配置
Traefik 从 Provider 获取其路由配置:无论是编排器、服务注册中心,还是普通的配置文件。
由于此配置取决于你的基础设施选型,我们建议你参阅文档中的专有章节。
在快速开始示例 中,whoami 应用的路由配置来自 Docker,具体形式是附加在 whoami 容器上的一个 label。
HTTPS 证书也属于路由配置。你可以添加 / 更新 / 删除它们,而无需重启 Traefik 实例。
安装配置
定义 Traefik 安装配置有三种互斥方式(即同一时间只能使用其中一种):
- 在配置文件中
- 在命令行参数中
- 作为环境变量
这三种方式的评估顺序如上所列。
如果某个选项未提供值,则使用默认值。此外,如果一个选项有子选项,而其中任何一个子选项未指定,也会使用默认值。
例如,--providers.docker 选项本身就足以启用 Docker Provider,即使存在 --providers.docker.endpoint 这样的子选项。一旦设定了该选项,就会同时设置(并重置)--providers.docker 所有子选项的默认值。
配置文件
启动时,Traefik 会在以下位置搜索名为 traefik.yml(或 traefik.yaml 或 traefik.toml)的安装配置文件:
/etc/traefik/$XDG_CONFIG_HOME/$HOME/.config/.(当前工作目录)
你可以使用 configFile 参数覆盖此行为:
traefik --configFile=foo/bar/myconfigfile.yml命令行参数
要获取所有可用参数的列表:
traefik --help
# 或者
docker run traefik[:version] --help
# 例如:docker run traefik:v3.7 --help完整的可用参数请参阅 CLI 参考。
环境变量
所有可用的环境变量可以在安装配置环境变量概览 中找到。
可用的配置选项
所有配置选项都在其所属章节中进行了文档化。你可以在菜单中浏览可用功能,或者在 Provider 与路由章节 中查看它们的实际应用。
在生产环境使用 Traefik OSS?
如果你在工作中使用 Traefik,可以考虑为其添加企业级 API 网关能力或获取 Traefik OSS 的商业支持。
为 Traefik OSS 添加 API 网关能力既快速又无需任何迁移改造。无需推倒重来,所有配置保持不变。可以通过这个短视频 了解实际效果。