scrapinghub/stunnel

dweomer/stunnel

镜像概述

dweomer/stunnel是一个基于Alpine Linux的轻量级Docker镜像，集成了stunnel工具。stunnel是一款SSL加密隧道工具，主要用于为不支持SSL/TLS的服务提供加密通信能力，通过在客户端和服务端之间建立加密隧道，保护数据传输安全。

核心功能与特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低
• 环境变量配置：支持通过环境变量快速配置stunnel服务参数，无需手动编写配置文件
• 灵活的服务映射：可指定监听端口（ACCEPT）和目标服务地址（CONNECT）
• 证书支持：允许挂载自定义SSL证书，满足生产环境安全需求

使用场景

适用于需要为非加密服务（如LDAP、HTTP、FTP等）添加SSL/TLS加密的场景，例如：

• 为LDAP服务（389端口）提供LDAPS加密访问（636端口）
• 为普通HTTP服务添加HTTPS加密
• 保护跨网络服务的通信安全

使用方法

基本部署示例

以下示例演示如何为名为directory的LDAP容器提供加密访问（LDAPS）：

bash
docker run -itd --name ldaps --link directory:ldap \
    -e STUNNEL_SERVICE=ldaps \
    -e STUNNEL_ACCEPT=636 \
    -e STUNNEL_CONNECT=ldap:389 \
    -p 636:636 \
    dweomer/stunnel

环境变量说明

自定义SSL证书配置

默认情况下，镜像可能使用内置测试证书（不建议用于生产环境）。生产环境中应挂载自定义证书：

bash
docker run -itd --name ldaps --link directory:ldap \
    -e STUNNEL_SERVICE=ldaps \
    -e STUNNEL_ACCEPT=636 \
    -e STUNNEL_CONNECT=ldap:389 \
    -p 636:636 \
    -v /etc/ssl/private/server.key:/etc/stunnel/stunnel.key:ro \  # 私钥文件
    -v /etc/ssl/private/server.crt:/etc/stunnel/stunnel.pem:ro \  # 证书文件
    dweomer/stunnel

注意：挂载的证书文件需设置为只读权限（:ro），确保容器安全性。

版权信息

MIT许可证 (MIT)

版权所有 © 2015-2019 https://github.com/dweomer

特此授予任何获得本软件及相关文档文件（以下简称“软件”）副本的人免费许可，允许其无限制地处理软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本，并允许向其提供软件的人这样做，但须符合以下条件：

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

本软件按“原样”提供，不提供任何明示或暗示的担保，包括但不限于适销性、特定用途适用性和非侵权性的担保。在任何情况下，作者或版权持有人均不对因软件或软件的使用或其他交易引起的任何索赔、损害或其他责任承担责任，无论是合同诉讼、侵权行为还是其他形式的诉讼。