本项目旨在演示如何快速上手 Traefik v3.x：包含服务动态接入、配置证书等核心功能。
如果你觉得这个例子有帮到你，欢迎点赞✨（star），如果你希望收到这个项目的更新推送，可以点击关注 👀（watch）并选择适合自己的关注模式。
- ✅ 服务动态接入：基于 Docker 标签自动发现和配置服务
- ✅ 多种证书配置：支持 ACME 自动申请证书和本地证书两种方式
- ✅ HTTP/3 支持：启用 HTTP/3 (QUIC) 协议支持
- ✅ Dashboard 界面：内置 Traefik Dashboard 可视化界面
- ✅ HTTPS 重定向：自动将 HTTP 请求重定向到 HTTPS
- ✅ GZIP 压缩：自动启用响应内容压缩
- ✅ 健康检查：内置健康检查机制
- ✅ 生产就绪：关闭匿名数据收集和版本检查，适合生产环境
traefik-v3-example/
├── scripts/ # 工具脚本目录
│ └── prepare-network.sh # 创建 Docker 网络脚本
├── traefik/ # Traefik 服务配置目录
│ ├── base/ # 基础配置（需要环境变量）
│ ├── acme/ # ACME 自动申请证书配置
│ └── local-certs/ # 使用本地证书配置
├── traefik-make-local-certs/ # 证书生成工具
├── traefik-app-examples/ # 应用集成示例目录
│ ├── flare/ # Flare 服务接入示例
│ ├── stargate/ # Stargate Forward Auth 服务示例
│ └── owlmail/ # OwlMail 邮件测试服务示例
├── README.md # 本文档（英文）
└── README.zh.md # 本文档（中文）
- Docker 20.10+
- Docker Compose 2.0+
- 基本的 Linux/Unix 命令行知识
Traefik 需要创建一个专用的 Docker 网络：
./scripts/prepare-network.sh或者手动创建：
docker network create traefik根据你的需求选择不同的配置方式：
- 参考 基础配置文档
启动成功后，访问 Traefik Dashboard：
- HTTPS:
https://traefik.example.com/dashboard/ - API:
https://traefik.example.com/api/
注意：请将
traefik.example.com替换为你配置的实际域名，并确保 DNS 解析正确。
- 基础配置：需要完整的环境变量配置，支持 ACME 和本地证书
- ACME 证书配置：使用 Let's Encrypt 自动申请证书（需要 DNS API Token）
- 本地证书配置：使用本地自签名证书，适合测试环境
- 证书生成工具：使用 certs-maker 容器生成自签名证书
- Flare 服务示例：Flare 服务接入 Traefik 的完整示例
- Stargate Forward Auth 示例：Stargate 认证服务集成示例，包含受保护服务演示
- OwlMail 邮件测试服务示例：OwlMail 邮件测试服务集成示例，支持 SMTP 和 Web 界面
- Traefik - 云原生反向代理和负载均衡器
- certs-maker - 证书生成工具
- docker-flare - Flare 服务 Docker 镜像
- Stargate - 轻量级 Forward Auth 认证服务
- OwlMail - 邮件开发和测试工具，兼容 MailDev
详见 LICENSE 文件。