hartge/testssl-web

testssl-Webfrontend Docker镜像

镜像概述

本Docker镜像是Markus Kraus的https://github.com/mycloudrevolution/testssl-webfrontend%E7%9A%84%E5%88%86%E6%94%AF%E7%89%88%E6%9C%AC%EF%BC%8C%E5%9F%BA%E4%BA%8Ethyssenkrupp CERT的https://github.com/TKCERT/testssl.sh-webfrontend%E9%A1%B9%E7%9B%AE%EF%BC%8C%E4%BD%BF%E7%94%A8Dirk Wetter的https://github.com/drwetter/testssl.sh%E8%84%9A%E6%9C%AC%E5%AE%9E%E7%8E%B0%E6%A0%B8%E5%BF%83%E5%8A%9F%E8%83%BD%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E6%8F%90%E4%BE%9BWeb%E7%95%8C%E9%9D%A2%EF%BC%8C%E6%96%B9%E4%BE%BF%E7%94%A8%E6%88%B7%E9%80%9A%E8%BF%87%E6%B5%8F%E8%A7%88%E5%99%A8%E5%8F%91%E8%B5%B7%E5%92%8C%E7%AE%A1%E7%90%86SSL/TLS%E5%AE%89%E5%85%A8%E6%B5%8B%E8%AF%95%E3%80%82

核心功能与特性

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

使用场景

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

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

使用方法

基本使用

拉取镜像

bash
docker pull ***-ghcr.xuanyuan.run/shartge/testssl-web

运行容器

bash
docker run --rm --name testssl-web -p 5000:5000 ***-ghcr.xuanyuan.run/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.xuanyuan.run/shartge/testssl-web

测试超时设置

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

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

bash
docker run --rm --name testssl-web -e TEST_TIMEOUT=600 -p 5000:5000 ***-ghcr.xuanyuan.run/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.xuanyuan.run/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;  # 必须禁用，确保实时更新
}