dweomer/stunnel

dweomer/stunnel

镜像概述

基于Alpine Linux构建的stunnel Docker镜像，用于为各类服务提供TLS加密保护，实现安全的网络传输。stunnel作为加密TCP隧道工具，可将非加密服务流量通过TLS/SSL加密，保障数据在传输过程中的安全性。

核心功能与特性

• 轻量高效：基于Alpine Linux，镜像体积小，资源占用低
• 环境变量配置：通过环境变量快速配置stunnel服务，无需手动编写配置文件
• 灵活服务映射：支持将加密监听端口（ACCEPT）映射到后端非加密服务（CONNECT）
• TLS加密支持：可挂载自定义SSL证书实现安全加密，默认可能使用自签名证书（具体以镜像内置配置为准）

使用场景与适用范围

适用于需要为非加密服务添加TLS加密层的场景，例如：

• 为LDAP服务（389端口）添加LDAPS加密（636端口）
• 为HTTP服务（80端口）添加HTTPS加密（443端口）
• 保护数据库、邮件等服务的传输安全

使用方法与配置说明

环境变量配置

证书配置

推荐挂载自定义SSL证书以确保安全性：

• 私钥文件：挂载至 /etc/stunnel/stunnel.key（需设置只读权限）
• 证书文件：挂载至 /etc/stunnel/stunnel.pem（需设置只读权限）

Docker运行示例

以下示例为名为directory的LDAP容器提供LDAPS加密（636端口）：

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

参数说明

• --link directory:ldap：将后端LDAP容器directory链接到当前容器，通过ldap主机名访问后端服务
• -p 636:636：将容器636端口映射到主机636端口，外部可通过主机636端口访问加密服务
• 环境变量配置服务名称、监听端口和后端服务地址，实现加密隧道功能

版权信息

MIT许可证 (MIT)

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

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

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

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