mmatur/traefik

Traefik 开发环境镜像文档

镜像概述

Traefik开发环境镜像（Traefik dev image）是专为开发和测试阶段设计的Traefik专用镜像。Traefik是一款现代化的HTTP反向代理和负载均衡器，原生支持Docker、Kubernetes等容器编排平台。该开发镜像包含最新开发特性、调试工具及便捷的开发功能，适合在本地开发环境中快速搭建、测试和调试微服务架构。

核心功能与特性

• 热重载配置：无需重启容器即可实时应用配置变更，加速开发迭代效率
• 调试模式：内置调试工具，支持详细日志输出和请求跟踪，便于排查配置问题
• 最新开发特性：包含Traefik主线开发分支的最新功能，提前体验未发布特性
• 轻量级设计：基于Alpine Linux构建，镜像体积小，启动速度快
• 多平台支持：兼容Linux/amd64、Linux/arm64等主流架构
• 灵活配置：支持文件配置、命令行参数及环境变量多种配置方式

使用场景与适用范围

• 微服务架构的本地开发与联调
• Traefik配置文件的调试与验证
• 新功能特性的早期测试与评估
• 教学与学习环境中的Traefik功能演示
• CI/CD流程中的开发阶段自动化测试

使用方法与配置说明

基本运行命令

bash
# 最简单的启动方式（默认配置）
docker run -d --name traefik-dev -p 80:80 -p 8080:8080 traefik:dev

# 启用API和仪表盘（开发环境专用，生产环境禁用）
docker run -d --name traefik-dev \
  -p 80:80 \
  -p 8080:8080 \
  traefik:dev \
  --api.insecure=true \
  --providers.docker=true \
  --providers.docker.exposedbydefault=false

挂载自定义配置文件

bash
# 创建配置文件目录
mkdir -p ./traefik-config

# 创建基础配置文件 traefik.yml
cat > ./traefik-config/traefik.yml << EOF
api:
  insecure: true  # 开发环境允许不安全访问API
  dashboard: true # 启用Web仪表盘
providers:
  file:
    directory: /etc/traefik/conf.d
    watch: true   # 启用文件配置热重载
entryPoints:
  web:
    address: ":80"
EOF

# 运行容器并挂载配置目录
docker run -d --name traefik-dev \
  -p 80:80 \
  -p 8080:8080 \
  -v $(pwd)/traefik-config:/etc/traefik \
  traefik:dev

调试模式配置

bash
# 启用调试模式和详细日志
docker run -d --name traefik-dev \
  -p 80:80 \
  -p 8080:8080 \
  -e TRAEFIK_LOG_LEVEL=DEBUG \
  -e TRAEFIK_DEBUG=true \
  traefik:dev \
  --api.insecure=true \
  --log.level=DEBUG \
  --debug=true

环境变量说明

docker-compose配置示例

yaml
version: '3.8'

services:
  traefik:
    image: traefik:dev
    container_name: traefik-dev
    ports:
      - "80:80"       # HTTP入口点
      - "8080:8080"   # API和仪表盘端口
    volumes:
      - ./traefik-config:/etc/traefik  # 挂载配置目录
      - /var/run/docker.sock:/var/run/docker.sock  # 允许访问Docker守护进程
    command:
      - "--api.insecure=true"
      - "--providers.docker=true"
      - "--providers.docker.exposedbydefault=false"
      - "--providers.file.directory=/etc/traefik/conf.d"
      - "--providers.file.watch=true"
      - "--log.level=DEBUG"
    environment:
      - TRAEFIK_DEBUG=true
    restart: unless-stopped

注意事项

• 该镜像仅用于开发和测试环境，禁止在生产环境中使用
• 调试模式和不安全API访问会带来安全风险，仅在可信环境中启用
• 开发镜像可能包含不稳定特性，建议定期更新镜像以获取最新修复
• 生产环境请使用Traefik官方稳定版本镜像（traefik:vX.Y.Z）

配置文件示例（traefik.yml）

yaml
# 基础配置示例
api:
  insecure: true
  dashboard: true
  debug: true

log:
  level: DEBUG
  format: json

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

providers:
  docker:
    endpoint: "unix:///var/run/docker.sock"
    exposedByDefault: false
  file:
    directory: "/etc/traefik/conf.d"
    watch: true

middlewares:
  redirect-to-https:
    redirectScheme:
      scheme: https