
أتمتة إيقاف الروبوتات الضارة من الوصول إلى خادمك
واجهة TUI وأداة CLI تساعدك على تهيئة خادمك لإيقاف الروبوتات الضارة دون الاختباء خلف شبكة CDN. إنها واجهة رسومية أنيقة لخادم الويب الموجود لديك (nginx أو Apache أو Traefik أو NPMplus) ولجدار الحماية لديك (nftables أو iptables). لأولئك منا الذين لا يريدون الاختباء خلف Cloudflare وإعطاء شركة واحدة مفاتيح كل الممالك.
تحميك بطريقتين:
إنها تحاول منعك من القيام بشيء مدمر لنفسك. سترى دائمًا التغييرات
أولاً قبل تطبيقها، ويمكنك استخدام علامة --dry-run لمزيد من الأمان. لكنني أظن
أنك في النهاية سترغب في تمكين التطبيق التلقائي للراحة. وبسبب هذا، يحاول التطبيق أيضًا
ألا يقفلك خارج الخادم. عناوين IP التي نجح تسجيل الدخول إليها عبر SSH لا تُحجب أبدًا،
ويُختبر إعداد خادم الويب دائمًا قبل التطبيق، ويحاول التعرف على التطبيقات التي تعمل خلف
وكلاء HTTP ويتكيف مع قواعد الكشف الديناميكية مع التطبيقات.
الزر الأحمر الكبير: sudo stop-bots uninstall all

