testssl-Webfrontend Docker镜像

镜像概述

本Docker镜像是Markus Kraus的mycloudrevolution/testssl-webfrontend的分支版本，基于thyssenkrupp CERT的testssl.sh-webfrontend项目，使用Dirk Wetter的testssl.sh脚本实现核心功能。该镜像提供Web界面，方便用户通过浏览器发起和管理SSL/TLS安全测试。

核心功能与特性

• 提供直观的Web界面，简化SSL/TLS安全测试流程
• 支持配置并发测试数量，通过调整进程和线程参数优化性能
• 可自定义测试超时时间，适应不同网络环境
• 内置调试模式，便于排查测试过程中的问题
• 支持集成到外部Nginx反向代理环境

使用场景

适用于需要通过Web界面便捷进行SSL/TLS安全测试的场景，如：

• 开发人员验证应用服务器的SSL配置
• 安全测试人员批量检查多个域名的SSL/TLS安全性
• 系统管理员定期审计服务器的SSL/TLS合规性

使用方法

基本使用

拉取镜像

bash
docker pull ghcr.io/shartge/testssl-web

运行容器

bash
docker run --rm --name testssl-web -p 5000:5000 ghcr.io/shartge/testssl-web

容器启动后，通过http://localhost:5000访问Web界面。

配置说明

并发SSL测试数量配置

通过环境变量UWSGI_PROCESSES和UWSGI_THREADS配置容器内uWSGI的进程数和线程数，控制并发SSL测试数量。

• UWSGI_PROCESSES：uWSGI进程数，默认值为4
• UWSGI_THREADS：每个进程的线程数，默认值为2

示例：配置2个进程，每个进程8个线程

bash
docker run --rm --name testssl-web -e UWSGI_THREADS=8 -e UWSGI_PROCESSES=2 -p 5000:5000 ghcr.io/shartge/testssl-web

测试超时设置

通过环境变量TEST_TIMEOUT配置单个测试的超时时间（秒），默认值为300秒。

示例：设置超时时间为600秒

bash
docker run --rm --name testssl-web -e TEST_TIMEOUT=600 -p 5000:5000 ghcr.io/shartge/testssl-web

启用调试模式

通过环境变量TESTSSLDEBUG启用testssl.sh调试模式，取值范围为0（无调试，默认）至6（最大调试级别）。建议调试时同时增加超时时间（如设置为600秒）。

示例：启用级别2的调试模式

bash
docker run --rm --name testssl-web -e TESTSSLDEBUG=2 -e TEST_TIMEOUT=600 -p 5000:5000 ghcr.io/shartge/testssl-web

集成外部Nginx

若将testssl-web部署在Nginx反向代理后，需禁用proxy_buffering以确保测试过程中的实时流更新正常显示。

Nginx配置示例：

nginx
location /testssl {
    proxy_pass       http://localhost:5000;
    proxy_set_header Host      $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_buffering  off;  # 必须禁用，确保实时更新
}