bostonuniversity/traffic-splitter

HTTP流量分流器

https://travis-ci.org/bu-ist/bu-traffic-splitter.svg?branch=master](https://travis-ci.org/bu-ist/bu-traffic-splitter)

此Docker镜像适用于开发环境，可将来自一个容器的HTTP请求重新路由到另外两个容器，帮助开发者灵活管理流量分配。

环境变量

• DEBUG：设置为1时可查看生成的NGINX配置。
• DNS_RESOLVER：指定自定义DNS解析器IP，默认auto自动解析容器默认解析器，失败则用127.0.0.11（适用于Docker网络）。
• DNS_RESOLVER_TIMEOUT：DNS响应缓存时长。

核心功能

1. 按掩码拆分流量：根据请求路径掩码将流量转发到不同容器。
2. 拦截外部流量：将开发环境中外部资源请求拦截并转发到本地服务。
3. 修改请求头：支持自定义Host和Referer头，适配受保护服务。

使用场景及示例

场景1：按掩码拆分静态与动态内容

将默认请求转发到动态服务，含static掩码的请求转发到静态服务。

yaml
version: "3.4"
services:
  app-server: # 动态内容服务
  static-content: # 静态内容服务
  splitter:
    image: docker.xuanyuan.run/bostonuniversity/traffic-splitter:latest
    ports: [3000:80]
    environment:
      DEFAULT_URL: http://app-server:80
      ALTERNATE_MASK: static
      ALTERNATE_URL: http://static-content:80
    depends_on: [app-server, static-content]

场景2：自定义替代URL的Host头

当替代服务需要特定Host时，用ALTERNATE_HOST设置。

yaml
version: "3.4"
services:
  app-server: # 动态内容服务
  splitter:
    image: docker.xuanyuan.run/bostonuniversity/traffic-splitter:latest
    ports: [3000:80]
    environment:
      DEFAULT_URL: http://app-server:80
      ALTERNATE_MASK: static
      ALTERNATE_URL: http://protected-host.com
      ALTERNATE_HOST: protected-host.com
    depends_on: [app-server]

场景3：拦截CDN资源到本地

将开发环境中CDN请求拦截并转发到本地静态服务。

yaml
version: "3.4"
services:
  app-server: # 动态内容服务
  static-content: # 本地静态服务
  splitter:
    image: docker.xuanyuan.run/bostonuniversity/traffic-splitter:latest
    ports: [3000:80]
    environment:
      DEFAULT_URL: http://app-server:80
      ALTERNATE_URL: http://static-content:80
      INTERCEPT_MASK: cdn.com
    depends_on: [app-server]

场景4：自定义拦截流量的Referer头

当外部资源需要特定Referer时，用ALTERNATE_REF设置。

yaml
version: "3.4"
services:
  app-server: # 动态内容服务
  splitter:
    image: bostonuniversity/traffic-splitter:latest
    ports: [3000:80]
    environment:
      DEBUG: 1
      DEFAULT_URL: [***]
      INTERCEPT_MASK: protected.cdn.com
      ALTERNATE_REF: authorized.application.com
    depends_on: [app-server]