Nextcloud на сервере: частые ошибки и решения

MAATRIX

Nextcloud надёжен, но при развёртывании и работе своего облака всплывают типичные проблемы: ошибка о недоверенном домене, предупреждения безопасности в разделе состояния, лимит на размер загружаемых файлов, не работающий cron, нехватка памяти PHP или медленная синхронизация. Практически все частые ошибки Nextcloud объясняются понятными причинами — конфиг, PHP, cron, кэш, ресурсы — и решаются проверенным набором действий, многие прямо через консольную утилиту occ. Разберём их по порядку, начиная с самых частых, с командами и указанием, где искать логи. Где искать причины. Главный лог Nextcloud — файл data/nextcloud.log (или его смотрят в интерфейсе: Настройки → Ведение журнала). Логи веб-сервера лежат в /var/log/apache2/error.log или /var/log/nginx/error.log, PHP — там же. Незаменимый инструмент администрирования — консольная утилита occ, запускаемая от пользователя веб-сервера из каталога Nextcloud: через неё чинят индексы файлов, меняют настройки, запускают обслуживание. Все команды occ выполняйте именно под www-data, иначе получите проблемы с правами.

Ошибка о недоверенном домене

Самая частая ошибка сразу после установки или переноса: «Доступ через недоверенный домен» (Access through untrusted domain). Это защитный механизм Nextcloud — он открывается только по заранее разрешённым доменам. Добавьте ваш домен в массив trusted_domains в файле конфигурации config/config.php. Отредактируйте его и впишите домен в список. Либо сделайте это через occ:

sudo -u www-data php occ config:system:set trusted_domains 1 --value=vashdomen.ru

Индекс (здесь 1) — позиция в массиве; 0 обычно занят localhost. После добавления домена ошибка исчезнет. Если облако доступно и по IP, и по домену, добавьте оба значения с разными индексами. Это первое, что настраивают после смены адреса или переноса Nextcloud на новый сервер.

Предупреждения безопасности и настройки

В разделе Настройки → Обзор Nextcloud показывает список предупреждений: не настроен кэш памяти, не работает cron, отсутствуют заголовки безопасности, не хватает PHP-расширения, база использует не тот способ хранения. Эти предупреждения не косметика — они влияют на скорость и надёжность. Разберём типовые.

«Кэш памяти не настроен» — установите Redis или APCu и пропишите его в config.php (параметр memcache.local). «Последняя фоновая задача выполнена давно» — не работает cron (см. ниже). «Отсутствуют рекомендуемые модули PHP» — доустановите указанные расширения (например, php-imagick, php-bcmath) и перезапустите PHP/Apache. «Заголовки безопасности не настроены» — добавьте их в конфиг веб-сервера или включите модули Apache headers. Устраняйте предупреждения по списку сверху вниз — Nextcloud прямо пишет, что и как исправить.

Не работает cron (фоновые задачи)

Nextcloud выполняет фоновые задачи: очистку, индексацию, отправку уведомлений. Если выбран режим AJAX (по умолчанию), задачи запускаются при заходах пользователей, что ненадёжно и даёт предупреждение о давно не выполнявшемся обслуживании. Правильно перевести их на системный cron. Добавьте задание для пользователя www-data:

crontab -u www-data -e

Впишите строку запуска каждые 5 минут:

*/5 * * * * php -f /var/www/vashdomen.ru/cron.php

Затем в интерфейсе (Настройки → Основные) выберите способ Cron. Проверить, что задача выполняется, можно по времени последнего запуска в том же разделе. Если cron не срабатывает, убедитесь, что путь к cron.php верный, а у www-data есть права на его выполнение. Системный cron — рекомендуемый способ для стабильной работы облака.

Лимит на размер загружаемых файлов

Пользователи не могут загрузить большой файл — Nextcloud или веб-сервер отвергает загрузку. Лимит задаётся в PHP и веб-сервере, а не в самом Nextcloud. Увеличьте в конфиге PHP параметры upload_max_filesize и post_max_size до нужного значения (например, 10G для больших файлов), а также memory_limit. После правки перезапустите PHP/Apache:

systemctl restart apache2

Для Apache с .htaccess Nextcloud обычно управляет частью лимитов сам, но при вынесенных настройках проверьте их вручную. Если используете Nginx, увеличьте client_max_body_size в его конфиге, иначе большой файл отвергнет веб-сервер с ошибкой 413. Также для очень больших файлов важен достаточный max_execution_time, чтобы загрузка не обрывалась по таймауту.

Нехватка памяти PHP и ошибки при операциях

При операциях с большими файлами, генерации превью или обновлении Nextcloud выдаёт ошибки памяти или падает. Nextcloud рекомендует memory_limit не ниже 512M для PHP — стандартных 128M ему мало. Увеличьте лимит в конфиге PHP и перезапустите обработчик. Проверьте общую память сервера:

free -m

Если система в свопе, серверу мало RAM — особенно при нескольких активных пользователях и генерации превью документов через imagick. Генерация превью — заметная нагрузка; на слабом сервере её можно ограничить в настройках. Если облаком пользуется команда и нагрузка стабильно высокая, честный вывод — нужна память. На VPS MAATRIX RAM наращивается без переустановки, что снимает проблему без переноса данных.

Медленная синхронизация и производительность

Клиенты синхронизируются медленно, интерфейс тормозит. Причин несколько. Первая — не настроен кэш памяти (Redis): без него каждая операция бьёт по базе. Поставьте Redis и пропишите его в config.php как локальный и блокировочный кэш — это заметно ускоряет работу. Вторая — медленный диск: облако интенсивно читает и пишет файлы, и на медленном HDD синхронизация вялая; SSD/NVMe критично важен. Третья — переполнение или фрагментация базы: выполните обслуживание через occ:

sudo -u www-data php occ db:add-missing-indices

Эта команда добавляет недостающие индексы базы, ускоряя запросы. Также проверьте, что фоновые задачи идут по cron, а не AJAX. Если после кэша, быстрого диска и оптимизации базы облако всё равно медленное при растущем числе пользователей — нужна конфигурация мощнее. На VPS MAATRIX ресурсы увеличиваются без переустановки.

Частые вопросы