پرسش و پاسخ

یک سیستم کامل OTT / IPTV: پنل مدیریت (داشبورد)، سرور API برای برنامه‌های بینندگان، پخش کانال‌های زنده، فیلم، سریال و رادیو، و یک وب پلیر. ما سیستم را فراهم و نگهداری می‌کنیم؛ ریسلرها از آن برای دادن حق تماشا (لاین) به مشتریان خود استفاده می‌کنند.

• برای شما پول جمع‌آوری نمی‌کند و درگاه پرداخت ندارد. قیمت برای مشتریان شما، نحوه دریافت پول و صدور فاکتور به عهده ریسلر است (به CON-01 نگاه کنید).
• با بینندگان ریسلر تماس نمی‌گیرد. پنل فقط به حساب‌های پنل ایمیل می‌فرستد، هرگز به یک لاین.
• داده‌های شخصی مشتری حذف‌شده را نگه نمی‌دارد و قابلیت بازیابی ندارد (به DATA-01 نگاه کنید).

1. مدیر کاتالوگ (کانال‌ها، فیلم‌ها، سریال‌ها، رادیو) را می‌سازد و آن را در بوکه‌ها (bouquet) گروه‌بندی می‌کند.
2. مدیر یک پکیج می‌سازد: بوکه‌ها + مدت + تعداد اتصال + قیمت به کردیت.
3. ریسلر برای فروش پکیج کردیت خرج می‌کند → سیستم یک لاین می‌سازد.
4. مشتری مشخصات لاین را در یک برنامه وارد می‌کند؛ سیستم لاین را بررسی می‌کند (منقضی نشده، فعال، در محدوده مجاز) و از یک سرور مناسب پخش می‌کند.

ریسلر می‌تواند فهرست کانال‌ها، فیلم‌ها، سریال‌ها، رادیو، بوکه‌ها و پکیج‌ها را ببیند (اگر گروهش مجوز داشته باشد)، اما نمی‌تواند محتوا اضافه، ویرایش یا حذف کند. محتوا و پکیج‌ها را مدیر مدیریت می‌کند. ریسلر با انتخاب پکیج (و بوکه‌ها، وقتی گروه اجازه دهد — PKG-05) تعیین می‌کند هر مشتری چه چیزی را می‌تواند تماشا کند.

گزینه Support در نوار کناری، سایت جداگانه پشتیبانی را باز می‌کند. پنل سیستم تیکت مخصوص خودش را ندارد. هنگام ارسال درخواست این موارد را بنویسید: نام کاربری لاین (هرگز رمز عبور)، زمان وقوع مشکل، برنامه / دستگاه، و کد پرسش از این صفحه اگر قبلاً امتحانش کرده‌اید.

پنل، وب پلیر و این صفحه راهنما یک تعویض‌کننده زبان با ۲۷ زبان دارند. انگلیسی و ویتنامی ترجمه‌های مرجع هستند؛ در زبان‌های دیگر یک صفحه تازه اضافه‌شده ممکن است مدتی به انگلیسی بماند. ایمیل‌هایی که پنل می‌فرستد فعلاً فقط انگلیسی هستند.

بسته‌های نصب، چک‌سام‌های SHA-256 آن‌ها و راهنمای کامل نصب (به انگلیسی) در https://download.xtream-ui.pro قرار دارند.

• پیش‌نیاز: اوبونتو 22.04 یا 24.04 (ماشین مجازی یا سرور فیزیکی)، دسترسی root یا sudo، و ترجیحاً یک سرور تازه.
• نصب: بسته مناسب CPU خود را مستقیماً روی سرور دانلود کنید، با sha256sum بررسی کنید، از حالت فشرده خارج کنید و sudo ./install.sh را اجرا کنید.
• ارتقای سرور در حال اجرا: sudo ./upgrade.sh --tag <version>.

دامنه‌ها با TLS، نودهای edge و همه گزینه‌ها در راهنما توضیح داده شده‌اند.

این طراحی عمدی است: لاین یک حساب پنل نیست. مشتری فقط مشخصات لاین را در یک برنامه IPTV، ست‌تاپ‌باکس یا وب پلیر استفاده می‌کند. برعکس آن هم صادق است: با حساب ریسلر نمی‌توان کانال تماشا کرد.

منوها و عملیات به گروهی بستگی دارند که مدیر به حساب شما داده است. صفحه‌ای که گروه شما مجوزش را ندارد در نوار کناری نشان داده نمی‌شود و باز نمی‌شود. از مدیر مجوز بیشتری بخواهید.

در بخش حساب (profile → change password). رمزهای پنل به‌صورت هش ذخیره می‌شوند؛ هیچ‌کس نمی‌تواند آن‌ها را بخواند — حتی مدیر. اگر آن را فراموش کردید، از حساب بالادستی خود (ریسلر والد یا مدیر) بخواهید رمز جدیدی تنظیم کند.

پنل می‌تواند طوری تنظیم شود که با تغییر آدرس IP نشست را پایان دهد، تا نشست دزدیده‌شده قابل استفاده نباشد. دوباره وارد شوید. این یک تنظیم مدیر است.

