📶 تثبيت TP-Link Omada Controller — إدارة شبكات أومادا المركزية على Docker
نشر خادم TP-Link Omada Controller على Ubuntu باستخدام Docker — المنصة المركزية لإدارة الشبكات المعرفة برمجياً (SDN) لربط وتهيئة ومراقبة نقاط وصول الواي فاي (EAPs) والمفاتيح والراوترات من تي بي لينك.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/networking/omada/omada-ubuntu.sh
chmod +x omada-ubuntu.sh
sudo bash omada-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/networking/omada/omada-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x omada-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلدات البيانات والسجلات وتشغيل حاوية mbentley/omada-controller مع فتح كافة منافذ الويب والاكتشاف وإدارة الأجهزة.
sudo bash omada-ubuntu.sh
4 إتمام معالج الإعداد
افتح متصفحك وانتقل إلى الرابط https://ip-سيرفرك:8043. أكمل معالج الإعداد الأولي لإنشاء حساب المشرف، وضبط شبكة الواي فاي الأولى، واعتماد أجهزة TP-Link Omada المتصلة بالشبكة.
https://:8043
# Accept the self-signed certificate and run the setup wizard
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8043 | Web UI (HTTPS) |
| 8088 | Web UI (HTTP) + portal redirect |
| 29810/udp | Device discovery |
| 29811-29814 | Device management, adoption, upgrades |
نظرة عامة
يعد برنامج TP-Link Omada Controller النظام المركزي لإدارة الشبكات المعرفة برمجياً (SDN) المخصص لمنظومة أجهزة تي بي لينك المؤسسية: نقاط وصول الواي فاي (EAPs)، والمفاتيح المدارة (JetStream Switches)، وبوابات الأمان والراوترات (SafeStream Gateways). يعمل النظام عبر حاوية Docker على المنفذ المشفر 8043 ومنفذ 8088، ليلغي الحاجة لشراء وحدات التحكم المادية باهظة الثمن (مثل OC200 أو OC300). ويوفر ميزات التجوال اللاسلكي السلس (802.11k/v/r)، وبوابة تسجيل دخول الضيوف (Captive Portal)، وعزل شبكات الـ VLAN، وتحديث البرامج الثابتة لجميع الأجهزة مركزياً.
لماذا تستخدمه
إدارة العشرات من أجهزة الواي فاي والمفاتيح بشكل منفصل عبر عناوين IP الفردية أمر غير عملي، ويؤدي إلى تضارب إعدادات الـ VLAN، ويمنع التجوال السلس للمستخدمين بين نقاط الوصول. تمنحك الاستضافة الذاتية لـ Omada Controller لوحة تحكم واحدة وموحدة لكافة فروع وشبكات شركتك دون أي رسوم تراخيص سحابية دورية. وبمجرد توصيل أي جهاز جديد بالشبكة، يكتشفه النظام تلقائياً ويدمج إعدادات الشبكة وكلمات المرور إليه فوراً.
متى تحتاجه
- تستخدم أجهزة شبكات TP-Link Omada (مثل EAP610 أو EAP650 أو سويتشات SG2008P أو راوترات ER605) في منزلك أو شركتك
- ترغب في تفعيل التجوال اللاسلكي فائق السرعة (Fast Roaming 802.11k/v/r) والتغطية الشبكية الموحدة (Mesh)
- تحتاج إلى بوابة دخول للضيوف (Captive Portal) مخصصة مع كروت الدخول (Vouchers) أو قبول الشروط للمطاعم والفنادق
- تدير عدة فروع ومواقع جغرافية متباعدة وتريد إدارتها ومراقبتها مركزياً من خادم سحابي واحد
- تريد الاستغناء عن شراء وحدات التحكم المادية (OC200/OC300) واستبدالها بحاوية Docker سريعة ومجانية
من يحتاجه
- مديرو شبكات الشركات الصغيرة والمتوسطة والمكاتب لتنظيم وتأمين شبكات الواي فاي
- أصحاب السيرفرات والمنازل الذكية لبناء شبكات واي فاي 6/7 متطورة مع عزل شبكات الأجهزة الذكية (IoT VLANs)
- مديرو الفنادق والمقاهي لتقديم خدمة واي فاي آمنة للزبائن مع بوابات تسجيل دخول احترافية
- مزودو الخدمات المدارة (MSPs) لإدارة شبكات عدة عملاء مختلفين عبر لوحة واحدة
- مهندسو الشبكات لمراقبة منافذ الطاقة PoE، واستهلاك الباندوث، ومستويات الإشارة للعملاء
حالات الاستخدام الشائعة
- إدارة مركزية لعشرات نقاط وصول الواي فاي مع التحسين التلقائي للقنوات اللاسلكية وتوجيه النطاق للترددات السريعة (5GHz/6GHz)
- تقسيم الأجهزة الذكية والموظفين والضيوف إلى شبكات VLAN معزولة تماماً مع قواعد جدار الحماية
- إنشاء بوابة تسجيل دخول لضيوف الفنادق مع تحديد السرعات وجلسات الاستخدام وتوليد كروت اشتراك مطبوعة (Vouchers)
- تحديث البرامج الثابتة لكافة المفاتيح ونقاط الوصول بضغطة زر واحدة في أوقات الصيانة المجدولة
- فحص التداخل اللاسلكي اللحظي وقوة إشارة الأجهزة (RSSI) والرسوم البيانية لاستهلاك البيانات
الميزات الرئيسية
- لوحة تحكم مركزية شاملة وشديدة الوضوح على المنفذ المشفر 8043 ومنفذ 8088
- دعم بروتوكولات التجوال السلس (802.11k/v/r) لمنع انقطاع مكالمات الفيديو والمكالمات الصوتية أثناء التنقل
- محرك متكامل لبوابة الضيوف: كروت Vouchers، حسابات محلية، سيرفر RADIUS، وتخصيص الشعار والألوان
- إدارة متقدمة للمواقع المتعددة (Multi-Site): تنظيم الأجهزة في مواقع جغرافية مستقلة بإعدادات منفصلة
- تحسين تلقائي للقنوات اللاسلكية وقوة الإرسال والجدولة الزمنية لإيقاف البث ليلاً
- إعداد شبكات VLAN وجدولة منافذ PoE وعزل المنافذ عبر مفاتيح JetStream المدارة
- نظام نسخ احتياطي آلي يتيح جدولة تصدير قواعد البيانات دورياً لحماية التكوينات
- نشر معزول ومستقر عبر Docker مع حفظ دائم لقواعد البيانات والسجلات
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط https://ip-سيرفرك:8043 (تجاوز تحذير شهادة SSL الأولية)
- اتبع معالج الإعداد لإنشاء اسم لوحة التحكم واسم المشرف وكلمة مرور قوية
- أنشئ شبكة الواي فاي الأولى (اسم الـ SSID، ومفتاح الأمان WPA2/WPA3، وتحديد رقم الـ VLAN إن وجد)
- انتقل إلى تبويب الأجهزة (Devices) لعرض نقاط الوصول والمفاتيح المكتشفة تلقائياً على شبكتك
- انقر على 'Adopt' بجانب كل جهاز لربطه بلوحة التحكم وسيقوم النظام بتطبيق إعدادات الواي فاي عليه تلقائياً
- انتقل إلى Settings ← Wireless Networks لضبط ميزات التجوال المتقدم (Fast Roaming وBand Steering)
- يمكنك ربط حساب TP-Link Cloud من الإعدادات للوصول للشبكة عبر تطبيق الهاتف المحمول من أي مكان
أفضل ممارسات الأمان
- غيّر كلمة مرور حساب المشرف فور تسجيل الدخول الأول واختر كلمة معقدة لحماية الشبكة
- لا تفتح منفذ الإدارة 8043 للإنترنت العام مباشرة، بل اتصل به عبر شبكة VPN أو شبكتك المحلية
- إذا كنت تدير أجهزة في مواقع متباعدة عبر الإنترنت (Layer 3 Adoption)، افتح منافذ الربط فقط (29811-29814) واحمِ لوحة الويب
- استخدم تشفير WPA3-SAE أو WPA2/WPA3 Mixed لكافة شبكات الواي فاي لحماية كلمات المرور من الاختراق
- اعزل شبكة الضيوف في VLAN منفصل مع تفعيل عزل العملاء (Client Isolation) لمنع وصولهم لأجهزة شبكتك الداخلية
- حدّث حاوية mbentley/omada-controller بانتظام للحصول على أحدث ميزات الأمان وتحسينات الأداء
المنافذ وإعدادات جدار الحماية
يستخدم خادم Omada منافذ متعددة للإدارة واكتشاف الأجهزة والاتصال: منفذ TCP 8043 (لوحة التحكم المشفرة)، ومنفذ TCP 8088 (لوحة التحكم العادية وبوابة التحويل)، ومنفذ TCP 8843 (بوابة الضيوف المشفرة)، ومنفذ UDP 29810 (اكتشاف الأجهزة)، ومنافذ TCP 29811-29816 (اعتماد الأجهزة وإدارتها وتحديثها). يجب فتح هذه المنافذ في جدار الحماية المحلي (ufw allow 8043/tcp && ufw allow 8088/tcp && ufw allow 29810/udp && ufw allow 29811:29816/tcp) لتمكين السيرفر من اكتشاف الأجهزة.
النسخ الاحتياطي والصيانة
- انسخ مجلد ./data (/opt/tplink/EAPController/data) احتياطياً، والذي يحتوي على قاعدة بيانات MongoDB بجميع المواقع والأجهزة وشبكات الواي فاي وكروت الضيوف
- استخدم ميزة النسخ الاحتياطي التلقائي المدمجة في Omada من Settings ← Maintenance ← Auto Backup لتصدير ملفات cfg دورياً
- احتفظ ببيانات حساب أجهزة الشبكة (Device Account) في مكان آمن للوصول للطابعات والمفاتيح عبر SSH في حالات الطوارئ
- أتمت النسخ الاحتياطي الدوري للمجلدات وارفعه إلى مساحة تخزين سحابية آمنة عبر restic أو rsync
- اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية للتأكد من ظهور كافة الأجهزة المعتمدة بنجاح
الأخطاء الشائعة
- حظر منفذ UDP 29810 أو منافذ 29811-29814 في جدار حماية السيرفر (UFW)، مما يمنع اكتشاف واعتماد الأجهزة
- نسيان حفظ بيانات حساب الأجهزة (Device Account) المحددة في إعدادات الموقع، مما يمنع الدخول المباشر للأجهزة عبر SSH عند فقدان السيرفر
- تشغيل السيرفر بعنوان IP ديناميكي يتغير عبر DHCP، مما يؤدي لانقطاع اتصال نقاط الوصول باللوحة (ثبت عنوان IP دائماً للسيرفر)
- عدم ربط مجلدي التخزين الدائم ./data و./logs، مما يسبب فقدان اعتماد الأجهزة والتكوينات بالكامل عند تحديث الحاوية
- فتح منفذ الإدارة 8043 للإنترنت العام دون جدار حماية أو شبكة VPN
استكشاف الأخطاء وإصلاحها
- الأجهزة تظهر بحالة 'Pending' وتفشل في الاعتماد — تأكد من فتح منافذ 29811-29814 في جدار الحماية ومطابقة عنوان Inform IP لعنوان سيرفرك الثابت
- نقاط الوصول لا تظهر تلقائياً — تأكد من وجود الأجهزة والسيرفر على نفس نطاق البث المباشر (Layer 2) أو استخدم أداة Omada Discovery Utility
- واجهة الويب لا تفتح — افحص سجلات الحاوية بالأمر: docker logs omada -f للتأكد من اكتمال تشغيل قاعدة بيانات MongoDB المدمجة
- الأجهزة تظهر 'Disconnected' بعد تغيير IP السيرفر — حدث عنوان السيرفر في Settings ← Controller ليطابق عنوان IP الجديد
- استهلاك ذاكرة مرتفع — خصص 1.5 إلى 2 جيجابايت RAM على الأقل للحاوية، حيث تتطلب بيئة Java وقاعدة البيانات قدراً كافياً من الذاكرة
البدائل
منصة UniFi Network Controller هي المنظومة السحابية الرائدة من Ubiquiti لإدارة أجهزة UniFi. منصة Aruba Instant On خيار سحابي ممتاز للشركات الصغيرة. نظام OpenWrt خيار مفتوح المصدر للراوترات المستقلة بدون لوحة تحكم مركزية. أنظمة pfSense وOPNsense بوابات جدران حماية وتوجيه مفتوحة المصدر.
متى لا تستخدمه
تجنب استخدام Omada Controller إذا كنت تمتلك راوترات وأجهزة واي فاي منزلية عادية غير متوافقة مع منظومة Omada SDN (حيث أن هذا البرنامج مخصص حصرياً لأجهزة TP-Link Omada). وإذا كنت تعتمد كلياً على أجهزة Ubiquiti UniFi، فاستخدم برنامج UniFi Controller المخصص لها.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
هل أحتاج لشراء جهاز تحكم مادي مثل OC200 أو OC300 إذا قمت بتثبيت هذه الحاوية؟
لا، يوفر خادم Omada Controller المستضاف عبر Docker نفس الميزات والوظائف المتوفرة في وحدات OC200 وOC300 المادية تماماً، مع أداء أسرع وسعة أكبر وبدون أي تكاليف عتاد إضافية.
هل تنقطع شبكة الواي فاي والإنترنت إذا تم إيقاف حاوية Omada Controller؟
لا، تحفظ نقاط الوصول والمفاتيح إعداداتها محلياً في ذاكرتها. وفي حال توقف السيرفر، يستمر الواي فاي وتمرير البيانات بالعمل بشكل طبيعي، وتتوقف فقط الميزات المركزية مؤقتاً مثل بوابة تسجيل دخول الضيوف وتسجيل الإحصائيات.
ما هي ميزة التجوال السريع (Fast Roaming 802.11k/v/r) في Omada؟
تتيح ميزة التجوال السريع للهواتف والحواسيب الانتقال بسلاسة بين نقاط الوصول أثناء الحركة داخل المبنى في زمن يقل عن 50 جزءاً من الثانية، مما يمنع انقطاع مكالمات Zoom أو تقطيع البث.
هل يمكن إدارة عدة فروع ومبانٍ متباعدة عبر خادم Omada واحد؟
نعم، يدعم Omada Controller إدارة المواقع المتعددة والربط عبر الطبقة الثالثة (Layer 3 Adoption). يمكنك ربط أجهزة الفروع الخارجية بخادمك المركزي بتوجيهها لعنوان السيرفر أو نطاقه العام.
كم يستهلك خادم Omada Controller من الذاكرة العشوائية؟
يستهلك خادم Omada Controller (المبني بـ Java وقاعدة بيانات مدمجة) ما بين 800 ميجابايت إلى 1.5 جيجابايت تقريباً من الذاكرة العشوائية، اعتماداً على عدد الأجهزة المعتمدة والعملاء المتصلين.
