Вы обновили приложение в Nextcloud, после чего вместо файлов появилась ошибка 503 Service Unavailable. Облако перестало открываться у всех пользователей, а перезапуск Apache либо не помогает, либо возвращает доступ только временно.
По одному коду 503 нельзя определить причину. Nextcloud может находиться в режиме обслуживания, ждать завершения обновления или не отвечать из-за сбоя PHP. Поэтому восстановление начинается с проверки состояния и журналов.
Ниже приведены команды для стандартной установки Nextcloud All-in-One на Linux. Выполняйте их по SSH на сервере с AIO. Команды occ запускаются внутри контейнера Nextcloud от пользователя www-data.
Известный случай: 503 после обновления Preview Generator
В сентябре 2026 года в сообществе Nextcloud был описан конкретный сбой: на AIO 14.1.1 с Nextcloud 34.0.4 попытка обновить Preview Generator с 5.14.0 до 5.15.0 приводила к недоступности всего облака. После остановки и запуска контейнеров через AIO доступ возвращался, но приложение оставалось на старой версии.
Разработчик AIO предложил исправление из версии 14.2.0, после которого автор обращения подтвердил успешное обновление. В этот выпуск вошло временное отключение PHP OPcache JIT, связанное со сбоями PHP-процессов.
Если версии и симптомы совпадают, проверьте доступное стабильное обновление AIO. Повторная установка Preview Generator сама по себе может не устранить причину. Для других версий сначала сопоставьте ошибку с логами: этот случай не объясняет каждый ответ 503.
1. Сохраните логи и проверьте контейнеры
Перед перезапуском запишите время сбоя, название обновлённого приложения и его версии до и после попытки обновления.
sudo docker ps -a --filter name=nextcloud-aio \
--format 'table {{.Names}}\t{{.Status}}'
В первую очередь интересуют:
nextcloud-aio-nextcloud— приложение Nextcloud и PHP.nextcloud-aio-apache— веб-сервер перед Nextcloud.nextcloud-aio-database— база данных.nextcloud-aio-redis— Redis.
Если контейнер остановлен или постоянно перезапускается, сначала выясните причину. Статус Running означает только, что контейнер запущен: отдельные PHP-процессы внутри него всё равно могут завершаться с ошибками.
sudo docker logs --timestamps --since 30m --tail 200 nextcloud-aio-nextcloud
sudo docker logs --timestamps --since 30m --tail 200 nextcloud-aio-apache
Посмотрите также журнал самого Nextcloud. В стандартной конфигурации AIO:
sudo docker exec --user www-data nextcloud-aio-nextcloud \
tail -n 100 /var/www/html/data/nextcloud.log
Если путь к журналу меняли, используйте настроенное расположение. Сообщение об отсутствии файла не означает, что ошибок нет.
| Что обнаружено | Что проверять дальше |
|---|---|
| PHP-процесс завершился с SIGSEGV, Apache сообщает Failed to read FastCGI header | Сбой PHP и известные исправления вашей версии AIO. Ошибка Apache здесь может быть следствием. |
| Исключение с упоминанием previewgenerator | Совместимость приложения и возможность временно его отключить. |
| Ошибка подключения к PostgreSQL или Redis | Состояние соответствующего контейнера и его журнал. |
| Allowed memory size exhausted или No space left on device | Лимит памяти PHP либо свободное место и inode на диске. |
Ориентируйтесь на сообщения, совпадающие со временем сбоя. Одна старая запись с названием приложения ещё не доказывает его причастность.
2. Проверьте состояние Nextcloud через occ
sudo docker exec --user www-data nextcloud-aio-nextcloud \
php occ status
Обратите внимание на поля:
installed: true— Nextcloud установлен.versionstring— версия Nextcloud Server; версия AIO указывается отдельно в панели AIO.maintenance: true— включён режим обслуживания.needsDbUpgrade: true— требуется завершить обновление.
Если вместо статуса команда возвращает исключение, сохраните его текст. Это отдельный диагностический результат. Не запускайте новую установку, если неожиданно видите installed: false: сначала проверьте подключение прежних томов и конфигурации.
До отключения приложений, запуска миграций или перезапуска убедитесь, что обновление либо восстановление из резервной копии не выполняется прямо сейчас. Проверьте панель AIO, свежие логи и процессы:
sudo docker top nextcloud-aio-nextcloud
Если видите работающий occ upgrade или продолжающиеся этапы обновления, не запускайте второй экземпляр. Отсутствие отдельного процесса occ само по себе не исключает обновление через веб-интерфейс.
3. Если причина связана с AIO, примените исправление через его панель
Для описанного сбоя Preview Generator проверьте стабильный выпуск AIO с исправлением. Обновление только mastercontainer не заменяет обновление контейнера Nextcloud.
Порядок действий через интерфейс AIO:
- Убедитесь, что предыдущая операция завершилась или остановилась с ошибкой.
- Сохраните резервную копию текущего состояния и отдельно сохраните рабочую копию до сбоя, если она есть.
- Используйте Stop containers.
- Установите предлагаемое обновление mastercontainer, если оно доступно.
- Выполните Start and update containers и проследите за журналом запуска.
Копия уже неисправного состояния помогает сохранить данные перед дальнейшими действиями, но не заменяет проверенную копию до обновления.
Как войти в AIO, если сам Nextcloud недоступен
Панель AIO может показывать сообщение The login is blocked since Nextcloud is running и предлагать вход через Nextcloud. При 503 такой вход недоступен.
После сохранения логов и проверки, что обновление или восстановление не выполняется, можно воспользоваться способом, который предлагает сама страница входа AIO:
sudo docker stop nextcloud-aio-apache
Команда останавливает веб-доступ к облаку. Затем откройте настроенный адрес панели AIO и войдите с её passphrase. Продолжайте восстановление через панель; после работ запустите контейнеры через AIO. Остановка Apache нужна для доступа к управлению и сама по себе не исправляет сбой PHP.
4. Если логи указывают на Preview Generator, временно отключите его
Этот шаг подходит, когда активное обновление уже завершилось, а ошибка связана с дополнением. Сначала проверьте список приложений:
sudo docker exec --user www-data nextcloud-aio-nextcloud \
php occ app:list
Идентификатор Preview Generator — previewgenerator. Для временного отключения:
sudo docker exec --user www-data nextcloud-aio-nextcloud \
php occ app:disable previewgenerator
Повторите app:list: приложение должно оказаться в разделе Disabled. Затем снова проверьте occ status и доступ к облаку.
Отключение дополнения не удаляет пользовательские фотографии и документы. Preview Generator занимается предварительной подготовкой миниатюр; обычная генерация превью по запросу остаётся отдельным механизмом Nextcloud.
Если вы настраивали собственное задание cron или systemd timer для preview:pre-generate, временно приостановите именно его. Общие фоновые задания Nextcloud оставьте включёнными.
Если occ завершается с ошибкой ещё до выполнения команды, не удаляйте каталог приложения и не меняйте записи в базе наугад. Сохраните исключение: дальнейшие действия зависят от того, повреждены ли файлы приложения, нарушена совместимость или недоступна база данных.
5. Разберитесь с незавершённым обновлением и maintenance mode
Если needsDbUpgrade: true
Сначала завершите обновление. Снятие режима обслуживания не выполняет миграции.
Если автоматический процесс AIO уже остановился, причина его ошибки устранена, резервная копия сохранена и файлы нужной версии установлены полностью, этап миграции можно продолжить:
sudo docker exec --user www-data nextcloud-aio-nextcloud \
php occ upgrade
Команда меняет базу данных и не скачивает недостающие файлы приложения. При новой ошибке остановитесь на ней и изучите журнал. Не повторяйте команду бесконечно и не запускайте её параллельно с обновлением AIO.
Если maintenance: true, но needsDbUpgrade: false
Когда обновление успешно завершено, резервное копирование или восстановление не выполняется, а режим обслуживания остался включённым, отключите его:
sudo docker exec --user www-data nextcloud-aio-nextcloud \
php occ maintenance:mode --off
Повторите occ status. Если оба значения уже false, дальнейшее переключение maintenance mode не поможет: возвращайтесь к ошибкам PHP, Apache и зависимостей.
6. Проверьте память и диск, если сбой повторяется
Большая фототека, генерация миниатюр и параллельные запросы могут создавать заметную нагрузку. Проверьте состояние VPS во время появления ошибки:
sudo docker stats --no-stream
free -h
df -h
df -i
df -h показывает свободное место, а df -i — доступность inode, необходимых для создания файлов. Проверяйте файловые системы, где находятся данные Nextcloud и Docker.
Для проверки завершения контейнера из-за памяти:
sudo docker inspect --format \
'OOMKilled={{.State.OOMKilled}} Restarts={{.RestartCount}}' \
nextcloud-aio-nextcloud
OOMKilled=true указывает на завершение из-за нехватки доступной памяти. Отдельный PHP-процесс также может упереться в собственный лимит: сообщение Allowed memory size exhausted не равнозначно заполнению всей RAM сервера.
Снимок показателей после перезапуска может не показать прошедший пик. Сопоставляйте нагрузку с журналами и временем сбоя.
Если ресурсов действительно недостаточно, пересмотрите параллельность фоновых задач и конфигурацию сервера. Для размещения Nextcloud в Xhost24 доступны VPS на NVMe. При выборе учитывайте объём файлов, миниатюры, версии документов, число пользователей и дополнительные сервисы. Исправление программной ошибки AIO всё равно требуется независимо от тарифа.
Как вернуть Preview Generator после восстановления
Сначала убедитесь, что облако стабильно работает без дополнения. Затем проверьте совместимость доступной версии Preview Generator с вашей версией Nextcloud и наличие исправления AIO.
После резервного копирования обновляйте только нужное приложение, чтобы видеть результат конкретного изменения:
sudo docker exec --user www-data nextcloud-aio-nextcloud \
php occ app:update previewgenerator
При успешном завершении и отсутствии ожидающих миграций включите его:
sudo docker exec --user www-data nextcloud-aio-nextcloud \
php occ app:enable previewgenerator
Проверьте несколько изображений и свежие записи журнала. Затем возвращайте ранее настроенное расписание генерации.
Не запускайте полную preview:generate-all по всей библиотеке во время восстановления 503. Она обрабатывает файлы и способна добавить нагрузку на уже нестабильный сервер.
Если нужна проверка предварительной генерации, сначала посмотрите справку установленной версии:
sudo docker exec --user www-data nextcloud-aio-nextcloud \
php occ help preview:generate-all
При наличии параметра --path ограничьте проверку небольшой тестовой папкой. Здесь alice — идентификатор пользователя, а Preview-test — папка в его файлах:
sudo docker exec --user www-data nextcloud-aio-nextcloud \
php occ preview:generate-all --path="/alice/files/Preview-test"
Когда восстанавливать резервную копию
Возврат к резервной копии нужен, если обновление оставило повреждённое или несогласованное состояние, которое не удаётся исправить штатными средствами.
Для встроенных копий AIO используйте восстановление через панель — Restore selected backup. Проверьте дату архива, доступность ключа шифрования и состав копии. Данные внешних хранилищ, подключённых через приложение External storage, автоматически в такую копию не входят.
Восстанавливать нужно согласованное состояние файлов, базы и конфигурации. Замена одного Docker-образа на старый после миграции базы не является корректным откатом.
До восстановления сохраните текущее состояние и учтите изменения после выбранной даты: новые файлы, правки документов, календарей и контактов. По возможности сначала проверьте копию на отдельном сервере.
Как проверить, что доступ восстановлен
occ statusпоказываетmaintenance: falseиneedsDbUpgrade: false.- Обычный пользователь входит в Nextcloud и открывает ранее загруженные файлы.
- Небольшой тестовый файл загружается и скачивается обратно.
- Клиент синхронизации подключается без повторяющихся ошибок.
- При просмотре изображений и выполнении фоновых задач 503 не возвращается.
- В свежих логах нет повторения исходного сбоя.
Что отправить администратору
Для диагностики подготовьте версии AIO, Nextcloud и проблемного приложения, время ошибки с часовым поясом, вывод occ status, состояние контейнеров и журналы за момент сбоя. Укажите, что именно уже делали и есть ли резервная копия до обновления.
Перед отправкой удалите из журналов токены, пароли и приватные ссылки. Полный конфигурационный файл с секретами не нужен для первого обращения.
Если нужна помощь с восстановлением или переносом Nextcloud на VPS, в Xhost24 можно согласовать задачу по администрированию. Опишите проблему, объём данных и допустимое время простоя — состав работ и стоимость определяются до начала.
Частые вопросы
Ошибка 503 означает, что файлы потеряны?
Нет. Она означает, что запрос сейчас не обслуживается. Сохранность данных проверяют отдельно. Не создавайте новую установку поверх существующих томов ради устранения ошибки.
Почему после отключения Preview Generator часть миниатюр всё ещё появляется?
Nextcloud умеет создавать их при обращении к файлу. Preview Generator заранее подготавливает превью, но не заменяет этот механизм.
Почему команда preview:generate-all не найдена?
Проверьте, включён ли Preview Generator и выключен ли режим обслуживания. В maintenance mode команды приложений недоступны. Также сверяйте наличие команды со справкой установленной версии.
Нужно ли переходить на beta ради исправления?
В старом обсуждении beta могла быть единственным выпуском с нужным исправлением. Сначала проверьте доступный стабильный релиз AIO и его changelog. Старый совет о beta не означает, что она требуется сейчас.
