ravensorb/traefik-certificate-exporter

traefik-certificate-exporter 镜像文档

概述

该Docker镜像提供了一个工具，用于从Traefik的JSON文件中提取ACME证书（如Let's Encrypt证书）。工具设计为监控指定文件夹中匹配特定文件模式的文件，当检测到文件变化时，会处理这些文件并将其中的证书提取到指定的输出路径。

!Github Tags !Docker Pulls

Docker拉取命令

bash
docker pull ravensorb/traefik-certificate-exporter:latest

核心功能与特性

• 文件监控：监控指定文件夹中匹配文件模式的JSON文件变化
• 证书提取：从Traefik的ACME JSON文件中提取证书
• 灵活配置：支持通过环境变量或配置文件进行配置
• 自定义匹配：可指定解析器ID、文件匹配模式、包含/排除域名
• 输出控制：支持证书导出路径结构（平坦/层级）、解析器名称包含
• 附加功能：可选证书导出后重启容器、启动时立即执行导出、干运行模式

使用场景

适用于需要将Traefik管理的ACME证书导出供其他服务（如Nginx、Apache、邮件服务器等）使用的场景，实现证书的集中管理与自动同步。

使用方法

docker run（使用环境变量）

以下命令监控以"acme"开头且包含解析器名称"resolver-http"的JSON文件：

bash
docker run -it ravensorb/traefik-certificate-exporter:latest \
                -v /mnt/traefik-data/letsencrypt:/data \
                -v /mnt/certs:/certs \
                -e "TRAEFIK_CERTIFICATE_EXPORTER_SETTINGS_TRAEFIKRESOLVERID=resolver-http" \
                -e "TRAEFIK_CERTIFICATE_EXPORTER_SETTINGS_FILESPEC=acme-*.json" 

docker run（使用配置文件）

通过挂载配置文件目录运行，配置文件（config.yml）需放置在本地./data/config目录：

bash
docker run -it ravensorb/traefik-certificate-exporter:latest \
                -v ${PWD}/data/config:/config \
                -v /mnt/traefik-data/letsencrypt:/data 

docker-compose（使用环境变量）

创建docker-compose.yml文件：

yaml
services:
  traefik-certificate-exporter:
    image: ravensorb/traefik-certificate-exporter:latest
    environment:      
      # - TRAEFIK_CERTIFICATE_EXPORTER_CONFIGFILE="/config/config.yaml"         # 配置文件路径
      # - TRAEFIK_CERTIFICATE_EXPORTER_SETTINGS_DATAPATH="/data"                # 查找Traefik证书JSON文件的基础路径
      # - TRAEFIK_CERTIFICATE_EXPORTER_SETTINGS_FILESPEC="*.json"               # 搜索文件模式（可指定具体文件名）
      # - TRAEFIK_CERTIFICATE_EXPORTER_SETTINGS_OUTPUTPATH="/certs"             # 证书导出基础路径
      # - TRAEFIK_CERTIFICATE_EXPORTER_SETTINGS_TRAEFIKRESOLVERID=              # 要匹配的解析器ID（可选）
      # - TRAEFIK_CERTIFICATE_EXPORTER_SETTINGS_FLAT=false                      # 是否在单个文件夹中导出证书（而非子文件夹）
      # - TRAEFIK_CERTIFICATE_EXPORTER_SETTINGS_RESTARTCONTAINER=false          # 证书导出后是否重启容器
      # - TRAEFIK_CERTIFICATE_EXPORTER_SETTINGS_DRYRUN=false                    # 干运行模式（仅显示导出内容，不实际创建文件）
      # - TRAEFIK_CERTIFICATE_EXPORTER_SETTINGS_RUNATSTART=true                 # 启动时立即执行导出
      - TRAEFIK_CERTIFICATE_EXPORTER_SETTINGS_RESOLVERINPATHNAME=true           # 导出路径中包含解析器名称
      - TRAEFIK_CERTIFICATE_EXPORTER_LOGGINGLEVEL=INFO                          # 日志级别
      # - TRAEFIK_CERTIFICATE_EXPORTER_SETTINGS_INCLUDE_DOMAINS=                # 仅导出的域名列表（逗号分隔）
      # - TRAEFIK_CERTIFICATE_EXPORTER_SETTINGS_EXCLUDE_DOMAINS=               # 排除导出的域名列表（逗号分隔）
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro  # 仅在需要重启容器时挂载
      - ./data/config:/config:rw                      # 仅在使用配置文件时挂载
      - ./data/letsencrypt:/data:ro                   # ACME文件位置
      - ./data/certs:/certs:rw                        # 证书导出位置

启动服务：

bash
docker compose up -d 

docker-compose（使用配置文件）

通过挂载配置文件目录运行，配置文件需放置在本地./data/config目录：

yaml
services:
  traefik-certificate-exporter:
    image: ravensorb/traefik-certificate-exporter:latest
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro  # 仅在需要重启容器时挂载
      - ./data/config:/config:rw                      # 配置文件目录
      - ./data/letsencrypt:/data:ro                   # ACME文件位置
      - ./data/certs:/certs:rw                        # 证书导出位置

启动服务：

bash
docker compose up -d 

配置参数说明

致谢

本工具深受 https://github.com/DanielHuisman 和 https://github.com/SnowMB 出色工作的启发。