بقية ملف readme هذا كتبه الذكاء الاصطناعي. لا تتردد في أن تطلب من الذكاء الاصطناعي الخاص بك تلخيصه، لن أمانع.
التثبيت لا يبدأ أي شيء، ولا يُكتب أي شيء حتى تقوم بالتطبيق. عند أول تطبيق، مع الإعدادات التي تبدأ بها قاعدة بيانات جديدة:
وهذا ما يُكتب وأين:
| ماذا | أين |
|---|---|
| قاعدة الحجب | داخل كتلة server لكل موقع، بين # BEGIN stop-bots و # END stop-bots |
الملفات التي تحتاجها القاعدة، عندما يحتاج إعداد ما إلى أحدها (robots.txt، تحديد المعدل) | /etc/stop-bots/nginx/ و conf.d الخاص بـ NGINX (بالنسبة لـ Apache، /etc/stop-bots/apache/ و conf-enabled) |
| على Traefik، كلاهما | ملف خاص به، stop-bots.yml، في الدليل الذي يقرأ منه مزود ملفات Traefik؛ لا يُعدّل أي ملف من ملفاتك |
| على NPMplus، كلاهما | كتلة واحدة في custom_nginx/server_http.conf، والتي يتضمنها كل مضيف NPMplus، وسطر واحد في custom_nginx/http_top.conf، وملفاته الخاصة في custom_nginx/stop-bots/؛ ملفات المضيف التي يكتبها NPMplus لا تُعدّل أبدًا |
| سكربت جدار الحماية | /etc/stop-bots/firewall.next.nft (أو .next.sh لـ iptables)، يُنسخ إلى firewall.nft بمجرد التطبيق؛ لا يلمس سوى جدول inet stop_bots الخاص به |
| الإعدادات والحجب وسبب وجود كل منها | /var/lib/stop-bots/db.sqlite3 |
إليك sudo stop-bots batch --dry-run --diff على قاعدة بيانات جديدة و NGINX بموقع واحد،
مختصرًا (نمط وكيل المستخدم الحقيقي يبلغ طوله بضع مئات من الأسماء):
Dry run: nothing is downloaded, scanned, written, applied or recorded. Against the database as it is, `batch` would:
NGINX: 1 file(s) would change:
/etc/nginx/sites-enabled/example.com
Firewall (nftables): 0 rule(s), 0 kernel entries; no applied script at /etc/stop-bots/firewall.nft yet, so all of it is new
lockout check passed: the SSH log was read, and no connected client would be blocked
would write 0 rule(s) to /etc/stop-bots/firewall.next.nft; not applied — review it, then apply it (“Apply everything” or `stop-bots render-firewall --apply`)
--- /etc/nginx/sites-enabled/example.com
+++ /etc/nginx/sites-enabled/example.com
@@ -1,4 +1,10 @@
server {
+ # BEGIN stop-bots (DO NOT EDIT)
+ if ($http_user_agent ~* "AgentReadinessScanner|AIScan|ArgusScanner|…|xAI-Grok|zmap-proxy-probe") {
+ return 403;
+ }
+ # END stop-bots
+
listen 443 ssl;
server_name example.com;
root /var/www/example.com;
--- /etc/stop-bots/firewall.nft (does not exist)
+++ /etc/stop-bots/firewall.next.nft
@@ -0,0 +1,29 @@
+#!/usr/sbin/nft -f
+# Generated by stop-bots 0.2.0. Not executed automatically — review, then run
+# with: nft -f <this file>
…
+add table inet stop_bots
+delete table inet stop_bots
+add table inet stop_bots
+add chain inet stop_bots bot_block { type filter hook input priority -1; policy accept; }
…
على Debian أو Ubuntu، من مستودع APT:
curl -fsSL https://ivankovic.github.io/stop-bots/key.gpg \
| sudo tee /usr/share/keyrings/stop-bots.gpg > /dev/null
echo "deb [signed-by=/usr/share/keyrings/stop-bots.gpg] \
https://ivankovic.github.io/stop-bots stable main" \
| sudo tee /etc/apt/sources.list.d/stop-bots.list
sudo apt update && sudo apt install stop-bots
أو cargo install stop-bots مع Rust 1.88 أو أحدث، أو ملف ثنائي ثابت لـ x86_64 أو
aarch64 Linux من الإصدارات على GitHub،
كل منها مع checksum وشهادة إثبات بناء
(التحقق من التنزيل).
التثبيت لا يبدأ أي شيء.
تم اختباره على Debian وUbuntu مع systemd، وNGINX أو Apache أو Traefik أو NPMplus. يحتاج
إلى nft، أو iptables-restore وip6tables-restore، لجدار الحماية. Caddy غير
مدعوم.
NGINX هو الافتراضي. على مضيف Apache، صرّح بذلك مرة واحدة، وفعّل mod_rewrite، الذي
تُكتب به الحظر:
sudo stop-bots set-web-server apache
sudo a2enmod rewrite
دعم Apache أحدث من دعم NGINX وتم اختباره على تخطيط Debian وUbuntu
(/etc/apache2). بعض الميزات خاصة بـ NGINX فقط، ومن بينها تحديد المعدل.
على مضيف Traefik 3، وجّهه إلى الدليل الذي يقرأه موفّر الملفات في Traefik، وأخبر سجل الوصول في Traefik بالاحتفاظ بوكيل المستخدم، وهو ما يُسقطه افتراضيًا وتحتاجه معظم أدوات الكشف:
sudo stop-bots set-web-server traefik --root /etc/traefik/dynamic
sudo stop-bots set-log-paths --access-log /var/log/traefik/access.log
# In Traefik's static config
accessLog:
filePath: /var/log/traefik/access.log
fields:
headers:
names:
User-Agent: keep
Referer: keep
يكتب موجّهات عالية الأولوية تردّ على طلب محظور بـ 403 قبل أن يصل إلى موجّه أي موقع. يقرأ Traefik الملف بنفسه، لذا لا يُنفَّذ أي إعادة تحميل. تحصل المواقع من تسميات Docker على الإعدادات الخاصة بالمضيف بأكمله؛ ولا يحصل الموقع على إعدادات خاصة به إلا عندما يكون موجّهه في ملف ضمن ذلك الدليل. لا يستطيع Traefik سوى الرد بـ 403، ولا يمكنه تقديم ملف robots.txt المُولَّد أو تحديد معدّل الطلبات.
على مضيف NPMplus، وجّهه إلى دليل بيانات NPMplus، وهو دليل المضيف الذي يربطه ملف compose الخاص به عند /data (/opt/npmplus ما لم تكن قد غيّرته)، وإلى سجل الوصول الذي يكتبه NPMplus بمجرد ضبط LOGROTATE=true في ملف compose.yaml الخاص به:
sudo stop-bots set-web-server npmplus --root /opt/npmplus
sudo stop-bots set-log-paths --access-log /opt/npmplus/nginx/logs/access.log