أسئلة وأجوبة

نظام OTT / IPTV كامل: لوحة الإدارة (dashboard)، وسيرفر API لتطبيقات المشاهدين، وبث القنوات المباشرة والأفلام والمسلسلات والراديو، ومشغّل ويب. إحنا بنوفّر النظام ونصونه، والموزّعون بيستخدموه لمنح عملائهم حق المشاهدة (الخطوط).

• لا تحصّل الفلوس نيابة عنك وليس فيها بوابة دفع. سعر عملائك وطريقة استلام الفلوس والفواتير شغل الموزّع (راجع CON-01).
• لا تتواصل مع مشاهدي الموزّع. اللوحة بتبعت إيميل لحسابات اللوحة فقط، ولا تبعت لأي خط.
• لا تحتفظ ببيانات شخصية لعميل محذوف وليس فيها وظيفة استرجاع (راجع DATA-01).

1. المسؤول بيبني الكتالوج (قنوات، أفلام، مسلسلات، راديو) ويجمّعه في bouquets.
2. المسؤول بينشئ package: bouquets + المدة + عدد الاتصالات + السعر بالكريديت.
3. الموزّع بيصرف كريديت لبيع الحزمة ← النظام بينشئ line.
4. العميل بيدخل بيانات الخط في تطبيق؛ النظام بيفحص الخط (غير منتهي، مفعّل، ضمن حدوده) ويشغّل من سيرفر مناسب.

يقدر الموزّع يشوف قوائم القنوات والأفلام والمسلسلات والراديو وbouquets والحزم (لو مجموعته عندها الصلاحية)، لكن لا يقدر يضيف أو يعدّل أو يحذف محتوى. المحتوى والحزم بيديرها المسؤول. الموزّع بيحدد اللي كل عميل يشاهده باختيار الحزمة (وbouquets لو المجموعة سمحت — PKG-05).

بند Support في الشريط الجانبي بيفتح موقع الدعم المنفصل. اللوحة ليس فيها نظام تذاكر خاص بها. لما تبعت طلب، اذكر: اسم مستخدم الخط (وليس كلمة السر)، ووقت حدوث المشكلة، والتطبيق / الجهاز، وكود السؤال من هذه الصفحة لو جرّبته.

اللوحة ومشغّل الويب وصفحة المساعدة هذه فيها مبدّل لغة بـ 27 لغة. الإنجليزية والفيتنامية هما الترجمتان المرجعيتان؛ وفي باقي اللغات ممكن شاشة مضافة حديثًا تفضل بالإنجليزية فترة. الإيميلات اللي بتبعتها اللوحة حاليًا بالإنجليزية فقط.

حزم التثبيت والـ checksums بتاعتها SHA-256 ودليل التثبيت الكامل (بالإنجليزي) على https://download.xtream-ui.pro.

• اللي محتاجه: Ubuntu 22.04 أو 24.04 (جهاز افتراضي أو سيرفر فعلي)، وصلاحية root أو sudo، والأفضل سيرفر جديد.
• التثبيت: نزّل الحزمة المناسبة للمعالج بتاعك مباشرة على السيرفر، وتحقق منها بالأمر sha256sum، وفك ضغطها وشغّل sudo ./install.sh.
• ترقية سيرفر شغال: sudo ./upgrade.sh --tag <version>.

الدومينات مع TLS والـ edge nodes وكل الخيارات متشرحة في الدليل.

ده بالتصميم: الخط مش حساب لوحة. العميل بيستخدم بيانات الخط فقط في تطبيق IPTV أو جهاز استقبال أو مشغّل الويب. وبالعكس، حساب الموزّع لا يصلح لمشاهدة القنوات.

القوائم والإجراءات بتعتمد على المجموعة اللي حطّها المسؤول لحسابك. الصفحة اللي مجموعتك ملهاش صلاحية عليها لا تظهر في الشريط الجانبي ولا يمكن فتحها. اطلب من المسؤول صلاحيات أكتر.

في منطقة الحساب (الملف الشخصي ← تغيير كلمة السر). كلمات سر اللوحة بتتخزّن مشفّرة (hash)؛ ولا أحد يقدر يقرأها تاني — ولا حتى المسؤول. لو نسيتها، اطلب من الحساب اللي فوقك (الموزّع الأب أو المسؤول) يعيّن لك واحدة جديدة.

ممكن تتضبط اللوحة على إنهاء الجلسة لما يتغير عنوان IP، عشان جلسة مسروقة متتعاد استخدامها. سجّل الدخول من جديد. ده إعداد من المسؤول.

اللوحة بتحدّ من محاولات الدخول الفاشلة (بضبط المسؤول). بعد تجاوز الحد لازم تستنى قبل ما تحاول تاني.

حساب demo بيعرض الواجهة فقط: لا يقدر يغيّر كلمة سره ولا يعدّل ملفه الشخصي ولا ينشئ أكواد تفعيل ولا يعمل أي حاجة لا يمكن التراجع عنها.

الحساب اللي فوقك أوقفه: لا تقدر تسجّل الدخول للوحة ومفاتيح API الخاصة بك بتترفض. الخطوط اللي اتباعت قبل كده لا تُحذف. تواصل مع الحساب اللي فوقك.

