启动环境¶

Traefik Proxy 的配置分为两大类：

安装配置：（原称静态配置）定义修改后需要重启 Traefik 的参数，包括入口点、提供者、API/仪表板设置以及日志级别。
路由配置：（原称动态配置）包含无需重启 Traefik 即可更新的元素，例如路由器、服务和中间件。

本节重点介绍安装配置的设置，这是 Traefik 初次启动所必需的配置。

配置方式¶

Traefik 提供多种定义安装配置的方式。

注意

必须选择一种方式并始终使用该方式，因为不支持混合使用不同的配置方式，否则可能导致意外行为。

以下是配置 Traefik 代理的可用方式：

文件
CLI
环境变量
Helm

文件¶

可以在文件中使用 YAML 或 TOML 等格式定义安装配置。

配置示例¶

traefik.yml (YAML)

entryPoints:
  web:
    address: ":80"
  websecure:
    address: ":443"

providers:
  docker: {}

api:
  dashboard: true

log:
  level: INFO

traefik.toml (TOML)

[entryPoints]
  [entryPoints.web]
    address = ":80"

  [entryPoints.websecure]
    address = ":443"

[providers]
  [providers.docker]

[api]
  dashboard = true

[log]
  level = "INFO"

配置文件¶

启动时，Traefik 会在以下目录中查找名为 traefik.yml（或 traefik.yaml、traefik.toml）的文件以读取安装配置：

/etc/traefik/
$XDG_CONFIG_HOME/
$HOME/.config/
.（当前工作目录）。

可以使用 configFile 参数覆盖此行为，如下所示：

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

CLI¶

使用 CLI 时，可以在启动 Traefik 时直接通过命令行参数传入安装配置。

配置示例¶

CLI

traefik \
  --entryPoints.web.address=":80" \
  --entryPoints.websecure.address=":443" \
  --providers.docker \
  --api.dashboard \
  --log.level=INFO

环境变量¶

也可以通过环境变量设置安装配置。每个选项对应一个以 TRAEFIK_ 为前缀的环境变量。

配置示例¶

ENV

TRAEFIK_ENTRYPOINTS_WEB_ADDRESS=":80" TRAEFIK_ENTRYPOINTS_WEBSECURE_ADDRESS=":443" TRAEFIK_PROVIDERS_DOCKER=true TRAEFIK_API_DASHBOARD=true TRAEFIK_LOG_LEVEL="INFO" traefik

Helm¶

在 Kubernetes 集群中使用 Helm 部署 Traefik Proxy 时，安装配置在 values.yaml 文件中定义。

可以在 GitHub 上找到 Traefik 官方 Helm Chart

配置示例¶

values.yaml

ports:
  web:
    exposedPort: 80
  websecure:
    exposedPort: 443

additionalArguments:
  - "--providers.kubernetescrd.ingressClass=traefik"
  - "--log.level=INFO"

Helm 命令

helm repo add traefik https://traefik.github.io/charts
helm repo update
helm install traefik traefik/traefik -f values.yaml