jorgeandrada/ca-certificates

ca-certificates https://images.microbadger.com/badges/version/jorgeandrada/ca-certificates:latest.svg](https://microbadger.com/images/jorgeandrada/ca-certificates:latest "获取版本徽章") https://images.microbadger.com/badges/image/jorgeandrada/ca-certificates:latest.svg](https://microbadger.com/images/jorgeandrada/ca-certificates:latest "获取镜像徽章") https://images.microbadger.com/badges/commit/jorgeandrada/ca-certificates:latest.svg](https://microbadger.com/images/jorgeandrada/ca-certificates:latest "获取提交徽章")

镜像概述

jorgeandrada/ca-certificates镜像用于快速生成自签名CA（证书颁发机构）及基于该CA的SSL/TLS证书，适用于开发、测试环境中的加密通信场景，支持灵活的参数自定义以满足不同需求。

核心功能

• 创建自签名CA证书
• 生成基于已有CA的服务器证书（含普通证书和通配符证书）
• 支持通过环境变量自定义证书有效期、密钥长度、主题、DNS/IP扩展等参数
• 复用已存在的CA文件（若文件已存在则直接使用）

使用场景

• NGINX服务器SSL/TLS加密配置
• Docker Registry私有仓库的TLS安全访问
• 本地开发服务的HTTPS测试验证

配置说明

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

• DEBUG：调试级别（0/1/2），默认值0
• CA_KEY：CA私钥文件路径，默认ca-key.pem（若存在则复用）
• CA_CERT：CA证书文件路径，默认ca.pem（若存在则复用）
• CA_SUBJECT：CA主题，默认test-ca
• CA_EXPIRE：CA有效期（天），默认60
• SSL_CONFIG：SSL配置文件路径，默认openssl.cnf（若存在则复用）
• SSL_KEY：服务器私钥文件路径，默认key.pem
• SSL_CSR：证书请求文件路径，默认key.csr
• SSL_CERT：服务器证书文件路径，默认cert.pem
• SSL_SIZE：密钥长度（位），默认2048
• SSL_EXPIRE：服务器证书有效期（天），默认60
• SSL_SUBJECT：服务器证书主题，默认example.com
• SSL_DNS：逗号分隔的备用主机名列表，无默认值（设置后会将SSL_SUBJECT加入备用列表）
• SSL_IP：逗号分隔的备用IP列表，无默认值（设置后会将SSL_SUBJECT加入备用列表）

部署示例

创建CA（首次执行）

shell
docker run --rm \
  -e SSL_SUBJECT=andradaprieto.es \
  -e SSL_DNS=andradaprieto \
  -v $(pwd)/certs:/certs \
  jorgeandrada/ca-certificates:latest

生成服务器证书（后续执行）

shell
docker run --rm \
  -e SSL_SUBJECT=blog.andradaprieto.es \
  -e SSL_DNS=blog \
  -v $(pwd)/certs:/certs \
  jorgeandrada/ca-certificates:latest

生成通配符证书

shell
docker run --rm \
  -e SSL_SUBJECT="*.andradaprieto.es" \
  -e SSL_DNS="*" \
  -v $(pwd)/certs:/certs \
  jorgeandrada/ca-certificates:latest

高级示例

用于NGINX SSL配置

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

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

重启NGINX并测试：

shell
$ service nginx restart
$ echo '127.0.2.1       blog.andradaprieto.es' >> /etc/hosts
$ curl --cacert /etc/nginx/certs/ca.pem https://blog.andradaprieto.es

用于Docker Registry

启动带TLS的Docker Registry：

shell
$ 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

验证功能：

shell
$ echo "127.0.2.1       test.pruebas.local" >> /etc/hosts
$ docker tag jorgeandrada/ca-certificates test.pruebas.local:5000/jandrada
$ docker push test.pruebas.local:5000/jandrada