magnitus/certificate-generator

证书生成器镜像

概述

本镜像基于TLS证书相关文献及网络教程开发，用于生成自签名证书或CA签名证书（需自行管理内部证书 authority），满足内部服务或测试场景的证书需求。

核心功能

1. 生成三类文件：证书（.crt）、证书签名请求（.csr）、私钥（.key）
2. 容器每次运行时重新生成证书，私钥和CSR仅首次生成（后续存在则复用）
3. 支持环境变量自定义证书参数（国家、域名、有效期等）
4. 可通过密码和加密算法保护私钥
5. 支持使用预存CA密钥和证书生成CA签名证书

使用场景

• 内部服务测试环境的证书快速生成
• 私有网络中内部CA的证书管理
• 开发环境下测试用证书的便捷获取

配置说明

通过以下环境变量自定义容器行为：

• COUNTRY: 证书所属国家
• STATE: 证书所属州/省
• CITY: 证书所属城市
• ORGANIZATION: 证书所属组织/公司
• DEPARTMENT: 组织内部门
• EMAIL: 联系***
• DOMAINS: 有效域名（多个用;分隔）
• CERTIFICATE_DURATION: 有效期（天，默认365）
• OUTPUT_DIR: 输出目录（默认/opt/output，建议挂载到容器外）
• KEY_FILE: 私钥文件名（默认domain.key，为空则用第一个域名命名）
• CSR_FILE: CSR文件名（默认domain.csr，为空则用第一个域名命名）
• CERTIFICATE_FILE: 证书文件名（默认domain.crt，为空则用第一个域名命名）
• KEY_PASSWORD: 私钥加密密码（需配合KEY_ENCRYPTION_CYPHER使用）
• KEY_PASSWORD_FILE: 私钥密码文件路径（需配合KEY_ENCRYPTION_CYPHER使用）
• KEY_ENCRYPTION_CYPHER: 私钥加密算法（如aes256、des3等）
• KEY_BITS: 私钥位数（默认2048）
• OUTPUT_CERTIFICATE_INFO: 是否输出证书信息（设为true则输出）
• CA_KEY_FILE: 预存CA密钥路径（自签名证书可省略）
• CA_CERTIFICATE_FILE: 预存CA证书路径（需与CA_KEY_FILE同时指定）
• CA_KEY_PASSWORD: CA密钥密码（若加密）
• CA_KEY_PASSWORD_FILE: CA密钥密码文件路径
• CA_SERIALIZATION_FILE: CA序列化文件路径（默认CA证书路径加.srl后缀）

部署示例

自签名证书生成

进入示例目录执行：

bash
docker-compose up

CA签名证书生成

先生成CA证书，再生成目标证书：

bash
docker-compose up ca-certificate-generator  
docker-compose up certificate-generator  

带密码保护私钥的自签名证书

设置KEY_PASSWORD和KEY_ENCRYPTION_CYPHER环境变量后，执行docker-compose up。

测试

进入测试目录执行：

bash
python run.py  

当前测试覆盖带密码保护密钥的CA签名证书场景，验证核心功能（含自签名证书生成）。

版本控制

采用语义化版本（X.Y.Z），建议使用特定版本标签（如1.0.0）而非latest，避免兼容性问题。

历史镜像名称

原镜像名为self-signed-certificate-generator，扩展支持CA签名后更名为certificate-generator。magnitus/certificate-generator:1与magnitus/self-signed-certificate-generator:v2在自签名功能上向后兼容。