Skip to content

Traefik 配置文档

配置简介

魔法是如何发生的

在 Traefik 中,"配置"一词可能指两种不同的东西:

  • 安装(启动)配置(以前称为 静态配置(static configuration)
  • 路由配置(以前称为 动态配置(dynamic configuration)

安装配置中的元素用于建立与 Provider 的连接,并定义 Traefik 将监听的入口点(这些元素通常不会频繁变化)。

路由配置则包含定义系统如何处理请求的所有内容。该配置可以变化,并且可以无缝地热加载 —— 不会中断任何请求,也不会丢失连接。

⚠️ 不兼容的配置

请注意,Traefik v1.x 的旧配置与 v2.x 配置兼容。 如果你正在运行 v2,请确保使用的是 v2 配置。

路由配置

Traefik 从 Provider 获取其路由配置:无论是编排器、服务注册中心,还是普通的配置文件。

由于此配置取决于你的基础设施选型,我们建议你参阅文档中的专有章节

快速开始示例 中,whoami 应用的路由配置来自 Docker,具体形式是附加在 whoami 容器上的一个 label。

HTTPS 证书也属于路由配置。你可以添加 / 更新 / 删除它们,而无需重启 Traefik 实例。

安装配置

定义 Traefik 安装配置有三种互斥方式(即同一时间只能使用其中一种):

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

这三种方式的评估顺序如上所列。

如果某个选项未提供值,则使用默认值。此外,如果一个选项有子选项,而其中任何一个子选项未指定,也会使用默认值。

例如,--providers.docker 选项本身就足以启用 Docker Provider,即使存在 --providers.docker.endpoint 这样的子选项。一旦设定了该选项,就会同时设置(并重置)--providers.docker 所有子选项的默认值。

配置文件

启动时,Traefik 会在以下位置搜索名为 traefik.yml(或 traefik.yamltraefik.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 网关能力既快速又无需任何迁移改造。无需推倒重来,所有配置保持不变。可以通过这个短视频 了解实际效果。

基于 MIT 协议发布