التوثيق

SIVO توثيق

من التثبيت بأمر واحد حتى مشاهدة المشتركين في تطبيقاتهم.

تثبيت سريع

لوحة تحكم في دقائق، بأمر واحد.

شغّله بصلاحيات root على خادم Ubuntu 24.04 أو 26.04 جديد (x86_64) داخل شبكتك.

اقرأ دليل التثبيت الكامل
Ubuntu — bash
curl -fsSL https://sivo.securytik.com/install.sh | sudo bash

دليل البدء

نظرة عامة

SIVO منصة IPTV تشغّلها على خادمك الخاص داخل شبكتك. تسحب كل قناة مباشرة من الإنترنت مرة واحدة وتقدّمها لكل مشترك يشاهدها، فلا تزداد تكلفة رفع القناة مع ازدياد عدد مشاهديها. تُحفظ الأفلام والمسلسلات وتسجيلات الإعادة على الخادم نفسه.

يشاهد المشتركون في التطبيقات التي يستخدمونها أصلًا: IPTV Smarters وTiviMate وVLC وتطبيقات التلفاز الذكي. يتحدث SIVO بلغة Xtream Codes API وM3U، لذا تُرسل إليهم فقط عنوان الخادم واسم المستخدم وكلمة المرور، أو رابط M3U واحدًا.

  • اللوحة (المنفذ 80) هي المكان الذي تدير فيه القنوات والمحتوى والمشتركين.
  • منفذ البث (المنفذ 8080 افتراضيًا) هو ما تتصل به التطبيقات؛ يُفحص كل طلب عليه: الحساب مفعّل، غير منتهٍ، الباقة تسمح بالقناة، والأجهزة في الوقت نفسه.

دليل البدء

المتطلبات

  • Ubuntu 24.04 أو 26.04، x86_64 (amd64). ARM وDocker غير مدعومين.
  • 4 أنوية CPU وذاكرة RAM بسعة 8 GB لبضع مئات من المشاهدين؛ يحتاج المزيد من المشاهدين شبكةً أكبر مما يحتاجون معالجًا أقوى، لأن القنوات تُنسخ ولا تُعاد ترميزها.
  • مساحة التخزين للمكتبة والإعادة: الفيلم الواحد من 1 إلى 20 GB، ويوم إعادة لقناة HD واحدة نحو 30 إلى 40 GB.
  • مسار شبكي من الإنترنت لسحب القنوات، ومن مشتركيك إلى الخادم.

دليل البدء

التثبيت

شغّله بصلاحيات root على خادم جديد:

curl -fsSL https://sivo.securytik.com/install.sh | sudo bash

يُنزِّل المثبِّت أحدث إصدار موقَّع (من GitHub، أو من المرآة dl.securytik.com عند حجب GitHub)، ويثبّت PostgreSQL ومحرك البث وnginx واللوحة، ويعرض كلمة مرور المدير في النهاية. إعادة تشغيله آمنة: يحتفظ ببياناتك وإعداداتك.

دليل البدء

تسجيل الدخول لأول مرة