Logs → Reseller Logs (لو المجموعة مسموح لها بعرض السجلات): كل خط أو جهاز اتنشأ أو اتعدّل أو اتجدّد أو اتفعّل / اتعطّل أو اتحذف، وكل موزّع فرعي اتنشأ وكل تحويل كريديت — مع الكريديت اللي اتخصم. بتشوف فقط سجلاتك وسجلات الحسابات تحتك؛ والسجل لا يمكن حذفه (للمسؤول فقط). دفتر الكريديت (CRD) يفضل المكان اللي تطابق فيه رصيدك.

الوحدة المدفوعة مسبقًا في اللوحة. كل عملية بيع (إنشاء خط، تجديد، إنشاء أكواد تفعيل، إنشاء موزّع فرعي) بتخصم كريديت حسب سعر الحزمة أو رسم المجموعة. الكريديت مش فلوس واللوحة لا تحوّله: قيمة الكريديت الواحد بتتفق عليها أنت والحساب اللي فوقك.

الكريديت بينزل من فوق لتحت: المسؤول بيدّي كريديت للموزّع، والموزّع بيحوّله لموزّع فرعي. الدفع للحساب اللي فوقك بيتم خارج اللوحة.

دايمًا كريديت الحساب اللي بينفّذ العملية، حتى لو الخط معيّن لموزّع فرعي تحته.

صفحة Credits: صف لكل حركة، مع التاريخ والمبلغ والرصيد بعدها والسبب ومين عملها. ده هو الدفتر — المصدر المعتمد لرصيدك.

العملية كلها بتترفض: لا يتنشأ خط ولا يتخصم أي شيء. الرصيد عمره ما بينزل تحت الصفر.

لا. كل طلب بيع بيحمل معرّف طلب (request_id)؛ إرسال نفس المعرّف تاني بيرجّع النتيجة السابقة. إنشاء الخط وخصم الكريديت دايمًا بينجحوا مع بعض أو بيتلغوا مع بعض.

لا. حذف الخط لا يرجّع أي شيء، حتى لو فيه وقت متبقي. الاستثناء الوحيد: حذف كود تفعيل غير مستخدم أنشأه الموزّع بيتم استرداده (CODE-08).

أيوه: في نموذج تعديل الموزّع الفرعي، اكتب رقم سالب في حقل تحويل الكريديت. لا يمكن لأي رصيد أن ينزل تحت 0.

قائمة اختيار الحزمة في نموذج الخط بتعرض سعرك أنت. من خلال الـ API، إجراء pricing بيرجّع رصيدك وسعر كل حزمة وكام واحدة تقدر تشتريها.

الـ bouquet هو قائمة محتوى (قنوات، أفلام، مسلسلات). الـ package هو المنتج اللي بتبيعه: bouquet واحد أو أكتر، ومدة، وعدد اتصالات، وصيغ إخراج، وأقفال، وسعر بالكريديت (السعر الرسمي وسعر التجربة).

الحزمة يقدر يبيعها فقط المجموعات اللي اختارها المسؤول لها. الحزمة اللي مش مخصصة لمجموعتك لا تظهر في القائمة وبتترفض لو اتبعتت عبر الـ API.

يقدر المسؤول يحدد سعرًا خاصًا لكل موزّع على كل حزمة (0 = مجانًا). السعر الخاص بيسري على إنشاء خط رسمي والتجديد وأكواد التفعيل الرسمية؛ ولا يسري على التجارب.

لا. الـ bouquets بتتنسخ داخل الخط وقت البيع؛ تعديل الحزمة بعد كده لا يؤثر على الخطوط اللي اتباعت. الخط بياخد bouquets الحزمة الجديدة عند تجديده / تغيير حزمته التالي. (لما يتغير المحتوى داخل bouquet، كل خط عنده هذا الـ bouquet بيشوفه فورًا. حذف bouquet بيشيل معرّفه من كل خط وحزمة. تغيير ترتيب bouquets العام لا يغيّر الترتيب المخزّن على الخطوط المباعة إلا لو علّمت خانة "apply to sold lines and packages"؛ ومجموعة bouquets الخاصة بالخط لا تتغير.)

فقط لو مجموعتك فعّلت Allow Bouquet Selection: بتعلّم جزء من bouquets الحزمة؛ لو مفيش حاجة معلّمة = الحزمة كلها؛ وbouquets خارج الحزمة بتتسقط. السعر لا يتغير.

تاريخ الانتهاء (النهاردة + مدة الحزمة)، وعدد الاتصالات، وصيغ الإخراج، وrestreamer، وقفل الجهاز، والدولة المفروضة، والسيرفر المفروض، وقفل ISP، وbouquets. القيم اللي يدخلها الموزّع لهذه الحقول بتتجاهل، ما عدا bouquets (PKG-05) وقفل ISP لو المجموعة فعّلت Allow Line Restrictions.

حزمة لا تُباع إلا لهذا النوع من أجهزة الاستقبال؛ لا يمكن بيعها لخط عادي ولا لنوع الجهاز الآخر. وبالعكس، لازم الحزمة تسمح بنوع الجهاز قبل ما تُستخدم في نموذج Add MAG / Add Enigma.

لازم تختار حزمة مجموعتك تقدر تبيعها وعندك كريديت كفاية. اسم المستخدم / كلمة السر: اكتب بنفسك (لو المجموعة سمحت) أو سيبهم فاضيين ليتولّدوا تلقائيًا. المسؤول ممكن كمان يسيب واحد منهم (أو الاتنين) فاضي عند إنشاء خط: النظام بيولّد 10 حروف ويعرضها بعد الحفظ مباشرة؛ نموذج التعديل لسه محتاج اسم مستخدم.

