jcrummy/tcsaver

tcsaver

镜像概述

tcsaver是一款用于从Traefik生成的acme.json文件中提取证书和私钥的工具，提取后的文件可用于其他服务。该工具会监控acme.json文件的变化，适合持续运行。通过配置文件指定需要提取证书的域名，支持监控配置文件变化，无需重启即可添加或移除域名。

核心功能与特性

• 证书提取：从acme.json中提取指定域名的证书和私钥，搜索时同时匹配主域名和SANs（主题备用名称）
• 文件监控：持续监控acme.json文件变化，自动提取更新后的证书
• 配置灵活性：支持通过环境变量自定义证书和私钥文件的扩展名
• 配置热更新：可选监控配置文件变化，动态添加/移除域名无需重启服务
• 定时提取：可配置固定时间间隔提取证书，即使文件无变化

使用场景与适用范围

• 需要将Traefik管理的SSL证书用于其他服务（如Nginx、Apache等）的场景
• 需自动同步Traefik证书更新的环境
• 需要集中管理多个域名证书文件的场景

使用方法与配置说明

环境变量

数据卷

配置文件

配置文件为YAML格式，包含需要提取证书的域名列表和可选的提取间隔。

示例配置：

yaml
domains:
  - www.example.com
  - subdomain.example.com
extractinterval: 30m

• domains：必填，需要提取证书的域名数组
• extractinterval：可选，除监控文件变化外，按指定间隔提取证书。值需符合https://pkg.go.dev/time#ParseDuration%E6%A0%BC%E5%BC%8F%EF%BC%88%E5%A6%8230m%E3%80%811h%EF%BC%89%EF%BC%8C%E4%B8%8D%E5%85%81%E8%AE%B8%E8%B4%9F%E5%80%BC%E3%80%82

Docker部署示例

docker-compose配置

yaml
version: '3.7'

services: 
  tcsaver:
    image: docker.xuanyuan.run/jcrummy/tcsaver:latest
    environment:
      - TCSAVER_WATCH=true  # 启用配置文件监控
      - TCSAVER_CERT_EXTENSION=.crt  # 证书文件使用.crt扩展名
      - TCSAVER_KEY_EXTENSION=.key  # 私钥文件使用.key扩展名
    volumes:
      - /path/to/config.yaml:/config.yaml  # 挂载配置文件
      - /path/to/acme.json:/acme.json      # 挂载Traefik的acme.json
      - /tls/certs:/certs                 # 证书输出目录
      - /tls/private:/private             # 私钥输出目录

问题反馈

如遇使用问题，请在GitHub仓库提交issue：github.com/jcrummy/tcsaver。