soulteary/certs-maker

Certs Maker

镜像概述

Certs Maker 是一款轻量级自签名证书生成工具，镜像大小仅约3MB，专为快速生成自托管或开发环境所需的SSL证书设计。通过简单配置即可生成多域名证书，并支持生成Kubernetes友好的证书格式。

核心功能

• 轻量级设计：镜像体积约3MB，资源占用低，启动快速
• 灵活配置：支持通过环境变量或CLI参数自定义证书信息
• 多域名支持：可同时为多个域名（含通配符域名）生成证书
• K8s兼容：提供Kubernetes友好模式，生成适用于K8s环境的证书

使用场景

• 自托管服务的SSL证书需求
• 开发/测试环境中快速获取SSL证书
• 需要为多个子域名（如*.lab.com、*.data.lab.com）生成证书的场景
• Kubernetes集群内服务的证书配置

快速开始

基本使用（Docker Run）

生成支持*.lab.com和*.data.lab.com的自签名证书，一键操作：

bash
docker run --rm -it -v `pwd`/ssl:/ssl soulteary/certs-maker "--CERT_DNS=lab.com,*.lab.com,*.data.lab.com"
# 或使用环境变量方式：
# docker run --rm -it -v `pwd`/ssl:/ssl -e "CERT_DNS=lab.com,*.lab.com,*.data.lab.com" soulteary/certs-maker

在执行命令的目录下的ssl文件夹中查看生成的文件：

bash
ssl
├── lab.com.conf  # 证书配置文件
├── lab.com.crt   # 证书文件
└── lab.com.key   # 私钥文件

Docker Compose配置

如果倾向于使用文件配置，可使用如下docker-compose.yml：

yaml
version: '2'
services:
  certs-maker:
    image: soulteary/certs-maker
    environment:
      - CERT_DNS=lab.com,*.lab.com,*.data.lab.com
    volumes:
      - ./ssl:/ssl

执行以下命令启动：

bash
docker-compose up
# 或
# docker compose up

K8s友好证书

如需生成Kubernetes友好的证书，添加FOR_K8S参数：

bash
docker run --rm -it -v `pwd`/ssl:/ssl soulteary/certs-maker "--CERT_DNS=lab.com,*.lab.com,*.data.lab.com --FOR_K8S=ON"
# 或
# docker run --rm -it -v `pwd`/ssl:/ssl -e "CERT_DNS=lab.com,*.lab.com,*.data.lab.com" -e "FOR_K8S=ON" soulteary/certs-maker

证书配置参数

环境变量配置

CLI参数配置

Docker镜像

https://hub.docker.com/r/soulteary/certs-maker