🩸 تثبيت Nightscout — منصة المراقبة الفورية لمستويات السكر CGM على Docker

نشر منصة Nightscout على Ubuntu باستخدام Docker — لوحة التحكم مفتوحة المصدر لمراقبة مستشعرات السكر المستمر (CGM) لحظياً، وإدارة مرض السكري وأنظمة البنكرياس الاصطناعي المغلقة ومتابعة الرعاية عن بُعد.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت مؤتمت — أمر واحد ينشر Nightscout وقاعدة بيانات MongoDB 5 على المنفذ 8194 مع مفاتيح API آمنة وتخزين دائم لقراءات السكر.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/clinic/nightscout/nightscout-ubuntu.sh
chmod +x nightscout-ubuntu.sh
./nightscout-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/clinic/nightscout/nightscout-ubuntu.sh

2 منح صلاحية التنفيذ

chmod +x nightscout-ubuntu.sh

3 تشغيل المثبت

./nightscout-ubuntu.sh

4 ربط التطبيق وضبط التنبيهات

http://your-server-ip:8194

المنافذ المستخدمة

المنفذالغرض
8194Nightscout web dashboard (mapped from container port 1337)
27017MongoDB — internal to the Docker network, not exposed to the host

نظرة عامة

تعد منصة Nightscout (المعروفة باسم CGM Remote Monitor) نظاماً مفتوح المصدر تم ابتكاره ضمن مبادرة #WeAreNotWaiting العالمية، لعرض ومراقبة قراءات مستشعرات السكر المستمرة (مثل Dexcom وFreeStyle Libre وMedtronic) في الوقت الفعلي عبر متصفح الويب. يعمل التطبيق على المنفذ 8194 مع قاعدة بيانات MongoDB 5 معزولة، ويتيح للمصابين بالسكري من النوع الأول وذويهم متابعة مسار السكر لحظياً، وضبط التنبيهات المخصصة، وعرض القراءات على الساعات الذكية (Apple Watch وGarmin وWear OS)، والربط مع أنظمة البنكرياس الاصطناعي (Loop وAndroidAPS وOpenAPS).

لماذا تستخدمه

تقوم تطبيقات الشركات المصنعة بحبس البيانات الطبية داخل خوادمها المغلقة مع خيارات مشاركة محدودة وتنبيهات متأخرة. تمنحك الاستضافة الذاتية لـ Nightscout السيادة الكاملة على بياناتك الصحية؛ حيث تتيح المراقبة الفورية للآباء ومقدمي الرعاية عبر أي جهاز متصل بالإنترنت، مع توفير واجهات برمجية API مفتوحة لربط الساعات الذكية واستخراج التقارير الطبية التفصيلية وسجلات الإنسولين والوجبات دون أي اشتراكات دورية.

متى تحتاجه

  • تستخدم أنت أو أحد أفراد أسرتك مستشعر CGM (مثل Dexcom أو Libre) وتحتاج لمتابعة قراءات السكر لحظياً من الهواتف والساعات الذكية
  • تشغل نظام البنكرياس الاصطناعي وضخ الإنسولين الآلي (AndroidAPS أو Loop أو OpenAPS) وتحتاج لخادم سحابي مركزي لتسجيل البيانات
  • أولياء أمور الأطفال المصابين بالسكري لمتابعة أطفالهم أثناء فترات المدرسة واستلام تنبيهات الهبوط والارتفاع التنبؤية
  • ترغب في عرض مستوى السكر وسهم الاتجاه مباشرة على واجهة ساعتك الذكية (Garmin أو Apple Watch أو Wear OS)
  • تريد الخصوصية التامة والتحكم الكامل في سجلاتك الصحية دون الاعتماد على خوادم الشركات التجارية

من يحتاجه

  • المصابون بالسكري المعتمد على الإنسولين (النوع الأول) لإدارة ومتابعة مستويات السكر اليومية بدقة
  • الآباء وأفراد الأسرة ومقدمو الرعاية لمتابعة سكر الأطفال وكبار السن عن بُعد في الوقت الفعلي
  • مستخدمو ومطورو أنظمة البنكرياس الاصطناعي مفتوحة المصدر (Closed-Loop Systems)
  • أطباء الغدد الصماء والسكري لمراجعة تقارير AGP التفصيلية ومعدل الوقت في النطاق المستهدف (TIR)
  • الرياضيون وممارسو رياضات التحمل لمتابعة استجابة الجسم والسكر أثناء التمارين

حالات الاستخدام الشائعة

  • عرض قراءات السكر الحية وأسهم الاتجاه ومعدل التغير (Delta) على واجهات الساعات الذكية والشاشات المنزلية
  • استلام تنبيهات صوتية وإشعارات فورية عبر الهاتف قبل حدوث حالات الهبوط الحاد (Hypoglycemia)
  • تسجيل جرعات الإنسولين وكميات الكربوهيدرات وممارسة الرياضة وتغيير المستشعرات في خط زمني موحد
  • متابعة الإنسولين النشط في الجسم (IOB) والكربوهيدرات النشطة (COB) المزامنة من مضخات الإنسولين الذكية
  • استخراج تقارير طبية شاملة (AGP وTime in Range) بصيغة PDF لتقديمها للطبيب المعالج في الزيارات الدورية

