svendowideit/traefik-certdumper

traefik-certdumper镜像说明

镜像概述

traefik-certdumper是一款针对Traefik的证书导出工具，可将Traefik保存在acme.json文件或Consul KV存储中的Let's Encrypt证书转换为通用的.crt、.key和.pem格式文件，满足证书直接使用的场景需求。

核心功能

• 支持从acme.json文件导出证书（默认模式）
• 支持从Consul KV存储导出证书（集群场景适用）
• 自动转换证书为标准文件格式

使用场景

• 单Traefik实例场景：通过acme.json模式导出证书
• 多Traefik集群场景：通过Consul模式从KV存储导出证书

配置说明

默认模式（acme.json）

默认模式下，只需将Traefik的acme.json文件挂载到容器内/traefik/acme.json路径，证书会自动导出到/traefik/ssl目录。

Docker Swarm部署示例：

# 监听acme.json并导出证书到文件
certdumper:
  image: svendowideit/traefik-certdumper:latest
  volumes:
    - traefikdata:/traefik
  deploy:
    mode: replicated
    replicas: 1

Consul模式

多Traefik实例集群通常使用Consul作为KV存储保存证书，需设置以下环境变量启用该模式：

• CERTDUMPER_MODE=consul：开启Consul模式
• CONSUL_HTTP_ADDR：Consul服务地址（格式：host:port）
• CERTDUMPER_CONSUL_PREFIX：Consul证书存储前缀（默认值：traefik，可选）

Docker Swarm部署示例：

# 从Consul监听证书配置并导出到文件
certdumper:
  image: svendowideit/traefik-certdumper:latest
  environment:
    - CERTDUMPER_MODE=consul
    - CERTDUMPER_CONSUL_ADDR=traefik_consul:8500
  volumes:
    - traefikcerts:/traefik/ssl
  networks:
    - traefik
  deploy:
    mode: replicated
    replicas: 1
    restart_policy:
      condition: on-failure
      delay: 60s