Homelab Pulse English

أدلة الإعداد

ثبّت الوكيل واقرن هاتفك

يقرأ Homelab Pulse سيرفرك عبر وكيل صغير يعمل عليه. تثبّته مرة واحدة بأمر واحد، ثم تقرن هاتفك بمسح رمز QR. يستغرق ذلك نحو خمس دقائق.

تحتاج إلى

  • سيرفر يعمل بنظام Debian أو Ubuntu أو Raspberry Pi OS بإصدار 64 بت (amd64 أو arm64) مع systemd.
  • حساب يملك صلاحية sudo عليه.
  • أن يكون هاتفك على شبكة السيرفر نفسها في أول اقتران.

  1. انسخ أمر التثبيت

    افتح في التطبيق إضافة سيرفر. تجد أمر التثبيت في البطاقة الأولى: انسخه، أو شاركه إلى الحاسوب الذي تصل منه إلى سيرفرك.

    curl -fsSL https://github.com/Aldaghir/homelab-pulse/releases/latest/download/install.sh | sudo sh

    تفضّل قراءة السكربت قبل تشغيله؟ نزّل install.sh من آخر إصدار واقرأه، ثم شغّله بالأمر sudo sh install.sh. يتحقق المثبّت من الوكيل الذي ينزّله بمطابقته مع بصمات الإصدار (checksums).

    شاشة إضافة سيرفر وفيها أمر التثبيت وخيارات المسح والقريب واليدوي

  2. شغّله على سيرفرك

    الصق الأمر في طرفية السيرفر. يثبّت الوكيل خدمةَ systemd باسم hlpulse-agent تعمل بمستخدمها الخاص hlpulse، ويطبع في النهاية رمز QR ورمز اقتران وبصمة السيرفر. يعمل الرمز مرة واحدة وتنتهي صلاحيته بعد 10 دقائق.

    انتهت صلاحية الرمز، أو كان الوكيل مثبّتاً من قبل؟ شغّل sudo hlpulse-agent pair لرمز جديد.

  3. امسح رمز QR

    اضغط مسح رمز QR ووجّه الكاميرا نحو الطرفية.

    تعذّر المسح؟ يعرض خيار قريب الوكلاءَ المعلنين على شبكة Wi-Fi، ويقبل خيار يدوي عنوان IP للسيرفر أو اسمه على المنفذ 8443.

    الإدخال اليدوي: عنوان السيرفر ومنفذه
    الإدخال اليدوي: عنوان السيرفر والمنفذ 8443.

  4. تأكّد أنه سيرفرك ثم اقترن

    يعرض التطبيق اسم السيرفر وعنوانه وبصمته. مسح رمز QR يثبت هوية السيرفر وحده؛ أما عند الإضافة اليدوية فقارن البصمة بالتي طبعها الوكيل.

    اكتب رمز الاقتران إن طلبه التطبيق، وسمِّ هذا الهاتف، ثم اضغط اقترن.

    اسم السيرفر وعنوانه وبصمته الموثّقة مع حقل اسم الجهاز وزر الاقتران

  5. انتهى

    تُفتح اللوحة بحالة سيرفرك الحيّة. الخطوة التالية: الوصول إليه من خارج المنزل، أو استقبال التنبيهات على Telegram.

    تم الاقتران: السيرفر متصل الآن بهذا الهاتف

إن واجهتك مشكلة

التطبيق لا يصل إلى السيرفر
يجب أن يكون الهاتف والسيرفر على الشبكة نفسها، وأن يقبل السيرفر الاتصال على منفذ TCP رقم 8443. إن كان عليه جدار حماية فاسمح بهذا المنفذ من شبكتك المحلية.
البصمة لا تطابق
لا تقترن: جهاز آخر يردّ على ذلك العنوان. شغّل sudo hlpulse-agent pair على السيرفر وقارن مرة أخرى.
هل الوكيل يعمل؟
الأمر systemctl status hlpulse-agent يعرض حالته، والأمر journalctl -u hlpulse-agent -e يعرض آخر رسائله.
إزالة الوكيل
شغّل أمر التثبيت مع إضافة --uninstall: curl -fsSL …/install.sh | sudo sh -s -- --uninstall، فيوقف الوكيل ويزيله. تبقى بياناته في /var/lib/hlpulse وإعداداته في /etc/hlpulse حتى تحذفها بنفسك.