الميزات الرئيسية

  • لوحة مراقبة تفاعلية بالألوان مع تحديد النطاقات المستهدفة وأسهم اتجاه مسار السكر
  • نظام تنبيهات متقدم: تنبيهات صوتية بالمتصفح، وإشعارات Pushover وTelegram وIFTTT والرسائل النصية
  • دعم واسع للساعات الذكية: تطبيقات وواجهات مخصصة لـ Apple Watch وWear OS وGarmin وFitbit
  • توافق كامل مع أنظمة البنكرياس الاصطناعي الذاتية: AndroidAPS وiOS Loop وOpenAPS وTrio
  • حزمة تقارير سريرية متكاملة: تحليلات يومية، مقارنات أسبوعية، ومخطط الملف الجلوكوزي الإسعافي (AGP)
  • دعم شامل لجميع مصادر البيانات: Dexcom Share وxDrip+ وSpike وLibreLinkUp وNightscout Uploader
  • نظام أمان بصلاحيات دقيقة عبر مفاتيح API Secret ورموز الوصول المخصصة للقراءة فقط
  • نشر معزول ومستقر عبر Docker يجمع خادم Nightscout مع قاعدة بيانات MongoDB 5 للتخزين الدائم

كيفية الاستخدام بعد التثبيت

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8194 لعرض واجهة Nightscout
  • اضبط وكيلاً عكسياً مع شهادة SSL مشفرة (HTTPS) ونطاق مخصص — تتطلب تطبيقات الهواتف والساعات HTTPS للعمل
  • اضبط تطبيق الرفع في هاتفك (مثل xDrip+ أو AndroidAPS أو Loop) بإدخال رابط السيرفر ورمز API Secret
  • انقر على القائمة الجانبية أعلى يمين الشاشة لضبط الإضافات (Plugins) والوحدات (mg/dL أو mmol/L) وحدود التنبيهات
  • سجل الدخول كمسؤول في واجهة الويب بإدخال رمز API Secret في الإعدادات لتفعيل أدوات الإدارة
  • أنشئ رموز وصول مخصصة (Viewer Tokens) من أدوات الإدارة لمشاركتها مع أفراد العائلة دون إعطائهم الرمز الرئيسي

