← Back to blog

Proxmox VE Post Install

Oct, 26, 2025

#proxmox#virtualization#devops

⚙️ Теория

🧩 Введение

После установки Proxmox VE обычно делают три вещи:

  • настраивают корректные репозитории;
  • обновляют систему;
  • при необходимости включают PCI passthrough.

Ниже только шаги, соответствующие официальной документации Proxmox.

⚙️ 1. Проверить версию и релиз

Перед настройкой репозиториев проверьте версию Proxmox VE и codename Debian:

pveversion -v
cat /etc/os-release

Это важно: строки репозиториев зависят от вашей версии PVE и Debian.

📦 2. Репозитории Proxmox

Отключить enterprise-репозиторий (если нет подписки)

Файл:

/etc/apt/sources.list.d/pve-enterprise.list

Пример строки (закомментировать):

# deb https://enterprise.proxmox.com/debian/pve bookworm pve-enterprise

Добавить no-subscription репозиторий

Для PVE 8 (Debian bookworm) пример:

deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription

Если у вас другой релиз, используйте соответствующий codename из официальной таблицы репозиториев.

Ceph-репозиторий

Нужен только если вы реально используете Ceph.
Версия Ceph должна соответствовать версии Proxmox VE (сверяйте по официальной документации).

🔄 3. Обновить систему

apt update
apt full-upgrade
reboot

ℹ️ 4. Сообщение “No valid subscription”

Это информационное уведомление при использовании pve-no-subscription.
Официально поддерживаемого способа “убрать баннер” без подписки нет.

Рекомендация для production: использовать подписку и enterprise-репозиторий.

🧠 5. PCI Passthrough (базовый, документированный сценарий)

Предусловия

  • CPU/плата поддерживают VT-d (Intel) или AMD-Vi/IOMMU (AMD);
  • включено в BIOS/UEFI;
  • устройство находится в отдельной IOMMU-группе.

Включить IOMMU в kernel cmdline (GRUB)

Файл:

/etc/default/grub

Intel:

GRUB_CMDLINE_LINUX_DEFAULT="quiet intel_iommu=on iommu=pt"

AMD:

GRUB_CMDLINE_LINUX_DEFAULT="quiet amd_iommu=on iommu=pt"

Применить:

update-grub
reboot

Если у вас не GRUB-схема загрузки, используйте соответствующую процедуру из wiki Proxmox.

Подгрузить VFIO-модули

cat >/etc/modules-load.d/vfio.conf <<'EOF'
vfio
vfio_pci
vfio_iommu_type1
EOF

update-initramfs -u -k all
reboot

Проверка IOMMU

dmesg | grep -E "DMAR|IOMMU"

Проверка IOMMU-групп

find /sys/kernel/iommu_groups/ -type l

Привязка устройства к vfio-pci

  1. Узнать PCI IDs:
lspci -nn
  1. Добавить IDs в конфиг:
echo "options vfio-pci ids=10de:1b80,10de:10f0" >/etc/modprobe.d/vfio.conf
update-initramfs -u -k all
reboot

Замените IDs на ваши.

Назначить устройство ВМ

qm set <VMID> -hostpci0 0000:01:00,pcie=1

Для диска по /dev/disk/by-id:

qm set <VMID> -scsi1 /dev/disk/by-id/<DISK-ID>

🧪 Практика

  • Используйте команды и примеры из разделов выше как рабочий чеклист.
  • Перед применением в production валидируйте изменения на test/stage и сверяйте с официальной документацией.

🧾 Вывод

Этот post-install чеклист покрывает безопасный минимум:

  • корректные репозитории;
  • предсказуемые обновления;
  • базовый PCI passthrough без неподдерживаемых “хакающих” шагов.

📚 Ссылки

✅ Проверка источников

Proxmox VE Post Install | Aleksandr Suprun