المراقبة من الخارج
المراقبة من الخارج
Section titled “المراقبة من الخارج”يعيد حارس كاظمه تشغيل الخادم الذي يتوقف، وينبّهك حين لا يستطيع. لكن الحارس يعمل على الجهاز نفسه الذي تعمل عليه كاظمه. فحين ينقطع عن الجهاز التيار الكهربائي أو الشبكة، أو ينام، أو يتوقف نفقه، يصمت الحارس معه، ولا يُخبَر أحد.
المراقبة من الخارج خدمة صغيرة تعمل في مكان آخر — عامل Cloudflare (Worker) على حسابك أنت — وتراقب التثبيت من هناك. وتنبّهك عبر بوت Telegram خاص بها، فلا يستطيع عطلٌ في بوت كاظمه نفسه أن يُسكتها هي أيضًا.
كيف تعرف ما الذي تعطّل
Section titled “كيف تعرف ما الذي تعطّل”كل دقيقة تفعل أمرين:
- تسأل الموقع من الخارج. تفتح صفحة الصحة في تثبيتك عبر النفق، كما يفعل المتصفح.
- تقرأ نبضة الحارس. بعد الربط يرسل إليها الحارس كل دقيقة رسالة قصيرة موقّعة: هل كاظمه تعمل وجاهزة، وقاعدة البيانات، وDocker، وموصل النفق، والمساحة الحرة على القرص، والطاقة على جهاز فيه بطارية أو UPS.
ومعًا يقول الأمران ما حدث:
| ما تراه | ما تخبرك به |
|---|---|
| الموقع يجيب، والنبضة تصل | كل شيء يعمل |
| الموقع لا يجيب، ولا نبضة | لا يمكن الوصول إلى الجهاز: الكهرباء أو الشبكة أو النوم |
| الموقع لا يجيب، والنبضة تصل | النفق متوقف؛ وكاظمه نفسها تعمل |
| النفق يجيب لكن كاظمه لا تجيب، والنبضة تقول إن كاظمه متوقفة | كاظمه متوقفة؛ والحارس يعيد تشغيلها |
| الموقع يجيب لكنه غير جاهز | كاظمه تعمل؛ واعتمادٌ ما (قاعدة البيانات، أو Docker) غائب |
| الموقع يجيب، ولا نبضة | الحارس توقف؛ وكاظمه بلا إشراف |
| لا عنوان يُنظر إليه (النبضات فقط)، ولا نبضة | لا يسمع Kazma Watch شيئًا من كاظمه: الكهرباء أو الشبكة أو النوم أو حارسها |
والتثبيت الذي لا عنوان له على الإنترنت يُراقَب بنبضاته وحدها: فيقول Kazma Watch حينئذ حال كاظمه مما يقوله الحارس، وحين تتوقف النبضات يقول إنه لا يسمع شيئًا.
يجب أن تدوم المشكلة ثلاث دقائق قبل أن تُنبَّه، فلا تنبّه إعادة تشغيل أو
انقطاع قصير في الشبكة أحدًا. تصلك رسالة واحدة حين تبدأ، وتذكير كل ساعة ما
دامت قائمة، ورسالة واحدة حين تنتهي تقول كم دامت. أما العمل المخطَّط — kazma update،
أو الحارس الموقوف مؤقتًا للصيانة — فلا ينبّه بشيء.
ما يُرسل إليها
Section titled “ما يُرسل إليها”حالات وأرقام فقط: لا محادثة، ولا ملفات، ولا مسارات، ولا أسماء، ولا نص خطأ.
يبني الحارس الرسالة من قائمة ثابتة من الحقول ويوقّعها بمفتاح لا يملكه إلا هذا
التثبيت؛ ويرفض المراقب رسالة غير موقّعة به، أو عمرها أكثر من خمس دقائق، أو
سبق أن استلمها.
ويشمل التوقيع العنوان الذي أُرسلت إليه الرسالة إلى جانب الرسالة نفسها، فيُرفض
الطلب الموقّع عند أي عنوان آخر من عناوين المراقب (راجع
deploy/observer/README.md، قسم “Signatures”). وحين يُحدَّث كاظمه والمراقب
كلاهما، انشر المراقب أولًا، ثم كاظمه.
إعدادها
Section titled “إعدادها”أمر واحد
Section titled “أمر واحد”على الحاسوب الذي تعمل عليه كاظمه:
kazma observer setupينشئ Kazma Watch خاصًا بك على حسابك في Cloudflare (تكفي الخطة المجانية) ويربط هذا التثبيت به، ذاكرًا كل خطوة وهو يمضي:
- يسجّل دخولك إلى Cloudflare في متصفحك، إن لم تكن مسجّلًا بالفعل
(بأداة Cloudflare نفسها،
wrangler، التي تعمل على Node: وتثبّت كاظمه Node جزءًا من أجزائها). - يطلب بوت Telegram للمراقب: في Telegram افتح @BotFather، وأرسل
/newbot، والصق التوكن الذي يعطيك إياه (لا يُعرض). ثم أرسل إلى البوت الجديد أي رسالة، فيجد الإعداد محادثتك. - يسأل عن عنوان كاظمه على الإنترنت، إن كان لها عنوان، ويفحصه من هنا. وإن لم يكن، يراقب Kazma Watch بالنبضات وحدها. والعنوان الذي خلف Cloudflare Access يحتاج إلى توكن خدمة من Access كي يدخل المراقب؛ ودونه، النبضات فقط.
- ينشئ قاعدة بيانات المراقب وينشره على
kazma-watch.<your subdomain>.workers.dev. - يربط هذا التثبيت، ويخبر المراقب بمنطقتك الزمنية، ويرسل إليك رسالة اختبار على Telegram.
لا يوضع شيء سري على سطر أوامر ولا يُحفظ في ملف: يذهب توكن البوت ورمز ربط المراقب
إلى Cloudflare أسرارًا للـWorker، ويُحفظ رمز الربط في خزنة كاظمه. شغّله مجددًا
بعد تحديث لينشر مراقب ذلك الإصدار (--update لا يسأل شيئًا)؛ وهو يُبقي قاعدة
البيانات والبوت والربط. ومع عدة حسابات في Cloudflare، أضف
--account-id <id>. والتثبيت المربوط بالفعل بمراقب آخر يُترك كما هو ما لم تضف
--move.
وحين تقدّم كاظمه مراقبًا تستضيفه للجميع، سيكون الربط به بالأمر
kazma observer pair --url <its address> مع الرمز الذي يعطيك إياه: ولا يتغير شيء
آخر في التثبيت.
يدويًا
Section titled “يدويًا”الخطوات التي يتخذها الأمر، وما تبقى (نطاقك الخاص للمراقب، وصفحة حالته خلف
Cloudflare Access، والتنبيهات بالبريد، وإشعارات Cloudflare)، في
deploy/observer/README.md. ثم اربط هذا التثبيت، من الإعدادات ←
التنبيهات ← مراقب كاظمه (Kazma Watch): الصق رمز الربط الذي أعطيته للمراقب
واضغط ربط؛ أو على الجهاز الذي تعمل عليه كاظمه:
kazma observer pairوفي الحالتين يُستخدم الرمز مرة واحدة ولا يُحفظ: تسجّل كاظمه هذا التثبيت، وتكتب مفتاح الربط في مجلد كاظمه نفسها، ولا يقرؤه إلا حسابك، ثم تُبلغ المراقب بمنطقتك الزمنية (منطقة التذكيرات في الإعدادات ← الذاكرة)، فتأتي الأوقات في رسائله بتوقيتها. وخلال دقيقة يكون الحارس يرسل النبضات.
لترى ما تراه:
kazma observer statusوالأمر نفسه في الإعدادات ← التنبيهات ← مراقب كاظمه: آخر نبضة استلمها المراقب، وما يستنتجه الآن، ونسبة التشغيل هذا الأسبوع والحوادث، والمنطقة الزمنية التي تستخدمها رسائله. يجعل زر إرسال رسالة تجريبية المراقبَ يرسل رسالة واحدة عبر بوته الخاص (وعبر البريد حين يُعَدّ) ويقول أيّ القنوات استلمتها؛ ويرسل إليه زر إبلاغ المراقب المنطقة الزمنية من جديد، وعنوان البريد الذي تُرسَل إليه الرسائل. ويكسب الملخص اليومي سطرًا أيضًا (“Outside watch: up 99.9 % this week, 1 incident (machine not reachable, 14 min)”).
لإيقافها، اضغط فك الربط هناك (وأشِّر على «احذف أيضًا» لحذف كل ما احتفظ به المراقب عن هذا التثبيت)، أو:
kazma observer unpair --forgetولا تحتاج الصفحة إلى رمز لهذه الأزرار: كل طلب موقَّع بمفتاح الربط الخاص بهذا
التثبيت (POST /v1/settings، و/v1/test-page، و/v1/leave). والمراقب الذي
نُشر قبلها يحتاج إلى تطبيق schema.sql مرة أخرى (يضيف الجدول
install_settings) ثم npx wrangler deploy.
صفحة الحالة
Section titled “صفحة الحالة”تعرض status.kazma.ai (خلف Cloudflare Access: لك وحدك) الحالة الآن، وأحدث
نبضة، وأشرطة التشغيل لتسعين يومًا، وكل حادثة بسببها ومدتها، وأزمنة الاستجابة
في آخر يوم.
من يراقب المراقب
Section titled “من يراقب المراقب”يرسل المراقب إشارة إلى Healthchecks.io كل دقيقة؛ وإن توقفت الإشارات راسلك Healthchecks بالبريد. وإشعار صحة النفق الخاص بـ Cloudflare نفسها إشارة ثانية مستقلة للنفق.
إعدادات الحارس
Section titled “إعدادات الحارس”تُضبط في بيئة الحارس (مهمة KazmaAgent)، لا في .env:
| المتغير | الافتراضي | ما يفعله |
|---|---|---|
KAZMA_GUARD_OUTSIDE_WATCH | auto | auto يرسل النبضات بعد الربط؛ وoff لا يرسلها أبدًا |
KAZMA_GUARD_OUTSIDE_WATCH_URL | عنوان المراقب المربوط | حيث تذهب النبضات (https فقط) |
KAZMA_GUARD_DISK_WATCH | auto | فحص الحارس نفسه للمساحة الحرة، وهو ينبّه أيضًا من الجهاز |

