stagex/openssl

TLS工具包镜像文档

镜像概述

本Docker镜像为传输层安全（TLS）协议提供一站式工具集，集成了多种常用TLS相关工具，旨在简化TLS证书管理、配置验证、安全诊断及协议实现流程。通过容器化方式，用户可快速获取完整的TLS工具链，无需在本地环境手动安装依赖，适用于开发、测试及生产环境中的TLS相关任务。

核心功能与特性

核心功能

• 证书生命周期管理：支持自签名证书生成、CA证书创建、证书签名请求（CSR）生成及证书吊销列表（CRL）管理
• TLS配置验证：检查服务器TLS协议版本支持情况、密码套件安全性及证书链完整性
• 协议诊断工具：提供TLS握手模拟、加密流量分析及安全漏洞扫描功能
• 证书格式转换：支持PEM、DER、PFX等常见证书格式的相互转换
• TLS版本支持：兼容TLS 1.0/1.1/1.2/1.3及SSLv3（用于兼容性测试，默认禁用不安全协议）

关键特性

• 工具集成全面：包含OpenSSL、tls-scan、certbot、mkcert等主流TLS工具
• 轻量级设计：基于Alpine Linux构建，镜像体积小，启动速度快
• 即开即用：无需额外配置即可使用核心工具，支持交互式操作与脚本化调用
• 跨平台兼容：支持x86_64、ARM等主流架构，可在各类容器环境中运行

使用场景与适用范围

典型使用场景

• 开发环境快速配置：生成测试用自签名证书，用于容器化应用的HTTPS开发调试
• 生产环境安全验证：部署前检查服务器TLS配置合规性，确保符合安全基线
• 证书管理自动化：通过脚本调用工具实现证书自动更新、格式转换及备份
• 安全审计与漏洞检测：扫描目标服务器的TLS协议漏洞（如Heartbleed、POODLE等）
• 教学与学习：直观演示TLS握手过程、证书结构及加密算法原理

适用人群

• 开发人员（TLS协议集成与调试）
• 系统管理员（服务器TLS配置与维护）
• 安全工程师（TLS安全评估与加固）
• 运维人员（证书生命周期管理）

使用方法与配置说明

基本使用

交互式运行

通过以下命令启动容器并进入交互式终端，直接使用工具：

bash
docker run -it --rm docker.xuanyuan.run/tls-toolkit:latest sh

进入终端后，可直接调用工具（如openssl version查看OpenSSL版本）。

生成自签名证书示例

在宿主机当前目录生成有效期为365天的自签名证书（需挂载本地目录）：

bash
docker run -it --rm -v $(pwd):/certs docker.xuanyuan.run/tls-toolkit:latest \
  openssl req -x509 -newkey rsa:2048 -nodes -keyout /certs/server.key -out /certs/server.crt -days 365 \
  -subj "/C=CN/ST=Beijing/L=Beijing/O=Example/OU=IT/CN=example.com"

执行后，当前目录将生成server.key（私钥）和server.crt（证书）文件。

验证目标服务器TLS配置

检查目标服务器（如example.com:443）的TLS支持情况：

bash
docker run -it --rm docker.xuanyuan.run/tls-toolkit:latest \
  tls-scan --host example.com --port 443

Docker Compose配置示例

创建docker-compose.yml文件，集成TLS工具包与Web服务进行本地HTTPS测试：

yaml
version: '3'
services:
  tls-toolkit:
    image: docker.xuanyuan.run/tls-toolkit:latest
    volumes:
      - ./certs:/certs
    command: sh -c "openssl req -x509 -newkey rsa:2048 -nodes -keyout /certs/server.key -out /certs/server.crt -days 365 -subj '/CN=localhost'"
  
  web-server:
    image: docker.xuanyuan.run/nginx:alpine
    ports:
      - "443:443"
    volumes:
      - ./certs:/etc/nginx/certs
      - ./nginx.conf:/etc/nginx/nginx.conf
    depends_on:
      - tls-toolkit

上述配置将自动生成证书并挂载到Nginx服务，实现HTTPS访问。

环境变量配置

示例：指定默认TLS版本为TLSv1.2

bash
docker run -it --rm -e TLS_DEFAULT_VERSION=TLSv1.2 docker.xuanyuan.run/tls-toolkit:latest

数据持久化

通过挂载数据卷持久化证书及配置文件：

bash
docker run -it --rm -v tls-data:/certs docker.xuanyuan.run/tls-toolkit:latest

（tls-data为命名卷，需提前创建：docker volume create tls-data）

常用工具列表

注意事项

• 生产环境中避免使用自签名证书，建议通过certbot申请可信CA证书
• 默认禁用SSLv3、TLSv1.0/1.1等不安全协议，如需测试兼容性需手动启用
• 敏感操作（如私钥管理）建议通过数据卷挂载本地目录，避免证书泄露
• 定期更新镜像以获取工具安全补丁及功能更新