ComusThumbz Documentation
Admin Login

Wymagania dotyczące układu

W przypadku stron internetowych opartych na wideo dla najlepszych wyników należy mieć główny serwer (dla ComusThumbz), serwer pamięci masowej i 1 lub więcej serwerów konwersji wideo. Dla serwerów pamięci masowej i covnersion można korzystać z usług, które są dostępne, wystarczy śledzić linki w naszym admin.

Co ta strona obejmuje

Ten przewodnik wyjaśnia, co serwer WWW musi zainstalować przed uruchomieniem ComusThumbz. Jeśli już zainstalowałeś ComusThumbz pomyślnie, serwer prawdopodobnie spełnia wszystkie te wymagania. Użyj tego przewodnika podczas konfiguracji nowego serwera lub rozwiązywania problemów.

Uwaga: Jeśli używasz dostawcy hostingu jak cPanel, HestiaCP lub Plesk, wiele z tych wymagań jest wstępnie skonfigurowanych dla Ciebie. Jednak niektóre ustawienia (szczególnie do przetwarzania wideo) mogą wymagać dostosowania.

Czy spełniam wymagania?

Szybkie sprawdzenie

Większość dostawców usług hostingowych obsługujących nowoczesne strony internetowe PHP może uruchomić ComusThumbz. Potrzebujesz:

  • Serwer Linux (Ubuntu, Debian, CentOS lub podobne)
  • PHP wersja 8.3 lub nowsza
  • Baza danych MySQL lub MariaDB
  • Co najmniej 2 GB pamięci RAM (4GB + zalecane dla stron wideo)
  • Zainstalowane FFmpeg (wymagane do przetwarzania wideo)
  • IonCube
Ostrzeżenie: ComusThumbz NIE działa na dzielonym hostingu, który blokuje narzędzia do przetwarzania wideo. Dla uzyskania najlepszych wyników potrzebny jest VPS (Virtual Private Server) lub serwer dedykowany.

Co ComusThumbz może zrobić

Kiedy serwer spełnia wszystkie wymagania, będziesz miał dostęp do następujących funkcji:

  • Wysyłanie i zarządzanie wideo z automatyczną generacją miniaturek i wieloma opcjami jakości
  • Tworzenie galerii zdjęć z przetwarzaniem obrazów i masowymi przesyłaniami
  • Host na żywo strumienie kamer wykorzystanie technologii wideo w czasie rzeczywistym
  • Monetyzacja twórcy w tym wskazówki, subskrypcje i zawartość pay- per- view
  • Wiele języków obsługa 25 języków z arabskiego na wietnamski
  • Przetwarzanie płatności ze wsparciem dla Stripe, PayPal, CCBill i 7 innych dostawców
  • Przechowywanie CDN do przenoszenia plików wideo do BunnyCDN, Wasabi, Backblaze i innych usług
  • Zaawansowana analityka śledzenie widoków, kliknięć, zarobków i zachowania użytkownika
  • Narzędzia zasilane prądem elektrycznym pomóc przeglądać i organizować treści szybciej
Uwaga: Nie musisz używać każdej funkcji. Na przykład, jeśli nie hosting strumieni na żywo, można pominąć usprawnienie konkretnych etapów konfiguracji.

Typ serwera: Co działa najlepiej

Typ hostinguNadaje sięUwagi
VPS (wirtualny serwer prywatny)Małe i średnie obiektyNajlepsza równowaga kosztów i kontroli
Serwer dedykowanyDuże obiekty o dużym ruchuMaksymalna skuteczność
Serwer chmur (DigitalOcean, Linode, Vultr)Skalowalne stronyŁatwy do uaktualnienia jak rośnie

Minimalne specyfikacje serwera:

  • 2 rdzenie procesora (4 + zalecane)
  • 2 GB RAM (4 GB + zalecane)
  • 10 GB wolnego miejsca na dysku (więcej, jeśli przechowywanie wideo lokalnie)
  • Ubuntu 22.04 lub Debian 12
Ostrzeżenie: Dzielone Hosting NIE jest zalecane, ponieważ:
  • Narzędzia do przetwarzania wideo są zazwyczaj blokowane
  • Za mało pamięci do przesyłania wideo
  • Nie można uruchomić zadań w tle potrzebnych do przetwarzania
  • Brak kontroli nad ustawieniami serwera