افتح http://SERVER-IP/admin/ وسجّل الدخول باسم admin وبكلمة المرور التي عرضها المثبِّت. غيّرها من ملفك الشخصي.

  • الإعدادات → البث: حدِّد العنوان العام الذي يستخدمه المشتركون (مثلًا http://tv.example.net:8080). يُدرج في كل تسجيل دخول ورابط M3U.
  • القنوات المباشرة → قنوات البداية: يضيف القنوات المجانية التي تبثّها الجهات الإذاعية بنفسها.
  • النظام → الترخيص: سجّل التثبيت بحسابك في SecuryTik (الخطة المجانية تشمل 100 مستخدم).

دليل البدء

إعدادات البث

  • العنوان العام والمنفذ: ما تتصل به التطبيقات.
  • الجودة المسحوبة من المصادر: الأفضل المتاح، أو سقف (1080p أو 720p أو 576p أو 480p) عندما يكون خط الإنترنت لديك صغيرًا.
  • تنتهي الاتصالات الخاملة تلقائيًا بعد المهلة التي تحدّدها.
  • مجلد الوسائط: حيث تُخزَّن الأفلام والمسلسلات والإعادة.

المحتوى

القنوات المباشرة

أضف قناة مع عنوان مصدرها (HLS وRTMP وRTSP وSRT وUDP) ومصدر احتياطي اختياري. تبدأ القناة عند الطلب حين يفتحها أول مشاهد، وتتوقف بعد دقيقة من مغادرة آخر مشاهد؛ أوقف خاصية الطلب للقنوات التي يجب أن تعمل دائمًا.

  • الحالة: بث، أو خامل، أو شاشة انقطاع الإشارة (المصدر لا يستجيب؛ يرى المشاهدون شاشتك).
  • الرقم والفئة والشعار وID الدليل هي ما تعرضه التطبيقات.
  • استيراد M3U يضيف قنوات كثيرة دفعةً واحدة من ملف أو عنوان.

المحتوى

شاشة انقطاع الإشارة

عندما لا يستجيب مصدر ما، يرى المشاهدون شاشة SIVO بدلًا من خطأ في التطبيق، وتحلّ الصورة محلّها تلقائيًا عند عودة المصدر. غيّر سطريها النصيّين، أو ارفع صورتك الخاصة، من الإعدادات → شاشة انقطاع الإشارة.

المحتوى

المصادر والاستيراد

تحتفظ المصادر بحسابات المزوّد (Xtream Codes) التي تملك حقوقها. أضف الخادم واسم المستخدم وكلمة المرور؛ يتحقق SIVO من تسجيل الدخول ويقرأ القنوات المباشرة والأفلام والمسلسلات الخاصة بالحساب. ما تضيفه يقع تحت مسؤوليتك: راجع الشروط والسياسة.

  • افتح حسابًا، وصفِّ حسب النوع أو الفئة، وابحث، وحدِّد العناوين التي تريدها ثم اختر استيراد المحدَّد.
  • تُنزَّل الأفلام والحلقات إلى خادمك عبر طابور واحد، ملف واحد في كل مرة، فلا يُستخدم حساب يسمح باتصال واحد مرتين أبدًا. تظهر في التطبيقات بعد اكتمال تنزيلها.
  • يُستورد المسلسل مع كل المواسم والحلقات التي يملكها المزوّد، مع الملصقات والقصة.
  • تُسحب القنوات المباشرة المستوردة من حساب ما أثناء مشاهدة أحدهم لها؛ وكل قناة تُشاهَد في اللحظة نفسها تستهلك اتصالًا من اتصالات الحساب.

لا تستورد إلا المحتوى الذي تملك حق توزيعه.

المحتوى

الأفلام

  • ارفع ملفًا، أو أدخل عنوانه واختر «تخزين على هذا الخادم» لتنزيله.
  • تُظهر الحالة: في الانتظار، أو قيد التنزيل مع النسبة المئوية، أو جاهز، أو خطأ.
  • القصة والممثلون والمخرج والملصق وصورة الخلفية، يدويًا أو من TMDB (أضف مفتاح TMDB في الإعدادات).
  • أضف لغات الصوت وملفات الترجمة؛ يدمجها SIVO في ملف واحد فتعرضها التطبيقات في قوائمها.

المحتوى

المسلسلات

  • المسلسلات → مسلسل → مواسمه → حلقات الموسم؛ كل مستوى قائمة يمكنك البحث فيها وترتيبها وتنفيذ إجراءات جماعية عليها.
  • الملفات المسماة S01E01 وS01E02… تحصل على أرقام موسمها وحلقتها تلقائيًا.
  • تُعرض أسماء المواسم وقصصها وملصقاتها في التطبيقات.

المحتوى

الإعادة

حدِّد أيام الإعادة (من 1 إلى 30) لقناة. يسجّلها SIVO في مقاطع من 10 ثوانٍ، وتعرض التطبيقات البرامج السابقة من الدليل، وتُحذف التسجيلات الأقدم من الإعداد. يعرض قسم التسجيلات استهلاك القرص لكل قناة.

المحتوى

دليل البرامج

أضف عناوين دليل XMLTV في دليل البرامج. تُجلب كل 6 ساعات وتُطابَق مع القنوات بواسطة ID الدليل. تحصل تطبيقات المشتركين على الدليل برابطهم الخاص.

المشتركون

الباقات

تفتح الباقة فئات مختارة من القنوات والأفلام والمسلسلات. يرى المشترك الذي لا باقة له كل شيء.

المشتركون

المشتركون

  • اسم المستخدم وكلمة المرور (تُستخدم في التطبيق)، الاسم الكامل، الهاتف، الباقة، تاريخ الانتهاء، والأجهزة المتزامنة.
  • يعرض «الوصول» الخادم وتسجيل الدخول وروابط M3U والدليل للإرسال.
  • تمديد يضيف أيامًا من اليوم أو من تاريخ الانتهاء الحالي، أيهما أحدث؛ وتعطيل ينهي ما يشاهده المشترك.
  • يُحتسب كل مشترك جديد ضمن الحد الأقصى للمستخدمين في الترخيص.

المشتركون

التطبيقات والروابط

في IPTV Smarters وTiviMate ومعظم التطبيقات، اختر Xtream Codes وأدخل عنوان الخادم واسم المستخدم وكلمة المرور. التطبيقات التي تقبل قائمة تشغيل فقط تستخدم رابط M3U من صفحة الوصول.

http://tv.example.net:8080/get.php?username=USER&password=PASS&type=m3u_plus&output=ts

المشتركون

المشاهدة الآن

تعرض «المشاهدة الآن» كل اتصال مفتوح: المشترك، والقناة أو العنوان، والجهاز، والعنوان الشبكي. أنهِ اتصالًا من قائمته؛ والمشترك الذي تجاوز أجهزته المتزامنة يُرفض بثّه التالي.

التشغيل

البحث والفلاتر والتصدير

  • اكتب في مربع البحث لتصفية الصفوف؛ واضغط Enter لتحتفظ به كرمز.
  • تحتوي القائمة المجاورة للمربع على الفلاتر والتجميع حسب والبحث المحفوظ والفلاتر المخصّصة.
  • حدِّد الصفوف للإجراءات الجماعية؛ و«تصدير» ينزّل ملف CSV.

التشغيل

المسؤولون والأدوار

أضف مسؤولين بأدوار تحدّد ما يمكنهم رؤيته وتغييره. تسجيل الدخول بعاملين متاح لكل مسؤول، وكل تغيير مسجَّل في سجل التدقيق.

التشغيل

النسخ الاحتياطي والاستعادة

الأدوات → النسخ الاحتياطي تأخذ نسخة احتياطية من قاعدة البيانات والإعدادات (مكتبة الوسائط ليست ضمنها؛ انسخ مجلد الوسائط بشكل منفصل). الاستعادة من الصفحة نفسها.

التشغيل

تحديثات

التحديثات موقَّعة من SecuryTik وتُفحص قبل تطبيقها. النظام → التحديثات يعرض الإصدار الحالي والأحدث؛ ويمكن تطبيق التحديثات يدويًا أو تلقائيًا.

التشغيل

الترخيص والخطط

يُرخَّص كل تثبيت بشكل مستقل حسب عدد المستخدمين (المشتركين). التثبيت غير المسجَّل يخدم حتى 25 مستخدمًا؛ وعند التسجيل على خطة Free: 100. الخطط المدفوعة: Lite 500، وPlus 1,000، وPro 2,000، وMega 5,000، وMax 10,000، وUnlimited. راجع الأسعار.

اطلب خطة من النظام → الترخيص أو من لوحة التحكم؛ أول طلب على الحساب هو شهر مجاني. إذا انتهى ترخيص مدفوع يظهر تحذير، ثم فترة سماح؛ ولا تُحذف أي بيانات أبدًا.

التشغيل

نفق Cloudflare

النظام → Cloudflare Tunnel يضع اللوحة (وبوابة البث، إن اخترت ذلك) على نطاقك الخاص عبر HTTPS دون فتح أي منافذ.

المراجع

واجهة برمجة تطبيقات REST

النظام → API ينشئ رموزًا بنطاقات محددة. تدير الواجهة المشتركين (إنشاء، وتغيير، وتمديد، وتفعيل، وتعطيل، وحذف، وروابط الوصول)، والباقات، والقنوات، والأفلام، والمسلسلات، ومن يشاهد الآن، والإجماليات. المرجع الكامل مع زر «جرّبه» موجود على تثبيتك في /api/v1/docs.

curl -H "Authorization: Bearer sivo_YOUR_TOKEN" http://SERVER/api/v1/subscribers

المراجع

Webhooks

النظام → API → Webhooks يرسل subscriber.created وsubscriber.updated وsubscriber.deleted إلى عنوانك بصيغة JSON، موقَّعةً بـ X-Sivo-Signature: sha256=HMAC لمحتوى الطلب. تُعاد محاولة الإرسال الفاشل.

المراجع

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

  • تعرض القناة شاشة انقطاع الإشارة: مصدرها لا يستجيب من خادمك؛ افتح قائمة القناة واختر اختبارها.
  • تُفتح القناة ببطء أو تتقطع: جودة المصدر أعلى مما يسمح به خط الإنترنت لديك؛ اضبط سقف الجودة في الإعدادات → البث.
  • يقول أحد التطبيقات إن تسجيل الدخول خاطئ: تحقّق من العنوان العام في الإعدادات، ومن أن المشترك مفعّل وغير منتهٍ.
  • عدد أجهزة كبير جدًا: بلغ المشترك حدّ أجهزته المتزامنة؛ أنهِ اتصالًا قديمًا من «المشاهدة الآن».