مجموعتك مطفّية Allow Username Change / Allow Password Change: الخط الجديد بياخد قيم مولّدة. لما تقدر تكتب بنفسك، الحد الأدنى للطول بتحدده المجموعة (8 حروف افتراضيًا).

في نموذج تعديل الخط وفي نافذة Generate play link في قائمة Lines. كلمات سر الخطوط بتتحفظ مقروءة لأن تطبيقات IPTV وروابط القوائم محتاجاها. كلمة السر المولّدة بتظهر بعد الحفظ مباشرة.

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

التفعيل / التعطيل، وملاحظات الموزّع، وجهة الاتصال، وقالب الفئة، والمالك (داخل شجرتك أنت)؛ اسم المستخدم وكلمة السر لو المجموعة سمحت؛ القيود (IPs، user agents، قفل ISP) لو المجموعة فعّلت Allow Line Restrictions؛ واختيار bouquets جديد داخل الحزمة لو المجموعة سمحت. الحزمة وتاريخ الانتهاء وعدد الاتصالات وعلامة التجربة وصيغ الإخراج وقفل الجهاز والدولة لا يمكن تعديلها مباشرة — بتتغير فقط من خلال تجديد / تغيير حزمة.

طريقتان، قاعدة واحدة:

• زر Renew (charged) في القائمة: بيستخدم حزمة الخط الحالية؛
• حقل Extend with package في نموذج التعديل: اختار أي حزمة تقدر تبيعها (وده كمان طريقة تغيير الحزمة).

لما تعدّل خط وتختار تجديد في نفس الحفظ، الاتنين عملية واحدة: لو التجديد اترفض (كريديت مش كفاية، الحزمة غير قابلة للبيع)، التعديل لا يتحفظ كمان ولا يتخصم أي كريديت. صحّح واحفظ تاني.

• الخط لم ينتهِ والحزمة الجديدة متوافقة مع القديمة ← الوقت بيتضاف لتاريخ الانتهاء الحالي.
• الخط انتهى، أو الحزمتان غير متوافقتين ← بيتحسب من النهاردة؛ وأي وقت متبقي لا يتحفظ.

"التوافق" بيتفحص فقط لو الحزمة الجديدة مفعّل فيها خيار فحص التوافق: لازم الحزمتان يكون عندهما نفس bouquets وصيغ الإخراج وعدد الاتصالات وعلامة restreamer وقفل الجهاز. ولو الخيار مقفول بيعتبروا دايمًا متوافقين. الحزم الجديدة الخيار فيها مفعّل افتراضيًا (المسؤول يقدر يقفله)؛ والحزم الموجودة بتحتفظ بإعدادها. خط MAG / Enigma لا يُجدَّد ولا يتغير إلا لحزمة تسمح بهذا النوع من الأجهزة.

تغيير الحزمة = شراء فترة رسمية واحدة من الحزمة الجديدة: بيتخصم السعر الكامل للحزمة الجديدة (سعرك الخاص لو عندك)، بدون تعويض عن الجزء غير المستخدم. الخط بياخد كل خصائص الحزمة الجديدة.

التعطيل: العميل لا يقدر يسجّل الدخول ولا يشاهد، والجلسات الجارية بتتقفل خلال حوالي دقيقة؛ فترة الاشتراك بتفضل شغالة؛ وتقدر تفعّله تاني في أي وقت. الحذف: نهائي، بدون استرجاع ولا استرداد (DATA-01). لعميل بيوقف مؤقتًا، عطّل — ولا تحذف.

العميل بيترفض لحد ما الخط يتجدد (الخط المنتهي والمحظور معًا بيشوف مقطع "منتهي"، لأن الانتهاء بيتفحص أولًا)؛ والجلسات الجارية بتتقفل خلال حوالي دقيقة. الخط لا يتحذف تلقائيًا: جدّده وهيشتغل تاني بنفس اسم المستخدم / كلمة السر.

أيوه: اختار حساب تحتك كمالك. المالك بيشوف الخط في قائمته. الكريديت بيتخصم دايمًا من اللي بيضغط حفظ.

خطوطك أنت وخطوط كل حساب تحتك. الخط خارج شجرتك مش موجود بالنسبة لك (الرد هيكون "not found").

عشان تفتكر العميل مين (إيميل، رقم تليفون، رقم طلب). المشترك عمره ما بيشوفهم. بيتمسحوا نهائيًا لما الخط يتحذف.

لو المجموعة عندها الصلاحية: Logs → Line Activity بيعرض سجل مشاهدة كل خط، وLogs → Live Connections بيعرض كل اتصال مفتوح لخطوط شجرتك (أي خط، أي قناة، من أي عنوان) مع زر لإغلاقه. Live Connections لا يفتح إلا لو المسؤول فعّل لمجموعتك خيار عرض سجل اتصالات العملاء (خانة client connection logs في نموذج المجموعة)؛ ولا تشوف أبدًا اتصالات خط خارج شجرتك.

الخط التابع لكود تفعيل بيكون مخفي من القائمة افتراضيًا لحد ما تفلتر عليه (CODE-02).

