تهيئة وحدة تحكم شبكة يوبيكويتي يونيفاي عبر سطر الأوامر

تتم معظم تهيئة يونيفاي من خلال وحدة تحكم شبكة UniFi الرسومية، لكن سطر الأوامر ضروري عندما يرفض جهاز التبني تلقائياً، أو عند التبني عبر شبكات مختلفة (الطبقة الثالثة)، أو عند استضافة وحدة التحكم ذاتياً. يغطي هذا الدليل من سكايلاين الأوامر الحقيقية المُتحقَّق منها — دون أي اختلاق. تحقّق دائماً من الصياغة وفق إصدار البرنامج الثابت لديك قبل التنفيذ في بيئة الإنتاج.

قبل أن تبدأ: كيف يعمل تبني يونيفاي

تتصل أجهزة يونيفاي (نقاط الوصول ومبدلات USW وبوابات UCG/UDM) بوحدة التحكم باستخدام بروتوكول inform عبر منفذ TCP رقم 8080. وتعمل واجهة الويب لوحدة التحكم المُستضافة ذاتياً (الإصدار القديم) على المنفذ 8443 (HTTPS). عندما يكون الجهاز ووحدة التحكم على نفس شبكة الطبقة الثانية، يتم التبني تلقائياً عادةً عبر اكتشاف الطبقة الثانية. أما عند وجودهما على شبكات فرعية أو مواقع مختلفة، فإنك توجّه الجهاز إلى وحدة التحكم يدوياً باستخدام الأمر set-inform.

الخطوة 1 — الاتصال بجهاز يونيفاي عبر SSH

يجب أن يكون SSH مُفعّلاً (وهو مُفعّل افتراضياً على الأجهزة الجديدة من المصنع، ويمكن ضبطه من وحدة التحكم عبر Settings ← System ← Device Authentication). اتصل باستخدام بيانات الاعتماد الافتراضية ubnt / ubnt ما لم تكن قد غُيّرت:

ssh ubnt@192.168.1.20

عند الطلب، أدخل كلمة المرور (الافتراضية ubnt). أنت الآن في صدفة الجهاز.

الخطوة 2 — توجيه الجهاز إلى وحدة التحكم باستخدام set-inform

نفّذ الأمر set-inform مع عنوان inform الخاص بوحدة التحكم. والصيغة دائماً هي http://<عنوان-وحدة-التحكم>:8080/inform:

set-inform http://192.168.1.10:8080/inform

للتبني عن بُعد عبر الطبقة الثالثة، استخدم عنوان IP أو اسم نطاق قابلاً للوصول لوحدة التحكم (مثل اسم نطاق عام أو عنوان يمكن الوصول إليه عبر VPN):

set-inform http://unifi.example.com:8080/inform

هدف inform الافتراضي على الجهاز الجديد هو http://unifi:8080/inform، حيث يكون unifi اسم نطاق تنشره كثير من الشبكات لوحدة التحكم.

الخطوة 3 — التبني في وحدة التحكم ثم التأكيد

بعد أول تنفيذ لـ set-inform، يظهر الجهاز ضمن UniFi Devices بحالة Pending Adoption. اضغط Adopt في وحدة التحكم. سيظهر الجهاز للحظات بحالة Adopting ثم تتم تهيئته. وإذا توقف عالقاً، عُد إلى جلسة SSH ونفّذ الأمر نفسه مرة ثانية لإتمام الربط:

set-inform http://192.168.1.10:8080/inform

هذا النمط من خطوتين (set-inform ← Adopt ← set-inform مرة أخرى) هو الطريقة القياسية لإتمام التبني عبر الطبقة الثالثة.

الخطوة 4 — التحقق من حالة الجهاز

تأكّد من التهيئة باستخدام الأمر info، الذي يطبع طراز الجهاز وإصدار البرنامج الثابت وعنوان inform الحالي وحالة الإدارة:

info

ابحث عن عنوان inform مطابقاً لوحدة التحكم وحالة Connected بعد اكتمال التبني.

