لا يحتاج تطبيق UniFi Network إلى عنوان 192.168.x.x خاص به لمجرد أن Docker يمنح الحاوية عنوان جسر 172.x. في وضع الجسر العادي، انشر منافذ المضيف المطلوبة واضبط مضيف Inform في UniFi على اسم مضيف أو عنوان IP يمكن الوصول إليه عبر الشبكة المحلية. تتصل الأجهزة الموجودة على الشبكة المحلية بعنوان المضيف، بينما تُبقي Docker الحاوية على شبكتها الخاصة.
خلط موضوع المصدر لعام 2026 بين عنوان IP الداخلي لجسر الحاوية والعنوان الذي ينبغي لأجهزة الشبكة المحلية استخدامه. توضح وثائق LinuxServer الحالية ذلك صراحةً: يمكن أن تبقى حاوية UniFi في وضع الجسر، وتتم عملية اعتماد الأجهزة عبر ضبط مضيف Inform يمكن الوصول إليه مع الإبقاء على المنفذ 8080.
لماذا ترى عنوانًا يبدأ بـ 172.x؟
تُسنِد شبكات جسر Docker عادةً عناوين خاصة للحاويات، مثل 172.17.x.x. هذا العنوان مخصص لشبكات الحاويات، وليس العنوان الذي يجب على المفاتيح ونقاط الوصول استخدامه من الشبكة المحلية الفعلية.
استخدم عنوان IP لمضيف ZimaOS مع المنافذ المنشورة
إذا كان خادم ZimaOS هو 192.168.1.20 وكانت UniFi تنشر المنفذين 8443 و8080، فستصل إلى الواجهة ونقطة Inform من خلال المضيف:
https://192.168.1.20:8443
http://192.168.1.20:8080/informاضبط مضيف Inform في UniFi
توضح وثائق UniFi من LinuxServer الحالية أن على مستخدمي Docker ضبط مضيف Inform أو التجاوز على اسم مضيف أو عنوان IP يمكن لأجهزة UniFi الوصول إليه.
عادةً ما يكون هذا هو عنوان IP المحلي لخادم ZimaOS أو اسم DNS محليًا ثابتًا.
أبقِ المنفذ 8080 مضبوطًا بنسبة 1:1
تحذر LinuxServer من أن اتصال أجهزة UniFi يتوقع 8080:8080، ما لم تُجرِ أيضًا تغييرات مطابقة داخل خصائص نظام UniFi. لا تُعيّن المنفذ 18080 على المضيف إلى 8080 في الحاوية عشوائيًا وتتوقع بقاء الاعتماد مستقرًا.
وضع المضيف لا يساوي «منح الحاوية عنوان IP خاصًا بها على الشبكة المحلية»
يجعل وضع مضيف Docker الحاوية تشارك مساحة أسماء شبكة المضيف. ولا ينشئ للحاوية عنوان 192.168.x.x ثانيًا.
إذا كنت تحتاج فعلًا إلى عنوان IP منفصل على الشبكة المحلية، فهذا تصميم يعتمد على macvlan أو ipvlan، ويضيف قيودًا تتعلق بالتوجيه والاتصال بين المضيف والحاوية.
وضع الجسر هو الخيار الأبسط عادةً
يُبقي وضع الجسر التطبيق معزولًا، ويجعل ملكية المنافذ واضحة، ويعمل مع تجاوز مضيف Inform الموثق. وغالبًا ما يكون كافيًا لاعتماد وحدة التحكم وإدارتها.
تذكّر متطلب MongoDB الخارجي
يتطلب تطبيق UniFi Network الحالي من LinuxServer مثيل MongoDB خارجيًا. إذا فشل وضع المضيف بينما يعمل وضع الجسر، فتحقق من بقاء اسم مضيف MongoDB ومسار الشبكة صالحين ضمن وضع الشبكة المحدد.
لا تعرّض وحدة التحكم مباشرةً للإنترنت
أبقِ الإدارة على الشبكة المحلية أو خلف شبكة وصول عن بُعد خاصة. يوفّر دليل الشبكة الخاصة السياق الشبكي الأكثر أمانًا.
استخدم عنوانًا ثابتًا للمضيف
نظرًا إلى أن الأجهزة التي تم اعتمادها تُبلَّغ بمكان العثور على وحدة التحكم، امنح مضيف ZimaOS عنوان IP ثابتًا على الشبكة المحلية من خلال حجز DHCP في جهاز التوجيه أو عنوان ثابت تتم إدارته بعناية. إذا تغيّر عنوان مضيف وحدة التحكم من 192.168.1.20 إلى عنوان آخر، فقد تواصل الأجهزة الاتصال بنقطة Inform القديمة.
افهم وظيفة كل منفذ
واجهة UniFi على الويب عبر المنفذ 8443 ليست سوى جزء واحد. تستخدم حركة Inform الخاصة بالأجهزة المنفذ 8080، بينما تستخدم خدمات الاكتشاف وSTUN الأخرى منافذ إضافية بحسب عملية النشر. لذلك قد تبدو وحدة التحكم سليمة في المتصفح، بينما تفشل الأجهزة في الاعتماد.
استخدم جدول المنافذ الحالي من LinuxServer وانشر ما تحتاج إليه بيئتك فقط، لكن أبقِ منافذ إدارة الأجهزة المطلوبة مضبوطة كما هي تمامًا.
استعد من Synology بحذر
إذا كنت تنقل وحدة التحكم من Synology، فلا تستعد نسخة UniFi الاحتياطية إلا بعد التأكد من سلامة حاوية ZimaOS الجديدة وMongoDB الخارجي. ثم تحقق من مضيف Inform وحالة الأجهزة قبل إيقاف تشغيل وحدة التحكم القديمة.
لا تُشغّل وحدتي تحكم نشطتين تدّعيان ملكية المواقع أو الأجهزة نفسها أثناء النقل، إلا إذا كنت تفهم تبعات الاعتماد.
متى يكون عنوان IP مخصص على الشبكة المحلية مفيدًا فعلًا؟
قد يكون عنوان macvlan أو ipvlan مفيدًا لتقسيم جدار الحماية بصرامة، أو تجنب تعارض المنافذ، أو جعل وحدة التحكم تبدو كجهاز مستقل. لكنه ليس مطلوبًا لمجرد أن Docker يعرض عنوانًا داخليًا يبدأ بـ 172.x.
إذا اخترت macvlan، فخطط لقيد الاتصال الشائع بين المضيف وmacvlan، وتحقق من بقاء MongoDB قابلًا للوصول من شبكة وحدة التحكم.
الأسئلة الشائعة
هل تحتاج حاوية UniFi إلى عنوان IP محلي يبدأ بـ 192.168؟
لا. يكفي في كثير من عمليات النشر استخدام وضع الجسر مع المنافذ المنشورة ومضيف Inform يمكن الوصول إليه.
لماذا تفشل أجهزة UniFi في الاعتماد داخل Docker؟
من الأسباب الشائعة الإعلان عن عنوان IP للحاوية لا يمكن الوصول إليه. اضبط مضيف Inform على عنوان ZimaOS المحلي أو على اسم مضيف آخر يمكن الوصول إليه.
هل ينبغي أن أستخدم شبكة المضيف؟
استخدمها فقط إذا كان لديك سبب لذلك. يشارك وضع المضيف شبكة مضيف ZimaOS، ولا ينشئ عنوان IP محليًا مخصصًا.
متى ينبغي أن أستخدم macvlan؟
استخدمه فقط عندما تحتاج الحاوية فعلًا إلى هوية خاصة على الشبكة المحلية وتفهم التعقيدات الإضافية المتعلقة بالتوجيه والوصول من المضيف.
