云服务器上安装Traefik的完整指南：从零开始配置反向代理

一、准备工作

在开始安装前，我们需要确保云服务器环境准备就绪：

• 1. 一台运行中的云服务器（推荐配置：1核CPU/2GB内存）
• 2. 已安装Docker环境（版本18.06+）
• 3. 开放80和443端口（Web服务标准端口）
• 4. 域名解析到服务器IP（可选，用于HTTPS配置）

二、Docker方式安装Traefik

这是最简单快捷的安装方式：

# 创建Traefik专用网络
docker network create traefik-net

# 运行Traefik容器
docker run -d \
  --name traefik \
  --network traefik-net \
  -p 80:80 \
  -p 443:443 \
  -p 8080:8080 \  # 管理界面端口
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v $PWD/traefik.yml:/etc/traefik/traefik.yml \
  traefik:v2.10

三、配置文件详解

创建traefik.yml配置文件：

# 全局配置
global:
  checkNewVersion: true
  sendAnonymousUsage: false

# 日志配置
log:
  level: INFO
  format: common

# 入口点配置
entryPoints:
  web:
    address: ":80"
  websecure:
    address: ":443"

# 提供者配置
providers:
  docker:
    endpoint: "unix:///var/run/docker.sock"
    exposedByDefault: false
  file:
    filename: "/etc/traefik/dynamic_conf.yml"
    watch: true

# API配置
api:
  dashboard: true
  insecure: true

四、动态配置设置

创建dynamic_conf.yml文件：

http:
  routers:
    dashboard:
      rule: Host(`traefik.yourdomain.com`) || PathPrefix(`/api`) || PathPrefix(`/dashboard`)
      service: api@internal
      middlewares:
        - auth

  middlewares:
    auth:
      basicAuth:
        users:
          - "admin:$apr1$9Cv/OMGj$ZomWQzuQbL.3RNS5H.lAl/"

五、HTTPS配置（Let's Encrypt）

要启用自动HTTPS，需修改traefik.yml：

certificatesResolvers:
  myresolver:
    acme:
      email: [email protected]
      storage: acme.json
      httpChallenge:
        entryPoint: web

六、部署应用示例

部署一个简单的whoami服务：

docker run -d \
  --name whoami \
  --network traefik-net \
  --label "traefik.enable=true" \
  --label "traefik.http.routers.whoami.rule=Host(`whoami.yourdomain.com`)" \
  --label "traefik.http.routers.whoami.tls.certresolver=myresolver" \
  containous/whoami

七、常见问题解决

• 端口冲突：确保80/443端口未被占用
• 证书问题：检查DNS解析和ACME配置
• 权限问题：Docker.sock需要正确权限
• 性能调优：高并发场景需调整timeout设置

八、进阶配置建议

生产环境还需考虑：

• 1. 启用访问日志分析
• 2. 配置速率限制中间件
• 3. 设置健康检查端点
• 4. 集成Prometheus监控
• 5. 多节点集群部署