إعادة ضبط الجهاز لإعادة التبني

الجهاز الذي سبق تبنّيه لن يقبل عنوان inform جديداً حتى يعود إلى حالة المصنع الافتراضية غير المُدارة. إذا كان الجهاز عالقاً، فأعد ضبطه إلى إعدادات المصنع — إما بالضغط المطوّل على زر إعادة الضبط الفعلي لنحو 10 ثوانٍ، أو من صدفة SSH:

set-default

بعد إعادة الضبط، كرّر الخطوات من 1 إلى 3. وتعامل مع إعادة ضبط المصنع كحل أخير، لأنه يمسح كل التهيئة الموجودة على الجهاز.

تثبيت تطبيق UniFi Network مُستضاف ذاتياً على لينكس

إذا كنت تشغّل وحدة تحكم خاصة بك بدلاً من بوابة سحابية، فإن تطبيق UniFi Network المُستضاف ذاتياً (الإصدار القديم) يُثبَّت من مستودع APT الخاص بيوبيكويتي على دبيان/أوبونتو. أولاً ثبّت المتطلبات الأساسية:

sudo apt-get update
sudo apt-get install ca-certificates apt-transport-https -y

أضف مفتاح التوقيع ومستودع يوبيكويتي:

wget -qO - https://dl.ui.com/unifi/unifi-repo.gpg | sudo tee /usr/share/keyrings/unifi-repo.gpg > /dev/null

echo 'deb [signed-by=/usr/share/keyrings/unifi-repo.gpg] https://www.ui.com/downloads/unifi/debian stable ubiquiti' | sudo tee /etc/apt/sources.list.d/unifi.list

ثم ثبّت التطبيق (أو حدّثه):

sudo apt-get update
sudo apt-get install unifi -y

يتطلب يونيفاي إصداراً متوافقاً من MongoDB؛ وإذا لم يكن مُتوفراً في توزيعتك، فيجب إضافة مستودع MongoDB وفق تعليمات MongoDB لدبيان قبل تثبيت unifi. وبعد التثبيت، تعمل وحدة التحكم كخدمة (دون واجهة رسومية محلية) ويمكن الوصول إليها على https://<عنوان-الخادم>:8443. أدِرها عبر أدوات الخدمة، مثل:

sudo systemctl status unifi
sudo systemctl restart unifi

عن UniFi OS Server (الخيار الأحدث)

المسار الأحدث للاستضافة الذاتية من يوبيكويتي هو UniFi OS Server، الذي يشغّل تطبيقات يونيفاي داخل حاويات باستخدام Podman على أوبونتو 23.04+ / دبيان 12+ عبر سكربت تثبيت رسمي، بدلاً من حزمة APT القديمة مع MongoDB. اختر UniFi OS Server للتركيبات الجديدة عندما تريد التجربة نفسها متعددة التطبيقات مثل البوابة السحابية على أجهزتك الخاصة.

مرجع سريع للأوامر

• ssh ubnt@<عنوان-الجهاز> — الاتصال بالجهاز (كلمة المرور الافتراضية ubnt).
• set-inform http://<وحدة-التحكم>:8080/inform — توجيه الجهاز إلى وحدة التحكم.
• info — عرض الطراز والبرنامج الثابت وعنوان inform والحالة.
• set-default — إعادة ضبط الجهاز إلى المصنع (حل أخير).
• sudo apt-get install unifi -y — تثبيت تطبيق الشبكة المُستضاف ذاتياً.
• sudo systemctl restart unifi — إعادة تشغيل خدمة وحدة التحكم المُستضافة ذاتياً.

هل تحتاج مساعدة؟

تقوم سكايلاين بتركيب وتهيئة ودعم وإصلاح أجهزة يوبيكويتي يونيفاي في جميع أنحاء المملكة العربية السعودية. للحصول على مساعدة عملية، اطّلع على خدمة تركيب ودعم يونيفاي، أو تصفّح سوق تراخيص البرمجيات، أو تواصل مع مهندسينا على الرقم +966 50 993 9334.