أيوه. حقل Expires on في نموذج الخط هو تاريخ ووقت بتوقيت اللوحة، فممكن الخط ينتهي في ساعة محددة. فتح النموذج والحفظ من غير لمس هذا الحقل بيحافظ على الانتهاء لحد الثانية — تعديل ملاحظة أو bouquets لا يدّي خط تجربة بالساعات وقتًا إضافيًا. القيمة اللي لا يمكن قراءتها بيتم الإبلاغ عنها في الحقل نفسه ولا تتحول أبدًا إلى "never expires". صفحة التعديل الجماعي لسه بتاخد تاريخًا، ويُقرأ كنهاية ذلك اليوم.

لما كل ده يتحقق: المسؤول لم يوقف التجارب للموزّعين؛ والحزمة لها فترة تجربة؛ ومجموعتك عندها Allowed Trials > 0؛ وكريديتك ≥ Minimum Trial Credits الخاص بالمجموعة؛ وعدد خطوط التجربة اللي أنشأتها خلال نافذة الحساب لم يصل للحصة.

زي ما هو مضبوط في المجموعة: day = آخر 24 ساعة، month = آخر 30 يوم. مثال، حصة 5 / يوم: 5 خطوط تجربة كحد أقصى في أي 24 ساعة. التجربة الأقدم بتحرّر مكانها لما تخرج من النافذة.

بالضبط سعر تجربة الحزمة (غالبًا 0). السعر الخاص بالموزّع لا يسري على التجارب.

شرط من شروط TRI-01 غير متحقق؛ النموذج بيذكر السبب جنب الخانة.

جدّد الخط بحزمة: الخط بياخد فترة رسمية ولا يعود تجربة. اسم المستخدم وكلمة السر بيفضلوا زي ما هم، والعميل مش محتاج يضبط أي حاجة تاني.

لا. التجربة بتتمنح مرة واحدة، عند إنشاء الخط؛ الخط الموجود يُجدَّد فقط بفترة رسمية (TRI-05). عشان تخلي العميل يجرّب تاني، أنشئ خط تجربة جديد (وبيتحسب ضمن حصة التجارب).

Lines → Generate play link: اختار الصيغة؛ الرابط بيتبني باسم مستخدم الخط وكلمة سره. من خلال الـ API، get_line بيرجّع الروابط جاهزة: m3u، m3u_hls، xmltv، player_api، web_player.

أي تطبيق بيدعم Xtream Codes API (IPTV Smarters، TiviMate، XCIPTV، GSE…): ادخل عنوان السيرفر + اسم المستخدم + كلمة السر. للتطبيق اللي بياخد قائمة تشغيل فقط، استخدم رابط M3U. أجهزة MAG بتستخدم البورتال، وأجهزة Enigma2 بتستخدم قائمة تشغيل / plugin. من غير أي جهاز، استخدم web player في المتصفح.

MPEG-TS: تبديل سريع بين القنوات، مناسب لتطبيقات IPTV وأجهزة الاستقبال. HLS: بيشتغل كويس في المتصفحات وأجهزة Apple والشبكات غير المستقرة. الخط يقدر يستخدم فقط الصيغ اللي حزمته بتسمح بها؛ والرابط بصيغة غير مسموحة بيترفض.

m3u_plus (بشعارات ومجموعات ومعرّفات EPG — الافتراضي الموصى به)، وm3u العادي، وأنواع Enigma2 / DreamBox / GigaBlue / Octagon / MediaStar / StarLive، وأنواع قوائم بسيطة. اختار واحد في نافذة Generate play link.

تطبيقات Xtream بتجيبه بنفسها. لتطبيق M3U، استخدم رابط XMLTV الخاص بالخط (قائمة m3u_plus بتحمل فعلًا عنوان EPG).

أيوه، على القنوات اللي فعّل المسؤول الأرشفة عليها؛ التطبيقات بتعرض أيقونة catch-up على هذه القنوات.

على /player/ في سيرفر الـ API (رابط web_player). سجّل الدخول باسم مستخدم / كلمة سر الخط، أو بكود تفعيل.

لا. كلمة السر جزء من الرابط ومخزّنة في التطبيق؛ بعد تغيير كلمة السر لازم العميل يدخلها من جديد / ياخد رابط جديد. وده كمان طريقة قطع شخص بيستخدم خط من غير إذن.

أيوه: اضبط Your own play address في صفحة مفتاح API (أو بإجراء set_play_base في الـ API). بتوجّه DNS الدومين لسيرفر API الخاص باللوحة، والمشغّل لازم يضبط من ناحيته؛ قول للمسؤول قبل ما تستخدمه. العنوان بيسري على الروابط اللي الـ API بيرجّعها لنظامك.

تقنيًا هما بيتشاركوا خط واحد، فبيتشاركوا عدد اتصالاته (SEC-01) وممكن يصطدموا بقاعدة IP الثاني (SEC-03). كل عميل المفروض يكون له خط خاص.

Devices → Add MAG / Add Enigma: ادخل الـ MAC، واختار حزمة. النظام بيبيع خط جديد ويربط الجهاز في خطوة واحدة؛ الجهاز بيسجّل الدخول بالـ MAC، ولا أحد محتاج يكتب اسم مستخدم / كلمة سر. الكريديت بيتخصم بالضبط زي الخط العادي.

في نموذج الجهاز، اختار الخط الموجود للعميل بدل الحزمة: الجهاز بيتم إقرانه بهذا الخط، مجانًا. العميل يكمل استخدام الخط في التطبيق؛ والجهاز بيتبع حزمة الخط وانتهاءه وbouquets وحالته.

