Traefik 镜像文档

镜像概述

Traefik 是一款云原生边缘路由器，专为云原生环境设计，用于处理边缘流量的路由与管理。作为云原生生态的关键组件，它支持动态配置、自动服务发现，可无缝集成各类容器编排平台与微服务架构。

环境变量配置

启动镜像时，可通过以下环境变量调整实例配置：

TRAEFIK_CONFIG_FILE

• 是否可选：是
• 作用：设置 Traefik 配置文件路径
• 默认值：/etc/traefik/traefik.yaml

TRAEFIK_ACME_FILE

• 是否可选：是
• 作用：设置 ACME 证书存储文件路径（用于 HTTPS 自动配置）
• 默认值：/etc/traefik/acme.json

使用方法

基础运行命令

bash
docker run -d --name traefik agrozyme-docker/traefik

指定自定义配置文件

若需使用自定义配置文件，可通过 TRAEFIK_CONFIG_FILE 指定路径，并挂载本地配置文件至容器内对应路径：

bash
docker run -d --name traefik \
  -e TRAEFIK_CONFIG_FILE=/custom/traefik.yaml \
  -v /path/to/local/traefik.yaml:/custom/traefik.yaml \
  agrozyme-docker/traefik

配置 ACME 证书文件

若需自定义 ACME 证书存储路径，可通过 TRAEFIK_ACME_FILE 指定，并挂载本地目录用于持久化存储证书：

bash
docker run -d --name traefik \
  -e TRAEFIK_ACME_FILE=/data/acme.json \
  -v /path/to/local/acme-dir:/data \
  agrozyme-docker/traefik

使用场景

Traefik 适用于以下云原生场景：

• Kubernetes 集群的入口控制器，管理集群内外流量
• Docker Swarm 或容器化环境的反向代理与负载均衡
• 微服务架构中的 API 网关，实现流量路由与访问控制
• 需要动态配置与自动服务发现的分布式系统

镜像来源

源码地址：[***]