أفضل ممارسات الأمان

  • استخدم تشفير HTTPS دائماً عبر وكيل عكسي (مثل Nginx مع Let's Encrypt) لحماية البيانات الصحية الحساسة أثناء النقل
  • حدد رمز API_SECRET قوي ومعقد (لا يقل عن 12 حرفاً) لمنع الوصول غير المصرح به لقاعدة البيانات
  • لا تشارك رمز API_SECRET الرئيسي مع الآخرين؛ بل أنشئ رموز وصول مخصصة للقراءة فقط لمقدمي الرعاية
  • أبقِ منفذ MongoDB 27017 معزولاً داخل شبكة Docker الداخلية وتجنب فتحه على جدار الحماية للإنترنت
  • احمِ الوصول للوحة التحكم عبر تقييد العرض بالمصادقة أو بوابات الوصول الآمنة
  • حدّث صورة حاوية Nightscout بانتظام للحصول على التحديثات الأمنية وإصلاحات الاتصال بالمستشعرات

المنافذ وإعدادات جدار الحماية

تعمل واجهة Nightscout والواجهات البرمجية REST API على المنفذ 8194 (المحول داخلياً من منفذ 1337). في الإنتاج، قم بتهيئة وكيل عكسي مشفر بـ SSL (مثل Nginx Proxy Manager أو Caddy) على المنفذ 443 ووجه الحركة إلى 8194. وتعمل قاعدة بيانات MongoDB على المنفذ الداخلي 27017 داخل شبكة Docker (`nightscout-net`) ويجب عدم فتحها مطلقاً في جدار الحماية العام.

النسخ الاحتياطي والصيانة

  • انسخ مجلد ./mongo احتياطياً، والذي يحتوي على قاعدة بيانات MongoDB بجميع قراءات السكر وسجلات الإنسولين السابقة
  • استخدم أمر mongodump داخل الحاوية لأخذ نسخ احتياطية مضغوطة: docker exec nightscout-mongo mongodump --out /data/db/backup
  • احتفظ بنسخة من رمز API_SECRET ومتغيرات البيئة ومفاتيح خطافات التنبيهات
  • أتمت النسخ الاحتياطي الدوري لقاعدة البيانات وارفعها إلى مساحة تخزين سحابية مشفرة عبر restic أو rsync
  • اختبر دورياً استعادة البيانات في حاوية تجريبية للتأكد من سلامة الجداول واسترجاع السجلات التاريخية

الأخطاء الشائعة

  • تشغيل Nightscout عبر بروتوكول HTTP غير المشفر: ترفض تطبيقات الهواتف الذكية (xDrip+ وLoop) وتطبيقات الساعات الاتصال بدون HTTPS
  • استخدام رمز API_SECRET أقل من 12 حرفاً، مما يؤدي لفشل التحقق والمصادقة في النظام
  • فتح منفذ قاعدة البيانات MongoDB 27017 للإنترنت العام
  • عدم ربط مجلد التخزين الدائم ./mongo، مما يسبب مسح السجلات التاريخية الطبية بالكامل عند تحديث الحاوية
  • نسيان ضبط المنطقة الزمنية الصحيحة (متغير TZ)، مما يؤدي لظهور القراءات في أوقات غير مطابقة للتوقيت المحلي

استكشاف الأخطاء وإصلاحها

  • تطبيق الهاتف يظهر خطأ 'Unauthorized (401)' — تأكد من تطابق رمز API Secret المدخل في الهاتف مع متغير API_SECRET في ملف السيرفر
  • اللوحة تعمل لكن لا تظهر أي قراءات — تأكد من عمل تطبيق الرفع في الهاتف ومزامنته وافحص سجلات الحاوية (docker logs nightscout -f)
  • فشل الاتصال بقاعدة البيانات عند بدء التشغيل — تحقق من تشغيل حاوية nightscout-mongo وصلاحيات مجلد البيانات
  • ظهور القراءات بوحدة خاطئة — بدل بين mg/dL وmmol/L من إعدادات الواجهة أو حدد متغير DISPLAY_UNITS في ملف الإعداد
  • عدم تحديث القراءات على الساعة الذكية — تأكد من أن نطاق السيرفر يعمل بشهادة HTTPS صالحة وموثوقة (Let's Encrypt)

البدائل

منصة Tidepool هي خيار سحابي غير ربحي يركز على تجميع السجلات الطبية للسكري بموافقة إدارة الغذاء والدواء. منصات Dexcom Clarity وLibreLinkUp هي البوابات السحابية الرسمية للشركات لمراجعة التقارير دون واجهات برمجية حية. منصة OpenHumans توفر منصة لا مركزية للبيانات الصحية. تطبيق Juggluco خيار متخصص لهواتف أندرويد لقراءة وبث حساسات Libre مباشرة.

متى لا تستخدمه

تجنب استخدام Nightscout إذا كنت لا تستخدم مستشعر قياس السكر المستمر (CGM) أو مضخة إنسولين ذكية، حيث أن المنصة مخصصة حصرياً لمعالجة تدفقات قراءات السكر الحية. وإذا كنت تحتاج فقط لتسجيل القراءات يدوياً في دفتر يوميات دون مشاركة حية أو ساعات ذكية، فإن التطبيقات البسيطة على الهاتف كافية وأسهل.

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

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

ما هي مستشعرات السكر (CGMs) المتوافقة مع Nightscout؟

يتوافق Nightscout مع جميع مستشعرات السكر الرائدة تقريباً مثل Dexcom G6 وG7 وONE، ومستشعرات FreeStyle Libre 1 و2 و3، ومستشعرات Medtronic Guardian وEversense، عبر تطبيقات وسيطة مثل xDrip+ أو LibreLinkUp أو برامج الرفع المباشرة.

هل يتطلب Nightscout شهادة HTTPS للاتصال بتطبيقات الهواتف والساعات؟

نعم، تفرض أنظمة تشغيل الهواتف (iOS وAndroid) وتطبيقات الساعات الذكية تشفيراً آمناً (TLS/HTTPS). يجب وضع Nightscout خلف وكيل عكسي مع شهادة SSL لتمكين التطبيقات من رفع واستقبال القراءات.

ما هو رمز API Secret في Nightscout؟

رمز API Secret هو كلمة المرور الرئيسية المشفرة (12 حرفاً على الأقل) المستخدمة لحماية موقعك، ويتم إدخالها في تطبيقات الهواتف وإعدادات الموقع لتخويل رفع البيانات والتعديل عليها.

هل يمكن لعدة أشخاص متابعة نفس المريض عبر Nightscout في وقت واحد؟

نعم، يمكن لعدة أفراد من العائلة والآباء ومقدمي الرعاية متابعة القراءات الحية في نفس اللحظة عبر هواتفهم وحواسيبهم، ويمكن توليد رموز قراءة مخصصة لمشاركتها معهم بأمان.

كم يستهلك Nightscout وقاعدة بيانات MongoDB من الذاكرة العشوائية؟

تستهلك حاوية Nightscout بجانب قاعدة بيانات MongoDB 5 معاً ما بين 250 إلى 450 ميجابايت تقريباً من الذاكرة العشوائية، مما يجعله خفيفاً ومناسباً للتشغيل على أصغر السيرفرات السحابية (1 GB RAM).