pcfens/redirector

Redirector镜像说明

镜像概述

Redirector是一个轻量级Web服务器，核心功能是根据YAML配置文件实现HTTP流量的灵活重定向。支持本地/远程配置文件、动态重载规则等特性，适用于多种场景下的流量引导需求。

核心功能

1. 多规则支持：可通过正则表达式定义重定向规则，支持源IP范围匹配、正则替换等复杂逻辑
2. 灵活配置：配置文件可本地挂载或远程加载，支持环境变量覆盖配置项
3. 动态重载：发送HTTP GET请求到/reload接口即可更新规则，无需重启服务
4. 多目标处理：同一规则可设置多个目标，根据条件返回不同重定向结果

使用场景

• 域名跳转（如HTTP转HTTPS、旧域名迁移到新域名）
• 内部网络与外部网络的差异化重定向（基于源IP段）
• 路径级别的URL重写与引导
• 避免404错误的兜底重定向配置

配置说明

主配置文件

主配置文件（默认config.yaml）示例：

yaml
bind_address: 0.0.0.0:8080
redirects:
  - rules.yaml

• bind_address：服务器监听地址与端口，可通过环境变量BIND_ADDRESS覆盖
• redirects：重定向规则文件列表（支持本地文件或HTTP/HTTPS远程地址），可通过环境变量REDIRECT_SOURCE设置（多值用逗号分隔）

重定向规则示例

1. 基础域名跳转：

yaml
- name: Blah域名迁移
  pattern: ^(www\.)?blahblahblah.com\/
  targets:
  - target: https://somethingdifferent.com/
    code: 301

2. 源IP条件重定向：

yaml
- name: TV服务访问控制
  pattern: ^tv\.university\.edu/
  targets:
  - target: https://contour.university.edu
    code: 302
    when:
      source:
        - 10.0.0.0/8
        - 192.168.1.0/24
  - target: https://google.com
    code: 302

3. 正则替换重定向：

yaml
- name: HTTP转HTTPS并替换域名
  pattern: ^(www\.)?(?P<name>[a-zA-Z0-9\-]+).com\/
  targets:
  - target: https://${name}.university.edu/
    code: 301

部署示例

Docker Run命令

bash
docker run -d \
  -p 8080:8080 \
  -v $(pwd)/config.yaml:/app/config.yaml \
  -v $(pwd)/rules.yaml:/app/rules.yaml \
  pcfens/redirector

环境变量覆盖配置

bash
docker run -d \
  -p 80:8080 \
  -e BIND_ADDRESS=0.0.0.0:8080 \
  -e REDIRECT_SOURCE=https://example.com/rules.yaml \
  pcfens/redirector

动态重载规则

向容器发送重载请求：

bash
curl http://<容器IP>:8080/reload