rveillerot/dumpcerts

Dumpcerts

镜像概述

Dumpcerts 是一个专为 Traefik 设计的辅助工具镜像。它通过持续监控 Traefik 的 acme.json 文件，在文件发生变化时自动执行 dumpcerts.sh 脚本，将 Traefik 自动申请的 Let's Encrypt 证书提取并导出为标准的 .crt 和 .key 独立文件。

核心功能与特性

• 自动监控：实时监控 acme.json 文件的变更，证书更新时自动触发导出，无需手动干预。
• 证书导出：将 JSON 格式存储的证书和私钥解析并导出为标准的 PEM 格式文件。
• 安全隔离：容器运行无需网络访问（--network none），确保私钥等敏感数据的安全性。
• 官方脚本：底层使用 Traefik 官方提供的 dumpcerts.sh 脚本，保证解析的准确性和兼容性。

使用场景

• 需要将 Traefik 自动申请的 TLS 证书共享给同一主机上的其他非 Traefik 服务（如 Nginx、Postfix、Dovecot 等）。
• 需要将证书导出到特定目录，以便进行备份或同步到其他服务器。
• 在 Docker 环境中，多个容器需要复用 Traefik 生成的 Let's Encrypt 证书。

挂载与配置说明

使用方法

1. 构建镜像（如使用本地源码）

如果您选择从源码构建，请克隆仓库并执行以下命令：

bash
docker build -t dumpcerts .

2. 使用 Docker CLI 运行

创建一个用于存储导出证书的 Docker 数据卷，并以只读方式挂载 Traefik 的配置文件：

bash
# 创建用于存储导出证书的卷
docker volume create tls

# 运行 dumpcerts 容器
docker run -d \
  --name dumpcerts \
  --network none \
  --restart unless-stopped \
  -v traefik:/etc/traefik:ro \
  -v tls:/tls:rw \
  dumpcerts

注：此示例假设您的 Traefik 容器使用了名为 traefik 的 volume 来存储数据。如果使用的是宿主机绝对路径，请将 traefik 替换为实际路径（如 /opt/traefik）。

3. 使用 Docker Compose 运行

以下是结合 Traefik 和 Dumpcerts 的 docker-compose.yml 配置示例：

yaml
version: '3.8'

services:
  traefik:
    image: traefik:v2.10
    # ... 其他 traefik 配置 ...
    volumes:
      - traefik_certs:/etc/traefik

  dumpcerts:
    image: dumpcerts 
    container_name: dumpcerts
    network_mode: "none"
    restart: unless-stopped
    volumes:
      - traefik_certs:/etc/traefik:ro
      - exported_tls:/tls:rw

volumes:
  traefik_certs:
  exported_tls:

证书使用示例

证书导出后，您可以在其他服务中通过挂载 exported_tls（或 tls）卷来使用这些证书。例如，在 Nginx 容器中以只读方式挂载并使用：

bash
docker run -d \
  --name my-nginx \
  -v exported_tls:/etc/nginx/certs:ro \
  -v ./nginx.conf:/etc/nginx/nginx.conf:ro \
  nginx:latest

在 Nginx 配置文件中，证书路径将指向 /etc/nginx/certs/ 目录下对应的域名 .crt 和 .key 文件。