让traefik代替你的 waf（使用CrowdSec）+ nginx + acme.sh + mtls-auth

traefik 可以帮你：

自动续证书
反代（自动处理 ws、tls 证书、反代地址、压缩 etc.）
使用插件代替 waf
负载均衡（可以使用多个后端、k8s）
支持 mTLS 认证（如果你使用的是 Cloudflare 的 CDN）

前言

本文是对traefik的一个简单介绍，主要介绍如何使用 traefik 来代替 waf（使用 CrowdSec）、nginx、acme.sh、mtls-auth 等。

traefik会是你服务器的入口，所有的请求都会先经过 traefik，然后再转发到后端服务。

后端服务也不用配置绑定的端口和ip了（例如docker.port: 127.0.0.1:8080:8080，然后nginx反代，每个服务都要记住端口很麻烦），traefik 会自动处理。

Note (info)

主要贴出配置，注意多看注释

Warning (IMPORTANT)

CrowdSec 的工作原理之后会说

Note (info)

简单说一下 mtls 的好处

如果其他人通过你的域名扫描全网 ip，没有 mtls 很容易就扫到你的服务器 ip 了，然后被定点攻击
如果你使用了 mtls 认证，其他人就算扫到你的 ip 也无法访问你的服务，除非他有 cf 的客户端证书，这个只有 cf 有私钥，无法伪造

traefik 配置

此项配置了之后可以

自动帮你续证书
如果你用的是 cf 的 cdn，还可以自动 mtls 认证。
使用 CrowdSec 作为 WAF（之后再配置 CrowdSec）
扫 443 和 80 端口的请求直接丢弃

1
traefik/
2
├── acme.json
3
├── docker-compose.yml
4
├── cf-cert/
5
│   └── cloudflare-ca.pem
6
├── dynamic_conf/
7
│   ├── ban.html
8
│   ├── cloudflare-mtls.yml
9
│   ├── compressor.yml
10
│   ├── crowdsec-middleware.yml
11
│   └── drop-ip-access.yml
12
└── logs/
13
    └── traefik.log

Warning (ERROR)

ban.html 我就不贴了，需要的自己 ai 写一个

Warning (IMPORTANT)

如果要自动帮你续证书，记得acme.json的权限要设置为600，否则 traefik 无法写入证书。
如果你使用的是 cf 的 cdn，记得在添加你的 cf 证书。到这里下载证书。
记得事先创建traefik-net网络，或者在docker-compose.yml中注释掉网络部分。

1
services:
2
  traefik:
3
  image: traefik:latest # 建议使用明确的版本号，而不是 latest。现在用的是 v3
4
  container_name: traefik
5
  restart: unless-stopped
6

7
  # --- 静态配置：通过 command 而不是文件 ---
8
  command:
9
    - '--entrypoints.websecure.http.middlewares=crowdsec-bouncer@file,global-compressor@file'
10
    # --- CrowdSec 插件配置 ---
11
    - '--experimental.plugins.crowdsec-bouncer-traefik-plugin.modulename=github.com/maxlerebourg/crowdsec-bouncer-traefik-plugin'
12
    - '--experimental.plugins.crowdsec-bouncer-traefik-plugin.version=v1.4.4'
13
    # --- API 和仪表盘 ---
14
    # - "--api.dashboard=true" # 启用仪表盘
15
    # # 警告：下面的 insecure=true 仅用于开发环境，方便通过 8080 端口访问。生产环境请务必通过安全路由暴露。
16
    # - "--api.insecure=true"
17

18
    # --- 入口点定义 ---
19
    - '--entrypoints.web.address=:80' # 定义 HTTP 入口点，监听80端口
20
    - '--entrypoints.websecure.address=:443' # 定义 HTTPS 入口点，监听443端口
21

22
    # --- Cloudflare IPs ---
23
    - '--entrypoints.web.forwardedheaders.trustedips=173.245.48.0/20,103.21.244.0/22,103.22.200.0/22,103.31.4.0/22,141.101.64.0/18,108.162.192.0/18,190.93.240.0/20,188.114.96.0/20,197.234.240.0/22,198.41.128.0/17,162.158.0.0/15,104.16.0.0/13,104.24.0.0/14,172.64.0.0/13,131.0.72.0/22'
24

25
    # --- Docker Provider 配置 ---
26
    - '--providers.docker=true' # 启用 Docker 服务发现
27
    - '--providers.docker.exposedbydefault=false' # 默认不暴露任何容器，更安全
28
    - '--providers.docker.network=traefik-net' # 指定Traefik监听哪个网络
29

30
    #配置log
31
    - '--log.level=DEBUG' # 设置日志级别为DEBUG
32
    - '--log.filePath=/var/log/traefik.log' # 设置日志文件路径
33
    # - "--log.format=json" # 设置日志格式为JSON，便于后续处理
34

