thomx/traefik-certificate-extractor

Traefik证书提取工具

Fork自https://github.com/DanielHuisman/traefik-certificate-extractor

用于从Traefik的ACME存储文件中提取Let's Encrypt证书的工具，支持通过Docker API自动重启相关容器。

核心功能与特性

• 证书提取：从Traefik的acme.json文件中提取Let's Encrypt证书
• 自动重启容器：通过Docker API识别带有特定标签的容器，在证书更新时自动重启
• 域名筛选：支持通过--include或--exclude参数筛选需要处理的域名
• 输出格式：可选择按域名分目录输出或所有证书输出到单个目录（flat模式）
• 安全验证：提供--dry-run选项，用于测试配置而不实际写入文件或重启容器

使用场景

适用于需要从Traefik获取Let's Encrypt证书并自动应用到其他依赖证书的服务场景，例如：

• 需要证书的Web服务、邮件服务器等应用
• 需在证书更新后自动重启以加载新证书的容器化服务
• 需要集中管理从Traefik提取的证书的场景

使用方法

源码安装（可选）

shell
git clone https://github.com/snowmb/traefik-certificate-extractor
cd traefik-certificate-extractor

命令行参数说明

默认证书文件路径为./data/acme.json，默认输出目录为./certs（按域名分目录）和./certs_flat（单目录）。

Docker部署

Docker镜像信息

官方Docker镜像：https://hub.docker.com/r/snowmb/traefik-certificate-extractor/

基本运行示例

shell
docker run --name extractor -d \
  -v /opt/traefik:/app/data \  # 挂载包含acme.json的目录到/app/data
  -v ./certs:/app/certs \      # 挂载证书输出目录
  -v /var/run/docker.sock:/var/run/docker.sock \  # 挂载Docker socket以操作容器
  snowmb/traefik-certificate-extractor -r  # -r启用自动重启容器

Docker Compose配置示例

yaml
services:
  certs:
    image: snowmb/traefik-certificate-extractor
    volumes:
      - path/to/acme.json:/app/data/acme.json:ro  # 只读挂载acme.json
      - certs:/app/certs:rw                       # 可写挂载证书输出目录
      - /var/run/docker.sock:/var/run/docker.sock  # Docker socket用于容器重启
    command: -r --include example.com  # 启用重启并仅包含example.com域名
    restart: always  # 确保容器持续运行

volumes:
  certs:  # 持久化存储提取的证书

容器自动重启机制

通过Docker socket识别带有以下标签的容器：
com.github.SnowMB.traefik-certificate-extractor.restart_domain=<DOMAIN>

• 当提取的证书域名与标签中的<DOMAIN>匹配时，容器将自动重启
• 多域名用逗号分隔（例如：example.com,sub.example.com）

输出结构

提取的证书将按以下结构输出：

certs/  # 按域名分目录（默认模式）
    example.com/
        cert.pem       # 证书文件
        chain.pem      # 证书链
        fullchain.pem  # 完整证书链（证书+链）
        privkey.pem    # 私钥
    sub.example.nl/
        cert.pem
        chain.pem
        fullchain.pem
        privkey.pem

certs_flat/  # 所有证书输出到单个目录（--flat模式）
    example.com.crt
    example.com.key
    example.com.chain.pem
    sub.example.nl.crt
    sub.example.nl.key
    sub.example.nl.chain.pem