# Обновление Proxmox VE 8 до 9: порядок, проверки и откат

> Пошаговый план обновления Proxmox VE 8 до 9: проверка кластера, смена репозиториев APT, порядок узлов и откат при сбое.

Мажорное обновление Proxmox VE меняет версию Debian под капотом, схему хранения конфигурации и иногда формат файлов виртуальных машин. Обновление вслепую командой `apt full-upgrade` без подготовки — верный способ получить кластер без кворума посреди рабочего дня.

## Что меняется при переходе с Proxmox VE 8 на 9

Proxmox VE 9 переезжает на новый релиз Debian, обновляет ядро Linux и версии QEMU, LXC и ZFS. Часть параметров в файлах `/etc/pve/qemu-server/*.conf` и сетевых настройках может требовать ручной правки после обновления. Прежде чем обновлять прод, прогоните апгрейд на тестовом узле или отдельной VM с похожей конфигурацией.

## Подготовка кластера к обновлению

Перед стартом сделайте снапшот конфигурации кластера и бэкапы критичных виртуальных машин через [Proxmox Backup Server](https://www.zevshost.net/ru/kb/proxmox-backup-server/). Затем запустите штатный чек-скрипт совместимости на каждом узле:

```
pve8to9 --full
```

Скрипт проверяет версии пакетов, конфигурацию кластера, storage.cfg и сетевые мосты, помечая проблемы значками FAIL и WARN. Обновление стоит начинать только тогда, когда список FAIL пуст.

## Как переключить репозитории APT на новый релиз

До запуска обновления пакетов замените ссылки на репозитории Proxmox и Debian в файлах источников:

| Файл | Было | Стало |
| --- | --- | --- |
| /etc/apt/sources.list | bookworm | trixie |
| /etc/apt/sources.list.d/pve-enterprise.list | bookworm | trixie |
| /etc/apt/sources.list.d/ceph.list | quincy/bookworm | squid/trixie |

После правки файлов обновите индекс пакетов и убедитесь, что нет ошибок подключения к репозиториям:

```
sed -i 's/bookworm/trixie/g' /etc/apt/sources.list.d/pve-enterprise.list
apt update
```

## В каком порядке обновлять узлы кластера

Обновление кластера идёт по одному узлу за раз, чтобы кворум не терялся ни на секунду:

1. Мигрируйте виртуальные машины с обновляемого узла на соседние командой [живой миграции](https://www.zevshost.net/ru/kb/proxmox-migration-live/) или через веб-интерфейс.
2. Выключите службы HA для узла или переведите его в режим обслуживания.
3. Обновите пакеты и перезагрузите узел, дождитесь возврата в кластер и появления зелёного статуса кворума.
4. Верните виртуальные машины на обновлённый узел и переходите к следующему.

## Как обновить пакеты и перезагрузить узел

Сама установка пакетов выполняется двумя командами подряд, между которыми стоит проверить журнал на ошибки зависимостей:

```
apt full-upgrade
reboot
```

После перезагрузки проверьте версию через `pveversion` и статус служб `pve-cluster`, `pvedaemon` и `corosync`. Если узел не входит в кластер за 2-3 минуты, смотрите журнал `journalctl -u corosync` на предмет рассинхронизации версий протокола.

## План отката, если обновление пошло не так

- Если узел не загрузился, выберите предыдущее ядро в меню GRUB — старые версии ядра не удаляются автоматически при обновлении.
- Если сломалась сеть, восстановите файл `/etc/network/interfaces` из резервной копии, снятой перед обновлением.
- Если пакетный менеджер завис на середине операции, выполните `dpkg --configure -a` и повторите `apt full-upgrade`.
- Если узел не подлежит восстановлению, разверните виртуальные машины на исправном узле из бэкапа PBS и исключите проблемный узел из кластера.

## Чек-лист после обновления кластера

Обновление Proxmox VE 8 до 9 считается завершённым, когда выполнены все пункты:

- Все узлы показывают одинаковую версию в выводе `pveversion`.
- Кворум кластера собран, статус corosync зелёный на всех узлах.
- Все виртуальные машины и контейнеры запущены и отвечают на пинг.
- Задания резервного копирования отработали хотя бы один раз без ошибок после обновления.

---

Источник: https://www.zevshost.net/ru/kb/proxmox-obnovlenie-8-na-9/