الأسئلة والأجوبة

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

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

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

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

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

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

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

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

النطاقات مع TLS وعقد الحافة وكل الخيارات مشروحة في الدليل.

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

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

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

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

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

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

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

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

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

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

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

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

يُرفض الإجراء كاملًا: لا يُنشأ خط ولا يُخصم شيء. لا ينزل الرصيد عن الصفر أبدًا.

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

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

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

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

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

لا يمكن بيع الحزمة إلا من المجموعات التي اختارها المدير لها. الحزمة غير المخصصة لمجموعتك لا تظهر في المحدّد ويتم رفضها عند إرسالها عبر API.

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

لا. تُنسخ باقات القنوات إلى الخط وقت البيع؛ وتعديل الباقة لاحقًا لا يؤثر على الخطوط المباعة. يحصل الخط على باقات القنوات الجديدة للباقة عند تجديده / تغيير باقته التالي. (أما عندما يتغير المحتوى داخل باقة قنوات، فكل خط يملكها يراه فورًا. حذف باقة قنوات يزيل معرّفها من كل خط وباقة. وتغيير الترتيب العام لباقات القنوات لا يغيّر الترتيب المخزّن في الخطوط المباعة إلا إذا حدّدت خانة «تطبيق على الخطوط والباقات المباعة»؛ أما مجموعة باقات القنوات في الخط فلا تتغير.)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

خطوطك وخطوط كل حساب تحتك. الخط خارج شجرتك غير موجود بالنسبة لك (الجواب «غير موجود»).

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

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

الخط التابع لرمز تفعيل يكون مخفيًا من القائمة افتراضيًا إلى أن تُصفّي عليه (CODE-02).

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

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

كما هو مضبوط في المجموعة: يوم = آخر 24 ساعة، شهر = آخر 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 تستخدم البوابة (portal)، وأجهزة Enigma2 تستخدم قائمة تشغيل / إضافة. وبدون أي جهاز، استخدم مشغّل الويب في المتصفح.

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 (أو بإجراء API ‏set_play_base). توجّه DNS النطاق إلى خادم API الخاص باللوحة، وعلى المشغّل أن يضبط من جانبه؛ أخبر المدير قبل الاستخدام. يسري العنوان على الروابط التي يعيدها API إلى نظامك.

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

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

في نموذج الجهاز، اختر الخط الموجود للعميل بدلًا من الباقة: يُقرَن الجهاز بذلك الخط (paired) مجانًا. يواصل العميل استخدام الخط في التطبيق؛ ويتبع الجهاز باقة الخط وانتهاءه وباقات قنواته وحالته.

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

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

عدّل عنوان 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 (رمز في كل سطر). الإجراءات الجماعية: تفعيل، تعطيل، إعادة تعيين الجهاز، حذف.

نعم، مثل كل خط يُباع بتلك الباقة: عدد الاتصالات، وصيغ الإخراج، وباقات القنوات، وقفل الجهاز، و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 أيام، مع عدد عناوين IP المختلفة — الخط المرتفع بشكل غير معتاد مشبوه.
• صفحة نشاط الخط: تعرض عناوين IP والأجهزة المستخدمة.
• ما العمل: غيّر كلمة مرور الخط (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. يُعرض المفتاح مرة واحدة عند إنشائه — انسخه فورًا. وإذا فقدته فأنشئ مفتاحًا جديدًا (يتوقف القديم عن العمل).

الأفضل لا. أنشئ مفتاحًا إضافيًا لكل نظام: سمّه، وقيّد عناوين IP / نطاقات CIDR التي يمكنها استخدامه، واجعله اختياريًا للقراءة فقط (عرض وسرد فقط)، وألغِه وحده دون التأثير على المفاتيح الأخرى.

تسري كل قواعد 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)؛ ويُعرض السر مرة واحدة عند إنشاء نقطة الاستقبال. ولا يحتوي webhook على كلمة مرور أبدًا.

تُجرَّب كل رسالة إشعار 3 مرات؛ ونقطة الاستقبال التي تفشل في 20 تسليمًا متتاليًا تُعطَّل. أصلح جانبك، واستخدم Send test، ثم أنشئ نقطة الاستقبال من جديد إن كانت قد عُطّلت.

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

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

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

بنظامك الخاص وبوابة الدفع الخاصة بك. لا تعالج اللوحة المدفوعات. يربط الموصّل (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 — كل موصّل مع بيانات الاتصال وخطوات التثبيت وزر Download والمجموع الاختباري SHA-256 للملف للتحقق منه.

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

يختلف ذلك من موصّل لآخر، وتذكره صفحة كل موصّل: بعضها شُغّل داخل المنصة الحقيقية (مثل WordPress + WooCommerce وOdoo وFOSSBilling وPaymenter)، وبعضها اختُبر جوهره فقط. اقرأ سطر «كيف اختُبر» وجرّبه في بيئة اختبار قبل البيع الفعلي.

لا يفعل الموصّل سوى استدعاء Reseller API بمفتاح API الخاص بك — يستطيع فعل ما تفعله أنت بالضبط ولا أكثر. الشيفرة المصدرية مفتوحة لتقرأها وتتحقق منها. أعطِ كل موصّل مفتاحًا خاصًا به مع تقييد IP (API-03).

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

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

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

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

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

كلمة مرور الخط يجب كتابتها في التطبيقات وهي جزء من رابط قائمة التشغيل، لذلك تحتفظ بها اللوحة مقروءة لمالك الخط. أما كلمات مرور حسابات اللوحة فتُخزَّن مشفّرة بالتجزئة فقط.

أنت والحسابات الأعلى منك في شجرتك والمدير. أما الموزّعون الآخرون والمستويات التي تحتك فلا.

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

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

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

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

جرّب بالتتابع: قناة أخرى (قناة واحدة أم كلها؟) ← شبكة أخرى ← صيغة أخرى (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).

لا يُرسل البريد إلا عندما يضبط المدير خادم بريد ويفعّل ذلك النوع من الرسائل؛ ويجب أن يملك الحساب عنوان بريد حقيقيًا. افحص مجلد الرسائل غير المرغوبة.