🌐 تثبيت NetBox — المرجع الموثوق للبنية التحتية والشبكات على Docker
نشر NetBox على سيرفر Ubuntu باستخدام Docker — المنصة القياسية الرائدة لإدارة عناوين IP (IPAM) وتوثيق مراكز البيانات (DCIM) لمهندسي الشبكات وفرق DevOps.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/security/netbox/netbox-ubuntu.sh
chmod +x netbox-ubuntu.sh
sudo bash netbox-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/security/netbox/netbox-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x netbox-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتهيئة قاعدة بيانات PostgreSQL 16 وخادم التخزين المؤقت Redis وتطبيق ترقيات المخطط وتشغيل واجهة NetBox وعامل المهام.
sudo bash netbox-ubuntu.sh
4 الوصول إلى واجهة NetBox
افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8000. سجل الدخول ببيانات المشرف المولدة لبدء توثيق المواقع والكبائن وعناوين IP والأجهزة.
http://:8000
# Log in with the superuser from your environment variables
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8000 | NetBox web UI + REST/GraphQL API |
| 5432 | PostgreSQL (internal only) |
| 6379 | Redis — cache + task queue (internal only) |
نظرة عامة
يعد NetBox المرجع الأساسي والموثوق (Network Source of Truth) للبنية التحتية للشبكات ومراكز البيانات، وهو مصمم خصيصاً لتمكين أتمتة الشبكات وإدارة عناوين IP (IPAM) وتوثيق البنية التحتية لمراكز البيانات (DCIM). تم تطوير المشروع أساساً من قِبل مهندسي الشبكات في DigitalOcean، ويتميز بأنه يمثل الحالة المستهدفة للشبكة بدلاً من حالتها التشغيلية اللحظية. يعمل النظام على المنفذ 8000 بجانب PostgreSQL وRedis، ويوفر بيئة دقيقة لنمذجة المواقع، والكبائن (Racks)، والأجهزة، والتوصيلات السلكية، ومسارات الطاقة، والشبكات الافتراضية (VLANs/VRFs) عبر واجهة ويب سلسة وواجهات برمجية متكاملة REST وGraphQL.
لماذا تستخدمه
إدارة شبكات الشركات ومراكز البيانات باستخدام جداول Excel أو صفحات الويكي غير المحدثة يؤدي إلى تكرار عناوين IP، وتوصيلات غير موثقة، وفوضى في الإعدادات. يحل NetBox هذه المشكلة بتوفير نموذج بيانات علائقي ومترابط للبنية التحتية بأكملها. وبفضل واجهاته البرمجية القوية، يمكن لأدوات الأتمتة الحديثة (مثل Ansible وTerraform وPython) الاستعلام من NetBox تلقائياً لتوليد إعدادات الراوترات والمفاتيح وتطبيق قواعد جدران الحماية بدقة وموثوقية تامة.
متى تحتاجه
- تبني خطوط أتمتة للشبكة (Ansible أو Terraform) وتحتاج إلى مصدر بيانات برمجي موحد لعناوين IP وبيانات الأجهزة
- تعاني مؤسستك من تكرار عناوين IP أو تشتت جداول توثيق الشبكات الفرعية والـ VLANs
- تدير كبائن خوادم في مراكز البيانات وتحتاج إلى رسم بياني مرئي لتوزيع الأجهزة ومسارات الكابلات وتوزيع الطاقة
- تحتاج إلى إدارة دقيقة لعناوين BGP ASNs وشبكات VRF وعقود مزودي خطوط الاتصال (Circuits)
- ترغب في استبدال برمجيات DCIM/IPAM التجارية المغلقة بحل مفتوح المصدر وقابل للتطوير
من يحتاجه
- مهندسو ومعماريو الشبكات الذين يصممون ويوثقون شبكات المؤسسات ومزودي الخدمة (ISPs)
- فرق DevOps وهندسة الموثوقية (SRE) الذين يدمجون توثيق البنية التحتية ضمن خطوط البناء المؤتمت
- مسؤولو عمليات مراكز البيانات لمتابعة مساحات الكبائن واستهلاك الطاقة وتوصيلات لوحات التوزيع
- مهندسو الاتصالات لإدارة خطوط الألياف الضوئية والدوائر المستأجرة وبيانات المزودين
- مديرو الأنظمة لتوثيق الخوادم المادية والأجهزة الافتراضية والتجمعات العنقودية (Clusters)
حالات الاستخدام الشائعة
- إدارة هرمية شاملة لعناوين وشبكات IPv4 وIPv6 ونطاقات الـ IP وحجوزات الأجهزة عبر الـ VRFs
- رسم وتوثيق كبائن مراكز البيانات (Rack Elevations) بأبعاد واقعية ومتابعة استهلاك مساحات الـ U والطاقة
- تتبع مسارات الكابلات المادية من بطاقات الشبكة في السيرفر عبر لوحات Patch Panels وحتى منافذ السويتشات
- تزويد منصة Ansible ببيانات الجرد اللحظية لتهيئة أجهزة Cisco وJuniper وArista آلياً
- توثيق دوائر الاتصال WAN وشروط اتفاقيات مستوى الخدمة (SLA) وجهات اتصال المزودين
الميزات الرئيسية
- نظام إدارة عناوين IP (IPAM) متقدم يدعم IPv4/IPv6 ونطاقات الـ IP وشبكات VRF وVLANs
- إدارة البنية التحتية لمراكز البيانات (DCIM): المواقع، والمناطق، ومجموعات الكبائن، وواجهات الرفوف التفاعلية
- نمذجة دقيقة للطبقة المادية: لوحات الطاقة، والكابلات، ومنافذ التوصيل الأمامية والخلفية، وواجهات الشبكة
- نمذجة البيئات الافتراضية: الأجهزة الافتراضية، ومجموعات VM Clusters، والواجهات الافتراضية
- إدارة الدوائر ومزودي الاتصال: خطوط WAN ونقاط الربط وبيانات المزودين
- واجهات برمجية كاملة REST وGraphQL مع توثيق تفاعلي مدمج عبر Swagger/OpenAPI
- سجل تدقيق وتغييرات شامل يسجل كل تعديل بالوقت وهوية المستخدم لتتبع التغييرات
- دعم الحقول المخصصة وخطافات الويب (Webhooks) والسكريبتات لتفعيل المهام التلقائية فور تعديل البيانات
كيفية الاستخدام بعد التثبيت
- افتح لوحة تحكم NetBox عبر الرابط http://ip-سيرفرك:8000 وسجل الدخول باسم المستخدم وكلمة المرور للمشرف
- أنشئ الهيكل الإداري: انتقل إلى Organization ← Sites وأضف موقعك الرئيسي أو فرع الشركة
- عرف هيكل عناوين IP: انتقل إلى IPAM ← Prefixes وحدد شبكاتك الأساسية (مثل 10.0.0.0/16 و192.168.1.0/24)
- أضف الشركات المصنعة ونماذج الأجهزة عبر Devices ← Device Types (مثل Cisco وDell وJuniper)
- أنشئ رمز API Token من إعدادات ملفك الشخصي لربط السكريبتات وأدوات أتمتة Ansible
- اضبط خطافات الويب (Webhooks) من قسم Operations لتشغيل مهام CI/CD فور حدوث أي تغيير في الأجهزة
- ضع NetBox خلف وكيل عكسي (مثل Nginx أو Caddy) مع شهادة SSL/TLS لاستخدام نطاق مشفر بـ HTTPS
أفضل ممارسات الأمان
- غيّر كلمة مرور حساب المشرف فور تسجيل الدخول الأول وافرض سياسات كلمات المرور القوية
- أنشئ رموز API بصلاحيات محددة للقراءة فقط لسكريبتات الأتمتة بدلاً من استخدام صلاحيات المشرف الكاملة
- أبقِ منفذي PostgreSQL (5432) وRedis (6379) معزولين داخل شبكة Docker وتجنب كشفهما للإنترنت
- استخدم وكيلاً عكسياً مشفراً بـ HTTPS قبل إتاحة NetBox عبر الإنترنت لحماية بيانات تسجيل الدخول والتوثيق
- فعل تسجيل الدخول الموحد (SSO) عبر SAML أو OAuth2 أو OIDC في بيئات العمل المؤسسية
- حدّث حاويات NetBox بانتظام للحصول على التحديثات الأمنية وإصلاحات الثغرات الدورية
المنافذ وإعدادات جدار الحماية
يقدم NetBox واجهة الويب والواجهات البرمجية REST/GraphQL عبر منفذ TCP 8000 (أو 8162). وتبقى قاعدة بيانات PostgreSQL (منفذ 5432) ومخزن Redis (منفذ 6379) معزولة تماماً داخل شبكة Docker الداخلية (`netbox-net`) ولا تتطلب فتح أي منافذ في جدار الحماية الخارجي. في الإنتاج، قم بتهيئة وكيل عكسي مشفر على المنفذ 443 ووجه الزوار بأمان.
النسخ الاحتياطي والصيانة
- انسخ قاعدة بيانات PostgreSQL احتياطياً باستخدام pg_dump: فهي تحتوي على جميع عناوين IP وسجلات الأجهزة والكابلات
- انسخ مجلد ./media احتياطياً، والذي يحتوي على الصور ومخططات الكبائن والمستندات المرفوعة
- احتفظ بنسخة من ملفات الإعداد docker-compose.yml والمفاتيح السرية
- جدول عمليات نسخ احتياطي ليلية تلقائية وارفعها إلى وحدة تخزين سحابية عبر restic أو rsync
- اختبر دورياً استعادة النسخة الاحتياطية على سيرفر تجريبي للتأكد من سلامة الجداول واسترجاع البيانات بنجاح
الأخطاء الشائعة
- الخلط بين NetBox وبرامج المراقبة: يمثل NetBox الحالة *المستهدفة* للشبكة وليس المراقبة الحية (استخدم Prometheus أو Zabbix للمراقبة)
- كتابة عناوين IP يدوياً في سكريبتات Ansible بدلاً من الاستعلام المباشر من واجهة NetBox البرمجية
- فتح منفذ قاعدة البيانات الداخلي 5432 للإنترنت العام
- عدم ربط مجلدات التخزين الدائم ./db و./media، مما يسبب فقدان كامل للبيانات عند إعادة إنشاء الحاوية
- تجاهل أخذ نسخة احتياطية من قاعدة البيانات قبل الترقية إلى إصدارات NetBox الرئيسية الجديدة
استكشاف الأخطاء وإصلاحها
- ظهور خطأ 'Server Error 500' — افحص سجلات الحاوية (docker logs netbox -f) وتأكد من اكتمال ترقيات الجداول
- فشل الاتصال بقاعدة البيانات — تأكد من تشغيل حاوية PostgreSQL وتطابق بيانات الاعتماد في متغيرات البيئة
- أخطاء عمال الخلفية — تأكد من تشغيل حاوية netbox-worker واتصالها بنفس شبكة Redis
- رفض طلبات API بخطأ 403 — تأكد من تمرير الترويسة الصحيحة: 'Authorization: Token <رمز_الـAPI>'
- عدم تحميل ملفات التنسيق والـ CSS — راجع إعدادات الوكيل العكسي وتأكد من تمرير ترويسات X-Forwarded-Proto وHost
البدائل
منصة Nautobot هي تفرع نشط ومفتوح المصدر من NetBox مخصص لأتمتة الشبكات المعقدة ونظام التطبيقات. تطبيق phpIPAM خيار كلاسيكي خفيف لإدارة عناوين IP فقط دون ميزات DCIM أو GraphQL. حلول SolarWinds وInfoblox خيارات تجارية مغلقة باهظة التكلفة للشركات. نظام Ralph خيار بديل مفتوح المصدر لإدارة أصول مراكز البيانات.
متى لا تستخدمه
تجنب استخدام NetBox إذا كانت شبكتك عبارة عن شبكة منزلية بسيطة تحتوي على بضعة أجهزة وعناوين IP محدودة — حيث تكفي جداول الراوتر العادية. وإذا كنت تبحث عن أداة لفحص الأجهزة المتصلة ومراقبة وقت التشغيل لحظياً، فإن أدوات المراقبة الحية (مثل NetAlertX أو Zabbix) أنسب من نموذج الحالة المستهدفة في NetBox.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما الفرق بين NetBox وبرامج مراقبة الشبكات؟
يمثل NetBox 'المرجع الموثوق' للحالة *المستهدفة* والمخططة للشبكة، بينما تراقب برامج المراقبة (مثل Zabbix) الحالة *التشغيلية الفعلية* للشبكة لحظياً. وتستخدم أدوات الأتمتة NetBox كمخطط لبناء الإعدادات وتطبيقها على الأجهزة.
هل يستطيع NetBox اكتشاف الأجهزة على الشبكة تلقائياً؟
لا يقوم NetBox بفحص الشبكة تلقائياً عن قصد لتجنب تخزين أجهزة أو إعدادات غير مصرح بها. ولكن يمكنك استخدام سكريبتات بايثون أو أدوات الفحص التلقائي لاستيراد الأجهزة المكتشفة إلى NetBox عبر واجهة REST API.
كيف أربط NetBox بمنصة الأتمتة Ansible؟
استخدم مكتبة netbox.netbox الرسمية لـ Ansible. توفر إضافات جرد ديناميكية تسحب الأجهزة وعناوين IP وخصائص التكوين مباشرة من NetBox لتطبيق المهام عليها تلقائياً.
هل يدعم NetBox استعلامات GraphQL؟
نعم، يوفر NetBox نقطة نهاية مخصصة لـ GraphQL على المسار /graphql، مما يتيح للمطورين استعلام البيانات المتشابكة (مثل جلب جهاز مع كابينته ومنافذه وتوصيلاته) في طلب HTTP واحد.
كم يحتاج NetBox من الذاكرة العشوائية (RAM)؟
تحتاج حزمة NetBox الكاملة (واجهة الويب، وعامل المهام، وقاعدة بيانات PostgreSQL 16، وRedis) ما بين 1.5 إلى 2.5 جيجابايت من الذاكرة العشوائية للعمل بكفاءة في بيئة الإنتاج.
