إصلاح أخطاء 429 وحدود المعدل في SearXNG
تعرف على سبب ظهور الخطأ `Too Many Requests` في SearXNG، واقرأ السجل وعدادات API لتمييز المحدِّد المحلي من حظر طلبات الصور من المنبع وإصلاح السبب الصحيح.
لماذا يعيد SearXNG أخطاء 429
تصل نسخة SearXNG المستضافة ذاتياً إلى حدود المعدل في موضعين غير مرتبطين، وعادةً لا يكون حد المعدل الذي تحتاج إلى إصلاحه هو الحد الذي تتوقعه. يمكن لكل من التحديد المحلي وطلب صورة من المنبع أن ينتجا استجابة 429. الحالة الأولى محلية: يقرر المحدِّد الخاص بـSearXNG أن الطلب صادر عن روبوت، ويردّ على Too Many Requests برمز الحالة 429. كما تعيد نقطة النهاية /image توجيه حالات الخطأ من المنبع، بما فيها 429. الحالة الثانية منبعية: يرفض محرك بحث عنوان IP الخاص بخادمك. يضع SearXNG علامة على هذا المحرك باعتباره غير مستجيب ويعلّقه، بينما يستمر المستخدمون في الحصول على صفحة نتائج عادية تنقصها بعض النتائج، وليس على استجابة 429.
لا يوجد إصلاح مشترك للحالتين. المحدِّد تحت إدارتك، ولذلك يمكنك تغييره. يحدث الحظر من المنبع على جانب محرك البحث، ولذلك لن يؤدي تغيير المحدِّد المحلي إلى رفعه. يوضح السجل أي حالة تواجهها خلال نحو دقيقة، لذلك ابدأ بفحصه.
يفترض هذا الدليل استخدام تثبيت الحاوية الموضح في نسخة SearXNG مستضافة ذاتياً على VPS الخاص بك. تأتي كل أسماء الإعدادات أدناه من وثائق المنبع الحالية ومن الشيفرة المصدرية، وقد جرى التحقق منها في 16 November 2026.
اقرأ السجل قبل تغيير أي إعداد
أعد إنتاج المشكلة مع فتح نافذة للسجل. في ملف Compose الأساسي، تُسمّى خدمة SearXNG core، وتُسمّى الحاوية الخاصة بها searxng-core، بينما تستخدم أوامر docker compose اسم الخدمة:
cd ./searxng/
docker compose logs -f coreتصدر رسائل أداة التقييد من مسجّلين باسم searx.limiter وsearx.botdetection، وتذكر شبكة العميل. تظهر إصابة قائمة الحظر بالشكل BLOCK 203.0.113.10/32: matched BLOCKLIST، وتظهر إصابة قائمة السماح بالشكل PASS 203.0.113.10/32: matched PASSLIST، ويتبع كلّاً منهما الإدخال المطابق في القائمة. إذا تعذّر على أداة التقييد تهيئة مخزن العدادات، يظهر في السجل النص The limiter requires Valkey, please consult the documentation، وهذا يعني أن أداة التقييد لم تُثبَّت.
يُسجَّل كل فحص منفرد للروبوت عند مستوى debug، ولذلك لن تراه افتراضياً. فعّل debug لاختبار واحد في settings.yml:
general:
debug: trueيضيف السجل بعد ذلك أسطراً بالصيغة BLOCK 203.0.113.10/32: missing HTTP header Accept-Language، وتذكر هذه الأسطر شبكة العميل والرأس الذي فشل. عطّل debug بعد ذلك، لأن المشروع الأساسي يوصي بعدم تشغيل نسخة منشورة مع تفعيله.
تبدو أعطال المحركات مختلفة تماماً. فهي تذكر اسم محرك بدلاً من عنوان IP؛ وتُسجَّل رسالة انتهاء المهلة التفصيلية عند مستوى debug، بينما تُسجَّل رسالة engine timeout الخاصة بخيط البحث عند مستوى error:
HTTP requests timeout (search duration : 3.1 s, timeout: 3.0 s)توجد أيضاً صفحة مخصصة لذلك. عندما تترك enable_metrics على قيمته الافتراضية true، تسجّل نسختك أخطاء المحركات في /stats/errors، وتعرض /preferences المحركات التي تستجيب حالياً. يحدد الإدخال في /stats/errors فشل محرك، لكن غياب أسطر searx.limiter لا يستبعد حظر أداة التقييد، لأن الفحوص الفردية للروبوتات تستخدم searx.botdetection عند مستوى debug.
ثبّت الإصدار قبل أن تبدأ تصحيح أي مشكلة
يتكوّن إعداد الحاوية من المصدر الأساسي من ملفين.
mkdir -p ./searxng/core-config/
cd ./searxng/
curl -fsSL \
-O https://raw.githubusercontent.com/searxng/searxng/master/container/docker-compose.yml \
-O https://raw.githubusercontent.com/searxng/searxng/master/container/.env.example
cp -i .env.example .envيسحب ملف Compose القيمة docker.io/searxng/searxng:${SEARXNG_VERSION:-latest}. ويعني المتغير غير المعيّن القيمة latest، بينما يعني latest أن النسخة ستتغير دون تدخّل منك عند تنفيذ docker compose pull التالية. لذلك قد يتوقف إعداد عمل الأسبوع الماضي عن التطابق مع الشفرة التي تقرؤه. تتضمن وسوم SearXNG تاريخاً ورقم commit. والوسم الوارد في المثال ضمن المصدر الأساسي .env.example اعتباراً من October 2026 هو 2026.3.25-541c6c3cb، لذا عيّن قيمة فعلية في .env:
SEARXNG_VERSION=2026.3.25-541c6c3cbتحقق من الوسوم المنشورة وثبّت الإصدار الذي اختبرته فعلياً، ثم صحّح الأخطاء مقابل هدف ثابت. ويمكن لملف .env نفسه الاحتفاظ بمفتاحك السري عبر SEARXNG_SECRET، لذا اقرأ كيفية عمل ملفات البيئة والأسرار في Docker Compose قبل إيداع ذلك المجلد في أي مكان.
يحتاج محدِّد المعدل إلى Valkey، وإلا فلن يعمل
يحسب محدِّد المعدل الطلبات لكل عميل، ويجب مشاركة هذه العدادات بين عمليات العاملين. مخزن البيانات هذا هو Valkey، وهو fork مُصان من Redis. تستخدم الأدلة الأقدم لـSearXNG هذا الإعداد باسم redis:. تقرأ الإصدارات الحالية valkey:، لذلك انسخ اسم المفتاح من الوثائق الحالية بدلاً من منشور قديم. تعود بعض هذه الصفحات إلى ما هو أقدم، وتصف Searx بدلاً من SearXNG. هذان مشروعان مختلفان بقاعدة شيفرة ومحدِّد معدل مختلفين، لذلك تحقق من المشروع الذي كُتبت الصفحة من أجله قبل نسخ كتلة إعداد منها.
use_default_settings: true
server:
secret_key: "change-this-value"
limiter: true
public_instance: false
valkey:
url: valkey://searxng-valkey:6379/0يشغّل ملف compose الأساسي خدمة valkey على الصورة docker.io/valkey/valkey:9-alpine، داخل حاوية اسمها searxng-valkey. لذلك يُحل اسم المضيف هذا داخل شبكة compose. ويمكن ضبط القيمة نفسها باستخدام متغير البيئة SEARXNG_VALKEY_URL. كما يعمل عنوان URL لمقبس Unix، وهو unix:///path/to/socket.sock?db=0، عندما يشترك SearXNG وValkey في المضيف نفسه.
يعتمد ما يحدث عند غياب المخزن على مفتاح آخر. مع public_instance: false، يسجل محدِّد المعدل خطأ Valkey ثم يتوقف، لذلك يواصل المثيل الخدمة من دون أي تحديد للمعدل. مع public_instance: true، تستدعي العملية sys.exit(1) بدلاً من ذلك، ولا تخدم مثيلاً عاماً من دون حماية من الروبوتات. تحتاج الحاوية التي تعيد التشغيل في حلقة بعد خطأ تهيئة Valkey هذا إلى إصلاح اتصالها بـValkey.
ما الذي يحتسبه محدِّد المعدل فعلياً
البيانات وراء هذا الرسم البياني
[
{
"label": "Burst, link token off",
"max_requests": 15,
"window": "20 seconds"
},
{
"label": "Burst, flagged client",
"max_requests": 2,
"window": "20 seconds"
},
{
"label": "Sustained, link token off",
"max_requests": 150,
"window": "10 minutes"
},
{
"label": "Sustained, flagged client",
"max_requests": 10,
"window": "10 minutes"
},
{
"label": "Non-HTML format in URL query",
"max_requests": 4,
"window": "1 hour"
},
{
"label": "Flagged requests before block",
"max_requests": 3,
"window": "30 days"
}
]عند تعطيل التحقق من link-token، يحصل العميل على 15 طلباً ضمن نافذة اندفاع مدتها 20 ثانية، وعلى 150 طلباً ضمن نافذة مدتها 10 دقائق. عند تفعيله، يتجاوز العميل الذي ينجح في فحص link-token العدادين معاً؛ أما العميل المشتبه فيه فيحصل على 2 طلباً لكل نافذة اندفاع. أما الصف الأخير فهو الأشد: بعد 3 طلبات معلّمة ضمن نافذة مدتها 30 يوماً، يُعاد توجيه ذلك العنوان إلى صفحة البداية بدلاً من تنفيذ البحث، ويذكر السجل BLOCK: too many request from ... in SUSPICIOUS_IP_WINDOW (redirect to /). يؤدي اجتياز فحص link-token إلى تصفير عداد الطلبات المشتبه فيها لذلك العميل.
هذه الأرقام ثوابت في searx/botdetection/ip_limit.py. وهي ليست إعدادات، ولا يتيح limiter.toml تغييرها، لذلك يتطلب تغييرها تعديل المصدر. أما ما يتحكم فيه /etc/searxng/limiter.toml فهو بادئات العناوين المستخدمة لتجميع العملاء، وقائمة الوكلاء الموثوقين، وفحص link-token الاختياري، وقائمتا السماح والحظر.
تنطبق الصفوف الخاصة بالطلبات المعلّمة فقط عند تفعيل فحص link-token، إما عبر link_token = true في limiter.toml، أو لأن public_instance: true يفعّله نيابةً عنك. عندها يُعد العميل مشتبهاً فيه إلى أن يحمّل stylesheet يحمل عنوان URL الخاص به token عشوائياً. عند تعطيل link-token، وهو الوضع الافتراضي، يحصل كل عميل يصل إلى هذه العدادات على الصفوف العادية.
تُطبَّق فحوصات الرؤوس بصرامة أكبر، لأنها لا تضع أي طلب في حالة الاشتباه: إذ يُرفض فوراً بالرمز 429 كل طلب يفشل في أحدها. كل فحص منها وحدة في searx/botdetection/، ويسمي سطر سجل التصحيح header الذي فشل:
http_accept: لا يحتوي headerAcceptعلىtext/html.http_accept_encoding: لا يذكر headerAccept-Encodingأياً منgzipأوdeflate.http_accept_language: لا يوجد headerAccept-Language.http_user_agent: قيمةUser-Agentمفقودة أو تطابق نمط bot معروفاً.http_sec_fetch: لا تتوافق headersSec-Fetch-*مع ما يرسله browser. يُنفّذ هذا الفحص فقط مع طلبات HTTPS الصادرة من إصدارات browser المعروفة بإرسالها، ويعيد التوجيه إلى صفحة البداية بدلاً من الرد بالرمز 429. في المصدر الحالي، يؤديSec-Fetch-Modeغير الصالح وحده فعلياً إلى إعادة التوجيه: أماSec-Fetch-SiteأوSec-Fetch-Destغير الصالحين فيُسجّلان على مستوى debug، لكن الطلب يستمر.
يرسل browser جميع هذه العناصر. أما استدعاء curl العادي فيرسل عدداً قليلاً منها فقط، لذلك يُرفض طلب الاختبار المكتوب يدوياً من المحاولة الأولى، بينما ينجح البحث نفسه في علامة تبويب browser. لهذا فإن ظهور النتيجة «يعمل في browser، لكن يحصل script على 429» أمر طبيعي، وليس لغزاً.
يمنع محدِّد المعدل الجميع في الوقت نفسه خلف Reverse Proxy
هذه أكثر الطرق شيوعاً لتعطيل مثيل يعمل بشكل صحيح. يأخذ SearXNG عنوان العميل من أول عنوان IP غير موثوق به في X-Forwarded-For، ثم يعود إلى X-Real-IP، ثم يعود مرة أخرى إلى العنوان الذي فتح الاتصال. ويحدّد trusted_proxies في limiter.toml ما إذا كان سيُعتد بهذه الرؤوس أصلاً. توضح وثائق botdetection أن trusted_proxies يتم تجاهله عند ضبط X-Real-IP فقط، لكن الشيفرة في searx/botdetection/trusted_proxies.py، التي جرى التحقق منها في 16 November 2026، تسقط الرأسين معاً عندما لا يكون عنوان الاتصال موثوقاً به. لذلك، لا يكفي إرسال X-Real-IP لتجاوز القائمة.
إذا لم يكن عنوان Proxy الخاص بك مدرجاً في تلك القائمة، فسيتم تجاهل الرؤوس، وسيصل كل زائر بعنوان Proxy. عندئذٍ يشتركون في عدّاد واحد. لذلك، عند تعطيل التحقق من link-token، يُحظر الموقع بأكمله معاً عندما يتجاوز المجموع 150 طلباً خلال 10 دقائق. وعند تفعيل التحقق من link-token، يشترك العملاء المشبوهون في العدادات الأكثر صرامة، بينما يتجاوز العميل الذي يجتاز التحقق عدّادي الدفعات والنافذة الطويلة.
الثقة الزائدة أسوأ. إذا أدرجت نطاقاً عاماً، يمكن لزائر يتصل من ذلك النطاق الموثوق إرسال رأس X-Forwarded-For الخاص به واختيار هوية جديدة مع كل طلب. أدرج العنوان الذي يتصل منه Proxy الخاص بك فقط. في Docker يكون هذا عادةً شبكة bridge داخل 172.16.0.0/12، ويكون ذلك السطر معطلاً بالتعليق.
[botdetection]
ipv4_prefix = 32
ipv6_prefix = 48
trusted_proxies = [
'127.0.0.0/8',
'::1',
'172.16.0.0/12',
]يجب أن يرسل Proxy الرؤوس أيضاً. لا يضيف Nginx الرؤوس X-Forwarded-Proto أو X-Real-IP أو X-Forwarded-For من تلقاء نفسه:
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header Connection $http_connection;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}يضبط Caddy وTraefik الرؤوس المُمرَّرة نيابةً عنك، لذلك لا تحتاج معهما إلا إلى تنفيذ الجزء trusted_proxies من المهمة. تتناول اختيار Reverse Proxy لخدمة مستضافة ذاتياً المفاضلات بين الخيارات. للتحقق من أي من الإعدادين، فعّل debug، وأجرِ بحثاً واحداً من هاتفك عبر بيانات الهاتف المحمول، وتأكد من أن الشبكة في سطر السجل هي عنوان هاتفك لا عنوان Proxy.
يعتمد حد API لوكيلك على الطلب
يكون إخراج JSON معطّلاً افتراضياً، لذلك يجب إضافته إلى الوكيل:
search:
formats:
- html
- jsonاقرأ الآن صف المخطط مرة أخرى. يُحتسب طلب /search يحتوي على مَعلمة استعلام URL هي format، وتختلف عن html، ضمن نافذته الخاصة: 4 طلباً لكل 1 hour، لكل شبكة عميل. تدعم API مَعلمات نماذج POST، لكن تنسيقاً غير HTML يُرسَل حصراً ضمن بيانات نموذج POST لا يزيد هذا العداد الخاص بـAPI؛ وتظل فحوصات المحدِّد الأخرى سارية. لا يؤدي اجتياز فحص رمز الرابط إلى تجاوز عداد API، لأن هذا العداد يُنفَّذ أولاً. يستهلك وكيل بحث يستخدم ?format=json هذا الحد في مهمة واحدة، ثم يعيد كل استدعاء لاحق الاستجابة 429. الرقم نفسه ثابت في المصدر، لذلك لا يمكنك رفعه من الإعدادات، لكنك لست مضطراً إلى ذلك: يمكنك إخراج عنوان الوكيل من العداد بالكامل.
الحل الصحيح هو إبلاغ المحدِّد بأن هذا العميل ليس عميلاً مجهولاً. أضف عنوانه إلى قائمة السماح في limiter.toml:
[botdetection.ip_lists]
block_ip = []
pass_ip = [
'10.8.0.0/24',
]
pass_searxng_org = trueتتقدّم pass_ip على كل طريقة أخرى، وتوضح تعليقة upstream نفسها في limiter.toml أن العنوان الموجود في تلك القائمة يحصل على وصول غير مقيّد. لذلك لا يخضع العميل الموجود في قائمة السماح لنافذة الطلبات الأربعة، ويتجاوز أيضاً فحوصات الرؤوس، ويعمل استدعاء curl المجرد. اجعل النطاق أصغر ما يمكن، وفضّل شبكة VPN فرعية أو شبكة حاويات على أي نطاق يمكن توجيهه. إن توجيه الوكيل مباشرةً إلى الحاوية عبر شبكة داخلية لا يتجاوز المحدِّد الخاص بـSearXNG؛ أضف عنوان العميل الذي يراه SearXNG فعلياً إلى قائمة السماح. يوضّح منح وكيل AI مهارة بحث في SearXNG كيفية إعداد ذلك.
تجنّب توجيه الوكيل إلى مثيل عام يشغّله شخص آخر. فقد تؤدي حركة المرور الآلية عبر SearXNG إلى حظر ذلك المثيل من محركات upstream.
عندما تحجبك محركات البحث بدلاً من ذلك
البيانات وراء هذا الرسم البياني
[
{
"label": "SearxEngineTooManyRequests",
"suspended_seconds": 180,
"roughly": "3 minutes"
},
{
"label": "SearxEngineAccessDenied",
"suspended_seconds": 180,
"roughly": "3 minutes"
},
{
"label": "SearxEngineCaptcha",
"suspended_seconds": 3600,
"roughly": "1 hour"
},
{
"label": "recaptcha_SearxEngineCaptcha",
"suspended_seconds": 604800,
"roughly": "7 days"
},
{
"label": "cf_SearxEngineCaptcha",
"suspended_seconds": 1296000,
"roughly": "15 days"
}
]عندما يجيب أحد المحركات برمز الحالة 429 الخاص به أو يعرض صفحة CAPTCHA، يرفع SearXNG استثناءً مسمىً ويتوقف عن إرسال الطلبات إلى ذلك المحرك لفترة من الوقت. لن يرى زوارك رمز 429 الناتج عن البحث في ذلك المحرك؛ إذ تستمر عملية البحث في عرض صفحة نتائج عادية، ولكن من دون نتائج ذلك المحرك. تؤدي استجابة تجاوز عدد الطلبات المسموح به إلى تعليق المحرك لمدة 180 ثانية، كما تؤدي استجابة رفض الوصول إلى تعليقه لمدة 3 minutes. أما CAPTCHA العادية فتعلّق المحرك لمدة 1 hour. وتعلّق CAPTCHA المقدّمة عبر Cloudflare المحرك لمدة 15 days، وهي أطول مدة افتراضية في القائمة. تحدد صفوف CAPTCHA الثلاثة التي وصلت إليها الإجراء التالي المناسب، ولأخطاء CAPTCHA مجموعة إصلاحات خاصة بها بعد معرفة الاستثناء الذي سجّلته نسختك.
هذه هي القيم الموجودة في searx/settings.yml التي تأتي مع SearXNG، وقد جرى التحقق منها في 16 November 2026. ما زالت وثائق الإعدادات تعرض قيماً أقدم وأطول، وهي ساعة واحدة لتجاوز عدد الطلبات المسموح به، ويوم واحد لرفض الوصول وCAPTCHA العادية. لذلك اعتمد على الملف الذي تحمّله نسختك فعلياً، لا على صفحة تقتبس قيماً قديمة.
تستخدم حالات الفشل العادية إعدادات مختلفة. يعلّق انتهاء المهلة أو فشل الاتصال المحرك لمدة search.ban_time_on_fail ثانية، وتكون القيمة الافتراضية 5، ولا تتجاوز المدة search.max_ban_time_on_fail، وتكون قيمتها الافتراضية 120. يُسجَّل خطأ التحليل في /stats/errors، لكنه لا يعلّق المحرك إطلاقاً. لذلك يتعافى المحرك البطيء تلقائياً خلال ثوانٍ، بينما يختفي المحرك الذي عرض CAPTCHA لمدة ساعة أو أكثر. يفسر هذا الفرق عرضاً يصفه المستخدمون بأنه عشوائي: تكون النتائج سليمة، ثم تختفي نتائج أحد المحركات لمدة ساعة في كل مرة.
من الأفضل معالجة انتهاء المهلة قبل إلقاء اللوم على أي جهة. القيمة الافتراضية لـ request_timeout هي 3.0 ثوانٍ، وقد تكون ضيقة لخادم VPS صغير بعيد عن أقرب خادم edge للمحرك.
outgoing:
request_timeout: 3.5
max_request_timeout: 10.0
engines:
- name: bing
timeout: 5.0يمثل request_timeout القيمة الافتراضية لكل محرك، ويمثل max_request_timeout الحد الأقصى، ويمكن لمحرك واحد تحديد قيمة timeout الخاصة به. تؤدي زيادة هذه القيم إلى مبادلة زمن تأخر الصفحة بعدد أقل من حالات الفشل. لذلك زدها بمقدار نصف ثانية في كل مرة، وراقب /stats/errors بدلاً من القفز مباشرة إلى 10.
إذا كان أحد المحركات يحجب عنوانك فعلياً، فأزله. تُتخطى المحركات المعلّقة حتى انتهاء مدة التعليق. والإبقاء على محرك يحجبك باستمرار يضيف محاولات فاشلة عندما يصبح مؤهلاً للاستخدام من جديد.
use_default_settings:
engines:
remove:
- googleطبّق التغييرات باستخدام docker compose restart core، ثم نفّذ عدة عمليات بحث وأعد تحميل /stats/errors. تحقق من أن عمليات البحث تعرض نتائج، ولا تكتفِ بالتحقق من الأخطاء المسجّلة.
يمكن التعامل مع عنوان IP الصادر من مركز بيانات باعتباره عنوان روبوت
تحظر Google الشبكات التي تحدد أنها ترسل حركة مرور آلية، بما في ذلك شبكات VPN المشتركة. ولا يمكن لأي إعداد لمحدد المعدل المحلي رفع هذا الحظر المفروض من الجهة الخارجية. كما أن رؤية محركات البحث لخادمك بدلاً من الشخص الذي يكتب الاستعلام هي جزء أساسي من مفاضلة الخصوصية التي قبلتها عند الاستضافة الذاتية. ويستحق مقدار ما يخفيه SearXNG فعلياً القراءة قبل افتراض أنه يغطي نطاقاً أوسع.
يمكنك تغيير محركات البحث التي تستعلم منها، وتحديد ما إذا كان مثيلك مدرجاً للعامة. يستطيع SearXNG توجيه طلبات محركات البحث عبر وكيل باستخدام outgoing.proxies أو outgoing.using_tor_proxy، ما ينقل حركة المرور إلى عنوان مختلف. ولا يضمن عنوان الخروج المختلف الوصول، إذ تحظر Google أيضاً بعض خدمات VPN والأنفاق المشتركة بسبب حركة المرور الآلية الصادرة عن مستخدميها.
راقب المثيل لتعرف بالمشكلة أولاً
يستجيب SearXNG على منفذه حتى عند تعليق جميع المحركات، لذلك يظل فحص التوافر الذي يراقب رمز الحالة فقط ناجحاً، بينما لا يعيد المثيل أي نتيجة. افحص المحتوى بدلاً من ذلك: أرسل بحثاً فعلياً وطابق كلمة تتوقع ظهورها في نص الاستجابة. ينفّذ مراقبة الكلمات المفتاحية عبر Uptime Kuma ذلك من دون أدوات إضافية. راقب /stats/errors بعد كل تحديث للإصدار أيضاً، لأن المحركات تغيّر HTML الخاص بها، وقد يتعطل المحلّل من دون أن تكون هناك أي مشكلة تتعلق بحدود المعدل.
FAQ
لماذا يعرض SearXNG الرمز 429 لكل زائر بعد وضعه خلف Reverse Proxy؟
لأن أداة تحديد المعدل تعتبر الـProxy عميلاً واحداً. لا يقرأ SearXNG قيمة X-Forwarded-For إلا عندما يكون عنوان الاتصال مدرجاً في trusted_proxies ضمن /etc/searxng/limiter.toml. إذا لم يكن العنوان مدرجاً، يشترك جميع الزوار في عدّاد واحد؛ ومع تعطيل التحقق من link-token، يتجاوزون معاً حد 150 طلباً خلال 10 دقائق. ومع تفعيل التحقق من link-token، يشترك العملاء المشبوهون في عدّادات أكثر تقييداً، بينما يتجاوز العملاء الذين يجتازون التحقق عدّادي الاندفاع والنافذة الزمنية الطويلة. أضف العنوان الذي يتصل منه الـProxy. في Docker، يكون هذا عادةً نطاق الجسر 172.16.0.0/12. وتأكد من أن الـProxy يرسل X-Real-IP وX-Forwarded-For. لا تُدرج نطاقاً لا تتحكم فيه، لأن عميلاً يتصل من نطاق موثوق يمكنه تعيين ذلك الرأس واختيار هوية جديدة مع كل طلب.
كم عدد طلبات API التي يسمح بها محدِّد المعدل في SearXNG كل ساعة؟
أربعة طلبات لكل شبكة عميل في الساعة، من أصل /search من الطلبات التي لا تكون فيها قيمة معامل الاستعلام format في عنوان URL مساويةً لـhtml. لا يزيد تنسيق غير HTML المرسل حصراً في بيانات نموذج POST عدّاد API هذا، لكن فحوصات محدِّد المعدل الأخرى تظل مطبّقة. تُحدَّد هذه القيمة في searx/botdetection/ip_limit.py، وليس في limiter.toml، لذلك لا يمكن رفعها من ملف الإعداد. يمرر agent أو script يستخدم ?format=json هذا الطلب ضمن مهمة واحدة. ويحصل العنوان المدرج في pass_ip ضمن limiter.toml على وصول غير مقيّد، ولا يُحتسب إطلاقاً، لذا أضف عنوان العميل هناك. لا يؤدي الاتصال عبر شبكة داخلية وحده إلى تجاوز محدِّد المعدل في SearXNG.
لماذا تعود نتائج البحث فارغة من دون ظهور الخطأ 429؟
محركات البحث ترفض خادمك، لا المستخدمين. افتح /stats/errors في نسختك الخاصة؛ فهو يذكر كل محرك فشل وسبب الفشل. ويعني إدراج CAPTCHA أو access-denied أن المحرك حظر عنوان IP الخاص بخادمك. يعلّق SearXNG المحرك بعد ذلك لمدة 3 دقائق عند تلقي إجابة تفيد بكثرة الطلبات أو رفض الوصول، ولمدة ساعة بعد CAPTCHA عادية، ولمدة أسبوع أو أكثر بعد reCAPTCHA أو Cloudflare CAPTCHA. لا يرفع أي إعداد محلي لمحدِّد المعدل الحظر الصادر من الخادم upstream، لذلك أزل المحركات التي تحظر عنوانك واحتفظ بالمحركات التي تستجيب.
هل ينبغي تفعيل محدِّد المعدل في نسخة خاصة؟
إذا لم يصل إلى النسخة سوى أنت، فاترك limiter: false. فهو يضيف اعتماداً على Valkey ويحظر scripts الخاصة بك، كما أنه يحمي من traffic غير موجود لديك. فعّله فور حصول النسخة على عنوان عام، مع public_instance: true. هذا الاقتران مقصود: عند تفعيل public_instance: true وعدم توفر Valkey عامل أثناء التهيئة، تنتهي العملية بالحالة 1 بدلاً من التشغيل دون حماية.