jamessharp/docker-nginx-https-redirect

docker-nginx-https-redirect

镜像概述

docker-nginx-https-redirect是一个轻量级的Nginx容器，其核心功能是将所有接收到的HTTP请求自动重定向至HTTPS协议，确保网络通信的安全性。该镜像配置简单，无需复杂设置即可快速部署，适用于需要强制HTTPS访问的场景。

核心功能和特性

• HTTP到HTTPS重定向：自动将所有HTTP请求（默认端口80）重定向至HTTPS
• 轻量级：基于Nginx基础镜像构建，体积小，资源占用低
• 零配置：无需手动修改Nginx配置文件，开箱即用
• 通用性：可与任何支持HTTPS的后端服务配合使用

使用场景

• 作为Web服务的前置层，强制所有访问通过HTTPS进行
• 简化HTTPS部署流程，无需在应用层单独实现重定向逻辑
• 适用于需要满足安全合规要求（如HTTPS强制启用）的环境
• 作为反向代理架构中的重定向节点

使用方法

基本部署（docker run）

通过以下命令快速启动容器，将主机的80端口映射到容器的80端口：

bash
docker run -d -p 80:80 --name nginx-https-redirect docker-nginx-https-redirect

参数说明：

• -d：后台运行容器
• -p 80:80：将主机的80端口映射到容器的80端口，接收HTTP请求
• --name nginx-https-redirect：指定容器名称，便于管理

docker-compose配置

创建docker-compose.yml文件，内容如下：

yaml
version: '3'
services:
  nginx-https-redirect:
    image: docker-nginx-https-redirect
    ports:
      - "80:80"
    restart: always

启动服务：

bash
docker-compose up -d

工作原理

容器内部的Nginx配置已预设重定向规则，当接收到HTTP请求时，会返回301永久重定向响应，将请求指向对应的HTTPS地址（默认使用443端口）。例如，访问http://example.com/path会被重定向至https://example.com/path。

注意事项

• 该镜像仅处理HTTP到HTTPS的重定向，不包含HTTPS证书配置，需确保后端服务已正确配置HTTPS
• 若需自定义重定向端口或域名，可通过挂载自定义Nginx配置文件实现（如-v /path/to/nginx.conf:/etc/nginx/conf.d/default.conf）