35
    # --- 文件 Provider 配置 ---
36
    - '--providers.file=true' # 启用文件提供者
37
    - '--providers.file.directory=/etc/traefik/dynamic_conf' # 指定动态配置文件目录
38
    - '--providers.file.watch=true' # 启用动态配置文件监控
39

40
    - '--accesslog=true' # 启用访问日志
41
    - '--accesslog.format=json' # 建议使用json格式，便于后续处理
42

43
    # --- Let's Encrypt (SSL证书) 配置 ---
44
    # 暂时注释掉，在您配置好域名后可以启用
45
    - '--certificatesresolvers.myresolver.acme.httpchallenge=true'
46
    - '--certificatesresolvers.myresolver.acme.httpchallenge.entrypoint=web'
47
    - '--certificatesresolvers.myresolver.acme.email=xxx'
48
    - '--certificatesresolvers.myresolver.acme.storage=/etc/traefik/acme.json'
49
    # 注意：请确保acme.json文件权限为600，Traefik才能写入证书
50

51
  # --- 端口映射 ---
52
  ports:
53
    - '80:80'
54
    - '443:443'
55
    # - "8080:8080" # 暴露仪表盘的8080端口(仅开发)
56

57
  # --- 挂载卷 ---
58
  volumes:
59
    # 挂载Docker socket，让Traefik可以监听到容器的创建和销毁
60
    - '/var/run/docker.sock:/var/run/docker.sock:ro'
61
    # 挂载acme.json文件，用于持久化SSL证书
62
    - './acme.json:/etc/traefik/acme.json'
63
    # 挂载动态配置文件目录
64
    - './dynamic_conf:/etc/traefik/dynamic_conf:ro'
65
    # 挂载日志目录
66
    - './logs:/var/log:rw'
67
    - './cf-cert:/etc/traefik/cf-cert:ro'
68

69
  # --- 网络 ---
70
  networks:
71
    - traefik-net
72

73
networks:
74
  traefik-net:
75
  name: traefik-net
76
  external: true

1
tls:
2
    options: # 给这个 TLS 选项起一个名字
3
        cloudflare-mtls:
4
            minVersion: VersionTLS12
5
        clientAuth:
6
            caFiles: - /etc/traefik/cf-cert/cloudflare-ca.pem
7
            clientAuthType: "RequireAndVerifyClientCert"

1
http:
2
  middlewares:
3
    # 定义一个全局可用的压缩中间件，我们给它起个名字叫 'global-compressor'
4
    global-compressor:
5
      compress:
6
        # 在这里可以设置更详细的参数，进行精细化控制
7

8
        # 排除不需要压缩的内容类型（例如图片，因为它们已经被压缩过了）
9
        excludedContentTypes:
10
          - 'image/png'
11
          - 'image/jpeg'
12
          - 'image/gif'
13
          - 'application/pdf'
14

15
        # 设置压缩算法，默认是gzip
16
        # 也可以使用 'br' (Brotli) 或者 'deflate'
17
        # 但注意，Brotli在某些浏览器上支持不如gzip
18
        # algorithm: "gzip" # 默认是gzip，通常不需要显式设置
19
        # 设置压缩级别，范围是1到9，数字越大压缩率越高，但CPU消耗也越大
20

21
        # 设置一个最小响应体大小，小于这个大小的响应不进行压缩 (避免浪费CPU)
22
        minResponseBodyBytes: 1024 # 即只压缩大于1KB的响应

1
http:
2
  middlewares:
3
    crowdsec-bouncer:
4
      plugin:
5
        crowdsec-bouncer-traefik-plugin:
6
          CrowdsecLapiKey: '' #填自己的
7
          Enabled: 'true'
8
          crowdsecMode: 'stream'
9
          # logLevel: "DEBUG"
10
          banHTMLFilePath: '/etc/traefik/dynamic_conf/ban.html' #自己生成
11
          forwardedHeadersCustomName: 'CF-Connecting-IP'
12
          forwardedHeadersTrustedIPs:
13
            # Cloudflare IPs
14
            - '173.245.48.0/20'
15
            - '103.21.244.0/22'
16
            - '103.22.200.0/22'
17
            - '103.31.4.0/22'
18
            - '141.101.64.0/18'
19
            - '108.162.192.0/18'
20
            - '190.93.240.0/20'
21
            - '188.114.96.0/20'
22
            - '197.234.240.0/22'
23
            - '198.41.128.0/17'
24
            - '162.158.0.0/15'
25
            - '104.16.0.0/13'
26
            - '104.24.0.0/14'
27
            - '172.64.0.0/13'
28
            - '131.0.72.0/22'
29
            # Local IPs
30
            - '10.0.10.23/32'
31
            - '10.0.20.0/24'
32
          # Local IPs
33
          clientTrustedIPs:
34
            - '192.168.0.0/16'
35
            - '10.0.0.0/8'
