Требования к серверу

TubePress работает на обычном стеке LAMP или LEMP. Не нужно устанавливать фреймворк, выполнять сборку через Composer или Node и подключать загрузчик ionCube — если ваш хост уже запускает WordPress, то TubePress почти наверняка тоже заработает.

На этой странице описаны минимальные требования, рекомендуемая конфигурация для продакшена и несколько необязательных компонентов (FFmpeg, аккаунт TubePress), которые нужны только для определённых функций. Веб-установщик проверяет всё это на шаге Проверка системы.

Минимальные требования

Это нижняя граница. Установщик не продолжит работу, пока все обязательные пункты не будут выполнены.

Обязательные расширения PHP

Установка заблокирована, если хотя бы одно из трёх расширений отсутствует:

Также обязательны рабочие PHP-сессии и серверная перезапись URL (Apache mod_rewrite или правило try_files в Nginx) — установщик проверяет оба условия.

Рекомендуемая конфигурация

Для стабильной работы сайта в продакшене:

• PHP 8.4 с OPcache — версия, на которой собирается и тестируется TubePress; кэш байт-кода включён для повышения производительности.
• memory_limit не менее 256 МБ — достаточный запас для массового импорта и обработки изображений.
• curl, zip и GD (или Imagick) — необязательны, но рекомендуются: для загрузки каталога и работы с маркетплейсом используется curl, для установки тем и плагинов из панели управления нужен zip, а для генерации миниатюр — GD или Imagick.
• HTTPS — обслуживайте сайт по TLS и задайте URL сайта с протоколом https.

Плановые задачи выполняются автоматически через встроенный pseudo-cron TubePress, поэтому системный crontab не требуется. Высоконагруженные сайты могут подключить настоящий cron — см. Cron & CLI.

Ограничения на загрузку видео

По умолчанию TubePress ограничивает прямые загрузки до 500 МБ (можно изменить в /admin/settings). Ограничения PHP и веб-сервера должны быть не меньше, иначе большие файлы будут отклонены до того, как достигнут приложения:

; php.ini - allow large video uploads
upload_max_filesize = 512M
post_max_size       = 512M
memory_limit        = 256M
max_execution_time  = 300

В Nginx также увеличьте client_max_body_size; в Apache — LimitRequestBody. Для очень больших библиотек лучше транскодировать и раздавать видео из удалённого хранилища — см. Транскодирование и Хранилище.

Веб-сервер

Веб-корень — это директория public/, и каждый запрос направляется через единственный фронт-контроллер public/index.php. Держите config/, src/ и storage/ выше корня документов (они находятся на один уровень выше public/), чтобы они никогда не отдавались напрямую.

Apache

Укажите корень документов на public/ и разрешите поставляемым файлам .htaccess выполнять свою работу:

DocumentRoot /var/www/tubepress/public
<Directory /var/www/tubepress/public>
    AllowOverride All
    Require all granted
</Directory>

Nginx

Используйте try_files для чистых URL, задайте алиасы для папок тем и шаблонов и запретите доступ к чувствительным путям:

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;
}

Оба сервера полностью поддерживаются — установщик автоматически определяет, какой из них вы используете.

Необязательно: FFmpeg и транскодирование

FFmpeg нужен только если вы хотите, чтобы TubePress транскодировал видео локально — конвертируя загружаемые файлы в форматы, подходящие для воспроизведения в браузере, и генерируя превью-миниатюры. Если вы импортируете уже закодированные файлы или раздаёте их из внешнего хранилища или CDN, FFmpeg можно не устанавливать вовсе. См. Транскодирование.

Необязательно: аккаунт TubePress

CMS полноценна и бесплатна сама по себе. Бесплатный аккаунт TubePress открывает дополнительные платные функции — AI-кредиты, каталог из более чем 400 тыс. видео, маркетплейс и поддержку. Вы начинаете со 150 бесплатными кредитами и никогда не нуждаетесь в аккаунте для полноценной работы сайта.

Следующие шаги