🛡️ تثبيت NetAlertX — فاحص أجهزة الشبكة ومراقب التواجد على Docker
نشر NetAlertX على Ubuntu باستخدام Docker — نظام مراقبة وفحص أجهزة الشبكة المحلية وتنبيهك فور اتصال أي جهاز غريب أو غير مصرح به بشبكتك.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/networking/netalertx/netalertx-ubuntu.sh
chmod +x netalertx-ubuntu.sh
sudo bash netalertx-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/networking/netalertx/netalertx-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x netalertx-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلدات الإعدادات وتشغيل حاوية NetAlertX في وضع شبكة المضيف (Host Network) لتتمكن من فحص جداول ARP واكتشاف جميع الأجهزة النشطة على الشبكة.
sudo bash netalertx-ubuntu.sh
4 الوصول إلى لوحة التحكم
افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:20211. سيبدأ NetAlertX تلقائياً بالفحص الأولي للشبكة وفهرسة جميع الأجهزة المتصلة.
http://<your-server-ip>:20211
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 20211 | Web UI (host = container) — runs in host network mode |
| host network | Required so the scanner can see the LAN it monitors |
| ./config, ./db | Settings and the device database with full history |
نظرة عامة
يعد NetAlertX (المعروف سابقاً باسم Pi.Alert) منصة مفتوحة المصدر لمراقبة أجهزة الشبكة المحلية وكشف المتسللين لشبكات الواي فاي في المنازل والمكاتب. يعمل التطبيق على المنفذ 20211 في وضع شبكة المضيف (`network_mode: host`)، ويقوم بفحص دوري ومستمر للشبكة عبر بروتوكولات ARP وICMP Ping والبحث العكسي في DNS وفحص المنافذ لرصد أي جهاز جديد أو تغيير في عناوين IP. وبفضل دعمه لقنوات التنبيه المتعددة (Telegram وDiscord وPushover والبريد الإلكتروني وWebhooks)، يرسل لك إشعاراً فورياً لحظة انضمام أي جهاز مجهول إلى شبكتك.
لماذا تستخدمه
تحتوي الشبكات المنزلية والمكتبية الحديثة على العشرات من الأجهزة الذكية وكاميرات المراقبة والهواتف، مما يجعل اكتشاف الأجهزة الغريبة أو اختراق شبكة الواي فاي أمراً شبه مستحيل يدوياً. يوفر NetAlertX رؤية كاملة وتلقائية على مدار الساعة لجميع عناوين MAC وIP على شبكتك المحلية، مع الاحتفاظ بسجل تاريخي لاتصالات الأجهزة وفحص المنافذ المفتوحة للتأكد من عدم وجود ثغرات أمنية في أجهزتك.
متى تحتاجه
- ترغب في استلام إشعارات فورية على هاتفك فور اتصال جهاز جديد غير معروف بشبكة الواي فاي
- تدير سيرفرات منزلية وتريد مراقبة استقرار وتواجد الأجهزة وتتبع تغييرات عناوين IP المحلية
- تحتاج إلى جرد تلقائي وشامل لجميع الأجهزة والشركات المصنعة (MAC Vendor) والمنافذ المفتوحة على شبكتك
- تريد مراقبة أمنية خفيفة لاكتشاف هجمات انتحال الشخصية (ARP Spoofing) أو أجهزة التوجيه الدخيلة
- تريد متابعة تواجد أجهزة أفراد الأسرة أو الأطفال لمعرفة أوقات اتصالهم وانفصالهم عن شبكة المنزل
من يحتاجه
- مديرو الشبكات المنزلية وهواة السيرفرات (Homelab) الراغبون في السيطرة الكاملة على شبكتهم
- المستخدمون الحريصون على أمان الشبكة ومنع الجيران أو المتطفلين من استهلاك باقة الإنترنت
- مسؤولو تقنية المعلومات في المكاتب الصغيرة لجرد وتتبع أجهزة الموظفين بدون تثبيت برامج عميلة
- مستخدمو Home Assistant الذين يبنون سيناريوهات أتمتة تعتمد على تواجد أجهزة معينة على الشبكة
- مهندسو الشبكات لمراقبة توزيع عناوين IP وجداول DHCP على الشبكات الفرعية
حالات الاستخدام الشائعة
- إرسال تنبيهات فورية عبر Telegram أو Discord عند اكتشاف عنوان MAC غريب على الشبكة
- تتبع سجل الاتصال اليومي وفترات تواجد أجهزة الموظفين أو أجهزة إنترنت الأشياء
- فحص المنافذ المفتوحة في كاميرات المراقبة والمقابس الذكية لكشف أي خدمات غير آمنة
- الاحتفاظ بقاعدة بيانات تاريخية لجميع الأجهزة التي اتصلت بالشبكة مع تواريخ أول وآخر ظهور
- تشغيل سيناريوهات أتمتة في Home Assistant عبر Webhooks عند انقطاع اتصال الأجهزة الأساسية
الميزات الرئيسية
- طرق فحص متعددة: فحص ARP النشط، وفحص ICMP Ping، والبحث العكسي لأسماء DNS، وفحص المنافذ
- إشعارات فورية عبر Telegram وDiscord وPushover والبريد الإلكتروني وNTFY وWebhooks
- قاعدة بيانات شاملة للأجهزة مع التعرف على الشركات المصنعة وتخصيص أسماء وتصنيفات الأجهزة
- لوحة تحكم تفاعلية على المنفذ 20211 تدعم الوضع الليلي وعرض إحصائيات التواجد التاريخية
- دعم إضافات للربط المباشر مع سيرفرات Pi-hole وراوترات UniFi وFritz!Box وMikroTik
- جدولة عمليات الفحص وتتبع التواجد للأتمتة والرقابة الأبوية
- قاعدة بيانات SQLite دائمة لحفظ سجلات الأجهزة وتغييرات IP وسجل الفحص بالكامل
- نشر خفيف عبر Docker في وضع شبكة المضيف للوصول المباشر لحزم الطبقة الثانية (Layer 2)
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:20211 لعرض لوحة تحكم NetAlertX
- انتقل إلى Settings ← Core / Scanning لتحديد نطاق شبكتك المحلية (مثل 192.168.1.0/24) وفترات الفحص
- انتقل إلى Settings ← Notifications لضبط وسيلة التنبيه المفضلة لديك (مثل إدخال Bot Token وChat ID لـ Telegram)
- راجع قائمة الأجهزة وحدد أجهزتك المنزلية المعروفة وقم بتعليمها كأجهزة موثوقة (Known) مع تسميتها بأسماء واضحة
- فعل الفحص المجدول الدوري (كل 5 إلى 15 دقيقة) من قسم Scheduling لمراقبة مستمرة للشبكة
- يمكنك اختيارياً ربط النظام براوترك أو خادم Pi-hole لاستيراد أسماء الأجهزة من جدول DHCP تلقائياً
أفضل ممارسات الأمان
- يعمل NetAlertX بصلاحيات شبكة المضيف؛ تجنب كشف المنفذ 20211 مباشرة للإنترنت العام
- اضبط كلمة مرور لحساب المشرف أو ضع اللوحة خلف وكيل عكسي آمن مع المصادقة الثنائية (مثل Authelia)
- احمِ مجلدي ./config و./db بصلاحيات مناسبة على السيرفر لحماية سجلات الأجهزة
- لا تشارك نسخ قواعد البيانات الاحتياطية علناً لاحتوائها على عناوين MAC وIP الحقيقية لأجهزتك
- حدّث صورة الحاوية ghcr.io/jokob-sk/netalertx دورياً للحصول على تحديثات الأمان وقواعد بيانات المصنعين
المنافذ وإعدادات جدار الحماية
يقدم NetAlertX واجهة التحكم عبر منفذ TCP 20211. ونظراً لتشغيل الحاوية في وضع شبكة المضيف (`network_mode: host`)، فإنها ترتبط مباشرة بواجهة شبكة السيرفر لفحص حزم ARP على الشبكة المحلية. يجب فتح المنفذ 20211 داخل شبكتك المحلية فقط، واستخدام شبكة VPN آمنة (مثل WireGuard) عند الحاجة للوصول للوحة التحكم من خارج المنزل.
النسخ الاحتياطي والصيانة
- انسخ مجلد ./db احتياطياً، والذي يحتوي على ملف قاعدة البيانات app.db بجميع سجلات الأجهزة وتواريخ الاتصال
- انسخ مجلد ./config احتياطياً، والذي يحتوي على إعدادات التنبيهات ورموز البوتات والإضافات
- أتمت النسخ الاحتياطي اليومي لمجلد التطبيق وارفعه إلى مساحة تخزين سحابية آمنة عبر restic أو rsync
- اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية والتأكد من استرجاع قائمة الأجهزة الموثوقة بنجاح
الأخطاء الشائعة
- تشغيل الحاوية في وضع bridge بدلاً من وضع `network_mode: host`، مما يعزل حزم ARP ويمنع اكتشاف أجهزة الشبكة
- نسيان تمييز الأجهزة المنزلية كأجهزة معروفة (Known)، مما يؤدي لفيضان من إشعارات الاختراق في كل فحص
- ضبط فترات فحص سريعة جداً (كل بضع ثوانٍ)، مما يسبب استهلاكاً غير ضروري لبطاريات الهواتف وحركة الشبكة
- فتح المنفذ 20211 للإنترنت العام دون مصادقة، مما يتيح للغرباء استعراض خريطة أجهزتك الداخلية
- عدم ربط مجلدي التخزين الدائم ./config و./db، مما يتسبب في ضياع أسماء وسجلات الأجهزة عند تحديث الحاوية
استكشاف الأخطاء وإصلاحها
- عدم اكتشاف أي أجهزة أثناء الفحص — تأكد من تشغيل الحاوية في وضع `network_mode: host` ومطابقة نطاق IP في الإعدادات لشبكتك
- الإشعارات لا تصل — اختبر إعدادات التنبيه بالضغط على زر 'Send Test Notification' في قسم الإعدادات
- واجهة الويب لا تفتح — تحقق من عمل الحاوية (docker ps) وافحص السجلات بالأمر: docker logs netalertx -f
- ظهور الأجهزة باسم 'Unknown' — اربط النظام بسيرفر Pi-hole أو اكتب أسماء مخصصة للأجهزة يدوياً
- ظهور تنبيهات متكررة للهواتف الذكية — فعل خيار التعرف على العناوين العشوائية (Randomized MAC) في الإعدادات
البدائل
مشروع Pi.Alert هو المشروع الأساسي الذي تفرع منه NetAlertX بميزات إضافية وواجهة حديثة. تطبيق Fing خيار تجاري للموبايل والحاسوب لفحص الشبكات. أداة Nmap هي الأداة القياسية عبر الطرفية لفحص المنافذ واستكشاف الشبكات. أداة Watch Your LAN خيار بديل وخفيف جداً بواجهة ويب بسيطة. منصة OpenVAS أداة متقدمة لفحص الثغرات الأمنية للشركات.
متى لا تستخدمه
تجنب استخدام NetAlertX إذا كنت تبحث فقط عن حظر الإعلانات دون الحاجة لتتبع الأجهزة (استخدم Pi-hole أو AdGuard Home بدلاً منه). وإذا كنت تدير شبكات مؤسسات كبرى مقسمة إلى عشرات الـ VLANs الموجهة بدون وصول لحزم البث المباشر (Broadcast)، فإن أنظمة المراقبة عبر SNMP مثل LibreNMS أنسب من فاحص ARP المحلي.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
لماذا يتطلب NetAlertX وضع شبكة المضيف (Host Network)؟
يستخدم NetAlertX حزم بروتوكول ARP لاكتشاف الأجهزة المتصلة بالشبكة المحلية. وتقوم شبكة Docker العادية بحظر هذه الحزم، لذلك يلزم وضع Host Network للوصول المباشر لطبقة الشبكة الثانية (Layer 2).
كيف ينبهني NetAlertX عند دخول جهاز جديد؟
عندما يقوم NetAlertX بفحص الشبكة ورصد عنوان MAC لم يُعلم مسبقاً كجهاز معروف (Known)، فإنه يرسل إشعاراً فورياً عبر القنوات التي حددتها (Telegram أو Discord أو البريد) مع تفاصيل الجهاز.
كيف أتعامل مع الهواتف التي تستخدم عناوين MAC عشوائية (Private MAC)؟
تستخدم هواتف iOS وAndroid الحديثة عناوين عشوائية افتراضياً. يمكنك إيقاف ميزة 'Private Wi-Fi Address' في إعدادات شبكة منزلك على الهاتف، أو تفعيل خيارات التعرف الذكي في إعدادات NetAlertX.
هل يمكن ربط NetAlertX بنظام Home Assistant؟
نعم، يدعم NetAlertX إرسال إشعارات Webhooks ورسائل MQTT، مما يتيح لـ Home Assistant تتبع تواجد الأجهزة وتنفيذ سيناريوهات الأتمتة الذكية عند اتصال الأجهزة أو انفصالها.
كم يستهلك NetAlertX من موارد السيرفر؟
NetAlertX فائق الخفة، حيث يستهلك حوالي 50 إلى 150 ميجابايت فقط من الذاكرة العشوائية ونسبة معالج ضئيلة جداً أثناء الفحص الدوري، مما يجعله مثالياً للتشغيل بجانب الخدمات الأخرى.