جریان محدود کننده فیبر Go

محدود‌کننده

این یک میان‌افزار برای Fiber است که برای محدود کردن درخواست‌های تکراری به API‌ها و یا نقاط پایانی عمومی (مانند بازنشانی رمز عبور) استفاده می‌شود. همچنین برای محدود کردن نرخ مشتریان API، وب‌کرال‌ها و یا سایر وظایفی که نیاز به محدودکردن نرخ دارند، مفید است.

نکته: این میان‌افزار از بسته Storage ما برای پشتیبانی از انواع مختلف پایگاه‌داده‌ها از طریق یک رابط یکپارچه استفاده می‌کند. تنظیم پیش‌فرض داده‌ها را در حافظه ذخیره می‌کند و شما می‌توانید به مثال زیر مراجعه کنید تا دیگر پایگاه‌داده‌ها را مشاهده کنید.

نکته: به طور پیش‌فرض، این ماژول از وضعیت با فرایندها/سرورهای دیگر به اشتراک گذاشته نمی‌کند.

امضا

func New(config ...Config) fiber.Handler

مثال

بسته میان‌افزار را به عنوان بخشی از چارچوب وب Fiber وارد کنید:

import (
  "github.com/gofiber/fiber/v2"
  "github.com/gofiber/fiber/v2/middleware/limiter"
)

پس از ایجاد برنامه Fiber، می‌توانید از گزینه‌های زیر استفاده کنید:

// با پیکربندی پیش‌فرض مقدماتی
app.Use(limiter.New())

// یا با پیکربندی سفارشی گسترده
app.Use(limiter.New(limiter.Config{
    Next: func(c *fiber.Ctx) bool {
        return c.IP() == "127.0.0.1"
    },
    Max:          20,
    Expiration:     30 * time.Second,
    KeyGenerator:          func(c *fiber.Ctx) string {
        return c.Get("x-forwarded-for")
    },
    LimitReached: func(c *fiber.Ctx) error {
        return c.SendFile("./toofast.html")
    },
    Storage: myCustomStorage{},
}))

پنجره لغزان

می‌توانید از الگوریتم پنجره لغزان به جای استفاده از الگوریتم پنجره ثابت استفاده کنید.

پیکربندی مثال به شکل زیر است:

app.Use(limiter.New(limiter.Config{
    Max:            20,
    Expiration:     30 * time.Second,
    LimiterMiddleware: limiter.SlidingWindow{},
}))

این به معنای آن است که هر پنجره شامل پنجره قبلی (در صورت وجود) خواهد بود. فرمول برای نرخ داده شده به شرح زیر است:

وزن پنجره قبلی = تعداد درخواست‌های پنجره قبلی * (زمان جدید/Expiration)
نرخ = وزن پنجره قبلی + تعداد درخواست‌های فعلی پنجره.

پیکربندی

نکته: اگر ذخیره‌سازی سفارشی رابط Storage را پیاده‌سازی می‌کند، می‌توانید از ذخیره‌سازی سفارشی استفاده کنید - برای اطلاعات بیشتر و مثال‌ها، لطفا به store.go مراجعه کنید.

پیکربندی پیش‌فرض

var ConfigDefault = Config{
    Max:        5,
    Expiration: 1 * time.Minute,
    KeyGenerator: func(c *fiber.Ctx) string {
        return c.IP()
    },
    LimitReached: func(c *fiber.Ctx) error {
        return c.SendStatus(fiber.StatusTooManyRequests)
    },
    SkipFailedRequests: false,
    SkipSuccessfulRequests: false,
    LimiterMiddleware: FixedWindow{},
}

انبار داده/پایگاه داده سفارشی

شما می‌توانید از هر روش ذخیره‌سازی در بسته انبار ما استفاده کنید.

storage := sqlite3.New() // از طریق github.com/gofiber/storage/sqlite3
app.Use(limiter.New(limiter.Config{
    Storage: storage,
}))