Traefik Docker镜像文档

镜像概述

Traefik是一款现代HTTP反向代理和入口控制器，旨在简化微服务部署流程。作为"云原生边缘路由器"，Traefik能够与现有基础设施组件（如Kubernetes、Docker、Swarm、Consul等）无缝集成，并实现自动动态配置。只需将Traefik指向您的编排器，即可完成主要配置工作。

维护者: Traefik项目

核心功能与特性

• 自动发现：与容器编排平台和服务注册中心自动集成
• 动态配置：无需重启即可实时更新配置
• 多平台支持：兼容Docker、Kubernetes、Swarm、Consul等多种环境
• 内置仪表盘：提供直观的Web界面监控和管理路由
• HTTPS自动配置：支持ACME协议，自动生成和更新SSL证书
• 中间件支持：丰富的中间件功能，如重定向、认证、限流等
• 高可用性：支持分布式部署，确保服务持续可用

支持的标签

v3系列

• v3.5.3, 3.5.3, v3.5, 3.5, v3, 3, chabichou, latest

v2系列

• v2.11.29, 2.11.29, v2.11, 2.11, v2, 2, mimolette

支持的架构

• amd64
• arm32v6
• arm64v8
• ppc64le
• riscv64
• s390x
• windows-amd64

使用场景与适用范围

Traefik适用于以下场景：

1. 微服务架构：为多个微服务提供统一入口
2. 容器化部署：与Docker、Kubernetes等容器平台配合使用
3. 云原生应用：为云环境中的应用提供边缘路由
4. 多环境部署：在开发、测试和生产环境中统一路由配置
5. API网关：作为API服务的入口点，提供认证、限流等功能
6. 负载均衡：在多个服务实例间分配流量

使用方法与配置说明

基本配置文件格式

Traefik使用YAML或TOML格式的配置文件，基本结构包括：

• 入口点(EntryPoints)：定义监听端口和协议
• 提供者(Providers)：配置服务发现来源
• 路由(Routers)：定义请求如何被路由到服务
• 服务(Services)：定义后端服务信息
• 中间件(Middlewares)：配置请求处理链

Traefik v3使用示例

1. 创建配置文件

创建traefik.yml配置文件：

## traefik.yml

# Docker配置后端
providers:
  docker:
    defaultRule: "Host(`{{ trimPrefix `/` .Name }}.docker.localhost`)"

# API和仪表盘配置
api:
  insecure: true

2. 启动Traefik容器

docker run -d -p 8080:8080 -p 80:80 \
  -v $PWD/traefik.yml:/etc/traefik/traefik.yml \
  -v /var/run/docker.sock:/var/run/docker.sock \
  amd64/traefik:v3

3. 启动后端服务

docker run -d --name test traefik/whoami

4. 访问服务

curl test.docker.localhost

预期输出：

Hostname: 0693100b16de
IP: 127.0.0.1
IP: ::1
IP: 192.168.215.4
RemoteAddr: 192.168.215.3:57618
GET / HTTP/1.1
Host: test.docker.localhost
User-Agent: curl/8.7.1
Accept: */*
Accept-Encoding: gzip
X-Forwarded-For: 192.168.215.1
X-Forwarded-Host: test.docker.localhost
X-Forwarded-Port: 80
X-Forwarded-Proto: http
X-Forwarded-Server: 8a37fd4f35fb
X-Real-Ip: 192.168.215.1

5. 访问Traefik仪表盘

打开浏览器访问 http://localhost:8080 即可查看Traefik仪表盘，监控路由器、服务和中间件状态。

Traefik v2使用示例

1. 创建配置文件

创建traefik.yml配置文件：

## traefik.yml

# Docker配置后端
providers:
  docker:
    defaultRule: "Host(`{{ trimPrefix `/` .Name }}.docker.localhost`)"

# API和仪表盘配置
api:
  insecure: true

2. 启动Traefik容器

docker run -d -p 8080:8080 -p 80:80 \
  -v $PWD/traefik.yml:/etc/traefik/traefik.yml \
  -v /var/run/docker.sock:/var/run/docker.sock \
  amd64/traefik:v2.11

3. 启动后端服务和访问方法与v3版本相同

Docker Compose部署方案

创建docker-compose.yml文件：

version: '3'

services:
  traefik:
    image: amd64/traefik:v3
    command:
      - "--providers.docker=true"
      - "--providers.docker.defaultRule=Host(`{{ trimPrefix `/` .Name }}.docker.localhost`)"
      - "--api.insecure=true"
    ports:
      - "80:80"
      - "8080:8080"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

  whoami:
    image: traefik/whoami
    container_name: test

启动服务：

docker-compose up -d

配置参数说明

主要配置选项

环境变量

Traefik支持通过环境变量配置，格式为TRAEFIK_<SECTION>_<KEY>，例如：

• TRAEFIK_API_INSECURE=true 对应配置文件中的 api.insecure: true
• TRAEFIK_PROVIDERS_DOCKER=true 对应 providers.docker: true

文档与资源

• 官方文档：
  • v3.x版本
  • v2.11版本
• 社区支持：Traefik社区论坛
• 问题反馈：GitHub Issues

许可证信息

查看许可证信息了解本镜像包含软件的许可条款。

与所有Docker镜像一样，本镜像可能包含其他软件，这些软件可能具有不同的许可证（如基础发行版中的Bash等，以及主要软件的任何直接或间接依赖项）。

自动检测到的其他许可证信息可能位于repo-info仓库的traefik目录中。

对于任何预构建镜像的使用，镜像用户有责任确保对本镜像的任何使用符合其中包含的所有软件的相关许可证。

获取帮助

如需帮助，可通过以下渠道获取支持：

• Docker社区Slack
• Server Fault
• Unix & Linux
• Stack Overflow