📹 تثبيت Scrypted — جسر كاميرات المراقبة فائق السرعة لمنظومة Apple HomeKit على Docker

نشر منصة Scrypted على Ubuntu باستخدام Docker — المنصة مفتوحة المصدر الرائدة لربط كاميرات المراقبة (RTSP/ONVIF) بمنظومات Apple HomeKit (مع ميزة HKSV) وGoogle Home وAlexa بزمن استجابة فائق السرعة.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر Scrypted مع شبكة المضيف على المنفذ 10443 (HTTPS) مع دعم تسريع كروت الشاشة والإضافات.
عرض على GitHub

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/cameras/scrypted/scrypted-ubuntu.sh
chmod +x scrypted-ubuntu.sh
sudo bash scrypted-ubuntu.sh

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/cameras/scrypted/scrypted-ubuntu.sh

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

chmod +x scrypted-ubuntu.sh

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

يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم للإعدادات (`./data`) وضبط نمط شبكة المضيف لاكتشاف الكاميرات، وتشغيل حاوية Scrypted الرسمية على منفذ HTTPS 10443.

sudo bash scrypted-ubuntu.sh

4 إنشاء حساب المشرف وإضافة الكاميرات

افتح متصفحك وانتقل إلى الرابط https://ip-سيرفرك:10443. أنشئ حساب المشرف الأول، وثبت إضافات ONVIF/RTSP وHomeKit، وأضف كاميراتك واربطها بتطبيق Apple Home.

https://<your-server-ip>:10443

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

المنفذالغرض
10443Web UI over HTTPS (host network) — self-signed cert
host networkRequired for camera discovery and HomeKit/mDNS pairing
adminNo default login — create the admin on first visit

نظرة عامة

تعد Scrypted منصة متطورة فائقة السرعة لربط وإدارة كاميرات المراقبة الذكية. تعمل المنصة عبر منفذ HTTPS 10443 (باستخدام شبكة المضيف Host Network لاكتشاف الكاميرات عبر بروتوكولات mDNS)، وتقوم بتحويل كاميرات المراقبة العادية (RTSP وONVIF) إلى كاميرات ذكية تتكامل بسلاسة مع Apple HomeKit وGoogle Home وAmazon Alexa وHome Assistant. وتتميز بزمن استجابة شبه معدوم (Sub-second Latency)، مع دعم التسجيل المشفر على iCloud (HomeKit Secure Video HKSV)، والمحادثة الصوتية ثنائية الاتجاه، وتسريع تحويل الفيديو عبر كروت الشاشة (Intel QuickSync وNVIDIA)، وخوارزميات الذكاء الاصطناعي لاكتشاف الأشخاص والوجوه والسيارات والطرود محلياً.

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

لا تدعم كاميرات المراقبة الاحترافية (مثل Reolink أو Dahua أو Hikvision) منظومة Apple HomeKit رسمياً، وتتسبب الجسور التقليدية (مثل Homebridge) في بطء شديد يستغرق من 5 إلى 10 ثوانٍ لفتح البث مع استهلاك هائل للمعالج. تعيد Scrypted بناء مسار تدفق الفيديو بالكامل باستخدام تقنيات WebRTC وتسريع العتاد، لتقدم بثاً حياً فورياً في أقل من ثانية واحدة على ساعات Apple Watch وشاشات Apple TV وهواتف iPhone مع ميزة تسجيل iCloud المشفر مجاناً.

متى تحتاجه

  • تريد ربط كاميرات المراقبة IP (عبر RTSP/ONVIF) بمنظومة Apple HomeKit مع تفعيل تسجيل HomeKit Secure Video (HKSV)
  • تريد بث فيديو حياً وفورياً بزمن استجابة أقل من ثانية على أجهزة iPhone وApple TV ولوحات التحكم الذكية
  • تريد التعرف الذكي محلياً على الأشخاص والوجوه والحيوانات والطرود دون الحاجة لاشتراكات سحابية مدفوعة
  • تحتاج إلى التحدث الصوتي ثنائي الاتجاه عبر أجراس الأبواب الذكية وتطبيق Apple Home
  • تريد تسريع إعادة ترميز الفيديو بالعتاد عبر كروت شاشة Intel QuickSync أو NVIDIA لتقليل استهلاك المعالج