بيتشاركوا في حد الاتصالات: التطبيق والجهاز مشترك واحد.

جدّد خطه (الرابط موجود في نموذج الجهاز). للجهاز المقترن، جدّد خط العميل — والجهاز بيتبعه تلقائيًا.

عدّل الـ MAC في الجهاز. لو الخط عليه قفل الجهاز، امسح الرقم التسلسلي / معرّف الجهاز المسجّل عشان الجهاز الجديد يقدر يتسجّل.

أيوه. حذف الجهاز بيحذف خطه كمان (مع سجل اتصالاته وأحداثه المعلقة). للاحتفاظ بخط اتدفع ثمنه، استخدم زر Convert to line: الجهاز بيتشال والخط بيبقى خط عادي. لما تحذف خط عميل، الجهاز المقترن بيكمل مستقلًا بخط خاص به.

أجهزة MAG الخاصة به، أيوه: إرسال رسالة للتلفزيون، تشغيل قناة، إعادة تحميل البورتال، إعادة تشغيل، إغلاق اتصالات الخط (المجموعة محتاجة صلاحية عرض سجلات اتصال العملاء)، إعادة ضبط ISP المسجّل وإعادة ضبط قفل STB. أوامر X-Plugin ولقطات الشاشة لأجهزة Enigma وحظر جهاز ونقل جهاز لخط آخر للمسؤول فقط. تفعيل / تعطيل جهاز الموزّع بيفعّل / بيعطّل خطه؛ والموزّع لا يقدر يرفع Banned عن جهاز.

بيع حق المشاهدة ككود (كارت خدش، كود يتبعت برسالة): العميل بيدخل الكود في تطبيق أو في مشغّل الويب ويقدر يشاهد، من غير اسم مستخدم / كلمة سر. الفترة بتبدأ فقط لما العميل يفعّل الكود أول مرة.

Active Codes → New: اختار الحزمة، والكمية (1–500 في الدفعة)، وطول الكود (6–24)، وخيار الأرقام فقط (سهل الكتابة بريموت التلفزيون)، وخيار التجربة. الكريديت بيتخصم عند الإنشاء = سعر الحزمة × عدد الأكواد. كل كود بييجي مع خط خاص به، مقفول لحد التفعيل.

حروف كبيرة وأرقام من غير الحروف اللي بتتلخبط بسهولة (0, O, 1, I)؛ أو أرقام فقط. العميل اللي بيكتب بحروف صغيرة بيتقبل برضه.

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

Reset device على الكود ده؛ بعدها الجهاز الجديد يقدر يفعّله. لا يتضاف وقت للفترة.

إدخال عدة أكواد غلط مختلفة ورا بعض بيخلي عنوان IP يتحظر لفترة (SEC-08).

في صفحة Active Codes، علّم الكود، واختار إجراء Extend (days) وادخل عدد الأيام. فقط الكود المفعّل بيتضاف له أيام (الكود غير المستخدم فترته لم تبدأ بعد)؛ الكود الصالح لسه بيتمدّد من تاريخ انتهائه الحالي، والمنتهي من دلوقتي. الإجراء ده لا يخصم كريديت، علشان كده الأدمن بس هو اللي يقدر يستخدمه: الموزّع بيجدّد خط الكود زي أي خط، بباقة وسعرها (Lines ← Renew، أو renew_line في Reseller API). لو حصل خصم غلط، الدعم بيصلّحه بتعديل في الرصيد، مش بتمديد مجاني. Admin API: extend_active_code.

كود غير مستخدم أنشأه الموزّع: بيتسترد بالكامل، مع صف في دفتر الكريديت. كود مفعّل: لا استرداد.

صفحة Batches بتعرض الإجمالي / الجاهز / المفعّل / المعطّل لكل دفعة وبتصدّر ملف TXT (كود في كل سطر). الإجراءات الجماعية: تفعيل، تعطيل، إعادة ضبط الجهاز، حذف.

أيوه، زي كل خط اتباع بهذه الحزمة: عدد الاتصالات، وصيغ الإخراج، وbouquets، وقفل الجهاز، وrestreamer وكمان الدولة المفروضة في الحزمة (SEC-07). العميل اللي بيفعّل كود من دولة خارج القائمة المسموحة يقدر يفعّله لكن بيترفض عند التشغيل.

هو عدد الأجهزة اللي بتشاهد في نفس الوقت بخط واحد. 0 = غير محدود. فتح القناة اللي بتشاهدها فعلًا تاني من نفس الجهاز لا يتحسب اتصالًا تانيًا.

افتراضيًا: الاتصال الجديد بيدخل والاتصال الأقدم بيتقفل (بيفضّل اتصال من نفس الجهاز، ثم من نفس الـ IP). المشغّل المقفول بيقف خلال حوالي 30 ثانية. المسؤول يقدر يحوّل لـ رفض الاتصال الجديد بدل إغلاق قديم.

لما المسؤول يفعّلها: طالما الخط بيتشاهد من IP واحد، اتصال مباشر من IP تاني بيترفض. القاعدة ممكن تتحصر في الخطوط قليلة الاتصالات (مثلًا خطوط باتصال واحد؛ الخط غير المحدود الاتصالات بيتقيّد فقط لو الحد 0). مع تفعيل Match The Address By Network، عناوين نفس شبكة /24 (IPv6: /64) بتتحسب مشاهد واحد. دي أداة ضد مشاركة الحساب.

