Rack-Throttle 使用指南

Rack-Throttle 使用指南

【免费下载链接】rack-throttle Rack middleware for rate-limiting incoming HTTP requests. 项目地址: https://gitcode.com/gh_mirrors/ra/rack-throttle

1. 项目介绍

Rack-Throttle 是一个用于Ruby on Rails应用程序的Rack中间件，提供了一种机制来限制HTTP请求的速率，以防止服务过载或滥用。尽管该项目已被标记为DEPRECATED，推荐使用更活跃维护的 rack-attack 作为替代，但Rack-Throttle仍然对于一些特定场景下希望维持旧实现或探索不同率限策略的开发者有一定的参考价值。它支持基于时间间隔的请求限制，比如每秒、每分钟、每小时及每天的请求次数。

2. 项目快速启动

安装

首先，通过RubyGems安装Rack-Throttle：

gem install rack-throttle

之后，在你的Rack应用程序的配置中加入以下代码，以实现基本的速率限制，例如限制每个IP地址每分钟只能发送60个请求：

# config.ru 或你的 Rack 应用初始化文件
require 'rack/throttle'

use Rack::Throttle::Minute, max: 60

run lambda { |env|
  [
    200,
    {'Content-Type' => 'text/plain'},
    "Hello, World!\n"
  ]
}

确保将上述代码片段置于你的应用程序服务器处理之前，这样每次请求都会先经过速率限制器。

3. 应用案例和最佳实践

自定义条件限制

你可以根据具体需求调整限制逻辑，如基于用户角色或者特定的请求路径进行限流：

limit_proc = proc { |req| 
  if req.env["REMOTE_USER"] == "admin"
    100 # 允许管理员每分钟100次请求
  else
    1   # 普通用户每分钟仅允许1次请求
  end
}

period_proc = proc { |req| 
  if req.env["REMOTE_USER"] == "admin"
    60  # 重置周期为1分钟
  else
    60  # 对于普通用户也保持1分钟重置周期
  end
}

Rack::Attack.throttle('request_per_user', limit: limit_proc, period: period_proc) do |req|
  req.ip
end

高级策略结合

为了创建更加复杂的限流策略，可以组合多个不同的速率限制规则：

use Rack::Throttle::Daily, :max => 1000
use Rack::Throttle::Hourly, :max => 100
use Rack::Throttle::Minute, :max => 60
use Rack::Throttle::Second, :max => 1

4. 典型生态项目

虽然Rack-Throttle本身是针对Rack应用程序的限流解决方案，但在现代Ruby on Rails项目中，如前所述，Rack-Attack 是更为流行的替代选项，它拥有更丰富的功能和社区支持。如果你正寻找集成度更高、功能更多的限流工具，考虑迁移到 Rack-Attack 并利用其与Rails生态更好的整合能力，例如与ActiveSupport的通知系统集成，来实现更精细的行为跟踪和自定义逻辑。

---

以上就是关于Rack-Throttle的基本使用和一些建议。鉴于项目已不再更新，建议在新的开发项目中评估使用更现代化且得到持续维护的解决方案。

【免费下载链接】rack-throttle Rack middleware for rate-limiting incoming HTTP requests. 项目地址: https://gitcode.com/gh_mirrors/ra/rack-throttle