Traefik 在 Docker 服务中的使用指南
1. 快速部署 Traefik
通过 Docker Compose 启动 Traefik,并配置基础路由与 HTTPS:
# docker-compose.yml
version: '3'
services:
traefik:
image: traefik:v2.10
command:
- --providers.docker=true # 启用 Docker 服务发现
- --entrypoints.web.address=:80 # HTTP 入口
- --entrypoints.websecure.address=:443 # HTTPS 入口
- --certificatesresolvers.le.acme.email=admin@example.com # Let's Encrypt 邮箱
- --certificatesresolvers.le.acme.storage=/acme.json # 证书存储路径
- --certificatesresolvers.le.acme.httpchallenge.entrypoint=web # HTTP 验证方式
ports:
- "80:80"
- "443:443"
volumes:
- /var/run/docker.sock:/var/run/docker.sock # 允许 Traefik 监听 Docker 事件
- ./acme.json:/acme.json # 持久化证书
networks:
- traefik-net
networks:
traefik-net:
driver: bridge
启动命令:
docker-compose up -d
2. 部署示例 Web 服务
为 Web 服务添加 Traefik 路由规则,自动启用 HTTPS:
# docker-compose.yml(追加)
services:
whoami:
image: traefik/whoami # 官方测试镜像
labels:
- "traefik.enable=true"
- "traefik.http.routers.whoami.rule=Host(`whoami.example.com`)" # 域名绑定
- "traefik.http.routers.whoami.entrypoints=websecure" # 强制 HTTPS
- "traefik.http.routers.whoami.tls.certresolver=le" # 自动申请证书
networks:
- traefik-net
验证 HTTPS:
curl -k https://whoami.example.com # 应返回容器信息
3. 常用功能配置示例
3.1 基础认证(Basic Auth)
为服务添加访问控制:
# docker-compose.yml(追加)
services:
dashboard:
image: traefik/whoami
labels:
- "traefik.enable=true"
- "traefik.http.routers.dashboard.rule=Host(`dashboard.example.com`)"
- "traefik.http.routers.dashboard.middlewares=auth"
- "traefik.http.middlewares.auth.basicauth.users=admin:$apr1$9C...(htpasswd生成值)"
3.2 路径重写
将 /api/* 请求转发到后端服务的 / 路径:
labels:
- "traefik.http.middlewares.stripprefix.stripprefix.prefixes=/api"
- "traefik.http.routers.myapi.rule=Host(`api.example.com`) && PathPrefix(`/api`)"
- "traefik.http.routers.myapi.middlewares=stripprefix"
3.3 流量权重分配
实现金丝雀发布(需定义多个服务):
services:
app-v1:
image: myapp:v1
labels:
- "traefik.http.services.app-v1.loadbalancer.server.port=8080"
- "traefik.http.routers.app.rule=Host(`app.example.com`)"
- "traefik.http.services.app.loadbalancer.servers=app-v1:90,app-v2:10"
app-v2:
image: myapp:v2
labels:
- "traefik.http.services.app-v2.loadbalancer.server.port=8080"
4. 监控与日志
4.1 启用 Prometheus 监控
# Traefik 服务追加配置
command:
- --metrics.prometheus=true
- --metrics.prometheus.entrypoint=metrics
- --entrypoints.metrics.address=:8080
4.2 结构化日志
command:
- --log.format=json
- --log.filePath=/var/log/traefik.log
核心优势总结
| 特性 | Docker + Traefik 实现方案 |
|---|---|
| 自动服务发现 | 监听 Docker 事件,新容器启动时自动创建路由 |
| 零配置 HTTPS | 自动为域名申请 Let’s Encrypt 证书 |
| 动态中间件 | 通过标签定义认证、限流、重试等逻辑 |
| 流量管理 | 容器标签直接配置权重分流、路径重写 |
完整流程图:
附录
下一篇文章介绍:
Traefik 在 Docker 中的全场景配置指南,从基础路由到企业级高阶用法,覆盖 12 种核心场景,提供开箱即用的 Docker Compose 配置模板。
982



被折叠的 条评论
为什么被折叠?



