概述
Fess 具有速率限制功能，用于维护系统的稳定性和性能。 通过此功能，可以保护系统免受过度请求的影响，实现公平的资源分配。
速率限制适用于以下场景:
包括搜索API和AI模式API在内的所有HTTP请求（
RateLimitFilter）爬虫请求（通过爬取设置进行控制）
HTTP请求的速率限制
可以按IP地址单位限制对 Fess 的HTTP请求数。 此限制适用于搜索API、AI模式API、管理界面等所有HTTP请求。
设置
app/WEB-INF/conf/fess_config.properties:
# 启用速率限制（默认: false）
rate.limit.enabled=true
# 每个IP地址每个窗口的最大请求数（默认: 100）
rate.limit.requests.per.window=100
# 窗口大小（毫秒）（默认: 60000）
rate.limit.window.ms=60000
行为
超过速率限制的请求返回HTTP 429 (Too Many Requests)
被阻止的IP地址的请求返回HTTP 403 (Forbidden)
限制按IP地址单位应用
每个IP从首次请求开始计算窗口，窗口期间过后计数重置（固定窗口方式）
超过限制时，IP会被阻止
rate.limit.block.duration.ms的期间
AI模式的速率限制
AI模式功能具有速率限制，用于控制LLM API的成本和资源消耗。 AI模式除了上述HTTP请求速率限制外，还可以设置AI模式固有的速率限制。
AI模式固有的速率限制设置请参阅 AI模式功能配置。
Note
AI模式的速率限制与LLM提供商端的速率限制分别应用。 请同时考虑两者的限制进行设置。
爬虫的速率限制
可以设置请求间隔，以避免爬虫对目标站点造成过度负载。
Web爬取设置
在管理界面的「爬虫」→「Web」中设置以下内容:
请求间隔: 请求间的等待时间（毫秒）
线程数: 并行爬取线程数
推荐设置:
# 一般站点
intervalTime=1000
numOfThread=1
# 大型站点（有授权时）
intervalTime=500
numOfThread=3
遵守robots.txt
Fess 默认遵守robots.txt的Crawl-delay指令。
# robots.txt示例
User-agent: *
Crawl-delay: 10
速率限制的全部配置项
app/WEB-INF/conf/fess_config.properties 中可配置的所有属性。
| 属性 | 说明 | 默认值 |
|---|---|---|
rate.limit.enabled | 启用速率限制 | false |
rate.limit.requests.per.window | 每个窗口的最大请求数 | 100 |
rate.limit.window.ms | 窗口大小（毫秒） | 60000 |
rate.limit.block.duration.ms | 超过限制时的IP阻止期间（毫秒） | 300000 |
rate.limit.retry.after.seconds | Retry-After响应头的值（秒） | 60 |
rate.limit.whitelist.ips | 从速率限制中排除的IP地址（逗号分隔） | 127.0.0.1,::1 |
rate.limit.blocked.ips | 要阻止的IP地址（逗号分隔） | （空） |
rate.limit.trusted.proxies | 信任的代理IP（从X-Forwarded-For/X-Real-IP获取客户端IP） | 127.0.0.1,::1 |
rate.limit.cleanup.interval | 防止内存泄漏的清理间隔（请求数） | 1000 |
高级速率限制设置
自定义速率限制
要根据特定条件应用不同的速率限制逻辑， 需要实现自定义组件。
// RateLimitHelper自定义示例
public class CustomRateLimitHelper extends RateLimitHelper {
@Override
public boolean allowRequest(String ip) {
// 自定义逻辑
}
}
排除设置
可以将特定IP地址从速率限制中排除或阻止。
# 白名单IP（从速率限制中排除，逗号分隔）
rate.limit.whitelist.ips=127.0.0.1,::1,192.168.1.100
# 阻止IP列表（始终阻止，逗号分隔）
rate.limit.blocked.ips=203.0.113.50
# 信任的代理IP（逗号分隔）
rate.limit.trusted.proxies=127.0.0.1,::1
Note
使用反向代理时，请将代理的IP地址设置在 rate.limit.trusted.proxies 中。 仅从信任的代理发出的请求，才会从X-Forwarded-For和X-Real-IP头获取客户端IP。
监控与告警
用于监控速率限制状况的设置:
日志输出
应用速率限制时，会记录在日志中:
<Logger name="org.codelibs.fess.helper.RateLimitHelper" level="INFO"/>
故障排除
正常请求被阻止
原因: 限制值过于严格
解决方法:
增加
rate.limit.requests.per.window将特定IP添加到白名单（
rate.limit.whitelist.ips）调整窗口大小（
rate.limit.window.ms）
速率限制不生效
原因: 设置未正确生效
确认事项:
是否设置了
rate.limit.enabled=true配置文件是否正确加载
是否重启了 Fess
性能影响
速率限制检查本身影响性能时:
利用白名单跳过信任IP的检查
禁用速率限制（
rate.limit.enabled=false）