---
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 series 2026-10-11 17:28–23:45 UTC (21 эпизод — гипервизорные stall'ы bserv)

Серия транзиентных недоступностей `cloud.gnexus.space` для монитора: hard-panel 21 раз за день зафиксировал сбой пробы /status.php (ConnectTimeout ~30 с, дважды ReadTimeout, один эпизод 66 с), каждый раз с самовосстановлением через ~30–66 с. Механизм во всех эпизодах один: проба монитора (192.168.1.150 → internal-proxy .226 → VM nextcloud .152, обе VM на bserv) не проходит TCP-путь на фоне хронического давления памяти на гипервизоре bserv (RAM ~97%, swap 100%, available ~1.9–2.3 GB). Nextcloud не при чём: стек внутри VM здоров во всех эпизодах (apache обслуживает пользовательский трафик, cron */3 штатно, логи чисты, uptime непрерывен, пакеты агента без пропусков). Kernel-журнал bserv чист (OOM-событий с 6 окт нет, hung-task/stall нет); в эпизоде 10 (22:15) единожды зафиксирован активный свопинг (si=8450/so=18756 KB/s). Поправка к ранней гипотезе: 3-минутного cron на гипервизоре нет (crontab bserv/root пусты, /etc/cron.d — только e2scrub_all) — триггер нагрузки внутри гостя (cron.php www-data */3 с тяжёлыми recognize/previewgenerator); всплески аллокаций в VM загоняют хост в reclaim/compaction-торможение.

| # | Окно (UTC) | Тип | Длит. | Интервал | События |
| --- | --- | --- | --- | --- | --- |
| 1 | 17:28:41–17:29:12 | ConnectTimeout | 30.4 с | — | — |
| 2 | 19:35:35–19:36:06 | ConnectTimeout | 30.4 с | ~2 ч 07 м | #431/#432 |
| 3 | 19:52:44–19:53:14 | ConnectTimeout | 30.4 с | ~17.3 м | — |
| 4 | 20:10:14–20:10:45 | ConnectTimeout | 30.4 с | ~17.5 м | #435/#436 |
| 5 | 20:37:47–20:38:18 | ReadTimeout | 31.2 с | ~27.5 м | #437/#438 |
| 6 | 20:40:57–20:41:27 | ConnectTimeout | 30.4 с | ~3.9 м | #439/#440 |
| 7 | 21:19:56–21:20:26 | ConnectTimeout | 30.4 с | ~39 м | #441/#442 |
| 8 | 21:31:27–21:31:57 | ConnectTimeout | 30.4 с | ~11.5 м | #443/#444 |
| 9 | 22:05:22–22:05:52 | ConnectTimeout | 30.4 с | ~34 м | #445/#446 |
| 10 | 22:15:43–22:16:15 | ConnectTimeout | 30.4 с | ~10.4 м | #447/#448 |
| 11 | 22:17:21–22:17:52 | ReadTimeout | 30.4 с | ~1.6 м | #449/#450 |
| 12 | 22:23:09–22:23:40 | ConnectTimeout | 30.4 с | ~5.8 м | #451/#452 |
| 13 | 22:27:20–22:27:51 | ConnectTimeout | 31.0 с | ~4.2 м | #453/#454 |
| 14 | 22:31:34–22:32:40 | ConnectTimeout | 66.2 с | ~4.2 м | #455/#456 |
| 15 | 22:40:39–22:41:10 | ConnectTimeout | 30.5 с | ~9.1 м | #457/#458 |
| 16 | 22:49:30–22:50:01 | ConnectTimeout | 30.4 с | ~8.9 м | #459/#460 |
| 17 | 23:01:26–23:01:56 | ConnectTimeout | 30.4 с | ~11.9 м | #461/#462 |
| 18 | 23:17:10–23:17:43 | ConnectTimeout | ~33 с | ~15.7 м | #463/#464 |
| 19 | 23:26:04–23:26:34 | ConnectTimeout | 30.4 с | ~8.9 м | #465/#466 |
| 20 | 23:40:54–23:41:25 | ConnectTimeout | 30.4 с | ~14.8 м | #467/#468 |
| 21 | 23:45:11–23:45:42 | ConnectTimeout | 30.4 с | ~4.3 м | #469/#470 |

Плотность: эпизоды 1–5 редкие (интервалы 17,5–39 мин), хвост серии плотный — 8 эпизодов за ~44 мин (22:05–22:49), далее интервалы 9–16 мин с отдельными провалами до 4,2–4,3 мин (эпизоды 13–14, 21). Длительности стабильны (~30 с), кроме эпизода 14 (66 с — максимум серии).

Сопутствующее: сканер уязвимостей с 192.168.1.226 в 19:32 UTC (~20 проб несуществующих .php) — шум, к серии отношения не имеет; virsh dommemstat balloon-статистика устаревшая (guest agent в VM не обновляет balloon).

### Эпизод 21 (23:45 UTC) — детали последней проверки

- 23:45:11–23:45:42 UTC: ConnectTimeout 30.4 с (события #469 down / #470 recovered), интервал от эпизода 20 ~4,3 мин; серия длится ~6,3 ч.
- VM #34 в окне здорова: пакеты агента 23:44:22/23:46:22 (120 с ровно, uptime 376676 с непрерывен), CPU 2.2–4.8%, load 1.03–1.43, RAM 9.4–10.8%, swap 28.6–28.7% (дрейф, не шторм). Остановок/рестартов внутри VM нет.
- Гипервизор bserv (проверка 23:46:30 UTC, read-only): RAM 117442/120828 MB занято (~97%), free 533 MB, swap 8191/8191 MB (100%, 0 свободно), available 1925 MB (минимум за серию), load 3.38/3.51/3.61; PSI memory some/full avg10=0.00 (активного давления в момент проверки нет); OOM-событий с 6 окт нет. Топ RSS: qemu nextcloud 32.7 GB, qemu jellyfin 16.3 GB, qemu mine 9.9 GB. virsh: nextcloud Id 34 running.
- Верификация восстановления (23:46:25 UTC): status.php → 200 (31.0.14.1, maintenance=false, needsDbUpgrade=false), все 8 сервисов hard-panel up (nextcloud 309.3 ms), все 19 серверов online.

Standing risk OOM (Incident 2026-10-06) активен и повышен: серия stall'ов возникает раньше срабатывания oom-killer'а на полностью исчерпанном swap; available опустился до ~1.9 GB (минимум серии). Детальный лог всех эпизодов: workspace rei `incident_nextcloud_2026-10-11_evening.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.