36
            - '172.16.0.0/12'

1
http:
2
  routers:
3
    catchall-http:
4
      rule: 'HostRegexp(`{host:.+}`)'
5
      entryPoints:
6
        - web
7
      service: 'blackhole-http-svc' # 指向HTTP黑洞服务
8
      priority: 1
9

10
  services:
11
    blackhole-http-svc:
12
      loadBalancer:
13
        servers:
14
          - url: 'http://10.255.255.1:80'
15

16
# TCP部分：处理所有未匹配的HTTPS请求 (例如 https://<IP>)
17
tcp:
18
  routers:
19
    catchall-tls:
20
      rule: 'HostSNI(`*`)' # 匹配任何TLS连接
21
      entryPoints:
22
        - websecure
23
      service: 'blackhole-tcp-svc' # 指向TCP黑洞服务
24
      priority: 1
25
      tls:
26
        passthrough: false
27

28
  services:
29
    blackhole-tcp-svc:
30
      loadBalancer:
31
        servers:
32
          # TCP服务使用 'address' 字段
33
          - address: '192.0.2.1:1'

crowdsec 配置

这里配置 CrowdSec，通过 docker 搭建。

整个安全方案由两部分组成：

CrowdSec Agent (crowdsec 服务): 负责分析日志、检测威胁，并管理决策（例如，哪个 IP 应该被禁止）。
Traefik Bouncer (作为 Traefik 插件): 在 Traefik 中运行，负责执行 CrowdSec Agent 的决策，直接在流量入口处阻止恶意 IP。

工作流程

Traefik 接收外部请求，并将访问日志（JSON 格式）输出。
CrowdSec Agent (crowdsec 服务) 通过挂载的 Docker Socket 读取 Traefik 的日志。
Agent 使用 crowdsecurity/traefik collection 中的解析器和场景分析日志，检测到攻击行为（如暴力破解、扫描等）。
一旦检测到威胁，CrowdSec 会生成一个“决策”，将攻击者的 IP 标记为恶意，并推送到 local API。
local API马上推送到所有Bouncer（如果还配置了其他Bouncer），其中Traefik 中的 CrowdSec Bouncer 插件会获取最新的决策列表。
当被标记为恶意的 IP 再次尝试访问时，Bouncer 会在 Traefik 层面直接拒绝该请求，从而保护所有后端服务。

1
services:
2
  crowdsec:
3
    image: crowdsecurity/crowdsec:latest
4
    container_name: crowdsec
5
    restart: unless-stopped
6
    environment:
7
      - GID=999
8
      - COLLECTIONS=crowdsecurity/traefik #安装了 crowdsecurity/traefik 集合，CrowdSec 知道 Traefik 日志长什么样。当它发现某个容器（也就是 Traefik 容器）的日志格式与 Traefik 解析器匹配时，就会自动开始采集和分析这些日志。
9
    volumes:
10
      - /var/run/docker.sock:/var/run/docker.sock:ro #允许 CrowdSec 监控其他容器的日志
11
      - ./data:/var/lib/crowdsec/data
12
      - ./config:/etc/crowdsec
13
    networks:
14
      - traefik-net
15

16
networks:
17
  traefik-net:
18
    external: true

反代配置

主要通过 traefik 的标签（labels）来配置反代。

1
services:
2
  umami:
3
    image: ghcr.io/umami-software/umami:postgresql-latest
4
    # ports:
5
    #   - "3000:3000"
6
    environment:
7
      DATABASE_URL:
8
      DATABASE_TYPE: postgresql
9
    init: true
10
    restart: unless-stopped
11
    healthcheck:
12
      test: ['CMD-SHELL', 'curl http://localhost:3000/api/heartbeat']
13
      interval: 5s
14
      timeout: 5s
15
      retries: 5
16
    networks:
17
      - traefik-net
18
    labels:
19
      - traefik.enable=true
20
      - traefik.http.routers.umami.rule=Host(`stats.xingpingcn.top`) # 替换为你的域名。会自动帮你申请证书，记得把ip指向vps ip或者cname到cf的cdn
21
      - traefik.http.services.umami.loadbalancer.server.port=3000 # umami 默认端口。traefik会主动处理，不需要要你自己设置端口。如果有另一个服务在网络traefik-net上监听3000端口，traefik会自动处理冲突。服务b想连接此服务，直接使用服务名和端口，例如 `http://umami:3000`
22
      - traefik.http.routers.umami.entrypoints=websecure
23
      - traefik.http.routers.umami.tls=true
24
      - traefik.http.routers.umami.tls.certresolver=myresolver # 使用之前定义的证书解析器
25
      - traefik.http.routers.umami.tls.options=cloudflare-mtls@file # 使用之前定义的 mtls 选项。traefik似乎不支持全局设置
26

27
networks:
28
  traefik-net:
29
    name: traefik-net
30
    external: true