dalf/filtron

⚠️ 该仓库已归档，不再更新。 ⚠️

Filtron

镜像概述

Filtron是一款反向HTTP代理工具，旨在通过自定义规则过滤请求，保护应用后端免受滥用。它最初为Searx（元搜索引擎）设计，现可用于防护各类Web应用。

核心功能

• 基于规则过滤HTTP请求，支持设置请求频率限制
• 提供多种动作：日志记录、阻止请求（返回429状态码）、执行Shell命令
• 支持选择器提取请求属性（IP、路径、方法、参数、Cookie、Header等）
• 提供REST API（默认监听127.0.0.1:4005）用于配置管理，及WebUI界面

使用场景

• 保护Web应用后端，防止频繁请求或***访问
• 为元搜索引擎（如Searx）提供访问控制
• 对特定请求（如特定User-Agent、参数）进行限制

配置说明

规则结构

每个规则需包含name（名称）和actions（动作），可选属性包括limit（请求限制）、interval（时间区间）、filters（过滤器）、aggregations（聚合器）、subrules（子规则）等。

示例规则：

json
{
    "name": "示例规则",
    "interval": 60,
    "limit": 10,
    "filters": ["GET:q", "Header:User-Agent=^curl"],
    "actions": [
        {"name": "log", "params": {"destination": "stderr"}},
        {"name": "block", "params": {"message": "不允许访问"}}
    ]
}

说明：允许每分钟10次带有GET参数q且User-Agent以curl开头的请求，超出限制则记录到stderr并阻止请求。

选择器语法

选择器用于提取请求属性，格式为[!]RequestAttribute[:SubAttribute][=Regex]：

• !：否定选择器
• RequestAttribute：请求属性（如IP、Host、Path、Method、GET、POST等）
• SubAttribute：子属性（如GET参数名、Header键）
• Regex：正则表达式过滤值

示例：

• IP：返回客户端IP
• GET:x：返回GET参数x
• !Header:Accept-Language：无Accept-Language Header时匹配
• `Path=^/(x|y)⚠️ 该仓库已归档，不再更新。 ⚠️

Filtron

镜像概述

Filtron是一款反向HTTP代理工具，旨在通过自定义规则过滤请求，保护应用后端免受滥用。它最初为Searx（元搜索引擎）设计，现可用于防护各类Web应用。

核心功能

• 基于规则过滤HTTP请求，支持设置请求频率限制
• 提供多种动作：日志记录、阻止请求（返回429状态码）、执行Shell命令
• 支持选择器提取请求属性（IP、路径、方法、参数、Cookie、Header等）
• 提供REST API（默认监听127.0.0.1:4005）用于配置管理，及WebUI界面

使用场景

• 保护Web应用后端，防止频繁请求或***访问
• 为元搜索引擎（如Searx）提供访问控制
• 对特定请求（如特定User-Agent、参数）进行限制

配置说明

规则结构

每个规则需包含name（名称）和actions（动作），可选属性包括limit（请求限制）、interval（时间区间）、filters（过滤器）、aggregations（聚合器）、subrules（子规则）等。

示例规则：

json
{
    "name": "示例规则",
    "interval": 60,
    "limit": 10,
    "filters": ["GET:q", "Header:User-Agent=^curl"],
    "actions": [
        {"name": "log", "params": {"destination": "stderr"}},
        {"name": "block", "params": {"message": "不允许访问"}}
    ]
}

说明：允许每分钟10次带有GET参数q且User-Agent以curl开头的请求，超出限制则记录到stderr并阻止请求。

选择器语法

选择器用于提取请求属性，格式为[!]RequestAttribute[:SubAttribute][=Regex]：

• !：否定选择器
• RequestAttribute：请求属性（如IP、Host、Path、Method、GET、POST等）
• SubAttribute：子属性（如GET参数名、Header键）
• Regex：正则表达式过滤值

示例：

• IP：返回客户端IP
• GET:x：返回GET参数x
• !Header:Accept-Language：无Accept-Language Header时匹配
• ：路径为/x或/y时匹配

Docker部署示例

bash
docker run -d \
  -p 8080:8080 \
  -v /本地路径/rules.json:/app/rules.json \
  dalf/filtron \
  --rules /app/rules.json \
  --listen 0.0.0.0:8080

说明：挂载本地规则文件，监听8080端口提供代理服务。