پنل تعداد ورودهای ناموفق را محدود می‌کند (توسط مدیر تنظیم می‌شود). پس از رسیدن به حد مجاز، باید قبل از تلاش دوباره صبر کنید.

حساب دمو فقط رابط کاربری را نشان می‌دهد: نمی‌تواند رمز عبورش را تغییر دهد، پروفایلش را ویرایش کند، کد فعال‌سازی بسازد یا کاری انجام دهد که قابل بازگشت نیست.

حساب بالادستی شما آن را خاموش کرده است: نمی‌توانید وارد پنل شوید و کلیدهای API شما رد می‌شوند. لاین‌هایی که قبلاً فروخته شده‌اند حذف نمی‌شوند. با حساب بالادستی خود تماس بگیرید.

Logs → Reseller Logs (اگر گروه اجازه دیدن لاگ‌ها را داشته باشد): هر لاین یا دستگاهی که ساخته، ویرایش، تمدید، فعال / غیرفعال یا حذف شده، هر زیرریسلر ساخته‌شده و هر انتقال کردیت — همراه با کردیت کسرشده. فقط ورودی‌های خودتان و حساب‌های زیر دستتان را می‌بینید؛ لاگ قابل حذف نیست (فقط مدیر). دفتر کردیت (CRD) همچنان جای تطبیق موجودی است.

واحد پیش‌پرداخت پنل. هر فروش (ساخت لاین، تمدید، ساخت کدهای فعال‌سازی، ساخت زیرریسلر) بر اساس قیمت پکیج یا هزینه گروه کردیت کم می‌کند. کردیت پول نیست و پنل آن را تبدیل نمی‌کند: ارزش هر کردیت را شما و حساب بالادستی‌تان با هم توافق می‌کنید.

کردیت از بالا به پایین جریان دارد: مدیر به ریسلر کردیت می‌دهد، ریسلر آن را به زیرریسلر منتقل می‌کند. پرداخت به حساب بالادستی خارج از پنل انجام می‌شود.

همیشه کردیت حسابی که عملیات را انجام می‌دهد، حتی اگر لاین به زیرریسلر پایین‌تر اختصاص داده شده باشد.

صفحه Credits: برای هر تغییر یک ردیف، با تاریخ، مبلغ، موجودی پس از آن، دلیل و فاعل. این همان دفتر کل است — منبع معتبر موجودی شما.

کل عملیات رد می‌شود: هیچ لاینی ساخته نمی‌شود و چیزی کسر نمی‌شود. موجودی هرگز منفی نمی‌شود.

خیر. هر درخواست فروش یک شناسه درخواست (request_id) دارد؛ ارسال دوباره همان شناسه نتیجه قبلی را برمی‌گرداند. ساخت لاین و کسر کردیت همیشه با هم موفق می‌شوند یا با هم لغو می‌شوند.

خیر. حذف لاین چیزی را بازپرداخت نمی‌کند، حتی اگر زمان باقی مانده داشته باشد. تنها استثنا: حذف یک کد فعال‌سازی استفاده‌نشده که خود ریسلر ساخته بازپرداخت می‌شود (CODE-08).

بله: در فرم ویرایش زیرریسلر، در فیلد انتقال کردیت یک عدد منفی وارد کنید. هیچ موجودی نمی‌تواند زیر ۰ برود.

انتخابگر پکیج در فرم لاین قیمت مخصوص شما را نشان می‌دهد. از طریق API، اکشن pricing موجودی شما، قیمت هر پکیج و تعدادی که از عهده‌اش برمی‌آیید را برمی‌گرداند.

بوکه (bouquet) فهرستی از محتوا (کانال‌ها، فیلم‌ها، سریال‌ها) است. پکیج (package) محصولی است که می‌فروشید: یک یا چند بوکه، یک مدت، تعداد اتصال، فرمت‌های خروجی، قفل‌ها و قیمت به کردیت (قیمت رسمی و قیمت تریال).

یک پکیج را فقط گروه‌هایی که مدیر برای آن انتخاب کرده می‌توانند بفروشند. پکیجی که برای گروه شما نیست در انتخابگر نمایش داده نمی‌شود و اگر از طریق API ارسال شود رد می‌شود.

مدیر می‌تواند برای هر ریسلر و هر پکیج یک قیمت اختصاصی تعیین کند (۰ = رایگان). قیمت اختصاصی برای ساخت لاین رسمی، تمدید و کدهای فعال‌سازی رسمی اعمال می‌شود؛ برای تریال اعمال نمی‌شود.

خیر. بوکه‌ها در زمان فروش در لاین کپی می‌شوند؛ ویرایش بعدی پکیج روی لاین‌های فروخته‌شده تأثیری ندارد. لاین در تمدید / تغییر پکیج بعدی خود بوکه‌های جدید پکیج را می‌گیرد. (وقتی محتوای داخل یک بوکه تغییر کند، هر لاینی که آن بوکه را دارد بلافاصله آن را می‌بیند. حذف یک بوکه شناسه آن را از همه لاین‌ها و پکیج‌ها حذف می‌کند. تغییر ترتیب سراسری بوکه‌ها فقط وقتی ترتیب ذخیره‌شده روی لاین‌های فروخته‌شده را عوض می‌کند که کادر «apply to sold lines and packages» را تیک بزنید؛ مجموعه بوکه‌های لاین تغییر نمی‌کند.)

