caprover/nginx-redirect

nginx-redirect 镜像文档

概述

nginx-redirect是一个基于nginx和Docker的极简重定向工具，旨在提供简单高效的域名流量重定向解决方案。通过简单配置即可实现将一个或多个域名的流量重定向至目标地址，支持HTTP/HTTPS协议，并可作为CapRover一键应用快速部署。

核心功能

• 极简配置：通过环境变量快速定义重定向规则
• 多域名支持：可同时连接多个域名并统一重定向至目标地址
• HTTPS兼容：支持为已连接域名启用HTTPS加密
• 轻量高效：基于nginx构建，资源占用低，响应迅速

使用场景

适用于需要创建域名别名或统一流量入口的场景，例如：

• 将http(s)://www.example.com重定向至https://example.com
• 多个子域名（如blog.example.com、docs.example.com）统一重定向至主站
• 临时域名过渡期间的流量转发

使用方法

直接通过Docker运行

bash
docker run -p 1234:80 --env RETURN_LOCATION='return 301 https://caprover.com$request_uri;' caprover/nginx-redirect

运行后，访问http://localhost:1234即可看到重定向效果。

作为CapRover一键应用使用

1. 在CapRover面板中创建"Nginx Redirect"一键应用，输入目标重定向URL（如https://example.com）
2. 应用部署完成后，进入面板将需要重定向的域名（如www.example.com）连接到该应用
3. 可根据需求添加多个域名（如www2.example.com、old.example.com等）
4. 如需启用HTTPS，在域名管理中为已添加的域名开启HTTPS选项
5. 完成配置后，访问任何已连接的域名将自动重定向至目标URL

配置参数说明

注：$request_uri变量会保留原始请求路径，确保重定向时路径信息不丢失。