txstatemws/keygenerator Docker 镜像 - 轩辕镜像

多阶段密钥对生成镜像

镜像概述

本镜像为多阶段构建的Docker镜像，专为安全、高效地生成各类加密算法的私钥/公钥对设计。通过多阶段构建机制，确保密钥生成环境的纯净性与安全性，同时支持灵活配置以满足不同场景的密钥需求。镜像集成主流密钥生成工具，可自动化完成密钥对生成、格式转换及安全导出流程。

核心功能与特性

1. 多阶段构建架构

• 构建阶段：基于安全加固的基础镜像（如Alpine Linux），集成密钥生成工具（OpenSSL等），确保生成环境无冗余依赖
• 输出阶段：仅保留生成的密钥对文件，可按需集成至其他应用镜像，减少最终镜像体积与***面

2. 多算法支持

• 支持主流密钥算法：RSA（默认）、ECDSA、Ed25519、DSA等
• 可配置密钥长度（如RSA 2048/4096位，ECDSA曲线参数）

3. 安全特性

• 密钥生成过程中避免敏感信息泄露
• 支持密码保护（通过环境变量配置密钥密码）
• 生成文件权限严格控制（默认600权限）

4. 灵活配置

• 通过环境变量自定义密钥类型、长度、输出路径及文件名
• 支持密钥格式转换（PEM、DER等）

使用场景

1. 开发与测试环境

• 快速生成测试用密钥对，用于本地服务认证（如SSH、TLS）
• 开发环境中模拟生产密钥配置，验证加密功能

2. CI/CD流程集成

• 在CI流水线中自动生成部署密钥，用于服务间安全通信
• 配合GitOps工具实现密钥的自动化管理与轮换

3. 生产环境初始化

• 安全敏感应用的首次部署密钥初始化
• 容器化应用的密钥对批量生成与分发

使用方法与配置说明

基本使用（docker run）

通过docker run命令直接生成密钥对，生成的密钥默认输出至容器内/output目录，可通过挂载卷导出至本地。

示例1：生成默认RSA密钥对（2048位）

bash
docker run --rm -v $(pwd)/keys:/output key-generator-image

执行后，本地keys目录将生成：

• private.key：私钥文件
• public.key：公钥文件

示例2：生成4096位RSA密钥并设置密码

bash
docker run --rm -v $(pwd)/keys:/output \
  -e KEY_TYPE=RSA \
  -e KEY_LENGTH=4096 \
  -e PASSPHRASE=your_secure_passphrase \
  key-generator-image

环境变量配置

多阶段构建示例（Dockerfile集成）

在应用Dockerfile中引用本镜像作为构建阶段，生成密钥对后仅将公钥复制到最终应用镜像，确保私钥不泄露。

dockerfile
# 阶段1：使用密钥生成镜像生成密钥对
FROM key-generator-image AS key-builder
ENV KEY_TYPE=ECDSA
ENV EC_CURVE=secp384r1
ENV PASSPHRASE=${APP_SECRET_KEY}  # 可从构建参数传入

# 阶段2：应用镜像（仅包含公钥）
FROM nginx:alpine
# 从构建阶段复制公钥
COPY --from=key-builder /output/public.key /etc/nginx/ssl/
# 配置Nginx使用公钥...

注意事项

1. 密钥安全：生成的私钥文件应妥善保管，避免提交至代码仓库或公开存储
2. 生产环境建议：生产环境中建议通过PASSPHRASE参数为私钥设置强密码，并使用密钥管理服务（如Vault）存储
3. 权限控制：宿主机挂载目录权限建议设置为0700，确保仅当前用户可访问生成的密钥文件
4. 算法选择：优先使用ED25519或ECDSA（secp384r1以上曲线）以获得更高安全性与性能