Wymagania serwerowe
PHP, baza danych, rozszerzenia, serwer WWW i opcjonalnie FFmpeg — wszystko, czego potrzebujesz przed instalacją.
TubePress działa na zwykłym stosie LAMP lub LEMP. Nie ma żadnego frameworka do zainstalowania, żadnego kroku budowania Composer ani Node, ani loadera ionCube — jeśli Twój hosting już obsługuje WordPress, niemal na pewno będzie też obsługiwał TubePress.
Ta strona opisuje minimum, czego potrzebujesz, konfigurację zalecaną dla środowiska produkcyjnego oraz kilka opcjonalnych elementów (FFmpeg, konto TubePress), których wymagają tylko konkretne funkcje. Instalator webowy sprawdza wszystko za Ciebie w kroku Sprawdzenie systemu.
Minimalne wymagania
To jest absolutne minimum. Instalator odmówi kontynuowania, dopóki wszystkie wymagane elementy nie zostaną spełnione.
| Komponent | Minimum | Uwagi |
|---|---|---|
| PHP | 8.2 | 8.4 zalecane; włącz OPcache |
| Baza danych | MySQL 5.7+ / MariaDB 10.4+ | InnoDB, utf8mb4 |
| Serwer WWW | Apache 2.4+ lub Nginx | Z przepisywaniem URL |
| Wymagane rozszerzenia | pdo_mysql, mbstring, fileinfo | Plus działające sesje PHP |
| Zalecane rozszerzenia | curl, zip, GD lub Imagick | Katalog, instalacja dodatków, miniatury |
| Ścieżki z zapisem | config/, storage/, public/uploads/ | Należące do użytkownika serwera WWW |
Wymagane rozszerzenia PHP
Instalacja jest zablokowana, jeśli któreś z tych trzech nie jest obecne:
Działające sesje PHP oraz przepisywanie URL po stronie serwera (Apache mod_rewrite lub reguła Nginx try_files) są również wymagane — instalator sprawdza oba.
Zalecana konfiguracja
Dla płynnie działającej strony produkcyjnej:
- PHP 8.4 z OPcache — wersja, pod którą TubePress jest budowany i testowany, z włączonym cache bytecode dla szybkości.
- memory_limit wynoszący 256 MB lub więcej — wygodny margines dla masowych importów i przetwarzania obrazów.
- curl, zip i GD (lub Imagick) — opcjonalne, ale zalecane: pobieranie katalogu i marketplace używają
curl, instalowanie motywów i wtyczek z panelu wymagazip, a generowanie miniatur potrzebuje GD lub Imagick. - HTTPS — obsługuj stronę przez TLS i ustaw URL swojej strony na adres
https.
Zaplanowane zadania uruchamiają się automatycznie przez wbudowany pseudo-cron TubePress, więc żaden systemowy crontab nie jest wymagany. Strony o dużym ruchu mogą nadal skonfigurować prawdziwy cron — zobacz Cron i CLI.
Limity przesyłania dla wideo
TubePress domyślnie ogranicza bezpośrednie przesyłanie do 500 MB (można to zmienić w /admin/settings). Limity PHP i serwera WWW muszą być co najmniej tak duże, inaczej duże pliki zostaną odrzucone przed dotarciem do aplikacji:
; php.ini - allow large video uploads
upload_max_filesize = 512M
post_max_size = 512M
memory_limit = 256M
max_execution_time = 300W Nginx również zwiększ client_max_body_size; w Apache, LimitRequestBody. W przypadku bardzo dużych bibliotek zamiast tego transkoduj i serwuj z zewnętrznego magazynu — zobacz Transkodowanie i Przechowywanie.
Serwer WWW
Katalogiem głównym serwera WWW jest katalog public/, a każde żądanie jest kierowane przez pojedynczy kontroler frontowy, public/index.php. Trzymaj config/, src/ i storage/ powyżej katalogu dokumentów (są one o poziom wyżej niż public/), aby nigdy nie były serwowane bezpośrednio.
Apache
Ustaw katalog dokumentów na public/ i pozwól dostarczonym plikom .htaccess wykonać swoją pracę:
DocumentRoot /var/www/tubepress/public
<Directory /var/www/tubepress/public>
AllowOverride All
Require all granted
</Directory>Nginx
Użyj try_files dla czystych URL, utwórz aliasy folderów motywów i szablonów oraz zablokuj wrażliwe ścieżki:
server {
root /var/www/tubepress/public;
index index.php;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.4-fpm.sock;
}
# Serve theme and template assets
location /themes/ { alias /var/www/tubepress/themes/; }
location /templates/ { alias /var/www/tubepress/templates/; }
# Never expose application internals
location ~ ^/(config|src|storage)/ { deny all; }
client_max_body_size 512M;
}Oba serwery są obsługiwane na równym poziomie — instalator automatycznie wykrywa, który z nich jest uruchomiony.
Opcjonalnie: FFmpeg i transkodowanie
FFmpeg jest potrzebny tylko wtedy, gdy chcesz, żeby TubePress transkodował wideo lokalnie — konwertując przesłane pliki do formatów przyjaznych dla sieci i generując miniatury podglądu. Jeśli importujesz już zakodowane pliki lub serwujesz z zewnętrznego magazynu lub CDN, możesz to całkowicie pominąć. Zobacz Transkodowanie.
Opcjonalnie: konto TubePress
CMS jest kompletny i bezpłatny sam w sobie. Bezpłatne konto TubePress odblokowuje płatne dodatki — kredyty AI, katalog ponad 400 tys. filmów, marketplace i wsparcie. Zaczynasz z 150 darmowymi kredytami i nigdy nie potrzebujesz konta, żeby prowadzić pełną stronę.
Następne kroki
Nadal masz problem?
Otwórz zgłoszenie z poziomu panelu, a nasz zespół Ci pomoże.