من يحتاجه

  • عشاق المنازل الذكية لربط كاميرات المراقبة المستقلة بمنظومات Apple HomeKit وHome Assistant
  • المستخدمون الراغبون في ميزة Apple HKSV دون شراء كاميرات تجارية باهظة الثمن تشترط اشتراكات سحابية
  • أصحاب السيرفرات المنزلية لبناء منظومة مراقبة متكاملة وسريعة محلياً على سيرفرات Ubuntu
  • مديرو العقارات والمنازل لمراقبة البوابات والمداخل واستقبال تنبيهات فورية على الهواتف
  • فنيو ومهندسو الشبكات لتثبيت جسور كاميرات ذكية فائقة الاعتمادية للعملاء

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

  • ربط 6 كاميرات Reolink بدقة 4K بـ Apple HomeKit مع عرض البث فورياً على شاشة Apple TV عند اكتشاف حركة
  • تفعيل ميزة التعرف على وجوه العائلة والطرود في جرس الباب الذكي وتسجيلها على iCloud HKSV
  • تحويل بث كاميرات H.265 بدقة 4K إلى صيغة H.264 WebRTC لحظياً باستخدام كرت الشاشة Intel QuickSync
  • تضمين بث الكاميرات المباشر وفائق السرعة داخل لوحات تحكم Home Assistant عبر بطاقة Lovelace
  • التحدث المباشر مع الزائرين عند الباب عبر مكبر الصوت والمايكروفون المدمج في الكاميرا من الآيفون

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

  • بث مباشر شبه معدوم التأخير: خط معالجة WebRTC وHLS متطور يقدم الفيديو في أجزاء من الثانية
  • دعم Apple HomeKit Secure Video (HKSV): تسجيل سحابي مشفر لـ 10 أيام، والتعرف على الوجوه، وتنبيهات الطرود
  • تسريع الترميز بالعتاد: دعم كروت شاشة Intel QuickSync (VAAPI) وNVIDIA NVENC وأجهزة Apple Silicon
  • منظومة إضافات غنية: تثبيت إضافات ONVIF وRTSP وHomeKit وGoogle Home وAlexa وRing وUnifi وReolink
  • اكتشاف الأجسام والوجوه بالذكاء الاصطناعي: تشغيل نماذج OpenCV وTensorFlow ومسرعات Coral TPU محلياً
  • دعم أجراس الأبواب والصوت ثنائي الاتجاه: توافق تام مع الميكروفونات ومكبرات الصوت للمحادثة الحية
  • مسجل Scrypted NVR (اختياري): إمكانية التسجيل المستمر 24/7 لعدة كاميرات مع استعراض الخط الزمني
  • نشر بنمط شبكة المضيف (Host Network) لضمان اكتشاف الكاميرات وتوافق بروتوكولات mDNS وBonjour

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

  • افتح المتصفح وانتقل إلى الرابط https://ip-سيرفرك:10443 (تجاوز تحذير شهادة SSL الذاتية)
  • أنشئ اسم المستخدم وكلمة المرور لحساب المشرف في شاشة الترحيب الأولى
  • انتقل إلى Plugins ← Install Plugin وثبت إضافات 'ONVIF' (أو 'RTSP') وإضافة 'HomeKit'
  • من تبويب ONVIF Devices اضغط 'Add Device' واكتب عنوان IP الكاميرا وبيانات الدخول
  • فعل خيار ملحق 'HomeKit' على الكاميرا داخل إعدادات Scrypted
  • افتح تطبيق Apple Home على هاتفك واضغط '+' ← 'Add Accessory' وامسح رمز الاستجابة السريعة (QR)
  • تأكد من فتح البث الحي الفوري واضبط إعدادات التسجيل السحابي لـ HomeKit Secure Video

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

  • تنبيه أمني حاسم: استخدم بروتوكول HTTPS دائماً عند فتح لوحة تحكم Scrypted على المنفذ 10443 (حيث يفرض Scrypted تشفير TLS)
  • عيّن اسم مستخدم وكلمة مرور معقدة لحساب المشرف أثناء معالج الإعداد الأولي
  • اعزل كاميرات المراقبة في شبكة محلية مستقلة (IoT VLAN) لمنع وصولها للإنترنت الخارجي
  • استخدم كلمات مرور قوية لتدفقات RTSP في الكاميرات وقم بتغييرها دورياً
  • احمِ مجلد البيانات `./data` الذي يحتوي على مفاتيح اقتران HomeKit بصلاحيات نظام مناسبة بالسيرفر
  • حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وتطويرات الإضافات

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

