Устранение неполадок

Большинство проблем сводится к нескольким причинам: версия PHP, права доступа к файлам, учётные данные базы данных, перезапись URL веб-сервером или отсутствующий воркер. На этой странице перечислены наиболее распространённые симптомы, с которыми сталкиваются операторы, и способы их устранения. Если вы не уверены, лог ошибок PHP поможет быстрее всего разобраться в ситуации.

Проблемы с установкой

«Ваша версия PHP не поддерживается»

TubePress требует PHP 8.2 или новее — это обеспечивается безопасной проверкой версии, которая выполняется раньше всего остального. Переключите версию PHP в панели управления хостингом (или направьте vhost на более новый сокет PHP-FPM) и перезапустите. См. Требования.

«Не удалось подключиться к базе данных»

На шаге базы данных в установщике проверьте хост (обычно localhost или 127.0.0.1), имя базы данных, пользователя и пароль, а также наличие привилегий у этого пользователя на данную базу данных. База данных должна существовать заранее — установщик создаёт таблицы, но не саму схему.

Установщик не может записать конфигурацию / ошибка «not writable»

Веб-серверу необходим доступ на запись в config/ и storage/ в процессе установки. Сделайте эти директории доступными для записи PHP-пользователем, затем повторите попытку. См. руководство по правам доступа в разделе Установка.

Я завершил установку, но /install по-прежнему загружается

При установке создаётся файл config/installed.php. Если он отсутствует, приложение считает себя неустановленным; если установка завершена, этот файл должен существовать и установщик блокирует сам себя. Повторно проверьте, что config/ был доступен для записи.

Сайт загружается, но страницы возвращают 404

Если главная страница работает, но все остальные URL возвращают 404, перезапись URL не достигает фронт-контроллера.

• Apache — убедитесь, что mod_rewrite включён и задан AllowOverride All, чтобы встроенный .htaccess применялся.
• Nginx — ваш блок location / должен передавать запросы фронт-контроллеру, например try_files $uri $uri/ /index.php?$query_string;. См. Архитектура для заметок по веб-серверу.

Вход и доступ к панели администратора

Не могу найти страницу входа в панель администратора

Если вы задали пользовательский URL панели администратора в целях безопасности, панель больше не находится по адресу /admin — она отвечает только по вашему секретному пути. Восстановите его из таблицы settings, если у вас есть доступ к базе данных. См. Безопасность.

Двухфакторная аутентификация блокирует мне доступ

Если вы потеряли аутентификатор, отключите TOTP пользователя в базе данных (соответствующий столбец в таблице users), чтобы восстановить доступ, затем выполните повторную регистрацию. Подробности в разделе Безопасность.

Загрузки и медиафайлы

Большие файлы не загружаются или превышают время ожидания

Увеличьте лимиты PHP upload_max_filesize и post_max_size, а в Nginx увеличьте client_max_body_size. Демо-версия допускает загрузку файлов в несколько гигабайт благодаря высокому значению client_max_body_size; установите то же на своём сервере для больших файлов.

Видео не воспроизводится

Недавно загруженные видео могут всё ещё находиться в состоянии обработки до завершения транскодирования. Убедитесь, что формат подходит для воспроизведения в браузере, что файлы рендеринга существуют в хранилище и что ваш сервер отправляет правильный MIME-тип для .mp4/.webm. См. Плеер.

Миниатюры или превью отсутствуют

Для генерации миниатюр и превью необходимо расширение GD или Imagick (и FFmpeg для кадров из видео). Убедитесь, что они установлены и что uploads/ доступен для записи.

Транскодирование зависло

Если задания находятся в очереди и никогда не завершаются:

• Убедитесь, что FFmpeg установлен там, где выполняется транскодирование (локальный сервер или удалённый воркер).
• Если вы используете удалённые серверы транскодирования, убедитесь, что воркер запущен и его API-ключ совпадает с настроенным в панели администратора.
• Убедитесь, что планировщик работает (см. ниже) — отправка и повтор заданий выполняются через pseudo-cron.

Запланированные задания не выполняются

Pseudo-cron срабатывает только при рендеринге страниц. На малопосещаемом сайте heartbeat поддерживает его работу — убедитесь, что heartbeat_enabled равно 1. Если вы его отключили, либо включите снова, либо добавьте запись системного cron, которая будет периодически обращаться к вашему сайту.

Электронная почта не отправляется

Настройте SMTP в разделе Электронная почта & уведомления и используйте встроенную кнопку Отправить тестовое письмо для подтверждения. Если тесты не проходят, проверьте хост/порт/учётные данные SMTP и убедитесь, что ваш хостинг разрешает исходящую почту; для обеспечения доставляемости настройте SPF/DKIM на вашем домене.

Производительность

Для быстрого сайта при высокой нагрузке: включите OPcache, предоставьте PHP достаточно памяти, держите MySQL в той же сети, что и PHP, и оставьте пересчёт CTR и другие запланированные задачи активными. TubePress поставляется с индексами и блочными заданиями, необходимыми для больших библиотек — см. Обслуживание.

Обновления не применяются

Если обновление не применяется, убедитесь, что основные файлы доступны для записи PHP-пользователю и что вы используете PHP 8.2+. Всегда создавайте резервную копию перед обновлением, чтобы можно было откатиться. См. Обновление.

Всё ещё не удаётся решить проблему?

Соберите точное сообщение об ошибке и соответствующие строки лога, затем откройте тикет с панели управления или через виджет поддержки в панели администратора. Чем больше контекста вы предоставите — версия PHP, веб-сервер и то, что вы делали — тем быстрее будет решена проблема. См. Объявления & поддержка.