mazdermind/traefik-certificate-extractor

镜像概述和主要用途

该镜像是一个轻量级工具，专门用于处理由Traefik生成和管理的acme.json文件，从中提取可直接使用的纯证书文件。它能够将ACME协议生成的证书数据转换为标准格式的证书文件，满足各类服务对SSL证书的使用需求。

核心功能和特性

• 证书提取：从acme.json中提取多种类型的证书文件，包括：
  • fullchain：包含证书和中间证书的组合文件
  • privkey：私钥文件
  • all：包含私钥、证书和中间证书的完整组合文件
  • url：CA处证书的URL文件
• SANs支持：对于包含Subject Alternative Names (SANs)的证书，自动创建指向主域名文件的符号链接，便于多域名证书的统一管理
• 运行模式：提供两种运行模式
  • 一次性模式：执行单次证书提取后退出
  • 监控模式：持续监控acme.json文件的变化，实时提取更新的证书
• 文件安全策略：仅创建和写入文件，从不删除旧文件或目录，确保历史证书文件可追溯，避免意外数据丢失

使用场景和适用范围

适用于需要从Traefik的acme.json文件中获取证书文件的各类场景，例如：

• 为非Traefik管理的Web服务（如Nginx、Apache等）提供SSL证书
• 备份ACME协议生成的证书文件
• 将证书文件用于外部系统或服务（如邮件服务器、API网关等）
• 需要自动化提取和更新证书的CI/CD流程

使用方法和配置说明

基本配置要求

• acme.json文件路径：容器默认期望acme.json文件位于/var/acmejson/acme.json，需通过卷挂载将宿主机的acme.json文件映射到该路径
• 证书输出路径：提取的证书文件将默认写入/var/acmejson/certs/目录，建议将该目录挂载到宿主机以实现证书文件的持久化存储

Docker运行示例

一次性模式

bash
docker run -v /host/path/to/acme.json:/var/acmejson/acme.json -v /host/path/to/certs:/var/acmejson/certs/ [镜像名称]

监控模式

bash
docker run -v /host/path/to/acme.json:/var/acmejson/acme.json -v /host/path/to/certs:/var/acmejson/certs/ [镜像名称] --watch

Docker Compose配置示例

yaml
version: '3'
services:
  cert-extractor:
    image: [镜像名称]
    volumes:
      - /host/path/to/acme.json:/var/acmejson/acme.json:ro  # 只读挂载acme.json
      - /host/path/to/certs:/var/acmejson/certs/           # 持久化存储证书
    command: --watch  # 启用监控模式，持续监控acme.json变化

注意事项

• 确保宿主机上的acme.json文件具有正确的读取权限，以便容器能够访问
• 证书输出目录应具有写入权限，避免因权限问题导致证书提取失败
• 监控模式下，工具将持续运行并在acme.json更新时自动提取新证书