Главная / Гайды

Гайды

Короткие и проверенные инструкции. Каждый гайд протестирован на чистой установке и обновляется вместе с релизами Proxmox.

Обновление Proxmox VE 8 → 9

⏱ 25 минутОбновлено 08.11.2026Сложность: средняя

Proxmox VE 9 основан на Debian 13 «Trixie». Перед обновлением убедитесь, что все ноды кластера на последней версии 8.4 и нет ошибок в выводе утилиты проверки.

Обязательно сделайте бэкап VM и конфигурации /etc/pve. Обновляйте ноды кластера по одной.

1. Проверка готовности

apt update && apt dist-upgrade -y
pve8to9 --full   # не должно быть FAIL

2. Смена репозиториев

sed -i 's/bookworm/trixie/g' /etc/apt/sources.list
cat > /etc/apt/sources.list.d/proxmox.sources <<'EOF'
Types: deb
URIs: http://download.proxmox.com/debian/pve
Suites: trixie
Components: pve-no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF

3. Обновление и перезагрузка

apt update && apt dist-upgrade
reboot

Скрипт pve-post-install умеет выполнить шаг 2 автоматически и вернуть всё обратно при ошибке.

Тюнинг ZFS ARC

⏱ 10 минутОбновлено 21.10.2026Сложность: лёгкая

По умолчанию ARC может занять до 10% RAM (в новых установках) или до 50% (в старых). На хостах с большим количеством VM это приводит к давлению на память и OOM.

  • Гипервизор с VM: zfs_arc_max ≈ 2 ГБ + 1 ГБ на каждый ТБ пула;
  • Файловый сервер: можно отдать ARC до 50–70% RAM;
  • Минимум держите не ниже 1 ГБ, иначе упадёт производительность метаданных.
# 16 ГБ максимум, 4 ГБ минимум
echo "options zfs zfs_arc_max=17179869184 zfs_arc_min=4294967296" > /etc/modprobe.d/zfs.conf
update-initramfs -u -k all
echo 17179869184 > /sys/module/zfs/parameters/zfs_arc_max   # применить без перезагрузки

Проброс GPU (PCIe passthrough)

⏱ 40 минутОбновлено 30.10.2026Сложность: высокая

Включите в BIOS/UEFI VT-d / AMD-Vi и Above 4G Decoding. Для систем с systemd-boot параметры ядра задаются в /etc/kernel/cmdline.

# Intel; для AMD IOMMU включён по умолчанию
echo "root=ZFS=rpool/ROOT/pve-1 boot=zfs intel_iommu=on iommu=pt" > /etc/kernel/cmdline
proxmox-boot-tool refresh
printf "vfio\nvfio_iommu_type1\nvfio_pci\n" >> /etc/modules
echo "blacklist nouveau" > /etc/modprobe.d/blacklist-gpu.conf
Проверить группы IOMMU удобно утилитой iommu-groups: устройство должно быть в отдельной группе или вместе со своим аудио-контроллером.

После перезагрузки добавьте устройство в VM: qm set 101 -hostpci0 0000:01:00,pcie=1,x-vga=1 (тип машины — q35, BIOS — OVMF).

Бэкапы Proxmox Backup Server в S3

⏱ 15 минутОбновлено 10.11.2026Сложность: лёгкая

Начиная с PBS 4.0 datastore может располагаться прямо в S3-совместимом хранилище, а локальный диск используется как кеш. Пример для Awesome S3:

proxmox-backup-manager s3 endpoint create awesome-s3 \
  --endpoint '{{bucket}}.s3.awesome.ru.net' --region ru-msk-1 \
  --access-key 'AKIA…' --secret-key '…'

proxmox-backup-manager datastore create offsite /mnt/cache \
  --backend type=s3,client=awesome-s3,bucket=pbs-offsite

Для PBS 3.x используйте синхронизацию через rclone — её делает скрипт pbs-s3-sync с ротацией и шифрованием на стороне клиента.

Кластер из 3 нод с Ceph

⏱ 1,5 часаОбновлено 11.11.2026Сложность: высокая
  1. Выделите отдельную сеть для corosync (1 Гбит/с достаточно, важна задержка < 2 мс);
  2. Для Ceph — минимум 10 Гбит/с, лучше 25 Гбит/с, MTU 9000;
  3. По одному OSD на NVMe, без аппаратного RAID.
pvecm create prod --link0 10.10.0.11
# на остальных нодах
pvecm add 10.10.0.11 --link0 10.10.0.12
pveceph install --repository no-subscription
pveceph init --network 10.20.0.0/24
pveceph mon create && pveceph osd create /dev/nvme1n1

Docker внутри непривилегированного LXC

⏱ 10 минутОбновлено 01.11.2026Сложность: лёгкая

Это экономит RAM по сравнению с отдельной VM, но ядро общее с хостом — для недоверенных нагрузок используйте VM.

pct set 200 --features nesting=1,keyctl=1
pct restart 200
pct exec 200 -- bash -c "curl -fsSL https://get.docker.com | sh"

Остался вопрос? Напишите нам — дополним гайд.