petekaik/openssl-certgen

openssl-certgen 镜像文档

概述

openssl-certgen是一个基于Alpine Linux的Docker镜像，集成OpenSSL工具，旨在自动化自签名证书的生成过程。该镜像提供了结构化的证书生成框架，支持CA（证书颁发机构）及设备、服务器、用户等多种类型证书的创建，适用于需要快速部署自签名证书的场景。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 完整工具链：集成OpenSSL，支持标准的证书生成流程
• 结构化设计：内置"certs"目录结构，分类管理CA及各类证书
• 配置驱动：通过"config"文件夹中的.conf配置文件定义证书参数，灵活定制
• 脚本化操作：提供预定义的证书生成脚本，位于"certs"目录的子文件夹中
• 灵活触发：支持手动执行或通过自动化工具（如Ansible）触发证书生成

使用场景

• 开发环境中快速生成自签名证书用于HTTPS测试
• 内部服务间的加密通信（如API服务、数据库连接）
• 测试环境中的证书颁发与管理
• 需要自动化证书生成流程的CI/CD pipeline

使用方法与配置说明

基本使用流程

1. 运行容器并挂载必要的目录（用于持久化证书和配置）
2. 编辑"config"文件夹中的.conf配置文件，定义证书参数
3. 执行对应证书类型的生成脚本

Docker部署示例

基本运行命令

bash
docker run -d --name certgen -v $(pwd)/certs:/opt/certgen/certs -v $(pwd)/config:/opt/certgen/config openssl-certgen

说明：挂载本地的"certs"和"config"目录到容器内，实现配置和证书的持久化存储

手动生成证书

通过docker exec命令手动触发证书生成脚本：

bash
# 生成CA证书
docker exec certgen /opt/certgen/certs/CA/gen_ca

# 生成服务器证书（假设存在server子目录脚本）
docker exec certgen /opt/certgen/certs/server/gen_server

配置文件说明

镜像通过"config"文件夹中的.conf文件定义证书生成参数，典型配置项包括：

• 证书有效期（days）
• 密钥长度（default_bits）
• 国家/地区（countryName）
• 组织（organizationName）
• 通用名称（commonName）

示例配置文件（config/ca.conf）：

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 = Example Corp
OU = IT Dept
CN = Example CA

[v3_ca]
subjectKeyIdentifier=hash
authorityKeyIdentifier=keyid:always,issuer
basicConstraints=CA:TRUE

自动化集成

可通过Ansible等自动化工具集成证书生成流程，例如使用petekaik/ansible-openssh角色实现证书的批量生成与分发：

yaml
- name: Generate CA certificate
  command: docker exec certgen /opt/certgen/certs/CA/gen_ca
  when: ca_cert_not_exists

- name: Generate server certificates
  command: docker exec certgen /opt/certgen/certs/server/gen_server_{{ item }}
  loop: "{{ server_list }}"

目录结构说明

容器内核心目录结构如下：

/opt/certgen/
├── certs/          # 证书生成根目录
│   ├── CA/         # CA证书相关脚本和输出
│   ├── server/     # 服务器证书相关脚本和输出
│   ├── device/     # 设备证书相关脚本和输出
│   └── user/       # 用户证书相关脚本和输出
└── config/         # 证书配置文件目录（.conf）

注：实际生成的证书文件将保存在对应类型的子目录中