morbz/docker-web-redirect

Docker-Web-Redirect

!Docker Build Status !Docker Pulls !Docker Stars

此Docker容器监听80端口，将所有Web流量重定向到指定的目标域名/URL。

核心功能与特性

• 轻量级：在Linux系统上仅占用约2MB内存
• 路径与参数保留：自动保留原始URL的路径和GET参数
• 灵活的重定向类型：支持永久重定向（默认）和临时重定向

使用场景

• 域名迁移时将旧域名流量重定向到新域名
• 网站重构后将旧URL路径重定向到新路径
• 需要临时将流量引导至替代站点（如维护期间）

使用方法与配置说明

Docker run 部署

通过REDIRECT_TARGET环境变量设置目标域名/URL。支持的目标类型包括：

• 域名（如mydomain.net）
• 带路径的域名（如mydomain.net/my_page）
• 带协议的完整URL（如https://mydomain.net/my_page）

示例命令：

bash
docker run --rm -d -e REDIRECT_TARGET=mydomain.net -p 80:80 morbz/docker-web-redirect

路径与参数保留机制

重定向时会自动保留原始请求的URL路径和GET参数。例如：

• 当设置REDIRECT_TARGET=mydomain.net时，对http://myolddomain.net/index.php?page=2的请求将重定向到http://mydomain.net/index.php?page=2

永久重定向（默认）

默认使用HTTP 301状态码（永久重定向），特点：

• 浏览器会缓存重定向规则，后续请求将直接访问新地址
• 搜索引擎会识别并更新索引中的URL
• 不适合临时场景（如网站维护）

临时重定向

通过设置REDIRECT_TYPE环境变量为redirect，可启用HTTP 302状态码（临时重定向）：

bash
docker run --rm -d -e REDIRECT_TARGET=mydomain.net -e REDIRECT_TYPE=redirect -p 80:80 morbz/docker-web-redirect

Docker Compose 配置

可与https://hub.docker.com/r/jwilder/nginx-proxy/%E9%85%8D%E5%90%88%E4%BD%BF%E7%94%A8%E3%80%82%E4%BB%A5%E4%B8%8B%E7%A4%BA%E4%BE%8B%E5%B0%86%60myolddomain.net%60%E9%87%8D%E5%AE%9A%E5%90%91%E5%88%B0%60mydomain.net%60%EF%BC%9A

yaml
version: '3'
services:
  redirect:
    image: morbz/docker-web-redirect
    restart: always
    environment:
      - VIRTUAL_HOST=myolddomain.net
      - REDIRECT_TARGET=mydomain.net