فقط وقتی گروه شما Allow Bouquet Selection را روشن دارد: بخشی از بوکه‌های پکیج را تیک می‌زنید؛ هیچ تیکی = کل پکیج؛ بوکه‌های خارج از پکیج حذف می‌شوند. قیمت تغییر نمی‌کند.

تاریخ انقضا (امروز + مدت پکیج)، تعداد اتصال، فرمت‌های خروجی، ریستریمر، قفل دستگاه، کشور اجباری، سرور اجباری، قفل ISP، بوکه‌ها. مقادیری که ریسلر برای این فیلدها وارد می‌کند نادیده گرفته می‌شود، به‌جز بوکه‌ها (PKG-05) و قفل ISP وقتی گروه Allow Line Restrictions را روشن دارد.

پکیجی که فقط برای آن نوع ست‌تاپ‌باکس قابل فروش است؛ برای لاین معمولی یا نوع دیگر دستگاه قابل فروش نیست. برعکس، یک پکیج باید نوع دستگاه را مجاز کرده باشد تا در فرم Add MAG / Add Enigma قابل استفاده باشد.

باید پکیجی را که گروه شما اجازه فروشش را دارد انتخاب کنید و کردیت کافی داشته باشید. نام کاربری / رمز عبور: خودتان تایپ کنید (اگر گروه اجازه دهد) یا خالی بگذارید تا تولید شوند. مدیر هم هنگام ساخت لاین می‌تواند یکی از آن‌ها (یا هر دو) را خالی بگذارد: سیستم ۱۰ نویسه تولید می‌کند و بلافاصله پس از ذخیره نشان می‌دهد؛ فرم ویرایش همچنان به نام کاربری نیاز دارد.

گروه شما Allow Username Change / Allow Password Change را خاموش دارد: لاین جدید مقادیر تولیدشده می‌گیرد. وقتی اجازه دارید خودتان تایپ کنید، حداقل طول را گروه تعیین می‌کند (به‌طور پیش‌فرض ۸ نویسه).

در فرم ویرایش لاین و در پنجره Generate play link در فهرست Lines. رمزهای لاین خوانا نگه داشته می‌شوند چون برنامه‌های IPTV و لینک‌های پلی‌لیست به آن نیاز دارند. رمز تولیدشده بلافاصله پس از ذخیره نشان داده می‌شود.

بعضی لاین‌هایی که نسخه قبلی پنل ساخته فقط یک رمز هش‌شده دارند. چنین لاینی نمی‌تواند وارد شود و پنل رمزی برای آن نشان نمی‌دهد. در فرم ویرایش لاین رمز جدیدی تنظیم کنید و برای مشتری بفرستید.

فعال / غیرفعال کردن، یادداشت‌های ریسلر، تماس، قالب دسته‌بندی، مالک (در درخت خودتان)؛ نام کاربری و رمز عبور اگر گروه اجازه دهد؛ محدودیت‌ها (IPها، user agentها، قفل ISP) وقتی گروه Allow Line Restrictions را روشن دارد؛ انتخاب جدید بوکه‌ها در محدوده پکیج اگر گروه اجازه دهد. پکیج، تاریخ انقضا، تعداد اتصال، پرچم تریال، فرمت‌های خروجی، قفل دستگاه و کشور را نمی‌توان مستقیم ویرایش کرد — فقط با تمدید / تغییر پکیج تغییر می‌کنند.

دو راه، یک قانون:

• دکمه Renew (charged) در فهرست: از پکیج فعلی لاین استفاده می‌کند؛
• فیلد Extend with package در فرم ویرایش: هر پکیجی را که اجازه فروشش دارید انتخاب کنید (تغییر پکیج هم از همین راه انجام می‌شود).

وقتی لاینی را ویرایش می‌کنید و در همان ذخیره تمدید هم انتخاب می‌کنید، هر دو یک تراکنش هستند: اگر تمدید رد شود (کردیت کافی نیست، پکیج قابل فروش نیست)، ویرایش هم ذخیره نمی‌شود و کردیتی کسر نمی‌شود. آن را اصلاح کنید و دوباره ذخیره کنید.

• لاین منقضی نشده و پکیج جدید با قبلی سازگار است → زمان به تاریخ انقضای فعلی اضافه می‌شود.
• لاین منقضی شده یا دو پکیج سازگار نیستند → از امروز حساب می‌شود؛ زمان باقی‌مانده حفظ نمی‌شود.

«سازگار» فقط وقتی بررسی می‌شود که گزینه بررسی سازگاری در پکیج جدید روشن باشد: هر دو پکیج باید بوکه‌ها، فرمت‌های خروجی، تعداد اتصال، پرچم ریستریمر و قفل دستگاه یکسان داشته باشند. با خاموش بودن گزینه، همیشه سازگار حساب می‌شوند. پکیج‌های جدید به‌طور پیش‌فرض این گزینه را روشن دارند (مدیر می‌تواند خاموشش کند)؛ پکیج‌های موجود تنظیم خود را حفظ می‌کنند. لاین MAG / Enigma فقط با پکیجی تمدید یا تغییر داده می‌شود که آن نوع دستگاه را مجاز کرده باشد.

