Configuration Introduction

魔术如何发生

Configuration

Traefik中的配置可以引用两种不同的内容:

  • 完全动态路由配置(称为动态配置
  • 启动配置(称为静态配置

静态配置中的元素建立到提供程序的连接,并定义Traefik将侦听的入口点(这些元素不会经常更改).

动态配置包含定义系统如何​​处理请求的所有内容. 此配置可以更改,并且可以无缝地热加载,而不会导致任何请求中断或连接丢失.

不兼容的配置

请注意,截至目前,Traefik v1.x的旧配置与v2.x配置不兼容. 如果您正在运行v2,请确保您使用的是v2配置.

The Dynamic Configuration

Traefik从提供者那里获取其动态配置 :协调器,服务注册表还是普通的旧配置文件.

由于此配置特定于您的基础结构选择,因此我们邀请您参考本文档专用部分 .

在" 快速入门"示例中 ,动态配置来自docker,以标签形式附加在容器上.

HTTPS证书也属于动态配置.

您可以添加/更新/删除它们,而无需重新启动Traefik实例.

The Static Configuration

有三种不同的互斥方式 (例如,您只能同时使用一种),可以在Traefik中定义静态配置选项:

  1. 在配置文件中
  2. 在命令行参数
  3. 作为环境变量

这些方法按上面列出的顺序进行评估.

如果没有为给定选项提供任何值,那么将应用默认值. 此外,如果选项具有子选项,并且未指定任何这些子选项,则默认值也将适用.

例如,-- --providers.docker选项本身足以启用--providers.docker提供程序,即使存在--providers.docker.endpoint类的子选项. 定位后,此选项将设置(并重置)-- --providers.docker子选项的所有默认值.

Configuration File

启动时,Traefik在以下位置搜索名为traefik.toml (或traefik.ymltraefik.yaml )的文件:

  • /etc/traefik/
  • $XDG_CONFIG_HOME/
  • $HOME/.config/
  • . (工作目录).

您可以使用configFile参数覆盖它.

traefik --configFile=foo/bar/myconfigfile.toml

Arguments

要获取所有可用参数的列表:

traefik --help

# or

docker run traefik[:version] --help
# ex: docker run traefik:2.0 --help

所有可用的参数也可以在此处找到.

Environment Variables

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

Available Configuration Options

所有配置选项均在其相关部分中记录.

您可以浏览菜单, 提供程序路由部分中的可用功能,以查看它们的作用.