Newer
Older
gnexus-book / 10-systems / hosts / nextcloud.md

owner: gmikcon status: active last_reviewed: 2026-10-11 review_interval: 90d confidence: high

source_of_truth: ssh-host-verified

Nextcloud VM

Nextcloud file cloud VM, upstream for cloud.gnexus.space.

Identity

  • Inventory id: nextcloud.
  • VM id: nextcloud (libvirt domain on hypervisor hp-proliant-dl380-g6, bserv 192.168.1.130).
  • LAN address: 192.168.1.152.
  • Resources: 24 vCPU, 32 GiB RAM.
  • Disk: qcow2 /mnt/main/vm_main/nextcloud.
  • Autostart: enabled. Note: libvirt autostart only fires on host/libvirt start — it does NOT recover a VM killed by the OOM killer.

Roles

  • Nextcloud instance behind cloud.gnexus.space (TLS terminates on internal-proxy-vps, upstream http://192.168.1.152).

Stack

  • Nextcloud 31.0.14 (с 2026-10-11; маршрут 27.1.6 → 28 → 29 → 30 → 31, см. Update ниже).
  • Ubuntu, Apache 2.4 (mpm_prefork + mod_php), PHP 8.1 (opcache настроен: 384 MB, interned 64, validate_timestamps=0), MySQL 8, Redis (memcache.distributed + memcache.locking), APCu (memcache.local, с 2026-10-11).
  • Каталог установки: /home/ubuntu/nextcloud (DocumentRoot vhost nc.lvs.conf), данные /home/ubuntu/nextcloud/data.
  • Фоновые задачи: cron www-data */3 * * * * php -f /home/ubuntu/nextcloud/cron.php.
  • SSH: ubuntu на 192.168.1.152, пароль как у гипервизора (gnexus-creds, секрет bserv@192.168.1.130); sudo через sudo -S. occ запускать от www-data (sudo -u www-data php occ ...).
  • Приложения (включены, тяжёлые): memories 7.8.2, recognize 9.0.9, maps 1.6.0, previewgenerator 5.14.0, richdocuments (+richdocumentscode), drawio, forms, deck, calendar, contacts, notes, tasks, bookmarks. Вопрос об отключении неиспользуемых открыт (владелец).
  • Health-мониторинг: hard-panel сервис #8 nextcloud — https://cloud.gnexus.space/status.php (LAN-URL без Host-заголовка даёт 400 trusted domains; см. 10-systems/services/hard-panel.md).

Update 2026-10-11 09:20 (navi rei) — оптимизация производительности (одобрено владельцем)

Повод: жалоба владельца на медленный Nextcloud. Диагностика: ресурсы VM в норме (load 0.04, RAM 1.1/31 Gi), узкие места — конфигурация стека.

Пункт 1 — MySQL tuning:

  • Найдено: innodb_buffer_pool_size = дефолт 128 MB при БД ~1 GB (451k записей oc_filecache) — главный тормоз листингов/WebDAV.
  • Сделано: /etc/mysql/mysql.conf.d/zz-nextcloud.cnf — innodb_buffer_pool_size = 4G, innodb_flush_log_at_trx_commit = 2 (персональное облако: потеря последней секунды транзакций при падении ОС приемлема). Рестарт mysql.
  • Проверено: SELECT @@innodb_buffer_pool_size = 4294967296 (4 GiB), mysql active, /status.php 200. RSS mysqld растёт лениво по мере прогрева — норма.

Пункт 2 — APCu:

  • Найдено: memcache.local был на Redis (каждый вызов по сети); APCu отсутствовал.
  • Сделано: apt-get install php8.1-apcu (+ apc.enable_cli=1 в /etc/php/8.1/mods-available/apcu-nc-cli.ini для cron/occ), occ config:system:set memcache.local --value "\OC\Memcache\APCu" (от www-data), рестарт apache2. Redis остался на distributed+locking.
  • Проверено: php -m → apcu, проба в Apache → APCU:yes, лог nextcloud.log без ошибок APCu.

Замеры до/после (localhost VM, warm):

Проба До После
/login (полный PHP-рендер) ~0.15 s ~0.12 s
/status.php ~0.06 s ~0.04 s
LAN через прокси /status.php 0.26 s, выбросы до 1.4 s 0.24 s стабильно

Основной эффект ожидается на DB-тяжёлых операциях (листинги файлов, WebDAV, поиск) — buffer pool теперь вмещает всю БД.

Бэкапы: /root/nc-config.php.bak-preopt-20261011 (config.php до правок). Откат: удалить zz-nextcloud.cnf + рестарт mysql; occ config:system:set memcache.local --value "\OC\Memcache\Redis" + рестарт apache2.

Не сделано (ждёт решения владельца): отключение тяжёлых приложений (memories/recognize/maps/previewgenerator/richdocuments/drawio/forms — список уточняется), переезд на php-fpm + mpm_event (модули в наличии, php8.1-fpm не установлен).

Update 2026-10-11 10:30 (navi rei) — major upgrade 27.1.6 → 31.0.14 (одобрено владельцем)

Маршрут: 27.1.6.2 → 28.0.14 → 29.0.16 → 30.0.17 → 31.0.14 — по одному мейджору за шаг (политика Nextcloud), каждый через updater.phar --no-interaction + гейт после шага: /status.php 200, maintenance off, needsDbUpgrade false, 0 ошибок в nextcloud.log, рестарт apache2 (ранбук opcache — см. Incident 10:06).

  • Предбэкапы: /root/nc-backup-preupgrade-20261011 — дамп БД 144M (gzip -t OK), tar apps+data 7.5G, config/, app-list.json. Итого ~7.7G.
  • Шаги 27→28, 28→29, 29→30 — чисто («Update successful», code integrity OK). Инцидент 500 на 29→30 — см. Incident ниже.
  • Шаг 30→31: updater заменил код, но упал на recognize — PHP Fatal: OCA\Recognize\Service\Logger::emergency несовместим с Psr\Log\LoggerInterface в NC 31 (старое приложение на новом коде). Лечение: maintenance on, occ app:disable recognize memories maps previewgenerator, ручной occ upgrade → «Update successful», integrity OK, рестарт apache2, maintenance off.
  • Приложения: occ app:update --all из App Store; все четыре отключённых обновились и включены: recognize 9.0.9, memories 7.8.2, maps 1.6.0, previewgenerator 5.14.0. Обновлены также text, twofactor_backupcodes, updatenotification, user_status, viewer, epubviewer, quota_warning, side_menu, tasks.
  • Финальный гейт: occ status 31.0.14 (31.0.14.1), maintenance false, needsDbUpgrade false; cron жив (фоновые задачи выполнялись 10:24–10:28); 0 ошибок в логе; внешний https://cloud.gnexus.space/status.php 200.
  • Диск: 21G/28G (81%; до апгрейда 47%) — рост от предбэкапов и бэкапов апдейтера. Остатки: updater-бэкап nextcloud-30.0.17.2-1791713615 в data/updater-ocj1jaf8egog/backups/ (можно удалить после периода наблюдения), предбэкапы в /root (7.7G).
  • Ограничение на будущее: PHP 8.1 для NC 31 — deprecated, но работает; NC 32+ требует PHP 8.2. Следующий мейджор = сначала апгрейд PHP. Актуальная ветка NC — 35 (35.0.1 на 2026-10-11).

Incident 2026-10-11 10:06–10:10 UTC (обновление 29→30 + opcache 500)

  • 10:04:00 UTC: root запустил updater.phar --no-interaction (detached, PPID 1) — обновление Nextcloud 29.0.17 → 30.0.17. Перед этим apache2 рестартовали в 09:42, 09:52, 10:03 (подготовка к обновлению, не сеанс оптимизации rei).
  • 10:06–10:10: миграция БД (occ upgrade) под maintenance mode. hard-panel увидел 503 на /status.php — ожидаемое поведение: Nextcloud в maintenance mode отвечает 503 на все эндпоинты. Стек (apache/mysql/redis) был жив весь апгрейд; вмешательства не требовалось.
  • 10:10:04: обновление успешно завершено (Update successful), maintenance снят, needsDbUpgrade=false.
  • 10:10:13–10:10:21: /status.php стал отдавать 500: Downgrading is not supported (from 30.0.17.2 to 29.0.16.1). Причина: apache последний раз рестартовали в 10:03:41 — ДО завершения обновления; opcache с validate_timestamps=0 держал в памяти старый код 29.0.16.1, который падал на уже мигрированной БД 30.0.17.2.
  • 10:10:23 (navi rei): рестарт apache2 → сброс opcache. status.php = 200 (30.0.17.2), /login = 200, level-3 ошибок в nextcloud.log после рестарта нет. hard-panel: nextcloud [up] 200.
  • Обновление 29→30 прошло чисто (repair steps, code integrity check — без ошибок). Побочная ошибка richdocuments (USER_AGENT_SAFARI_MOBILE undefined) была только внутри окна апгрейда и не повторяется.

Ранбук (обязательно): после КАЖДОГО завершения occ upgrade на этой VM — немедленный рестарт apache2: opcache с validate_timestamps=0 не подхватывает новый код сам, старый код даёт 500 на новой БД.

Отчёт: workspace rei incident_nextcloud_2026-10-11.md.

Incident 2026-10-06 (OOM crash)

  • 2026-10-06 07:53:20 UTC: global OOM on hypervisor bserv — 117 GiB RAM exhausted and 8 GiB swap full. Kernel OOM killer killed the nextcloud qemu process (pid 3965, ~28 GiB RSS, largest allocation on the host).
  • 2026-10-06 07:54:06 UTC: VM shut down, reason=crashed (libvirt log).
  • Down ~31h12m; cloud.gnexus.space returned 502 from the internal proxy during the outage. Started manually by the owner 2026-10-07 15:06 UTC; service verified 200 after start.
  • Standing risk: hypervisor memory stays tight (90/117 GiB used, swap 8/8 GiB full at check 2026-10-07); the nextcloud VM is the largest single memory allocation (32 GiB) and the most likely OOM victim again. Note: MySQL buffer pool 4G внутри VM добавляет давление на гипервизор только при реальном прогреве кэша (RSS растёт лениво); следить за free на bserv.

No raw credentials are documented here.