.NET Core限制请求频率中间件 AspNetCoreRateLimit

时间：12-15来源：作者：点击数：49

在.NET Core中，我们可以使用ASP.NET Core的中间件来对Web API进行流量限制。ASP.NET Core提供了一个名为RateLimit的开源库，可以方便地实现流量限制功能。下面将详细介绍如何在.NET Core中使用RateLimit库对Web API进行流量限制，并给出相应的示例代码。

安装RateLimit库

首先，我们需要在.NET Core项目中安装RateLimit库。可以通过NuGet包管理器或者dotnet命令行工具来安装该库。

dotnet add package AspNetCoreRateLimit

配置流量限制

在项目的Startup.cs文件中，我们需要进行一些配置来启用流量限制功能。具体步骤如下：

导入相关命名空间

在Startup.cs文件中，导入AspNetCoreRateLimit命名空间。

using AspNetCoreRateLimit;

添加流量限制配置

在ConfigureServices方法中，添加流量限制配置。

public void ConfigureServices(IServiceCollection services)
{
    // 添加流量限制配置
    services.AddOptions();
    services.AddMemoryCache();
    services.Configure<IpRateLimitOptions>(Configuration.GetSection("IpRateLimiting"));
    services.Configure<IpRateLimitPolicies>(Configuration.GetSection("IpRateLimitPolicies"));
    services.AddSingleton<IIpPolicyStore, MemoryCacheIpPolicyStore>();
    services.AddSingleton<IRateLimitCounterStore, MemoryCacheRateLimitCounterStore>();
    services.AddSingleton<IRateLimitConfiguration, RateLimitConfiguration>();
}

添加流量限制中间件

在Configure方法中，添加流量限制中间件。

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // 添加流量限制中间件
    app.UseIpRateLimiting();
    
    // 其他中间件配置
    // ...
}

添加流量限制配置文件

在appsettings.json文件中，添加流量限制的配置项。

{
  "IpRateLimiting": {
    "EnableEndpointRateLimiting": true,
    "StackBlockedRequests": false,
    "RealIpHeader": "X-Real-IP",
    "ClientIdHeader": "X-ClientId",
    "HttpStatusCode": 429,
    "GeneralRules": [
      {
        "Endpoint": "*",
        "Period": "1s",
        "Limit": 5
      }
    ]
  },
  "IpRateLimitPolicies": {
    "EndpointRateLimitPolicy": {
      "Period": "1s",
      "Limit": 10
    }
  }
}

以上配置中，我们设置了一个通用规则（GeneralRules），即每秒最多允许5个请求。可以根据实际需求进行调整。

使用流量限制

在需要进行流量限制的Web API接口上，我们可以通过使用RateLimit特性来启用流量限制。具体步骤如下：

导入相关命名空间

在需要进行流量限制的控制器文件中，导入AspNetCoreRateLimit命名空间。

using AspNetCoreRateLimit;

添加流量限制特性

在需要进行流量限制的接口方法上，添加RateLimit特性。

[RateLimit("EndpointRateLimitPolicy")]
[HttpGet]
public IActionResult Get()
{
    // 接口逻辑
    // ...
}

在上述代码中，我们使用了名为EndpointRateLimitPolicy的流量限制策略。可以根据实际需求进行调整。

完整示例代码

下面给出一个完整的示例代码，演示如何在.NET Core中使用RateLimit库对Web API进行流量限制。假设我们要对一个简单的GET接口进行流量限制。

using AspNetCoreRateLimit;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

namespace RateLimitExample
{
    public class Startup
    {
        public Startup(IConfiguration configuration)
        {
            Configuration = configuration;
        }

        public IConfiguration Configuration { get; }

        public void ConfigureServices(IServiceCollection services)
        {
            services.AddControllers();

            // 添加流量限制配置
            services.AddOptions();
            services.AddMemoryCache();
            services.Configure<IpRateLimitOptions>(Configuration.GetSection("IpRateLimiting"));
            services.Configure<IpRateLimitPolicies>(Configuration.GetSection("IpRateLimitPolicies"));
            services.AddSingleton<IIpPolicyStore, MemoryCacheIpPolicyStore>();
            services.AddSingleton<IRateLimitCounterStore, MemoryCacheRateLimitCounterStore>();
            services.AddSingleton<IRateLimitConfiguration, RateLimitConfiguration>();
        }

        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            app.UseRouting();

            // 添加流量限制中间件
            app.UseIpRateLimiting();

            app.UseEndpoints(endpoints =>
            {
                endpoints.MapControllers();
            });
        }
    }

    [ApiController]
    [Route("api/[controller]")]
    public class TestController : ControllerBase
    {
        [RateLimit("EndpointRateLimitPolicy")]
        [HttpGet]
        public IActionResult Get()
        {
            // 接口逻辑
            return Ok("Hello, World!");
        }
    }
}