Jeśli jesteś obecnie na współdzielonym hostingu, musisz uaktualnić do VPS, aby korzystać z funkcji wideo.

Wymagania dotyczące oprogramowania

Web Server

Twój serwer potrzebuje albo Apache lub Nginx do obsługi stron internetowych.

Apache (najczęściej):

  • Musi wspierać .htaccess pliki dla czystych adresów URL
  • Wersja 2.4 lub nowsza

Nginx:

  • Wersja 1.18 lub nowsza
  • Wymaga ręcznej konfiguracji dla czystych adresów URL

Wskazówka: Jeśli używasz panelu kontrolnego jak cPanel lub HestiaCP, serwer internetowy jest już skonfigurowany dla Ciebie.

Wersja PHP

Wymagane: PHP 8.3 lub nowsze

ComusThumbz wykorzystuje nowoczesne funkcje PHP, które działają tylko w wersji 8.3 i powyżej. Starsze wersje (PHP 7.x lub PHP 8.0- 8.2) nie będą działać.

Sprawdzanie wersji PHP:

Jeśli masz dostęp do serwera, uruchom:

php -v

Powinieneś zobaczyć coś takiego: PHP 8.3.x

Jeśli widzisz niższą wersję (np. 7.4 lub 8.0), musisz uaktualnić PHP przed zainstalowaniem ComusThumbz.

Baza danych

Wymagane: MySQL 5,7 + lub MariaDB 10,3 +

Zalecane: MySQL 8.0 + lub MariaDB 11.4 +

Baza danych przechowuje wszystkie treści, użytkowników i ustawienia. Nowsze wersje zapewniają lepszą wydajność dla dużych stron.

Narzędzie przetwarzania wideo (FFmpeg)

Błąd: FFmpeg jest WYMAGANY dla funkcji wideo do pracy. Bez niego:
  • Przesłane filmy utknęły w "oczekujących" na zawsze
  • Nie generuje się miniatur ani podglądów
  • Filmy nie mogą być konwertowane na formaty strumieniowe

Co to jest FFmpeg?
FFmpeg jest narzędziem linii komendant, które konwertuje filmy do różnych formatów i tworzy miniatury. Działa w tle automatycznie, gdy użytkownicy przesyłają filmy.

Sprawdzanie, czy zainstalowano FFmpeg:

ffmpeg -version

Jeśli widzisz informacje o wersji, FFmpeg jest zainstalowany. Jeśli widzisz "polecenie nie znaleziono", będziesz musiał zainstalować go lub poprosić operatora hostingu, aby zainstalować go.


Ustawienia PHP, które wymagają dostosowania

Kilka ustawień PHP kontroluje, jak duże pliki można przesłać i jak długie przetwarzanie może być uruchomione. Zwykle należy je zwiększyć z wartości domyślnych.

Ważne ustawienia

UstawienieCo to robi?Zalecana wartość
pamięćgranicaIle pamięci PHP może używać512M
maxexecutionczasJak długo skrypty mogą działać600 sekund (10 minut)
uploadmaxfilesizeMaksymalny rozmiar wysyłania500M (lub większy)
postmaxrozmiarMaksymalny rozmiar formularza500M (to samo co wysyłanie)
Wskazówka: Jeśli używasz cPanel, możesz ustawić te ustawienia z Edytor multiPHP INIDla HestiaCP, przejdź do Serwer > Konfiguracja > PHP i edytować ustawienia tam.

Jak sprawdzić bieżące ustawienia

Utwórz wywołany plik phpinfo.php z tą zawartością:

