traefik-certs-dumper

]([] ![Go Report Card]([]

如果您喜欢这个项目：

![Sponsor]([***]

核心功能

• 支持的数据源：
  • 文件（"acme.json"）
  • KV存储（Consul、Etcd、Zookeeper、Boltdb）
• 监控变化：
  • 来自文件（"acme.json"）
  • 来自KV存储（Consul、Etcd、Zookeeper）
• 输出格式：
  • 域名作为子目录（允许自定义名称和扩展名）
  • 扁平格式（域名作为文件名）
• 钩子（仅在监控模式且数据源变化时触发）

安装方式

下载 / CI集成

bash
curl -sfL [***] | bash -s -- -b $(go env GOPATH)/bin v2.8.1

从二进制文件安装

您可以使用预编译的二进制文件：

• 从发布页面下载适用于您的操作系统/架构的最新版本二进制文件
• 解压缩归档文件
• 将traefik-certs-dumper添加到您的PATH环境变量中

从Docker安装

bash
docker run ldez/traefik-certs-dumper:<tag_name>

示例：

• Traefik v1：docker-compose（Traefik v1的docker-compose示例）
• Traefik v2：docker-compose（Traefik v2的docker-compose示例）

使用方法

• traefik-certs-dumper
• traefik-certs-dumper file
• traefik-certs-dumper kv

示例

注意： 从Traefik v2导出数据时，必须添加CLI标志--version v2。

简单导出

console
$ traefik-certs-dumper file
dump
├──certs
│  └──my.domain.com.key
└──private
   ├──my.domain.com.crt
   └──letsencrypt.key

更改源和目标路径

console
$ traefik-certs-dumper file --source ./acme.json --dest ./dump/test
test
├──certs
│  └──my.domain.com.key
└──private
   ├──my.domain.com.crt
   └──letsencrypt.key

使用域名作为子目录

console
$ traefik-certs-dumper file --domain-subdir=true
dump
├──my.domain.com
│  ├──certificate.crt
│  └──privatekey.key
└──private
   └──letsencrypt.key

更改文件扩展名

console
$ traefik-certs-dumper file --domain-subdir --crt-ext=.pem --key-ext=.pem
dump
├──my.domain.com
│  ├──certificate.pem
│  └──privatekey.pem
└──private
   └──letsencrypt.key

更改文件名称

console
$ traefik-certs-dumper file --domain-subdir --crt-name=fullchain --key-name=privkey
dump
├──my.domain.com
│  ├──fullchain.crt
│  └──privkey.key
└──private
   └──letsencrypt.key

钩子（Hook）

钩子可以是作为字符串传递的单行命令，或用于更复杂后钩子场景的文件。对于后者，创建一个文件（例如：hook.sh）并挂载它，然后将sh hook.sh作为--post-hook的参数传递。

以下是docker-compose示例：

yml
version: '3.9'

services:
# ...

  traefik-certs-dumper:
    image: ldez/traefik-certs-dumper:v2.8.1
    container_name: traefik-certs-dumper
    entrypoint: sh -c '
      apk add jq
      ; while ! [ -e /data/acme.json ]
      || ! [ `jq ".[] | .Certificates | length" /data/acme.json` != 0 ]; do
      sleep 1
      ; done
      && traefik-certs-dumper file --version v2 --watch
        --source /data/acme.json --dest /data/certs
        --post-hook "sh /hook.sh"'
    labels:
      traefik.enable: false
    volumes:
      - ./letsencrypt:/data
      - ./hook.sh:/hook.sh

# ...

KV存储示例

Consul

console
$ traefik-certs-dumper kv consul --endpoints localhost:8500

Etcd

console
$ traefik-certs-dumper kv etcd --endpoints localhost:2379

Boltdb

console
$ traefik-certs-dumper kv boltdb --endpoints /the/path/to/mydb.db

Zookeeper

console
$ traefik-certs-dumper kv zookeeper --endpoints localhost:2181