ثبّت TP-Link Omada Controller على CasaOS كخدمة Docker دائمة، وحافظ على مجلدات البيانات والعمل والسجلات الخاصة بها. يظل الدليل القديم لعام 2023 مفيدًا من الناحية المفاهيمية، لكن صورة mbentley/omada-controller التي تخضع للصيانة تطورت، ويجب على عمليات النشر الحالية إتاحة عدة منافذ TCP وUDP للاكتشاف والتبنّي والإدارة ووظائف البوابة المقيدة.
لا تتعامل مع Omada كتطبيق ويب ذي منفذ واحد. قد تُفتح واجهة الويب بنجاح بينما يفشل اكتشاف الأجهزة وتبنّيها بسبب فقدان منافذ UDP أو منافذ الإدارة.
استخدم صورة Omada لـ Docker تخضع للصيانة
إن صورة Omada Controller الحالية لـ Docker تخضع للصيانة الفعّالة وتتضمن إرشادات الترقية الحالية.
احفظ مسارات البيانات الرئيسية الثلاثة كلها
توثّق الصورة وحدات تخزين دائمة للمسارات التالية:
/opt/tplink/EAPController/data/opt/tplink/EAPController/work/opt/tplink/EAPController/logs
اربطها بمجلدات AppData في CasaOS حتى لا تؤدي الترقيات إلى محو حالة وحدة التحكم.
اكشف المنافذ المطلوبة
تستخدم Omada أكثر من واجهة إدارة واحدة عبر الويب. تتضمن وثائق الحاوية الحالية منافذ مثل:
- 8043/TCP للإدارة عبر HTTPS؛
- 8088/TCP للإدارة عبر HTTP؛
- 8843/TCP للبوابة عبر HTTPS؛
- 27001/UDP و29810/UDP للاكتشاف؛
- 29811–29817/TCP لإدارة الأجهزة في الإصدارات الحالية.
انشر الخدمات التي يحتاجها نشرُك فقط، لكن لا تحذف منافذ الاكتشاف/التبنّي ثم تشخّص وحدة التحكم على أنها معطّلة.
يعمل وضع الجسر عادةً
يمكن لأجهزة Omada الاتصال بحاوية عبر منافذ المضيف المنشورة. لا تحتاج تلقائيًا إلى استخدام شبكة المضيف أو عنوان macvlan مخصص.
إذا فشل اكتشاف الأجهزة عبر شبكات VLAN، فستصبح المشكلة متعلقة بالاكتشاف الموجّه/تصميم الشبكة، وليست مشكلة تثبيت في CasaOS.
كيفية التثبيت كتطبيق مخصص في CasaOS
- أنشئ تطبيق Docker مخصصًا.
- استخدم الإصدار الحالي
mbentley/omada-controllerالصورة/الوسم. - اربط مجلدات البيانات والعمل والسجلات الدائمة.
- انشر منافذ TCP وUDP المطلوبة.
- عيّن سياسة إعادة تشغيل مثل
ما لم يتم إيقافها. - شغّل الحاوية وافتح منفذ الإدارة عبر HTTPS.
انسخ وحدة التحكم احتياطيًا قبل الترقيات الرئيسية
قد تتضمن ترقيات وحدة تحكم Omada تغييرات في قاعدة البيانات. صدّر نسخة احتياطية من وحدة التحكم قبل تغيير الإصدارات الرئيسية، لا سيما عند الإصدارات التي تتطلب خطوات ترحيل.
لا تُتِح منافذ الإدارة للعامة
أبقِ وحدة التحكم على شبكة محلية موثوقة أو شبكة VPN خاصة. استخدم دليل نشر Docker لتطبيق مبادئ نشر الحاويات نفسها.
استخدم عنوانًا ثابتًا لوحدة التحكم
تحتاج أجهزة Omada إلى مواصلة العثور على وحدة التحكم بعد عمليات إعادة التشغيل. امنح خادم CasaOS عنوانًا ثابتًا على الشبكة المحلية عبر حجز DHCP أو عنوان IP ثابت تتم إدارته بعناية. إذا تغيّر عنوان المضيف، فقد تواصل الأجهزة المعتمدة سابقًا محاولة الوصول إلى عنوان وحدة التحكم القديم.
قد يتطلب الاكتشاف عبر شبكات VLAN تصميمًا إضافيًا للشبكة
يعمل اكتشاف البث المحلي بأفضل صورة عندما تكون وحدة التحكم وأجهزة Omada الجديدة على شبكة الطبقة الثانية نفسها. إذا كانت نقاط الوصول ووحدة التحكم لديك على شبكات VLAN مختلفة، فقد لا يكفي نشر منافذ Docker لعبور بث الاكتشاف عبر الموجّه.
في هذه الحالة، استخدم عملية الاعتماد/الإبلاغ المدعومة من TP-Link عبر الطبقة الثالثة، أو اضبط قواعد التوجيه/جدار الحماية عمدًا. لا تحاول حل مشكلة توجيه VLAN بإعادة تثبيت الحاوية مرارًا.
تحقّق من ذاكرة Java على مضيفي CasaOS صغيرين
Omada تطبيق Java وقد يستهلك ذاكرة أكبر بكثير من حاويات DNS أو لوحات المعلومات الخفيفة. تكشف الصورة المدعومة إعدادات متعلقة بالذاكرة، وينبغي لعمليات النشر محدودة الموارد ترك ذاكرة RAM كافية لـ CasaOS وDocker والخدمات الأخرى.
إذا أُعيد تشغيل الحاوية تحت الضغط، افحص السجلات وضغط الذاكرة قبل افتراض تلف قاعدة البيانات.
تحقّق من اعتماد الأجهزة بعد كل ترقية
بعد تحديث رئيسي لـ Omada، تأكّد من فتح واجهة وحدة التحكم، وبقاء الأجهزة المعتمدة متصلة، واستمرار نشر منافذ الاكتشاف/الاعتماد. لا يكفي أن تكون الحاوية «قيد التشغيل» لإثبات سلامة طبقة إدارة الشبكة.
الأسئلة الشائعة
لماذا يمكنني فتح Omada، لكن لا يتم اكتشاف الأجهزة؟
قد يعمل منفذ الويب بينما تكون منافذ اكتشاف UDP أو إدارة TCP مفقودة. تحقّق من نشر كل منفذ مطلوب.
هل أحتاج إلى وضع المضيف؟
لا. يعمل وضع الجسر مع المنافذ المنشورة الصحيحة في العديد من عمليات النشر.
ما الذي ينبغي أن أحتفظ بنسخة احتياطية منه؟
احتفظ بمجلدات البيانات/العمل/السجلات الموثقة، واستخدم أيضًا النسخة الاحتياطية الخاصة بوحدة تحكم Omada قبل الترقيات الرئيسية.
هل يمكنني إتاحة Omada مباشرةً على الإنترنت؟
تجنّب ذلك. أبقِ واجهة الإدارة خلف الشبكة المحلية أو الوصول البعيد الخاص.
