esplo/docker-local-ssl-termination-proxy

Docker本地SSL终止代理

镜像概述和主要用途

一个简单的SSL终止代理，用于访问https://localhost。此代理易于使用（一条命令即可启动），且借助Docker无需在本地机器安装任何额外软件。

核心功能和特性

• 简化本地HTTPS访问配置，无需手动配置SSL证书
• 单命令快速启动，降低使用门槛
• 支持自定义SSL证书，可集成本地信任的开发证书
• 跨平台兼容（Mac OSX、Linux及其他Docker支持的平台）

使用场景和适用范围

适用于本地开发环境中需要通过HTTPS访问localhost服务的场景，例如：

• Web应用本地开发时测试HTTPS相关功能
• 前端开发中模拟生产环境的HTTPS请求
• 需要SSL终止能力的本地服务调试

环境要求

• Docker (20.10.0+ 版本)

使用方法和配置说明

基本使用

假设您的应用运行在http://localhost:8000，以下命令可使您通过https://localhost访问该服务。

Mac OSX

bash
docker run -it \
  -e "PORT=8000" \
  -p 443:443 \
  --rm \
  esplo/docker-local-ssl-termination-proxy

Linux

bash
docker run -it \
  --add-host=host.docker.internal:host-gateway \
  -e "PORT=8000" \
  -p 443:443 \
  --rm \
  esplo/docker-local-ssl-termination-proxy

其他平台

需确保host.docker.internal能在Docker容器内正确解析。对于大多数无法自动解析的平台（如Mac的Docker Desktop），添加--add-host=host.docker.internal:host-gateway参数即可解决。

测试连接

启动代理后，可通过以下命令测试连接：

bash
curl -k https://localhost/

本地信任的开发证书配置

容器可通过SSL_CERT和SSL_KEY环境变量配置自定义证书。推荐使用https://github.com/FiloSottile/mkcert%E7%94%9F%E6%88%90%E6%9C%AC%E5%9C%B0%E4%BF%A1%E4%BB%BB%E7%9A%84%E5%BC%80%E5%8F%91%E8%AF%81%E4%B9%A6%EF%BC%9A

1. 生成证书：

bash
mkdir -p ssl
mkcert -install
mkcert --cert-file ssl/localhost.pem --key-file ssl/localhost.key localhost 127.0.0.1 ::1

2. 挂载证书到容器：

bash
docker run -it \
  -e 'PORT=8000' \
  -e 'SSL_CERT=localhost.pem' \
  -e 'SSL_KEY=localhost.key' \
  -p 443:443 \
  -v "$(pwd)"/ssl:/etc/nginx/ssl/ \
  --rm \
  esplo/docker-local-ssl-termination-proxy

故障排除

Chrome中显示"您的连接不是私密连接"

点击"高级"按钮，然后点击"继续前往"（不推荐用于生产环境，仅适用于本地开发）。

许可证

参见LICENSE文件了解许可权利和限制（MIT）。