إن منشور مجتمع IceWhale لعام 2023 حول Uptime Kuma يُعد مقدمة أكثر منه دليلًا إرشاديًا للتثبيت. يذكر المنشور أن البرنامج التعليمي يغطي التثبيت على CasaOS، بينما تركز الردود على أسباب تقدير المستخدمين لـ Uptime Kuma: إشعارات انقطاع الخدمة، ومراقبة الخدمات غير الحرجة في بيئة الإنتاج، ومراقبات الدفع. ولا يحتفظ نص المنتدى نفسه بإعدادات المثبّت خطوة بخطوة.
لذلك، ينبغي أن تحافظ الصفحة الحالية المفيدة على سياق CasaOS وحالات الاستخدام التي ذكرها المجتمع، مع الاعتماد على متطلبات Docker المُحدّثة التي يحافظ عليها Uptime Kuma للنشر الفعلي.
ما الذي يضيفه Uptime Kuma إلى الخادم المنزلي؟
Uptime Kuma لوحة مراقبة مستضافة ذاتيًا. ويمكنها اختبار سلامة موقع ويب، أو خدمة TCP، أو نقطة نهاية DNS، أو هدف ping، أو خدمة مرتبطة بـ Docker، أو مهمة تعتمد على الدفع، كما يمكنها إرسال إشعارات عند تغيّر الحالة.
أكدت الردود الأصلية مرارًا أن الإشعارات هي الفائدة العملية الأهم. فاللوحة مفيدة، لكن الميزة الرئيسية هي معرفة أن إحدى الخدمات متوقفة قبل أن يبلغ أحد أفراد المنزل عن ذلك.
استخدم حاوية Uptime Kuma الحالية
تستخدم تعليمات نشر Uptime Kuma الحالية الصورة المُصانة louislam/uptime-kuma:2. ويستمع تطبيق الويب إلى المنفذ 3001، ويخزن قاعدة البيانات والإعدادات الدائمة ضمن /app/data.
عند إنشاء تطبيق مخصص حالي في CasaOS، حوّل إعدادات تثبيت Docker التي يحافظ عليها Uptime Kuma إلى حقول تطبيق CasaOS بدلًا من استخدام وسم صورة قديم من فيديو يعود إلى عام 2023.
إتاحة لوحة التحكم على المنفذ 3001
تستخدم خدمة الويب داخل الحاوية منفذ TCP 3001. وإذا كان منفذ المضيف هذا مستخدمًا بالفعل، فاربط منفذ مضيف آخر بمنفذ الحاوية 3001، ثم افتح تطبيق CasaOS عبر منفذ المضيف الذي اخترته.
لا يتطلب تغيير منفذ المضيف تغيير المنفذ الداخلي لـ Uptime Kuma، ما لم يكن التطبيق upstream يدعم هذا التغيير ويحتاج إليه صراحةً.
الاحتفاظ بالبيانات في /app/data
اربط مجلدًا على مضيف CasaOS أو وحدة تخزين Docker بالمسار /app/data. فهذا هو الهدف الأهم للنسخ الاحتياطي، لأنه يحتوي على إعدادات المراقبة وبيانات المستخدم وقاعدة بيانات SQLite.
إن إعادة إنشاء الحاوية دون وحدة التخزين الدائمة هذه ستجعلها تتصرف كأنها تثبيت جديد لـ Uptime Kuma.
احتفظ بقاعدة البيانات على نظام ملفات يوفر قفلًا موثوقًا
تحذر إرشادات Uptime Kuma الحالية من أن قاعدة بيانات SQLite تحتاج إلى قفل موثوق للملفات وفق POSIX، وتحذر تحديدًا من أنظمة الملفات مثل العديد من إعدادات NFS لدليل البيانات الخاص بها.
بالنسبة إلى الخادم المنزلي، يُعد الاحتفاظ بـ /app/data على وحدة تخزين محلية الخيار الأبسط. ويمكنك بعد ذلك نسخ هذا الدليل المحلي احتياطيًا إلى قرص آخر أو وجهة بعيدة.
اختر مراقبات تتوافق مع تجربة الاستخدام
لا يثبت مراقب ping سوى أن جهازًا ما يستجيب لـ ICMP. فإذا كان المتطلب الفعلي هو «ينبغي أن يتم تحميل Jellyfin»، فسيكون مراقب HTTP لنقطة نهاية Jellyfin أكثر فائدة.
يمكن أن تتضمن مجموعة عملية ما يلي:
- فحوصات HTTP لتطبيقات الويب؛
- فحوصات TCP للخدمات التي لا توفر نقطة نهاية ويب مفيدة؛
- فحوصات DNS لـ Pi-hole أو AdGuard Home؛
- فحوصات ping للتحقق الأساسي من إمكانية الوصول إلى المضيف؛
- مراقبات الدفع للمهام المجدولة التي ينبغي أن تبلغ عن اكتمالها.
لماذا تُعد مراقبة الدفع المذكورة في الموضوع مهمة؟
ذكر أحد المشاركين في المجتمع على وجه الخصوص أنه يستخدم مراقبات الدفع كثيرًا. فبدلًا من أن يستطلع Uptime Kuma حالة الخدمة، يستدعي برنامج نصي للنسخ الاحتياطي أو مهمة مجدولة عنوان URL فريدًا عند نجاحه. وإذا لم تصل نبضة الحياة هذه خلال الفترة المتوقعة، يضع Uptime Kuma علامة على أن المراقب غير سليم.
يفيد ذلك في المهام التي لا يثبت فيها كون الخادم متصلًا أن المهمة قد نُفذت بالفعل.
اختبر الإشعارات قبل أول انقطاع
اضبط قناة إشعارات واحدة على الأقل، وشغّل تنبيهًا اختباريًا عمدًا. فنظام المراقبة الذي يفشل بصمت في إرسال الإشعارات ليس سوى لوحة معلومات تاريخية.
وبالنسبة إلى الخدمات المنزلية، ضع أيضًا في الاعتبار إرهاق التنبيهات. فقد يؤدي إعداد إشعارات فورية لكل نقطة نهاية بسيطة إلى جعل تجاهل الانقطاعات الحقيقية أسهل.
أبقِ لوحة المراقبة خاصة ما لم يكن الوصول عن بُعد مقصودًا
قد يكشف Uptime Kuma أسماء المضيفين الداخلية، وأسماء الخدمات، وعناوين الشبكة، وسجل الانقطاعات. فلا تعرضه مباشرةً على الإنترنت العام لمجرد أن المراقبة عن بُعد مفيدة. استخدم شبكة VPN أو شبكة تراكبية خاصة أو وكيلًا عكسيًا موثّقًا إذا كان الوصول عن بُعد مطلوبًا.
لا تتعامل مع موضوع CasaOS لعام 2023 على أنه تثبيت لإصدار حالي
يشيد النقاش المصدر بتطبيق يحظى بصيانة جيدة، لكنه لا يحتفظ بإصدار للصورة. وهذا مفيد: استخدم الإصدار الحالي من upstream بدلًا من محاولة إعادة إنشاء الحاوية نفسها التي كانت موجودة في سبتمبر 2023.
الأسئلة الشائعة حول Uptime Kuma على CasaOS
ما المنفذ الذي يستخدمه Uptime Kuma حاليًا؟
المنفذ 3001 لواجهة الويب.
ما الدليل الذي يجب الاحتفاظ به؟
/app/data.
لماذا ينبغي إبقاء دليل البيانات على وحدة تخزين محلية؟
تحتاج قاعدة بيانات SQLite إلى قفل موثوق للملفات، وتحذر إرشادات upstream الحالية من أنظمة ملفات الشبكة غير المناسبة.
ما أكثر ما قدّره المجتمع في الأصل؟
جرى التأكيد مرارًا في الردود على الإشعارات ووظيفة مراقبات الدفع.
