مستندات

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 و 8 GB RAM برای چند صد بیننده؛ بیشتر بینندگان به شبکه بیشتری نیاز دارند تا CPU بیشتر، چون کانال‌ها کپی می‌شوند و دوباره کدگذاری نمی‌شوند.
  • دیسک برای کتابخانه و بازپخش: یک فیلم 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) و در صورت تمایل یک منبع پشتیبان اضافه کنید. کانال «بر اساس درخواست» وقتی اولین بیننده آن را باز کند شروع می‌شود و یک دقیقه پس از خروج آخرین بیننده متوقف می‌شود؛ برای کانال‌هایی که همیشه باید اجرا شوند، حالت درخواستی را خاموش کنید.

  • وضعیت: در حال پخش، بی‌کار، یا صفحه بدون سیگنال (منبع پاسخ نمی‌دهد؛ بینندگان صفحه شما را می‌بینند).
  • شماره، دسته، لوگو و شناسه راهنما همان چیزی است که برنامه‌ها نشان می‌دهند.
  • وارد کردن M3U، کانال‌های زیادی را یک‌جا از یک فایل یا نشانی اضافه می‌کند.

محتوا

صفحه بدون سیگنال

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

محتوا

منابع و وارد کردن‌ها

منابع حساب‌های ارائه‌دهنده (Xtream Codes) را نگه می‌دارد که حقوق آن‌ها متعلق به شماست. سرور، نام کاربری و رمز عبور را اضافه کنید؛ SIVO ورود را بررسی می‌کند و کانال‌های زنده، فیلم‌ها و سریال‌های حساب را می‌خواند. مسئولیت آنچه اضافه می‌کنید با شماست: شرایط و سیاست را ببینید.

  • یک حساب را باز کنید، بر اساس نوع یا دسته فیلتر کنید، جستجو کنید، عنوان‌های موردنظر را علامت بزنید و گزینه «وارد کردن انتخاب‌شده‌ها» را انتخاب کنید.
  • فیلم‌ها و قسمت‌ها از طریق یک صف، یک فایل در هر زمان روی سرور شما دانلود می‌شوند، بنابراین حسابی که فقط یک اتصال را مجاز می‌داند هرگز دو بار استفاده نمی‌شود. پس از دانلود در برنامه‌ها ظاهر می‌شوند.
  • سریال همراه با تمام فصل‌ها و قسمت‌هایی که ارائه‌دهنده دارد، با پوستر و خلاصه داستان وارد می‌شود.
  • کانال‌های زنده‌ای که از یک حساب وارد شده‌اند، تا زمانی که کسی آن‌ها را تماشا می‌کند از آن دریافت می‌شوند؛ هر کانالی که هم‌زمان تماشا شود، یکی از اتصال‌های حساب را مصرف می‌کند.

فقط محتوایی را وارد کنید که حق توزیع آن را دارید.

محتوا

فیلم‌ها

  • یک فایل بارگذاری کنید، یا نشانی آن را بدهید و گزینه «ذخیره روی این سرور» را انتخاب کنید تا دانلود شود.
  • وضعیت نشان می‌دهد: در صف، در حال دانلود با درصد آن، آماده یا خطا.
  • داستان، بازیگران، کارگردان، پوستر و تصویر پس‌زمینه با دست یا از TMDB (کلید TMDB را در تنظیمات اضافه کنید).
  • زبان‌های صوتی و فایل‌های زیرنویس را اضافه کنید؛ SIVO آن‌ها را در یک فایل قرار می‌دهد تا برنامه‌ها آن‌ها را در منوهایشان فهرست کنند.

محتوا

سریال‌ها

  • سریال‌ها → یک سریال → فصل‌های آن → قسمت‌های یک فصل؛ هر سطح فهرستی است که می‌توانید در آن جستجو کنید، مرتب کنید و به‌صورت گروهی روی آن اقدام کنید.
  • فایل‌هایی با نام S01E01، S01E02… شماره فصل و قسمت خود را به‌طور خودکار می‌گیرند.
  • نام فصل‌ها، داستان‌ها و پوسترها در برنامه‌ها نمایش داده می‌شوند.

محتوا

بازپخش

روزهای بازپخش (1 تا 30) را برای یک کانال تنظیم کنید. SIVO آن را در قطعه‌های 10 ثانیه‌ای ضبط می‌کند، برنامه‌های گذشته را از راهنما در برنامه‌ها پیشنهاد می‌دهد و ضبط‌هایی که قدیمی‌تر از تنظیم هستند حذف می‌شوند. بخش ضبط‌ها میزان استفاده هر کانال از دیسک را نشان می‌دهد.

محتوا

راهنمای برنامه

نشانی‌های راهنمای XMLTV را در راهنمای برنامه اضافه کنید. هر 6 ساعت دریافت می‌شوند و با شناسه راهنما به کانال‌ها تطبیق داده می‌شوند. برنامه‌های مشترکان راهنما را با پیوند اختصاصی خود دریافت می‌کنند.

مشترکین

بسته‌ها

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

مشترکین

مشترکین

  • نام کاربری و رمز عبور (در برنامه استفاده می‌شود)، نام کامل، تلفن، بسته، انقضا و تعداد دستگاه‌های هم‌زمان.
  • بخش «دسترسی» نشانی سرور، ورود، پیوندهای 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 کاربر را پوشش می‌دهد؛ ثبت‌شده روی طرح رایگان، 100. طرح‌های پولی: Lite 500، Plus 1,000، Pro 2,000، Mega 5,000، Max 10,000 و Unlimited. قیمت‌ها را ببینید.

طرح را از سیستم → لایسنس یا از داشبوردتان درخواست کنید؛ اولین درخواست یک حساب یک ماه رایگان است. اگر لایسنس پولی منقضی شود ابتدا هشدار داده می‌شود و سپس دوره مهلت؛ هیچ داده‌ای هرگز حذف نمی‌شود.

در حال بهره‌برداری

Cloudflare Tunnel

سیستم → Cloudflare Tunnel پنل (و در صورت انتخاب شما، درگاه پخش) را روی دامنه خودتان از طریق HTTPS قرار می‌دهد، بدون باز کردن پورت.

منابع

REST API

سیستم → API توکن‌هایی با دامنه دسترسی می‌سازد. 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 متن درخواست. ارسال‌های ناموفق دوباره تلاش می‌شوند.

منابع

عیب‌یابی

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