Wyślij go na swoją stronę i odwiedź w przeglądarce (przykład: https://yoursite.com/phpinfo.php). Zobaczysz wszystkie ustawienia PHP. Szukaj powyższych nazw ustawień, aby zobaczyć bieżące wartości.

Ostrzeżenie: Usuń phpinfo.php po sprawdzeniu ustawień - ujawnia informacje o serwerze, które nie powinny być jawne.

Funkcje PHP, które muszą być włączone

Niektórzy dostawcy hostingów wyłączają niektóre funkcje PHP dla bezpieczeństwa. ComusThumbz potrzebuje tych funkcji do pracy:

FunkcjaDo czego służy?
exec()Uruchomienie FFmpeg do przetwarzania wideo
shellexec()Narzędzia do uruchamiania linii komend
fileputcontents()Zapisz pliki konfiguracyjne
mkdir()Tworzenie folderów do wysyłania
chmod()Ustawienie uprawnień do folderów

Jeżeli są wyłączone: Filmy nie przetwarzają się, wysyłanie nie powiedzie, a ustawienia nie mogą być zapisane.

Jak umożliwić im: Skontaktuj się z dostawcą hostingu lub edytuj php.ini jeśli masz dostęp do serwera. Szukaj linii zaczynającej się od disablefunctions = i usunąć którąkolwiek z funkcji wymienionych powyżej.


Automatyczne zadania tła (Cron Jobs)

Błąd: A cron job MUSZĄ być uruchomione lub witryna nie działa prawidłowo. Bez niego:
  • Filmy utknęły w "oczekujących"
  • Zyski nie są obliczane
  • Statystyki nie aktualizują

Czym jest Cron Job?

Praca cron jest automatyczne zadanie, które działa co minutę w tle. Zajmuje się przetwarzaniem wideo, uaktualnianiem statystyk i wykonywaniem innych zadań konserwacyjnych.

Ustawianie zadania Cron

Musisz ustawić jeden cron pracy, która działa co minutę:

Polecenie:

     php /path/to/your/site/ct/admin/cron/sitecron.php

Zastąp /path/to/your/site/ ze ścieżką instalacji.

Użytkownicy cPanel:

Idź do Zaawansowane > Cron Jobs

  1. Ustaw czas na (w każdej minucie)
  2. Wklej powyższe polecenie poprawną ścieżką
  3. Kliknij Dodaj nową pracę Cron

Użytkownicy HestiaCP:

  1. Zaloguj się przez SSH
  2. Biegnij: crontab -e
  3. Dodaj linię cron i zapisz

Sprawdzanie, czy działa:

  • Filmy powinny przejść z "oczekujących" do "aktywnych" w ciągu kilku minut od wysłania
  • Idź do Panel administracyjny > Cron Manager by zobaczyć ostatni raz


Certyfikat HTTPS / SSL

Ostrzeżenie: HTTPS jest zdecydowanie zalecane i wymagane dla:
  • Przyjmowanie płatności
  • SEO (ranking Google)
  • Zabezpieczenia przeglądarki

Większość nowoczesnych dostawców usług hostingowych oferuje darmowe certyfikaty SSL poprzez Zaszyfrujmy.

cPanel: Idź do Stan SSL / TLS i kliknij AutosSL aby otrzymać bezpłatny certyfikat

HestiaCP: Idź do Web > [domeny] > Edycja > SSL i włączyć szyfrowanie

Konfiguracja ręczna: Jeśli zarządzasz własnym serwerem, użyj Certbot:

sudo certbot --apache -d yourdomain.com

Sukces: Po zainstalowaniu SSL, Twoja strona będzie automatycznie przekierować z http:// do https://.

Planowanie przestrzeni magazynowej

Ile przestrzeni potrzebuję?

ZawartośćZalecana przestrzeń
Małe strony (do 1000 filmów)50GB z CDN
Średnia strona (do 10 000 filmów)500GB z CDN
Duża strona (100.000 + filmy)Wymagany CDN - nie przechowywać lokalnie
Wskazówka: Do przechowywania filmów należy używać sieci CDN (Content Delivery Network), takich jak BunnyCDN, Wasabi lub Backblaze. Dzięki temu Twoje miejsce na dysku serwera jest wolne i dostarcza wideo szybciej użytkownikom na całym świecie. ComusThumbz buduje wsparcie dla wszystkich głównych CDN.

Gdzie przechowywane są pliki

Po instalacji foldery te będą trzymały zawartość:

  • ct/uploads/videos/ - Wysłane pliki wideo
  • ct/uploads/images/ - Obrazy i miniatury
  • ct/cache/ - Pliki tymczasowe (mogą być rozliczone)
  • ct/logs/ - Rejestry systemów

Te foldery muszą być zapisywane przez serwer internetowy.


Wymogi dotyczące strumieniowania na żywo (nieobowiązkowo)

Uwaga: Potrzebne tylko, jeśli chcesz prowadzić na żywo strumienie kamer internetowych. Pomiń tę sekcję, jeśli nie używasz funkcji strumieniowania na żywo.

Live streaming wymaga Docker oraz LiveKit do zainstalowania na serwerze.

Co to jest Docker?
Docker jest narzędziem, które obsługuje LiveKit (oprogramowanie strumieniowe) w izolowanym pojemniku.

Co to jest LiveKit?
LiveKit obsługuje transmisję wideo w czasie rzeczywistym między nadawcami a widzami.

Wymagania dotyczące układu:

  • Silnik dokujący 20.10 lub nowszy
  • Porty otwarte: 7880, 7881 (TCP) i 50000- 50020 (UDP)
  • Oddzielny serwer polecany do strumieniowania o wysokim natężeniu ruchu

Wskazówka: Jeśli nie jest Ci wygodnie skonfigurować Docker, rozważyć korzystanie z zarządzanej usługi streaming zamiast, lub pomiń streaming na żywo całkowicie. Możesz nadal prowadzić nagrane filmy bez LiveKit.

Wspólne problemy i rozwiązania

Filmy pobyt "Oczekiwanie" Na zawsze

Co widzisz: Wysyłasz film, ale nigdy nie pojawia się na swojej stronie. W panelu administracyjnym pokazuje status "oczekujący".

Częste przyczyny:

  1. Robota Cron nie działa
  2. Nie zainstalowano FFmpeg
  3. Funkcje PHP wyłączone

Jak naprawić:

  1. Sprawdź, czy praca cron jest uruchomiona (zobacz Panel administracyjny > Cron Manager)
  2. Test FFmpeg: Uruchom ffmpeg -version przez SSH lub zapytaj hosta
  3. Zaznacz funkcje PHP: Utwórz plik testowy do weryfikacji exec() roboty
  4. Pomoc kontaktowa, jeśli problem nadal istnieje

Nie można przesłać dużych plików

Co widzisz: Wysyłanie nie udaje się na wideo większe niż 100MB.

Jak naprawić:

  1. Zwiększ ustawienia PHP (uploadmaxfilesize oraz postmaxsize) do co najmniej 500M
  2. Przywróć PHP- FPM po zmianie ustawień
  3. Jeśli na cPanelu, należy użyć Edytor multiPHP INI

Błędy w zezwoleniu

Co widzisz: Błędy dotyczące plików lub folderów nie mogą być zapisywane.

Jak naprawić:

  1. Upewnij się, że foldery mają poprawne uprawnienia:

  • ct/logs/ powinno być zapisywalne
  • ct/uploads/ powinno być zapisywalne
  • ct/cache/ powinno być zapisywalne

  1. Jeśli masz dostęp do SSH, uruchom: chmod -R 775 ct/logs ct/uploads ct/cache
  2. Skontaktuj się z dostawcą hostingu, jeśli nie masz dostępu do SSH

Połączenie z bazą danych nie powiodło się

Co widzisz: Komunikat o błędzie w związku z bazą danych na każdej stronie.

Jak naprawić:

  1. Sprawdź, czy MySQL działa
  2. Weryfikacja uwierzytelniania bazy danych w ct/dat/config.inc.php
  3. Upewnij się, że użytkownik bazy danych ma pełne uprawnienia
  4. Skontaktuj się z dostawcą usług hostingowych w kwestiach związanych z bazą danych


Automatyczne sprawdzanie serwera

Wymagania Sprawdź skrypt

Zapisz to jako checkrequirements.php na swojej stronie root i odwiedź ją w przeglądarce:

ComusThumbz Requirements Check\n";
echo "
\n";

// PHP Version
$phpOk = versioncompare(PHPVERSION, '8.3.0', '>=');
echo "PHP Version: " . PHPVERSION . " " . ($phpOk ? '✅ OK' : '❌ Need 8.3+') . "\n\n";

// Extensions
$extensions = ['pdo', 'pdomysql', 'gd', 'curl', 'mbstring', 'json'];
echo "Required Extensions:\n";
foreach ($extensions as $ext) {
$loaded = extensionloaded($ext);
echo " $ext: " . ($loaded ? '✅ OK' : '❌ MISSING') . "\n";
}

// Functions
$disabled = explode(',', iniget('disablefunctions'));
$required = ['exec', 'shellexec', 'mkdir', 'chmod', 'fileputcontents'];
echo "\nRequired Functions:\n";
foreach ($required as $func) {
$ok = !inarray(trim($func), arraymap('trim', $disabled));
echo " $func: " . ($ok ? '✅ OK' : '❌ DISABLED') . "\n";
}

// Settings
echo "\nPHP Settings:\n";
echo " memorylimit: " . iniget('memorylimit') . "\n";
echo " maxexecutiontime: " . iniget('maxexecutiontime') . " seconds\n";
echo " uploadmaxfilesize: " . iniget('uploadmaxfilesize') . "\n";
echo " postmaxsize: " . iniget('postmaxsize') . "\n";

// FFmpeg
echo "\nExternal Tools:\n";
$ffmpeg = @shellexec('which ffmpeg 2>/dev/null');
echo " FFmpeg: " . ($ffmpeg ? '✅ Found' : '❌ NOT FOUND') . "\n";
echo "
\n"; ?>

Ten skrypt sprawdza:

  • Wersja PHP
  • Wymagane rozszerzenia
  • Włączone funkcje
  • Ustawienia PHP
  • Instalacja FFmpeg

Wskazówka: Zielone znaki kontrolne (ang. green checkmark) oznaczają, że wszystko jest OK. Czerwone znaki X (ang. Red X marks) wskazują na problemy wymagające naprawy.

Pomoc

Gdzie szukać najpierw

  1. Sprawdź pracę cron - Większość problemów "wideo nie przetwarzanie" są związane cron
  2. Weryfikacja FFmpeg jest zainstalowana - Uciekaj. ffmpeg -version sprawdzić
  3. Przegląd ustawień PHP - Upewnij się, że pamięć i limit wysyłania są wystarczająco wysokie
  4. Sprawdź uprawnienia folderów - Folder do wysyłania musi być zapisany

Kiedy skontaktować się z obsługą

Skontaktuj się z dostawcą hostingu, jeśli:

  • Nie można uzyskać dostępu do ustawień PHP lub cPanel
  • FFmpeg nie jest zainstalowany i nie można go zainstalować
  • Baza danych nie połączy się pomimo poprawnych danych
  • Zagadnienia zapory blokują połączenia

Skontaktuj się z obsługą ComusThumbz, jeśli:

  • Wymagania są spełnione, ale funkcje nadal nie działają
  • Widzisz konkretne komunikaty błędów w panelu administracyjnym
  • Opcje konfiguracji nie są jasne


PrzewodnikKiedy go używać
Przewodnik instalacyjnyPo sprawdzeniu wymagań, użyj tego do instalacji ComusThumbz
Podręcznik konfiguracji serweraSzczegółowe instrukcje dotyczące ustawień cPanel, HestiaCP, Plesk i CLI
Ustawienia Centrum sterowaniaKonfiguracja ustawień ComusThumbz po instalacji
Ustawienia procesora wideoFine- tune przetwarzanie wideo i opcje FFmpeg
Serwery pamięciKonfiguracja pamięci CDN dla filmów wideo
Cron ManagerMonitorowanie i zarządzanie zadaniami w tle

Podsumowanie listy kontrolnej

Przed instalację ComusThumbz, sprawdź, czy masz:

  • [] Serwer Linux (VPS lub dedykowany, nieudostępniony hosting)
  • [] PHP 8.3 lub nowsze
  • [] MySQL 5.7 + lub MariaDB 10.3 +
  • [] Co najmniej 2 GB RAM (4 GB + zalecane)
  • [] FFmpeg zainstalowany i działający
  • [] exec() i powiązane funkcje PHP włączone
  • [] Limit pamięci PHP ustawiony na 512M lub wyższy
  • [] Upload max filesize set to 500M or higher
  • [] Zapisywalne foldery do przesyłania, dzienników i pamięci podręcznej
  • [] Możliwości pracy na wronie (działa co minutę)
  • [] Certyfikat SSL (darmowe Szyfrowanie działa świetnie)
  • [] 10GB + wolne miejsce na dysku
Sukces: Jeśli możesz sprawdzić wszystkie te pola, serwer jest gotowy do instalacji ComusThumbz!

Potrzebujesz więcej pomocy? Następnie sprawdź Przewodnik instalacyjny lub skontaktuj się z dostawcą hostingu, aby zweryfikować wymagania serwera.