fsouza/docker-ssl-proxy

docker-ssl-proxy

镜像概述和主要用途

构建一个基础Nginx服务器Docker镜像，用于将传入的SSL请求代理到目标主机（通常是另一个Docker容器）。

核心功能和特性

• 基于Nginx实现SSL请求代理
• 支持通过环境变量灵活配置代理目标和服务器参数
• 内置自有根CA用于生成SSL证书，并支持共享CA以实现容器间信任
• 允许使用用户自有SSL证书

环境变量

以下环境变量用于配置Nginx：

• DOMAIN：SSL证书中的域名（默认值：www.example.com）
• TARGET_PORT：反向代理的目标端口（默认值：80）
• TARGET_HOST：反向代理的目标主机（默认值：proxyapp）
• CLIENT_MAX_BODY_SIZE：客户端上传的最大大小（默认值：20M）
• SSL_PORT：Nginx SSL代理监听的端口

证书和CA位置

SSL证书使用自有根CA生成，该CA位于目录/etc/nginx/ca中。您可以使用Docker卷将CA共享给其他容器，以便它们信任已安装的证书。

使用自有证书

您可以为您的DOMAIN使用现有的SSL证书，方法是将卷挂载到/etc/nginx/certs目录，并在其中包含以下文件：

• key.pem：私钥文件
• cert.pem：证书文件

证书生成器会检查是否存在key.pem，如果存在则会中止自动生成过程。

Docker Hub镜像

您可以在以下位置获取公开可用的Docker镜像：https://registry.hub.docker.com/u/fsouza/docker-ssl-proxy/

使用示例

基本运行命令

bash
docker run -d \
  -e DOMAIN=myapp.example.com \
  -e TARGET_HOST=backend-service \
  -e TARGET_PORT=3000 \
  -e SSL_PORT=443 \
  -p 443:443 \
  fsouza/docker-ssl-proxy

使用自有证书运行

bash
docker run -d \
  -e DOMAIN=myapp.example.com \
  -e TARGET_HOST=backend-service \
  -v /path/to/your/certs:/etc/nginx/certs \
  -p 443:443 \
  fsouza/docker-ssl-proxy

共享CA与其他容器

bash
# 创建共享CA卷
docker volume create ssl-proxy-ca

# 运行ssl-proxy并挂载CA卷
docker run -d \
  -e DOMAIN=myapp.example.com \
  -v ssl-proxy-ca:/etc/nginx/ca \
  -p 443:443 \
  --name ssl-proxy \
  fsouza/docker-ssl-proxy

# 其他容器挂载CA卷以信任证书
docker run -d \
  -v ssl-proxy-ca:/etc/ssl/certs/ssl-proxy-ca \
  --name backend-service \
  your-backend-image