این راهنماها مفاهیم یک صنعت را روی اشیایی که پلتفرم امروز دارد (بوکه‌ها، لاین‌ها، بسته‌ها، حساب‌های پارتنر، نودها، API) نگاشت می‌کنند. این‌ها نگاشت‌های مفهومی‌اند، نه قابلیت‌های مخصوص صنعت، و حساب پارتنر یک حساب تفویضی است، نه tenant ایزوله.
نگاشت مفهومی
در پنل چیزی به نام واحد یا ساکن نیست. جدول می‌گوید کدام شیء چه نقشی دارد؛ بخش‌های زیر آن‌ها را به همین ترتیب راه می‌اندازند.
| در صنعت شما | روی پلتفرم | کجا در پنل |
|---|---|---|
| حساب مدیر ملک | حساب پارتنر (ریسلر): داشبورد تفویضی با کردیت، مجوزها و لاین‌های خودش | Users ← افزودن ریسلر؛ Groups برای مجوزهای آن |
| فهرست کانال | بوکه: مجموعه‌ای نام‌دار از کانال‌ها، فیلم‌ها یا سریال‌ها که یک بسته می‌دهد | Bouquets، از Streams و Movies / Series |
| کانال یا کانال اطلاعات | کانال زنده: یک استریم با منابع، EPG و فرمت‌های خروجی‌اش | Streams ← افزودن استریم زنده (URL منبع یا RTMP push) |
| ویدیوهای خوش‌آمدگویی و اطلاعیه | کاتالوگ VOD: فیلم و سریال با فصل و قسمت، دسته‌بندی‌ها و اطلاعات متادیتا | Movies و Series، یا کار ingest VOD |
| دسترسی واحد | لاین: یک دسترسی با بسته، بوکه‌ها، انقضا، محدودیت اتصال و خروجی‌هایش | Lines ← افزودن، یا کدهای فعال‌سازی، یا Reseller API |
| دوره اجاره یا سکونت | تاریخ انقضای لاین، که با بسته، کردیت یا API تمدید می‌شود | تاریخ انقضای لاین و مدت بسته |
| نود ساختمان | نودهای پخش: سرورهای edge ثبت‌شده از پنل، یکی برای هر سایت یا ساختمان | Servers ← افزودن نود، نصب‌شده با SSH |
پیش‌نیازها
آنچه پیش از نصب باید داشته باشید.
- یک سرور برای شرکت مدیریت (Ubuntu 22.04 یا 24.04)، نصب‌کننده و یک سرور برای هر ساختمان که به شبکه ساکنان دسترسی داشته باشد.
- فیدهای کانالی که مجتمع می‌تواند بازپخش کند (URLهای pull یا RTMP)، اطلاعیه‌ها و ویدیوهای خوش‌آمدگویی شرکت مدیریت و دستگاه‌های ساکنان (ستاپ‌باکس، تلویزیون هوشمند با برنامه پخش‌کننده یا مرورگر).
- تصمیم درباره انواع خانه (استاندارد، سالمند، دانشجو) و اینکه چه کسی در شرکت مدیریت لاین‌ها را باز و تمدید می‌کند.
استقرار زیرساخت
سرور مرکزی، بعد یک نود برای هر ساختمان.
- نصب‌کننده را روی سرور مرکزی اجرا کنید و URL پایه پخش را روی آدرسی بگذارید که ساختمان‌ها به آن می‌رسند.
- فیدهای کانال را زیر Streams و اطلاعیه‌ها را زیر Movies اضافه کنید و در پخش‌کننده وب بررسی کنید.
- برای هر ساختمان از Servers یک نود ثبت کنید؛ پنل آن را با SSH نصب می‌کند، یا نود با کد یک‌بارمصرف ثبت می‌شود، و ساکنان آن ساختمان را به آن هدایت می‌کند.
- مدیر ملک را زیر Users → افزودن ریسلر با گروهی اضافه کنید که لاین‌ها را مجاز می‌کند و تغییر کاتالوگ را نه.
سازمان‌دهی محتوا
فهرست کانال برای هر نوع خانه.
- از کانال‌های هر نوع خانه برای هر فهرست یک بوکه بسازید، و یک بوکه برای اطلاعات شرکت مدیریت.
- بوکه اطلاعات را به هر بسته اضافه کنید تا هر ساکن اطلاعیه‌ها را بگیرد.
- برای هر نوع خانه یک بسته با بوکه‌هایش و مدتی متناسب با اجاره یا دوره سکونت بسازید.
- کانال‌ها را مرتب کنید و لوگو بدهید تا منوی تلویزیون خوب خوانده شود.
پیکربندی پارتنر (ریسلر)
مدیر ملک به‌صورت حساب تفویض‌شده.
- گروهی با مجوزهای محدود به لاین‌ها بسازید، بدون دسترسی به کاتالوگ یا سرورها.
- هر مدیر ملک را با آن گروه، بسته‌های خانه‌هایش و موجودی کردیت به‌عنوان ریسلر اضافه کنید.
- مدیر چند ساختمان می‌تواند برای هر ساختمان یک زیرریسلر اضافه کند که هر کدام خانه‌ها و کردیت خودش را دارد.
پیکربندی واحد (لاین)
یک لاین برای هر واحد، با شماره‌اش نام‌گذاری می‌شود.
- برای هر واحد زیر Lines → افزودن یک لاین بسازید که شماره واحد نامش و بسته آن نوع خانه است.
- حداکثر اتصال را روی تعداد تلویزیون‌های خانه بگذارید.
- وقتی ساکن باید کد کوتاهی را روی دستگاه وارد کند، به‌جای رمز عبور از کد فعال‌سازی استفاده کنید.
- دستگاه را یک بار پیکربندی کنید (Xtream Codes API یا M3U با اطلاعات لاین، یا پورتال MAG یا Enigma2)؛ اطلاعات ورود تا وقتی به لاین اطلاعات تازه داده نشده با واحد می‌ماند.
ویدیوهای خوش‌آمدگویی و اطلاعیه
ویدیوهای شرکت مدیریت به‌صورت درخواستی.
- ویدیوی خوش‌آمدگویی، قوانین ساختمان و راهنمای تعمیر و نگهداری را با دسته‌بندی برای هر موضوع به‌صورت فیلم آپلود کنید.
- آن‌ها را در بوکه اطلاعات بگذارید تا هر بسته شاملشان شود.
- وقتی اطلاعات تغییر می‌کند ویدیو را از پنل جایگزین کنید؛ ساکنان نسخه جدید را فوراً می‌بینند.
کانال‌ها و کانال اطلاعات
فهرست کانال و کانال اطلاعیه به‌صورت استریم زنده.
- هر کانال دارای مجوز را زیر Streams با فیدش اضافه کنید، و یک منبع EPG تا راهنمای روی تلویزیون برنامه‌ها را نشان دهد.
- کانال اطلاعات را به‌صورت استریم زنده اضافه کنید که انکودری با RTMP یا یک منبع تکرارشونده تغذیه‌اش کند، و در بوکه اطلاعات بگذارید.
- کانال‌های دارای محدودیت قلمرو را در بوکه‌هایی نگه دارید که فقط بسته‌های درست می‌دهند.
ورود، خروج و انقضا
دوره سکونت به‌عنوان اعتبار لاین.
- لاین در پایان دوره بسته‌اش منقضی می‌شود؛ برای هر دوره جدید اجاره آن را با بسته یا یک کردیت تمدید کنید.
- وقتی ساکنی می‌رود لاین را غیرفعال کنید؛ ساکن بعدی آن را با اطلاعات ورود تازه دوباره فعال می‌کند، پس چیزی نزد خانوار قبلی نمی‌ماند.
- سامانه مسکن یا مدیر را به وب‌هوک‌ها مشترک کنید تا لاین‌هایی که در شرف انقضا یا منقضی‌اند را ببیند.
یکپارچگی با سامانه مسکن یا صورت‌حساب
سامانه‌ها دسترسی را باز می‌کنند؛ پخش‌کننده پخش می‌کند.
- برای سامانه مسکن یا صورت‌حساب یک کلید Reseller API بسازید؛ create_line، renew_line، enable_line و disable_line را صدا می‌زند و با هر نوشتن یک شناسه درخواست می‌فرستد.
- وقتی ساکنان بسته‌های اضافه را آنلاین می‌خرند از کانکتور تجارت استفاده کنید؛ هر سامانه دیگری از Reseller API و وب‌هوک استفاده می‌کند.
- ورود یکپارچه برای بینندگان نیست: ساکن با اطلاعات لاین وارد پخش‌کننده می‌شود.
ملاحظات امنیتی
سرویس را داخل مجتمع نگه دارید.
- پنل را پشت ریورس‌پراکسی با TLS ارائه دهید و TRUSTED_PROXIES را تنظیم کنید تا گزارش ممیزی و قواعد IP آدرس‌های واقعی را ببینند.
- ورود دومرحله‌ای برای هر حساب مدیریت؛ مدیران ملک گروه مجوزی محدود به لاین‌ها می‌گیرند.
- سقف اتصال برای هر لاین، لینک‌های پخش امضاشده و منقضی‌شونده، و بستن به آدرس جایی که دستگاه‌ها آدرس ثابت دارند.
- پشتیبان‌گیری رمزگذاری‌شده پایگاه داده با نسخه بیرونی را فعال کنید؛ اطلاعات ورود لاین‌ها در آن است.
عیب‌یابی
بررسی‌های اولیه معمول.
- واحدی تلویزیون ندارد: بررسی کنید لاینش فعال و منقضی‌نشده است، سپس اطلاعات ورود دستگاه و آدرس پخش.
- ساختمانی عصرها بافر می‌کند: heartbeat نود ساختمان و اینکه ساکنانش به آن هدایت می‌شوند را بررسی کنید.
- کانالی برای یک نوع خانه نیست: بوکه‌های آن بسته را بررسی کنید.
- مدیر نمی‌تواند لاین بسازد: موجودی کردیت ریسلر، مجوزهای گروهش و بسته‌های اختصاص‌یافته به او را بررسی کنید.