يعمل Scrypted في Docker بنمط شبكة المضيف (`network_mode: host`) لتسهيل اكتشاف أجهزة mDNS وBonjour، ويقدم لوحة الإدارة عبر منفذ TCP 10443 (المشفر بـ HTTPS). يجب فتح المنفذ 10443 في جدار الحماية للشبكة المحلية (`ufw allow 10443/tcp`). وتجنب كشف المنفذ 10443 للإنترنت العام مباشرة.

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

  • انسخ مجلد `./data` احتياطياً، والذي يحتوي على كافة الإضافات المثبتة، وإعدادات الكاميرات، ومفاتيح اقتران HomeKit
  • احتفظ بنسخة من ملف `docker-compose.yml` الذي يحتوي على مسارات التخزين وتمرير كروت الشاشة
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية للتأكد من استرجاع قنوات البث واقتران HomeKit بنجاح

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

  • تشغيل الحاوية بنمط الجسر العادي بدلاً من `network_mode: host` (مما يعطل اكتشاف الكاميرات واقتران HomeKit)
  • عدم تمرير كرت الشاشة المدمج (`/dev/dri`)، مما يرفع استهلاك المعالج بشدة أثناء تحويل الفيديو
  • كتابة HTTP بدلاً من HTTPS في المتصفح (حيث يعمل Scrypted حصرياً عبر اتصال HTTPS المشفر)
  • عدم ربط مجلد التخزين الدائم `./data`، مما يسبب فقدان الكاميرات واقتران Apple Home عند تحديث الحاوية
  • وضع الكاميرات في شبكة فرعية معزولة دون تفعيل خاصية توجيه الـ mDNS في الراوتر

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

  • المتصفح يظهر 'Connection Refused' — تأكد من كتابة `https://` (وليس `http://`) مع المنفذ 10443
  • تطبيق Apple Home يظهر 'No Response' — تأكد من تفعيل نمط شبكة المضيف Host Network ومراجعة إعدادات mDNS بالراوتر
  • تقطيع في بث الفيديو — تأكد من تفعيل التسريع العتادي للكرت (GPU Transcoding) من إعدادات الكاميرا
  • فشل اكتشاف الكاميرا — تأكد من إمكانية اتصال السيرفر بـ IP الكاميرا واختبر رابط الـ RTSP بأمر `ffprobe`
  • انهيار الحاوية عند التشغيل — افحص سجلات الحاوية بالأمر: `docker logs scrypted -f`

البدائل

منصة Homebridge (إضافة Camera.UI) لربط الأجهزة الذكية. منصة Frigate لتسجيل كاميرات المراقبة بالذكاء الاصطناعي. منصة go2rtc لإعادة بث الفيديو بسرعة. منصة ZoneMinder الكلاسيكية للمراقبة. منصة Shinobi مفتوحة المصدر.

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

تجنب استخدام Scrypted إذا كنت لا تستخدم منظومة Apple HomeKit أو Google Home أو Alexa وتريد فقط برنامج تسجيل كاميرات مستقل يعمل 24/7 مع الذكاء الاصطناعي (حيث صُممت منصة Frigate خصيصاً كمسجل NVR مستقل). وإذا كنت تريد فقط أداة بسيطة لإعادة بث الـ RTSP بدون أي مميزات ذكية، فإن go2rtc أخف وزناً.

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

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

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

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

لماذا يتطلب Scrypted العمل بنمط شبكة المضيف (Host Network)؟

يتيح نمط شبكة المضيف لـ Scrypted استخدام بروتوكولات mDNS وBonjour عبر الشبكة المحلية مباشرة، وهو أمر إلزامي لاكتشاف الكاميرات، واقتران منظومة Apple HomeKit، وتدفق بث WebRTC فائق السرعة.

هل يدعم Scrypted ميزة Apple HomeKit Secure Video (HKSV)؟

نعم! عند ربطه بحساب Apple iCloud+ نشط ووجود جهاز Apple Home Hub (مثل Apple TV أو HomePod)، يتيح Scrypted التسجيل السحابي المشفر لـ 10 أيام، والتعرف على الوجوه، وتنبيهات الطرود مجاناً.

هل يمكن لـ Scrypted ربط الكاميرات بـ Google Home وAmazon Alexa؟

نعم! بالإضافة إلى HomeKit، يحتوي Scrypted على إضافات رسمية لـ Google Home وAmazon Alexa لعرض بث الكاميرات على شاشات Nest Hub وEcho Show الذكية.

هل يشترط توفر كرت شاشة (GPU) لتشغيل Scrypted؟

يمكن لـ Scrypted العمل على المعالج فقط، ولكن تفعيل كرت الشاشة (عبر Intel QuickSync `/dev/dri` أو NVIDIA) يقلل استهلاك المعالج بشكل هائل عند تحويل بث كاميرات 4K H.265 إلى H.264 للهواتف.

كم يستهلك Scrypted من الذاكرة العشوائية (RAM)؟

يستهلك Scrypted عادة ما بين 200 إلى 500 ميجابايت فقط من الذاكرة العشوائية داخل Docker، وتتغير النسبة قليلاً حسب عدد الكاميرات النشطة في نفس اللحظة.