HTTPS重定向Docker镜像

镜像概述

本Docker镜像用于在反向代理环境中实现自动HTTPS重定向功能。它通过检测请求头中的X-Forwarded-Proto字段判断请求协议，当该字段值不为https时，自动将请求重定向到HTTPS版本的URL，确保所有访问通过安全协议进行。

核心功能与特性

• 基于X-Forwarded-Proto头检测：通过解析反向代理传递的X-Forwarded-Proto请求头判断原始请求协议
• 自动HTTPS重定向：当检测到非HTTPS请求时，自动生成HTTPS版本的URL并返回重定向响应
• 可配置重定向状态码：支持设置301（永久重定向）或302（临时重定向）状态码
• 路径与查询参数保留：重定向时自动保留原始请求的路径和查询参数
• 轻量级设计：基于极简基础镜像构建，资源占用低，启动速度快

使用场景与适用范围

• 反向代理SSL终止环境：部署在Nginx、Traefik、HAProxy等反向代理服务器之后，当反向代理已处理SSL终止时
• 云服务CDN场景：配合Cloudflare、AWS CloudFront等CDN服务使用，确保用户通过HTTPS访问
• 多服务统一重定向：在微服务架构中作为统一的HTTPS重定向入口，避免在各服务中重复实现重定向逻辑
• 容器化应用安全加固：为未实现HTTPS重定向的应用提供额外安全层

使用方法与配置说明

基本使用（docker run）

bash
docker run -d \
  --name https-redirector \
  -p 80:80 \
  -e REDIRECT_STATUS_CODE=301 \
  your-image-name:latest

Docker Compose配置

yaml
version: '3.8'

services:
  https-redirect:
    image: your-image-name:latest
    container_name: https-redirector
    ports:
      - "80:80"
    environment:
      - REDIRECT_STATUS_CODE=302  # 可选，默认301
      - LISTEN_PORT=80             # 可选，默认80
    restart: unless-stopped

配置参数说明

工作流程

1. 客户端发送HTTP请求到反向代理服务器
2. 反向代理服务器添加X-Forwarded-Proto: http请求头并转发请求到本镜像容器
3. 容器检测到X-Forwarded-Proto值为http，生成HTTPS版本URL（替换协议部分）
4. 返回配置的重定向状态码和HTTPS URL给客户端
5. 客户端根据重定向响应重新发起HTTPS请求

注意事项

• 确保反向代理服务器已正确配置并传递X-Forwarded-Proto请求头
• 重定向目标域名与原始请求域名保持一致，不支持跨域重定向
• 对于需要保留原始主机头的场景，确保反向代理正确传递Host请求头

示例场景

在Traefik反向代理环境中使用：

yaml
# docker-compose.yml片段
services:
  traefik:
    image: traefik:v2.9
    # Traefik配置...
    
  https-redirector:
    image: your-image-name:latest
    environment:
      - REDIRECT_STATUS_CODE=301
    labels:
      - "traefik.http.routers.redirector.rule=Host(`example.com`)"
      - "traefik.http.routers.redirector.entrypoints=web"
      - "traefik.http.services.redirector.load***.server.port=80"

以上配置将使所有发送到example.com的HTTP请求被重定向到[***]。