stakater/ssl-certs-generator

自签名SSL证书生成器镜像文档

镜像概述

本镜像源自 https://github.com/paulczar/omgwtfssl%EF%BC%8C%E5%9F%BA%E4%BA%8EAlpine Linux构建，旨在简化自签名SSL证书的创建过程，避免每次需要自签名证书时都需手动搜索操作步骤。通过简单的Docker命令即可生成完整的证书链，包括CA证书、服务器证书及相关密钥文件。

核心功能和特性

主要功能

• 自动生成证书颁发机构（CA）密钥和证书
• 生成服务器SSL密钥、证书签名请求（CSR）和最终证书
• 支持通过环境变量自定义证书参数
• 已存在的CA文件可重复使用，避免重复生成

环境变量配置

可通过以下环境变量自定义证书生成参数：

[1] 若文件已存在则会重复使用。
[2] 若设置了SSL_DNS或SSL_IP，SSL_SUBJECT会自动添加到备选主机名列表中。

使用场景和示例

基本使用

通过以下命令生成默认配置的证书，证书文件将输出到/tmp/certs目录：

bash
docker run -v /tmp/certs:/certs stakater/ssl-certs-generator:1.0

生成的文件包括：ca-key.pem、ca.pem、ca.srl、cert.pem、key.csr、key.pem、openssl.cnf。

验证证书有效性：

bash
openssl verify -CAfile /tmp/certs/ca.pem /tmp/certs/cert.pem

为NGINX创建证书

生成证书

指定证书主题为test.example.com：

bash
docker run -v /tmp/certs:/certs \
  -e SSL_SUBJECT=test.example.com \
  stakater/ssl-certs-generator:1.0

配置NGINX

在/etc/nginx/sites-enabled/default中启用SSL：

nginx
server {
    listen 443;
    server_name test.example.com;
    root html;
    index index.html index.htm;
    ssl on;
    ssl_certificate /tmp/certs/cert.pem;
    ssl_certificate_key /tmp/certs/key.pem;
    ssl_session_timeout 5m;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers HIGH:!aNULL:!MD5;
    location / {
        try_files $uri $uri/ =404;
    }
}

测试配置

bash
# 重启NGINX
service nginx restart

# 添加本地域名解析
echo '127.0.2.1       test.example.com' >> /etc/hosts

# 测试HTTPS连接
curl --cacert /tmp/certs/ca.pem https://test.example.com

为Docker Registry创建密钥

创建证书卷容器

bash
docker run \
  --name certs \
  -e SSL_SUBJECT=test.example.com \
  stakater/ssl-certs-generator:1.0

运行Docker Registry

使用卷容器挂载证书：

bash
docker run -d \
  --name registry \
  --volumes-from certs \
  -e REGISTRY_HTTP_TLS_CERTIFICATE=/certs/cert.pem \
  -e REGISTRY_HTTP_TLS_KEY=/certs/key.pem \
  -p 5000:5000 \
  registry:2

验证Registry

bash
# 添加本地域名解析
echo "127.0.2.1       test.example.com" >> /etc/hosts

# 标记并推送镜像
docker tag paulczar/omgwtfssl test.example.com:5000/omgwtfbbq
docker push test.example.com:5000/omgwtfbbq

使用方法和配置说明

基本步骤

1. 挂载本地目录到容器的/certs目录，用于输出证书文件
2. （可选）通过-e参数设置环境变量自定义证书参数
3. 运行镜像，自动生成证书文件到挂载目录

自定义示例

生成包含DNS和IP备选名称的证书：

bash
docker run -v /tmp/certs:/certs \
  -e SSL_SUBJECT=test.example.com \
  -e SSL_DNS="test.example.com,[***]" \
  -e SSL_IP="192.168.1.100,10.0.0.1" \
  -e SSL_EXPIRE=365 \
  stakater/ssl-certs-generator:1.0