تغییر پکیج = خرید یک دوره رسمی از پکیج جدید: قیمت کامل پکیج جدید کسر می‌شود (قیمت اختصاصی شما اگر داشته باشید)، بدون کردیت برای بخش استفاده‌نشده. لاین همه ویژگی‌های پکیج جدید را می‌گیرد.

غیرفعال کردن: مشتری نمی‌تواند وارد شود یا تماشا کند، نشست‌های جاری ظرف حدود یک دقیقه بسته می‌شوند؛ دوره اشتراک ادامه می‌یابد؛ هر زمان می‌توانید دوباره فعالش کنید. حذف: دائمی، بدون بازیابی، بدون بازپرداخت (DATA-01). برای مشتری‌ای که مکث می‌کند، غیرفعال کنید — حذف نکنید.

تا زمان تمدید لاین، مشتری رد می‌شود (لاینی که هم منقضی و هم بن شده کلیپ «expired» را می‌بیند، چون انقضا اول بررسی می‌شود)؛ نشست‌های جاری ظرف حدود یک دقیقه بسته می‌شوند. لاین به‌طور خودکار حذف نمی‌شود: تمدیدش کنید و با همان نام کاربری / رمز عبور دوباره کار می‌کند.

بله: یکی از حساب‌های زیر دست خود را به‌عنوان مالک انتخاب کنید. مالک لاین را در فهرست خودش می‌بیند. کردیت همچنان از کسی کسر می‌شود که ذخیره را می‌زند.

لاین‌های خودتان و لاین‌های همه حساب‌های زیر دستتان. لاینی خارج از درخت شما برای شما وجود ندارد (پاسخ «یافت نشد» است).

برای اینکه خودتان به یاد داشته باشید مشتری کیست (ایمیل، شماره تلفن، شماره سفارش). مشترک هرگز آن‌ها را نمی‌بیند. با حذف لاین برای همیشه پاک می‌شوند.

وقتی گروه مجوز داشته باشد: Logs → Line Activity تاریخچه تماشای هر لاین را نشان می‌دهد و Logs → Live Connections همه اتصال‌ها باز لاین‌های درخت شما را نشان می‌دهد (کدام لاین، کدام کانال، از کدام آدرس) همراه با دکمه بستن آن. Live Connections فقط وقتی باز می‌شود که مدیر برای گروه شما گزینه دیدن تاریخچه اتصال مشتریان را روشن کرده باشد (کادر client connection logs در فرم گروه)؛ اتصال‌ها لاینی خارج از درخت خود را هرگز نمی‌بینید.

لاینی که متعلق به یک کد فعال‌سازی است به‌طور پیش‌فرض از فهرست پنهان است تا زمانی که برایش فیلتر کنید (CODE-02).

بله. فیلد Expires on در فرم لاین یک تاریخ و ساعت در منطقه زمانی پنل است، پس یک لاین می‌تواند در ساعت مشخصی منقضی شود. باز کردن فرم و ذخیره بدون دست زدن به این فیلد انقضا را تا ثانیه حفظ می‌کند — ویرایش یک یادداشت یا بوکه‌ها به لاین تریال ساعتی زمان اضافه نمی‌دهد. مقداری که خوانده نشود در همان فیلد گزارش می‌شود و هرگز به «هرگز منقضی نمی‌شود» تبدیل نمی‌شود. صفحه ویرایش گروهی همچنان تاریخ می‌گیرد و آن را پایان همان روز می‌خواند.

وقتی همه این شرایط برقرار باشند: مدیر تریال را برای ریسلرها خاموش نکرده باشد؛ پکیج دوره تریال داشته باشد؛ گروه شما Allowed Trials > 0 داشته باشد؛ کردیت شما ≥ Minimum Trial Credits گروه باشد؛ و تعداد لاین‌های تریالی که در بازه شمارش ساخته‌اید به سهمیه نرسیده باشد.

طبق تنظیم گروه: روز = ۲۴ ساعت گذشته، ماه = ۳۰ روز گذشته. مثال، سهمیه ۵ / روز: حداکثر ۵ لاین تریال در هر ۲۴ ساعت. یک تریال قدیمی‌تر وقتی از بازه خارج شود جای خود را آزاد می‌کند.

دقیقاً قیمت تریال پکیج (معمولاً ۰). قیمت اختصاصی ریسلر برای تریال اعمال نمی‌شود.

یکی از شرایط 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 از پلی‌لیست / پلاگین استفاده می‌کنند. بدون هیچ دستگاهی، از وب پلیر در مرورگر استفاده کنید.