لما المجموعة فعّلت Allow Line Restrictions: حقل Allowed IPs (IP، أو نطاق CIDR، أو اسم دومين، واحد في كل سطر؛ الدومين بيتفحص وقت الاتصال فالـ IP المتغير بيفضل شغّال) وAllowed User-Agents. فاضي = كل شيء مسموح. ملاحظة: القيود دي بتمنع عند التشغيل؛ التطبيق بيسجّل الدخول ويعرض قائمة القنوات عادي.

الخط بيفتكر مزوّد الإنترنت بتاع أول اتصال ويرفض الاستخدام من مزوّد تاني. لما العميل يغيّر المزوّد، اقفل قفل ISP وافتحه تاني عشان يسجّل الجديد. لا يسري على أجهزة MAG.

بيربط الخط بأول جهاز استقبال يسجّل الدخول (الرقم التسلسلي، معرّف الجهاز)؛ جهاز تاني بيترفض. بتحدده الحزمة.

الخط يقدر يتصل فقط من دولته المفروضة (ALL = من أي مكان). لما يكون فاضي، بتسري القائمة العامة للدول المسموحة في اللوحة. عميل بيسافر برّه أو بيستخدم VPN ممكن يترفض لهذا السبب.

• تلقائيًا: محاولات دخول فاشلة من IP واحد بأسماء مستخدمين / أكواد تفعيل مختلفة كتير في وقت قصير، أو سيل من الطلبات. الحظر التلقائي بيتفك لوحده بعد المدة اللي ضبطها المسؤول (60 دقيقة افتراضيًا).
• يدويًا: المسؤول حظر الـ IP / نطاق الـ IP؛ ده لا ينتهي.

طالما الـ IP محظور، لا يقدر أي خط يتصل منه. تكرار كتابة نفس اسم المستخدم غلط لا يسبب حظرًا.

المسؤول يقدر يحظر بـ User-Agent (التطبيق)، وبـ مزوّد الإنترنت (ISP) وبـ ASN (مثلًا نطاقات الاستضافة / VPN). الخط اللي المسؤول فعّل له "bypass UA" بيتخطى قائمة حظر التطبيقات.

خط لشريك بيسحب البثوث عشان يعيد توزيعها. بيتعفى من حد الاتصالات وقاعدة الـ IP التاني والإنهاء التلقائي للجلسات الطويلة وحظر ASN. بتحدده الحزمة / المسؤول؛ مش مخصص للمشاهدين العاديين.

المسؤول يقدر يحدد أقصى مدة لجلسة متواصلة؛ بعدها الجلسة بتتقفل والعميل بيضغط تشغيل ليكمل. الجلسة اللي بتفقد الإشارة حوالي 90 ثانية بتتحسب مقفولة كمان.

• صفحة Theft Detection (لو المجموعة عندها الصلاحية): بتصنّف الخطوط حسب عدد الأفلام / الحلقات المختلفة المشاهدة في ساعة / 24 ساعة / 7 أيام، مع عدد الـ IPs المختلفة — الخط العالي بشكل غير عادي مشبوه.
• صفحة نشاط الخط: بتعرض الـ IPs والأجهزة المستخدمة.
• اللي تعمله: غيّر كلمة سر الخط (PLAY-08)، فعّل تقييد IP / قفل ISP، أو عطّل الخط.

لما مجموعتك تفعّل Can Create Sub-Resellers ويكون فيه مجموعة واحدة على الأقل في Groups for sub-resellers. كل إنشاء بيخصم رسم الإنشاء (كريديت) المضبوط في المجموعة. شجرة الموزّعين عمقها 5 مستويات كحد أقصى.

أنت بتختار مجموعة من القائمة اللي سمح بها المسؤول؛ المجموعة دي بتحدد صلاحيات الموزّع الفرعي والحزم القابلة للبيع وحصة التجارب.

الإيميل، الاسم، كلمة السر، الحالة، المجموعة (من القائمة)، الملاحظات، تحويل / استرجاع الكريديت، وكل خط تحته. لا تقدر تغيّر دوره أو مالكه.

لا شيء: كل حساب بيشوف بس اللي تحته، عمره ما بيشوف المستويات اللي فوقه ولا الفروع التانية.

المجموعة محتاجة Can Delete Users مفعّل. الكريديت المتبقي والخطوط والحسابات التابعة بتنتقل إلى الحساب اللي بيحذف. خطوط العملاء بتفضل شغّالة. البيانات الشخصية للحساب المحذوف (اسم المستخدم، الإيميل، الاسم، كلمة السر، مفاتيح API، الملاحظات) بتتمسح؛ واسم المستخدم والإيميل ده يقدروا يتستخدموا تاني.

لما المسؤول يفعّل إيميل الترحيب: الحساب الجديد بيستلم اسم الدخول ورابط تسجيل الدخول. الإيميل لا يحتوي على كلمة السر أبدًا — أنت اللي بتبعتها له بنفسك.

لإعادة ترتيب أو إعادة تسمية أو إخفاء الفئات (مباشر، أفلام، مسلسلات، راديو) اللي العميل بيشوفها في التطبيق — لكل خط، من غير ما تلمس فئات اللوحة نفسها.

