openiamdocker/certificate-generator

Certificate Generator Docker镜像文档

镜像概述与主要用途

Certificate Generator是一款轻量级Docker镜像工具，专注于简化加密证书的生成流程。该镜像集成了证书生成核心功能，支持快速创建SSL/TLS证书、自签名证书等多种类型，无需复杂依赖配置。主要用途包括开发环境测试证书创建、小型Web服务HTTPS配置、内部系统加密通信等场景，帮助用户一键完成证书生成与导出。

核心功能与特性

• 多证书类型支持：兼容RSA、ECC等主流加密算法，满足不同安全需求
• 自定义参数配置：支持设置证书有效期、密钥长度、主题信息（国家、组织、通用名称等）
• 轻量级设计：基于精简基础镜像，体积小（<50MB），启动速度快
• 无依赖部署：容器化封装，无需本地安装OpenSSL等工具链
• 一键导出：自动将生成的私钥、证书文件导出至指定目录，方便直接使用

使用场景与适用范围

• 开发测试环境：快速创建临时证书用于本地服务调试（如Nginx、Node.js服务HTTPS测试）
• 小型生产部署：个人博客、内部工具等轻量服务的HTTPS证书配置
• 临时加密需求：本地网络通信加密、临时数据传输证书生成
• 教育演示场景：证书原理教学、加密配置演示环境搭建

使用方法与配置说明

基础使用（docker run）

通过以下命令生成默认配置的自签名证书，并将证书文件挂载到本地./certs目录：

bash
docker run --rm -v $(pwd)/certs:/app/certs certificate-generator:latest

生成的证书文件将保存在本地./certs目录，包含：

• privkey.pem：私钥文件
• cert.pem：证书文件
• fullchain.pem：完整证书链（含证书）

自定义配置（环境变量）

通过环境变量自定义证书参数，支持以下配置项：

示例：生成ECC类型、有效期180天的证书

bash
docker run --rm \
  -v $(pwd)/certs:/app/certs \
  -e CERT_TYPE=ecc \
  -e KEY_LENGTH=384 \
  -e VALID_DAYS=180 \
  -e COMMON_NAME=example.com \
  -e ORGANIZATION="My Company" \
  certificate-generator:latest

docker-compose配置示例

创建docker-compose.yml文件，定义固定证书配置：

yaml
version: '3'
services:
  cert-gen:
    image: certificate-generator:latest
    volumes:
      - ./certs:/app/certs
    environment:
      - CERT_TYPE=rsa
      - KEY_LENGTH=4096
      - VALID_DAYS=730
      - COMMON_NAME=blog.example.com
      - ORGANIZATION=Example Org
    command: sh -c "sleep 1 && exit 0"  # 生成后自动退出

启动并生成证书：

bash
docker-compose up

高级用法（自定义主题扩展）

如需添加Subject Alternative Name（SAN，多域名支持），可通过挂载自定义配置文件实现。创建本地openssl.cnf配置文件，挂载至容器/app/openssl.cnf：

bash
docker run --rm \
  -v $(pwd)/certs:/app/certs \
  -v $(pwd)/openssl.cnf:/app/openssl.cnf \
  certificate-generator:latest

自定义openssl.cnf示例（添加SAN支持）：

ini
[req]
prompt = no
default_bits = 2048
distinguished_name = req_distinguished_name
x509_extensions = v3_ca

[req_distinguished_name]
C = CN
ST = Beijing
L = Beijing
O = MyOrg
OU = IT
CN = example.com

[v3_ca]
subjectAltName = DNS:example.com,DNS:www.example.com,IP:192.168.1.1
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth

注意事项

• 自签名证书不被公共CA信任，仅适用于非生产或内部环境
• 生产环境建议使用Let's Encrypt等可信CA签发的证书
• 密钥文件需妥善保管，避免泄露
• 证书有效期建议根据使用场景合理设置（测试环境≤30天，内部生产≤1年）