MPEG-TS: تعویض سریع کانال، مناسب برنامه‌های IPTV و ست‌تاپ‌باکس‌ها. HLS: در مرورگرها، دستگاه‌های اپل و شبکه‌های ناپایدار خوب کار می‌کند. یک لاین فقط می‌تواند از فرمت‌هایی که پکیجش مجاز کرده استفاده کند؛ لینک با فرمت غیرمجاز رد می‌شود.

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 خود وارد می‌شود و کسی لازم نیست نام کاربری / رمز عبور تایپ کند. کردیت دقیقاً مثل لاین معمولی کسر می‌شود.

در فرم دستگاه، به‌جای پکیج لاین موجود مشتری را انتخاب کنید: دستگاه با آن لاین جفت می‌شود، رایگان. مشتری همچنان لاین را در برنامه استفاده می‌کند؛ دستگاه از پکیج، انقضا، بوکه‌ها و وضعیت لاین پیروی می‌کند.

آن‌ها محدودیت اتصال را به اشتراک می‌گذارند: برنامه و دستگاه یک مشترک هستند.

لاین آن را تمدید کنید (پیوند در فرم دستگاه است). برای دستگاه جفت‌شده، لاین مشتری را تمدید کنید — دستگاه خودکار دنبال می‌کند.

MAC را روی دستگاه ویرایش کنید. اگر لاین قفل دستگاه را روشن دارد، شماره سریال / شناسه دستگاه ثبت‌شده را پاک کنید تا دستگاه جدید بتواند ثبت شود.

بله. حذف دستگاه لاین آن را هم حذف می‌کند (با تاریخچه اتصال و رویدادهای در انتظار). برای نگه داشتن لاینی که پولش پرداخت شده، از دکمه Convert to line استفاده کنید: دستگاه حذف می‌شود و لاین به یک لاین معمولی تبدیل می‌شود. وقتی لاین مشتری را حذف کنید، دستگاه جفت‌شده مستقل و با لاین مخصوص خودش باقی می‌ماند.

دستگاه‌های MAG خودش را بله: ارسال پیام به تلویزیون، پخش یک کانال، بارگذاری مجدد پورتال، ری‌بوت، بستن اتصال‌ها لاین (گروه برای دیدن لاگ اتصال‌ها مشتریان به مجوز نیاز دارد)، ریست ISP ثبت‌شده و ریست قفل STB. دستورهای X-Plugin و اسکرین‌شات دستگاه‌های Enigma، بن کردن دستگاه و انتقال دستگاه به لاین دیگر فقط برای مدیر است. فعال / غیرفعال کردن دستگاه ریسلر، لاین آن را فعال / غیرفعال می‌کند؛ ریسلر نمی‌تواند Banned را از یک دستگاه بردارد.

فروش دسترسی به‌صورت یک کد (کارت خراشیدنی، کدی که با پیام فرستاده می‌شود): مشتری کد را در یک برنامه یا در وب پلیر وارد می‌کند و بدون نام کاربری / رمز عبور می‌تواند تماشا کند. دوره فقط از اولین باری شروع می‌شود که مشتری کد را فعال می‌کند.

Active Codes → New: پکیج، تعداد (۱ تا ۵۰۰ در هر دسته)، طول کد (۶ تا ۲۴)، گزینه فقط‌رقم (تایپ آسان با ریموت تلویزیون) و گزینه تریال را انتخاب کنید. کردیت هنگام ساخت کسر می‌شود = قیمت پکیج × تعداد کدها. هر کد با یک لاین مخصوص خودش می‌آید که تا زمان فعال‌سازی قفل است.

حروف بزرگ و ارقام بدون نویسه‌هایی که به‌راحتی با هم اشتباه می‌شوند (0، O، 1، I)؛ یا فقط ارقام. اگر مشتری با حروف کوچک تایپ کند باز هم پذیرفته می‌شود.

یک دستگاه. کد به اولین دستگاهی که آن را فعال می‌کند نود می‌خورد؛ دستگاه دیگری که همان کد را وارد کند رد می‌شود. آن دستگاه هر چند بار بخواهد می‌تواند کد را وارد کند، مشخصات ورود لاین تغییر نمی‌کند.

روی آن کد Reset device را بزنید؛ سپس دستگاه جدید می‌تواند آن را فعال کند. زمانی به دوره اضافه نمی‌شود.

وارد کردن پشت‌سرهم چند کد اشتباه متفاوت باعث می‌شود آدرس IP برای مدتی مسدود شود (SEC-08).

در صفحه Active Codes کد را تیک بزنید، عملیات Extend (days) را انتخاب کنید و تعداد روز را وارد کنید. فقط به کد فعال‌شده روز اضافه می‌شود (کد استفاده‌نشده هنوز دوره‌اش شروع نشده)؛ کدی که هنوز معتبر است از تاریخ انقضای فعلی و کد منقضی‌شده از همین الان تمدید می‌شود. این عملیات کردیت کسر نمی‌کند، بنابراین فقط ادمین می‌تواند از آن استفاده کند: ریسلر لاین مربوط به کد را مانند هر لاین دیگر با یک پکیج و قیمت آن تمدید می‌کند (Lines ← Renew، یا renew_line در API ریسلر). اگر کردیت اشتباهی کسر شده باشد، پشتیبانی آن را با تنظیم کردیت اصلاح می‌کند، نه با تمدید رایگان. API ادمین: extend_active_code.