كل محتوى الفئة دي بيتخفى كمان من التطبيق وقائمة التشغيل للخطوط اللي بتستخدم القالب.

أيوه، فورًا لكل خط معيّن له القالب. لما القالب يتحذف، خطوطه بترجع للتخطيط الافتراضي.

الرؤية: قوالبك وقوالب الحسابات تحتك، وقوالب النظام، والقوالب اللي شاركتها المستويات الأعلى. التعديل: قوالبك أنت وقوالب اللي تحتك فقط. لتعديل قالب نظام، كرّره (duplicate) وعدّل النسخة.

ترتيب الفئات المخصص لا يسري على جزء الأفلام / المسلسلات في قائمة M3U (الأسماء والإخفاء لسه بيسروا). التطبيقات اللي بتستخدم Xtream API بتاخد كل شيء.

لنظامك أنت (متجر ويب، فوترة، بوت) عشان يبيع ويدير الخطوط / الموزّعين الفرعيين من غير ما تفتح الـ dashboard. العنوان: {API}/reseller/v1، والمصادقة بهيدر X-API-Key. التوثيق الكامل على /docs/ في سيرفر الـ API.

صفحة API Key. المفتاح بيظهر مرة واحدة، عند إنشائه — انسخه فورًا. لو ضاع، أنشئ مفتاح جديد (القديم بيتوقف).

الأفضل لا. أنشئ مفتاح إضافي لكل نظام: سمّيه، وحدّد الـ IPs / CIDRs اللي تقدر تستخدمه، واختياريًا خليه read-only (قوائم وعرض فقط)، وألغِه لوحده من غير ما يأثر على باقي المفاتيح.

كل قاعدة في الـ dashboard (المجموعة، السعر الخاص، حصة التجارب، نطاق الشجرة) بتسري عبر الـ API بنفس الطريقة بالضبط.

لا، طالما بتبعت نفس request_id لنفس المعاملة: النظام بيرجّع النتيجة السابقة. الـ request_id الخاص بالتجديد مرتبط بذلك الخط: إعادة استخدامه لخط تاني بيرجّع خطأ تعارض (HTTP 409) والخط التاني لا يتغير — ولّد request_id جديد لكل معاملة.

صفحة API Key فيها جدول مكالمات API الأخيرة (30 يوم): الإجراء، النتيجة، كود الخطأ، العنوان المتصل، اسم الـ connector. المعاملات (parameters) عمرها ما بتتسجّل.

اللوحة بتبلّغ نظامك لما يحصل حاجة، فمش محتاج تسأل باستمرار. الأحداث: line.created، line.renewed، line.enabled، line.disabled، line.deleted، line.expiring (قبلها بـ 3 أيام)، line.expired، credits.low (أقل من الحد اللي حددته). عنوان الاستقبال لازم يكون https ويمكن الوصول له من الإنترنت.

كل إشعار بيحمل التوقيع X-Xtream-Signature: sha256=HMAC(secret, timestamp.body)؛ والـ secret بيظهر مرة واحدة، عند إنشاء الـ endpoint. الـ webhook عمره ما بيحتوي كلمة سر.

كل إشعار بيتجرّب 3 مرات؛ والـ endpoint اللي يفشل في 20 تسليم ورا بعض بيتوقف. صلّح من ناحيتك، واستخدم Send test، وبعدين أنشئ الـ endpoint من جديد لو كان اتوقف.

أيوه، لكن لمالك الخط فقط (أنت والمستويات فوقك في الشجرة). متخزّنش كلمات سر الخطوط في سجلات ولا تبعتها عبر قناة غير آمنة.

أيوه، لما تبعت معاه package_id (الاسم القديم package مقبول كمان): بجانب التعديل، الإجراء بيبيع فترة رسمية واحدة من الحزمة دي بالضبط زي change_package — نفس السعر، ونفس request_id، والرد بيحمل credits_charged. التعديل والتجديد عملية واحدة: لما بتترفض (كريديت مش كفاية، حزمة غير صالحة، trial اتبعت معاها) لا شيء بيتغير. edit_line من غير حزمة بيعدّل فقط اسم المستخدم وكلمة السر وجهة الاتصال والملاحظات ولا يلمس الحزمة ولا الانتهاء.

مش كما هو. الـ API بيحتفظ بأسماء الإجراءات المألوفة لكنه واجهة جديدة: العنوان /reseller/v1، ومفتاح API منشأ في هذه اللوحة، وإجراءات الكتابة بتتبعت بـ POST، والأخطاء بترجع كحالة HTTP مع حقل error، ونتيجة إنشاء الخط في data.line. استخدم التوثيق على /docs/ أو connector جاهز (CON-02).

بنظامك أنت وبوابة الدفع بتاعتك. اللوحة لا تعالج المدفوعات. الـ connector بيربط نظام متجرك باللوحة: العميل بيدفع عندك ← الـ connector بينادي الـ Reseller API لإنشاء / تجديد الخط.

WHMCS وBlesta وWISECP وHostBill وClientExec وFOSSBilling وPaymenter وWordPress (WooCommerce / Easy Digital Downloads) وOdoo وPrestaShop وOpenCart وMagento وDolibarr وERPNext، و"webhook bridge" لـ Shopify وUpmind وInvoice Ninja.

في اللوحة: الشريط الجانبي Resources → All Connectors — كل Connector مع بيانات الاتصال وخطوات التثبيت وزرار Download وSHA-256 بتاع الملف عشان تتحقق منه.

