Skip to content

配置介绍

魔术是如何发生的

Configuration

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

所有可用的参数也可以在这里找到。

环境变量

可以在此处找到所有可用的环境变量

可用的配置选项

所有配置选项都记录在相关部分中。

您可以浏览菜单,提供程序路由部分中的可用功能,以查看它们的运行情况。