کد استفاده‌نشده‌ای که ریسلر ساخته: کاملاً بازپرداخت می‌شود، با یک ردیف در دفتر کردیت. کد فعال‌شده: بازپرداخت ندارد.

صفحه Batches برای هر دسته مجموع / آماده / فعال‌شده / غیرفعال را نشان می‌دهد و یک فایل TXT (هر خط یک کد) خروجی می‌دهد. عملیات گروهی: فعال کردن، غیرفعال کردن، ریست دستگاه، حذف.

بله، مثل هر لاینی که با آن پکیج فروخته شده: تعداد اتصال، فرمت‌های خروجی، بوکه‌ها، قفل دستگاه، ریستریمر و همچنین کشور اجباری پکیج (SEC-07). مشتری‌ای که کد را از کشوری خارج از فهرست مجاز فعال کند می‌تواند آن را فعال کند اما هنگام پخش رد می‌شود.

تعداد دستگاه‌هایی است که همزمان با یک لاین تماشا می‌کنند. ۰ = نامحدود. باز کردن دوباره کانالی که همین الان از همان دستگاه تماشا می‌کنید اتصال دیگری حساب نمی‌شود.

به‌طور پیش‌فرض: اتصال جدید وارد می‌شود و قدیمی‌ترین اتصال بسته می‌شود (اتصال از همان دستگاه و سپس از همان IP ترجیح داده می‌شود). پلیر بسته‌شده ظرف حدود ۳۰ ثانیه متوقف می‌شود. مدیر می‌تواند به‌جای بستن اتصال قدیمی، رد کردن اتصال جدید را انتخاب کند.

وقتی مدیر آن را روشن کرده باشد: تا زمانی که یک لاین از یک IP تماشا می‌شود، اتصال زنده از IP دیگر رد می‌شود. این قانون را می‌توان به لاین‌های با اتصال کم محدود کرد (مثلاً لاین‌های با ۱ اتصال؛ لاین با اتصال نامحدود فقط وقتی آستانه ۰ باشد مقید می‌شود). با روشن بودن Match The Address By Network، آدرس‌های یک شبکه /24 (در IPv6: /64) یک بیننده حساب می‌شوند. این ابزاری علیه اشتراک‌گذاری حساب است.

وقتی گروه Allow Line Restrictions را روشن دارد: فیلد Allowed IPs (یک IP، یک محدوده CIDR یا یک نام دامنه، هر کدام در یک خط؛ دامنه هنگام اتصال بررسی می‌شود، پس IP پویا هم کار می‌کند) و Allowed User-Agents. خالی = همه مجاز. توجه: این محدودیت‌ها در پخش مسدود می‌کنند؛ برنامه همچنان وارد می‌شود و فهرست کانال‌ها را نشان می‌دهد.

لاین ارائه‌دهنده اینترنت اولین اتصال خود را به خاطر می‌سپارد و استفاده از ارائه‌دهنده دیگر را رد می‌کند. وقتی مشتری ارائه‌دهنده را عوض کرد، قفل ISP را خاموش و دوباره روشن کنید تا مورد جدید ثبت شود. روی دستگاه‌های MAG اعمال نمی‌شود.

لاین را به اولین ست‌تاپ‌باکسی که وارد می‌شود (شماره سریال، شناسه دستگاه) نود می‌زند؛ دستگاه دیگر رد می‌شود. توسط پکیج تعیین می‌شود.

یک لاین فقط از کشور اجباری خود می‌تواند متصل شود (ALL = هر جا). وقتی خالی باشد، فهرست کلی کشورهای مجاز پنل اعمال می‌شود. مشتری‌ای که به خارج سفر می‌کند یا از VPN استفاده می‌کند ممکن است به همین دلیل رد شود.

• خودکار: ورودهای ناموفق از یک IP با نام‌های کاربری / کدهای فعال‌سازی متفاوت بسیار در زمان کوتاه، یا سیل درخواست‌ها. مسدودسازی خودکار پس از مدتی که مدیر تنظیم کرده (به‌طور پیش‌فرض ۶۰ دقیقه) خودش برداشته می‌شود.
• دستی: مدیر IP / محدوده IP را مسدود کرده؛ این منقضی نمی‌شود.

تا زمانی که یک IP مسدود است، هیچ لاینی نمی‌تواند از آن متصل شود. اشتباه تایپ کردن مکرر همان نام کاربری باعث مسدودسازی نمی‌شود.

مدیر می‌تواند بر اساس User-Agent (برنامه)، ارائه‌دهنده اینترنت (ISP) و ASN (مثلاً محدوده‌های هاستینگ / VPN) مسدود کند. لاینی که مدیر برایش «bypass UA» را روشن کرده، فهرست مسدودی برنامه‌ها را رد می‌کند.

لاینی برای یک شریک که استریم‌ها را می‌کشد تا دوباره توزیع کند. از محدودیت اتصال، قانون IP دوم، پایان خودکار نشست‌های طولانی و مسدودسازی ASN معاف است. توسط پکیج / مدیر تعیین می‌شود؛ برای بینندگان عادی در نظر گرفته نشده است.