نفس الـ Connectors، مع خطوات التثبيت والـ checksums، منشورة على https://plugins.xtream-ui.pro، والكود المصدري على https://github.com/xtreamui-pro/plugins.

بيختلف من connector للتاني، وصفحة كل connector بتقول ده: بعضها اشتغل داخل المنصة الحقيقية (مثلًا WordPress + WooCommerce وOdoo وFOSSBilling وPaymenter)، وغيرها اتجرّب جوهره فقط. اقرا سطر "how it was tested" وجرّب في بيئة اختبار قبل ما تبيع بجد.

الـ connector بينادي الـ Reseller API فقط بمفتاح API بتاعك — يقدر يعمل بالضبط اللي تقدر تعمله، لا أكتر. الكود المصدري مفتوح تقراه وتتحقق منه. اديّ كل connector مفتاح خاص به مع تقييد IP (API-03).

الخطوط (إنشاء، تجديد، تغيير حزمة، إيقاف، حذف) وحسابات الموزّعين الفرعيين بالكريديت.

اعمل التكامل بنفسك بالـ Reseller API (API-01) وwebhooks، أو ابعت طلب عبر قناة الدعم.

لا. المحذوف راح: بيانات الخط (اسم المستخدم، كلمة السر، جهة الاتصال، الملاحظات)، وسجل اتصالاته (IPs، أجهزة، اللي اتشاهد)، وأجهزة الاستقبال المرتبطة بالخط وكود تفعيله. مفيش سلة مهملات ولا وظيفة أو API استرجاع. لما العميل يرجع، أنشئ له خط جديد.

فقط سجل إحصائي مجهول للمشغّل (عميل جديد أو عائد، أي الحزم مشهورة). مفيهوش حاجة مقروءة عن العميل ولا يقدر أي موزّع أو connector أو API يوصل له.

لا. النسخ الاحتياطية لقاعدة البيانات موجودة فقط لإعادة بناء النظام بعد حادث ويحتفظ بها المشغّل؛ ولا تُستخدم للتراجع عن حذف. النسخ القديمة بتتدوّر وتتشال، فالبيانات المحذوفة بتختفي منها كمان.

كلمة سر الخط لازم تتكتب في التطبيقات وهي جزء من رابط القائمة، فاللوحة بتحتفظ بها مقروءة لمالك الخط. كلمات سر حسابات اللوحة بتتخزّن مشفّرة (hash) فقط.

أنت، والحسابات اللي فوقك في شجرتك، والمسؤول. الموزّعون التانيين والمستويات تحتك لا يقدروا.

أبدًا. عملاء الخط بيتبعوا الموزّع؛ أنت اللي بتتواصل معاهم عبر نظامك الخاص.

بطريقتين: إيميل ملخص يومي بالخطوط اللي على وشك الانتهاء (لما يفعّله المسؤول؛ قبلها بـ 3 أيام افتراضيًا)، وwebhooks line.expiring / line.expired لنظامك.

غالبًا واحد من أقفال التشغيل (الصفوف 5–9 من FIX-01): تسجيل الدخول وقائمة القنوات لا يفحصوا الـ IP / التطبيق، التشغيل فقط هو اللي بيفحص. لو قناة واحدة بس بتفشل على كل الخطوط ← القناة المصدر فيها مشكلة؛ بلّغ المسؤول باسم القناة والوقت.

راجع bouquets الخط (PKG-04, PKG-05) وقالب الفئات المعيّن له (CAT-02). بعد أي تغيير، اطلب من العميل يعيد تحميل القائمة في التطبيق. القناة اللي المسؤول أضافها لتوّه بتظهر بعد حوالي نص دقيقة؛ ولو قناة في الـ bouquet ومفيش خط بيشوفها، ممكن المسؤول يكون سحبها من البث.

جرّب بالترتيب: قناة تانية (قناة واحدة ولا كلها؟) ← شبكة تانية ← صيغة تانية (HLS بدل MPEG-TS) ← تطبيق تاني. كل القنوات بتفشل على كل الشبكات ← بلّغ الدعم باسم المستخدم والوقت والقناة.

تطبيق M3U محتاج إضافة رابط XMLTV (PLAY-05). القناة اللي من غير EPG في المصدر مبتعرضش جدول.

بالترتيب: مفيش حزمة مختارة · الحزمة مش لمجموعتك (PKG-02) · كريديت مش كفاية (CRD-05) · اسم المستخدم مأخوذ أو أقصر من الحد الأدنى (LINE-02) · حصة التجارب خلصت (TRI-01).

429: الخط بينزّل قوائم تشغيل / ملفات EPG كتير مرة واحدة — استنى وحاول تاني. صفحة 404: النظام بيرد 404 على كل رفض (بيانات غلط، منتهي، مقفول، فوق حد) عشان السبب ميتكشفش للغرباء؛ افحص بـ FIX-01.

مجموعتك ملهاش صلاحية على الصفحة دي (ACC-02). Live Connections كمان محتاجة إن المسؤول يفعّل خيار عرض اتصالات العملاء للمجموعة (LINE-15).

الإيميل بيتبعت فقط لما المسؤول يضبط سيرفر بريد ويفعّل النوع ده من الرسائل؛ ولازم يكون للحساب عنوان إيميل حقيقي. راجع مجلد السبام.