配置介绍¶
魔术是如何发生的
Traefik 中的配置可以指两个不同的方式:
- 完全动态的路由配置(称为动态配置)
- 启动配置(称为静态配置)
静态配置 中的元素设置与提供者 的连接,并定义 Traefik 将监听的入口点(这些元素不会经常更改)。
该 动态配置 包含定义是如何处理通过你的系统请求。此配置可以更改并无缝热重新加载,无需任何请求中断或连接丢失。
不兼容的配置
请注意,截至目前,Traefik v1.X 的旧配置与 v2.X 配置不兼容。 如果您正在测试 v2,请确保您使用的是 v2 配置
动态配置¶
Traefik 从提供程序providers获取其 动态配置:无论是协调器,服务注册表还是普通的旧配置文件。由于此配置特定于您的基础架构选择,因此我们邀请您参阅本文档的专用部分。
注意
在快速入门示例中,动态配置来自 docker,其形式为附加到容器的标签。
注意
HTTPS 证书也属于动态配置。您可以在不重新启动 Traefik 实例的情况下添加/更新/删除它们。
静态配置¶
在 Traefik 中有三种不同的,互斥的方式来定义静态配置选项:
- 在配置文件中
- 在命令行参数中
- 作为环境变量
这些方法按上面列出的顺序进行评估。
如果没有为给定选项提供值,则使用应用默认值。此外,如果选项具有子选项,并且未指定任何这些子选项,则也将应用默认值。
例如,即使子选项--providers.docker.endpoint
存在,--providers.docker
该选项本身也足以启用 docker 提供程序。确定,此选项设置(并重置)子选项的所有默认值--providers.docker
配置文件¶
在启动时,Traefik 搜索名为 traefik.toml(或 traefik.yml 或 traefik.yaml)的文件在以下路径:
/etc/traefik/
$XDG_CONFIG_HOME/
$HOME/.config/
.
(the working directory).
您可以使用 configFile 参数覆盖它。
traefik --configFile=foo/bar/myconfigfile.toml
参数¶
可能使用下面命令获取所有可用参数的列表:
traefik --help
# or
docker run traefik[:version] --help
# ex: docker run traefik:2.0 --help
所有可用的参数也可以在这里找到。
环境变量¶
可以在此处找到所有可用的环境变量
可用的配置选项¶
所有配置选项都记录在相关部分中。