مدیر می‌تواند حداکثر مدت یک نشست پیوسته را تنظیم کند؛ پس از آن نشست بسته می‌شود و مشتری برای ادامه پخش را می‌زند. نشستی که حدود ۹۰ ثانیه سیگنال را از دست بدهد هم بسته حساب می‌شود.

• صفحه Theft Detection (اگر گروه مجوز داشته باشد): لاین‌ها را بر اساس تعداد فیلم‌ها / قسمت‌های متفاوت تماشاشده در ۱ ساعت / ۲۴ ساعت / ۷ روز رتبه‌بندی می‌کند، همراه با تعداد IPهای متفاوت — لاینی با مقدار غیرعادی بالا مشکوک است.
• صفحه فعالیت لاین: IPها و دستگاه‌های در حال استفاده را نشان می‌دهد.
• چه باید کرد: رمز عبور لاین را تغییر دهید (PLAY-08)، محدودیت IP / قفل ISP را روشن کنید، یا لاین را غیرفعال کنید.

وقتی گروه شما Can Create Sub-Resellers را روشن دارد و دست‌کم یک گروه در Groups for sub-resellers باشد. هر ساخت، هزینه ساخت (کردیت) تنظیم‌شده روی گروه را کسر می‌کند. درخت ریسلرها حداکثر ۵ سطح عمق دارد.

شما گروهی را از فهرستی که مدیر مجاز کرده انتخاب می‌کنید؛ آن گروه مجوزها، پکیج‌های قابل فروش و سهمیه تریال زیرریسلر را تعیین می‌کند.

ایمیل، نام، رمز عبور، وضعیت، گروه (از فهرست)، یادداشت‌ها، انتقال / پس گرفتن کردیت، و همه لاین‌های زیر دست او. نقش یا مالک او را نمی‌توانید تغییر دهید.

هیچ چیز: هر حساب فقط آنچه را زیر خودش است می‌بیند، هرگز سطوح بالاتر یا شاخه‌های دیگر را.

گروه باید Can Delete Users را روشن داشته باشد. کردیت باقی‌مانده، لاین‌ها و حساب‌های فرزند به حسابی که حذف می‌کند منتقل می‌شوند. لاین‌های مشتریان به کار خود ادامه می‌دهند. داده‌های شخصی حساب حذف‌شده (نام کاربری، ایمیل، نام، رمز عبور، کلیدهای API، یادداشت‌ها) پاک می‌شود؛ آن نام کاربری و ایمیل دوباره قابل استفاده است.

وقتی مدیر ایمیل خوش‌آمدگویی را فعال کرده باشد: حساب جدید نام ورود و پیوند ورود را دریافت می‌کند. ایمیل هرگز رمز عبور را ندارد — رمز را خودتان برایشان می‌فرستید.

برای بازچینی، تغییر نام یا پنهان کردن دسته‌هایی (زنده، فیلم، سریال، رادیو) که مشتری در برنامه می‌بیند — برای هر لاین، بدون دست زدن به دسته‌های خود پنل.

همه محتوای آن دسته هم از برنامه و پلی‌لیست لاین‌هایی که از آن قالب استفاده می‌کنند پنهان می‌شود.

بله، بلافاصله برای همه لاین‌هایی که قالب به آن‌ها اختصاص دارد. وقتی قالبی حذف شود، لاین‌هایش به چیدمان پیش‌فرض برمی‌گردند.

دیدن: قالب‌های خودتان و حساب‌های زیر دستتان، قالب‌های سیستمی و قالب‌های اشتراکی سطوح بالاتر. ویرایش: فقط قالب‌های خودتان و زیر دستتان. برای تنظیم یک قالب سیستمی، آن را کپی کنید و نسخه کپی را ویرایش کنید.

ترتیب سفارشی دسته‌ها روی بخش فیلم / سریال پلی‌لیست M3U اعمال نمی‌شود (نام‌ها و پنهان‌سازی همچنان اعمال می‌شوند). برنامه‌هایی که از Xtream API استفاده می‌کنند همه چیز را می‌گیرند.

برای اینکه سیستم خودتان (فروشگاه وب، صورتحساب، بات) بدون باز کردن داشبورد لاین / زیرریسلر بفروشد و مدیریت کند. آدرس: {API}/reseller/v1، با هدر X-API-Key احراز هویت می‌شود. مستندات کامل در /docs/ روی سرور API است.

صفحه API Key. کلید یک بار، هنگام ساخت نشان داده می‌شود — بلافاصله کپی‌اش کنید. اگر گمش کردید، کلید جدیدی بسازید (کلید قدیمی از کار می‌افتد).

بهتر است نه. برای هر سیستم یک کلید اضافی بسازید: نامی بدهید، IPها / CIDRهایی را که می‌توانند از آن استفاده کنند محدود کنید، در صورت نیاز آن را فقط‌خواندنی کنید (فقط فهرست و مشاهده) و بدون تأثیر بر کلیدهای دیگر جداگانه لغوش کنید.

هر قانون داشبورد (گروه، قیمت اختصاصی، سهمیه تریال، دامنه درخت) دقیقاً به همان شکل از طریق API هم اعمال می‌شود.

