docker-redirector 镜像文档

镜像概述与主要用途

docker-redirector 是一个基于 NGINX 的轻量级镜像，用于将所有传入流量重定向到指定的 URL。该镜像设计用于反向代理后端，主要解决旧的或不再使用的（子）域名的流量重定向需求。

核心功能与特性

• 简单配置：通过环境变量即可完成所有重定向参数设置
• URI 保留：支持保留原始请求的 URI 路径（如将 a.example.com/bla 重定向到 b.example.com/bla）
• ACME 挑战处理：可配置对 ACME 挑战请求返回 404，避免与反向代理的证书验证冲突
• 日志控制：支持自定义访问日志路径或禁用日志输出

使用场景与适用范围

• 旧域名/子域名迁移：将废弃域名的所有流量统一重定向到新域名
• 反向代理后端服务：作为 Traefik、Nginx Proxy Manager 等反向代理的后端，处理特定域名的重定向逻辑
• 临时重定向需求：快速部署临时域名指向正式服务

配置说明

通过环境变量进行配置，支持以下参数：

使用方法

Docker 命令示例

基础重定向（不保留 URI）

将所有请求重定向到指定仓库：

bash
docker run -e dest='[***] -e access_log='off' -e keep_uri='false' -it cryptkiddie2/redirector:latest

保留 URI 的重定向

将 a.example.com/bla 重定向到 b.example.com/bla：

bash
docker run -e dest='[***] -e access_log='off' -e keep_uri='true' -it cryptkiddie2/redirector:latest

Docker Compose 示例

***提供了 示例 docker-compose.yml 文件，基础配置参考如下：

yaml
version: '3'
services:
  redirector:
    image: cryptkiddie2/redirector:latest
    environment:
      - dest=[***]
      - access_log=off
      - keep_uri=true
    ports:
      - "80:80"

待办事项与已知问题

待办事项

• 支持在单个容器中配置多源重定向规则

已知问题

• 不支持 HTTPS 协议（原作者场景中通过 Traefik 等反向代理处理 HTTPS，因此不影响使用）