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适用于以下场景：

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

使用方法与配置说明

基本配置文件格式

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

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

Traefik v3使用示例

1. 创建配置文件

创建traefik.yml配置文件：

yaml
## traefik.yml

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

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

2. 启动Traefik容器

bash
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. 启动后端服务

bash
docker run -d --name test traefik/whoami

4. 访问服务

bash
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配置文件：

yaml
## traefik.yml

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

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

2. 启动Traefik容器

bash
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文件：

yaml
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

启动服务：

bash
docker-compose up -d

配置参数说明

主要配置选项

配置项	描述	示例值
`providers.docker`	启用Docker提供者	`true`
`providers.docker.defaultRule`	默认路由规则	`Host(`{{ .Name }}.localhost`)`
`api.insecure`	启用不安全的API访问	`true`
`api.dashboard`	启用仪表盘	`true`
`entryPoints.web.address`	HTTP入口点	`:80`
`entryPoints.websecure.address`	HTTPS入口点	`:443`
`certificatesResolvers.le.acme.email`	ACME***	`***`
`certificatesResolvers.le.acme.storage`	证书存储路径	`/acme.json`