配置介绍¶

神奇功能如何实现

Traefik 中的配置可以指两种不同的内容：

• 安装（启动）配置（原称为_静态配置_）
• 路由配置（原称为_动态配置_）

_安装配置_中的元素负责建立与提供者的连接，并定义 Traefik 监听的入口点（这些元素通常不会频繁变化）。

_路由配置_包含定义系统如何处理请求的全部内容。 这类配置可以更改，并通过无缝热重载生效，不会中断请求或导致连接丢失。

路由配置¶

Traefik 从提供者获取_路由配置_：提供者可以是编排器、服务注册中心，也可以是普通配置文件。

由于这类配置取决于您所选择的基础设施，请参阅本文档的专门章节。

安装配置¶

Traefik 有三种互斥的安装配置选项定义方式（即同一时间只能使用一种）：

1. 在配置文件中定义
2. 在命令行参数中定义
3. 通过环境变量定义

这些方式按上述顺序进行求值。

如果某个选项未提供值，则使用默认值。 此外，如果某个选项具有子选项，任何未指定的子选项也会使用默认值。

例如，单独设置 --providers.docker 选项就足以启用 Docker 提供者，即使存在 --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

# or

docker run traefik[:version] --help
# ex: docker run traefik:v3.7 --help

有关所有可用参数的概览，请查看 CLI 参考。

环境变量¶

所有可用环境变量都列在安装配置环境变量概览中。

可用配置选项¶

所有配置选项都在相应章节中有详细说明。

您可以浏览菜单中的可用功能、提供者或路由章节，了解它们的实际用法。