خیر، به شرطی که برای همان تراکنش همان request_id را بفرستید: سیستم نتیجه قبلی را برمی‌گرداند. request_id یک تمدید به آن لاین نود خورده است: استفاده از آن برای لاین دیگر خطای تعارض (HTTP 409) برمی‌گرداند و لاین دیگر تغییر نمی‌کند — برای هر تراکنش یک request_id جدید بسازید.

صفحه API Key جدولی از فراخوانی‌های اخیر API (۳۰ روز) دارد: اکشن، نتیجه، کد خطا، آدرس فراخواننده، نام کانکتور. پارامترها هرگز ثبت نمی‌شوند.

پنل وقتی اتفاقی می‌افتد به سیستم شما خبر می‌دهد، تا مجبور نباشید مدام بپرسید. رویدادها: line.created، line.renewed، line.enabled، line.disabled، line.deleted، line.expiring (۳ روز قبل)، line.expired، credits.low (زیر آستانه‌ای که تعیین کرده‌اید). آدرس دریافت‌کننده باید https و از اینترنت در دسترس باشد.

هر اعلان امضای X-Xtream-Signature: sha256=HMAC(secret, timestamp.body) را دارد؛ secret یک بار، هنگام ساخت endpoint نشان داده می‌شود. وب‌هوک هرگز رمز عبور ندارد.

هر اعلان ۳ بار تلاش می‌شود؛ endpointی که ۲۰ ارسال پشت‌سرهم ناموفق باشد خاموش می‌شود. سمت خودتان را درست کنید، از 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/ یا یک کانکتور آماده (CON-02) استفاده کنید.

با سیستم و درگاه پرداخت خودتان. پنل پرداخت را پردازش نمی‌کند. کانکتور سیستم فروشگاه شما را به پنل وصل می‌کند: مشتری در سمت شما پرداخت می‌کند → کانکتور 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)، بعضی فقط هسته‌شان آزمایش شده. خط «how it was tested» را بخوانید و پیش از فروش واقعی در محیط آزمایشی امتحان کنید.

کانکتور فقط Reseller API را با کلید API خودتان فراخوانی می‌کند — دقیقاً همان کاری را می‌تواند بکند که شما می‌توانید، نه بیشتر. کد منبع برای خواندن و بررسی شما باز است. به هر کانکتور یک کلید مخصوص با محدودیت IP بدهید (API-03).

لاین‌ها (ساخت، تمدید، تغییر پکیج، تعلیق، حذف) و حساب‌های زیرریسلر همراه با کردیت.

خودتان با Reseller API (API-01) و وب‌هوک‌ها یکپارچه کنید، یا از راه کانال پشتیبانی درخواست بفرستید.

خیر. حذف‌شده یعنی از بین رفته: مشخصات لاین (نام کاربری، رمز عبور، تماس، یادداشت‌ها)، تاریخچه اتصال آن (IPها، دستگاه‌ها، آنچه تماشا شد)، ست‌تاپ‌باکس‌های وصل به لاین و کد فعال‌سازی آن. سطل بازیافت، قابلیت بازیابی یا API بازیابی وجود ندارد. وقتی مشتری برگشت، لاین جدیدی بسازید.

فقط یک رکورد آماری ناشناس برای اپراتور (مشتری جدید یا برگشتی، کدام پکیج‌ها محبوب‌اند). هیچ چیز قابل خواندنی درباره مشتری ندارد و هیچ ریسلر، کانکتور یا API به آن دسترسی ندارد.

خیر. بکاپ‌های پایگاه داده فقط برای بازسازی سیستم پس از یک حادثه وجود دارند و نزد اپراتور هستند؛ برای لغو یک حذف استفاده نمی‌شوند. بکاپ‌های قدیمی چرخانده و حذف می‌شوند، پس داده حذف‌شده از آن‌ها هم محو می‌شود.

رمز عبور لاین باید در برنامه‌ها تایپ شود و بخشی از لینک پلی‌لیست است، پس پنل آن را برای مالک لاین خوانا نگه می‌دارد. رمزهای حساب‌های پنل فقط به‌صورت هش ذخیره می‌شوند.

شما، حساب‌های بالادستی شما در درخت، و مدیر. ریسلرهای دیگر و سطوح زیر شما نمی‌بینند.

هرگز. مشتریان یک لاین متعلق به ریسلر هستند؛ شما از طریق سیستم خودتان با آن‌ها تماس می‌گیرید.

به دو شکل: یک ایمیل خلاصه روزانه از لاین‌های نزدیک به انقضا (اگر مدیر فعال کرده باشد؛ به‌طور پیش‌فرض ۳ روز قبل)، و وب‌هوک‌های line.expiring / line.expired برای سیستم شما.

معمولاً یکی از قفل‌های پخش (ردیف‌های ۵ تا ۹ در 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).

ایمیل فقط وقتی ارسال می‌شود که مدیر سرور ایمیل را پیکربندی و آن نوع پیام را فعال کرده باشد؛ حساب باید آدرس ایمیل واقعی داشته باشد. پوشه اسپم را بررسی کنید.