thedxw/bouncer

bouncer 镜像文档

镜像概述

bouncer是一个基于Rack框架的重定向服务，主要功能是从https://github.com/alphagov/transition%E5%88%9B%E5%BB%BA%E7%9A%84%E6%98%A0%E5%B0%84%E5%85%B3%E7%B3%BB%E4%B8%AD%E6%8F%90%E4%BE%9B301%EF%BC%88%E6%B0%B8%E4%B9%85%E9%87%8D%E5%AE%9A%E5%90%91%EF%BC%89%E5%92%8C410%EF%BC%88%E6%B0%B8%E4%B9%85%E7%A7%BB%E9%99%A4%EF%BC%89HTTP%E5%93%8D%E5%BA%94%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E5%9F%9F%E5%90%8D%E8%BF%81%E7%A7%BB%E3%80%81%E8%B7%AF%E5%BE%84%E8%B0%83%E6%95%B4%E6%88%96%E8%B5%84%E6%BA%90%E4%B8%8B%E7%BA%BF%E5%9C%BA%E6%99%AF%E3%80%82

核心功能与特性

• 基于Rack框架：轻量级Web服务架构，易于集成和扩展
• 响应类型支持：提供301永久重定向和410永久移除两种HTTP状态码
• 动态映射管理：重定向规则来源于Transition创建的映射数据，支持动态更新
• 灵活配置：可通过Nginx反向代理等方式实现域名级别的重定向测试与部署

使用场景与适用范围

适用于需要测试或部署域名重定向、路径迁移或资源下线功能的开发环境，特别适合依赖Transition工具管理重定向规则的技术团队。

使用方法与配置说明

开发环境浏览器测试步骤

以下步骤假设已满足：使用开发虚拟机（Dev VM）、bouncer服务已运行、Transition/Bouncer数据库中存在测试数据。以测试bis.gov.uk域名为例：

1. 获取虚拟机IP地址

在本地终端执行以下命令获取Dev VM的IP地址：

bash
ping transition.dev.gov.uk

记录返回的IP地址（示例：10.1.1.254）。

2. 修改本地hosts文件

在本地终端编辑hosts文件：

bash
cat /etc/hosts

添加以下条目（使用实际获取的VM IP）：

10.1.1.254 dev.bis.gov.uk

3. 配置Nginx站点（虚拟机内操作）

以root身份在虚拟机中创建Nginx配置文件：

bash
cat /etc/nginx/sites-available/bis.gov.uk

配置文件内容：

nginx
server {
  server_name dev.bis.gov.uk;
  listen 80;

  location / {
    proxy_pass http://bouncer.dev.gov.uk-proxy;
    proxy_set_header Host bis.gov.uk;
  }
}

4. 启用Nginx配置并重启服务

创建符号链接并重启Nginx：

bash
sudo ln -s /etc/nginx/sites-available/bis.gov.uk /etc/nginx/sites-enabled/bis.gov.uk
sudo service nginx restart

5. 验证测试结果

在浏览器中访问http://dev.bis.gov.uk/410，验证是否成功返回410响应。