basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN
    МануалHomelabProxmox

    Установка Proxmox VE 9: флешка, установщик, репозиторий без подписки и первое обновление

    Девять шагов от ISO до хоста, на который можно ставить гостей: пишем флешку, включаем виртуализацию в BIOS, ставим систему, подключаем репозиторий без подписки, обновляемся, кладём ключ SSH и проверяем, что уведомления доходят. Установщик стирает выбранный диск целиком.

    Что получится

    хост      Proxmox VE 9.2 на Debian 13, ядро 7.0
    адрес     https://10.0.0.2:8006, вход root, Realm — Linux PAM
    диск      ext4: local (ISO, шаблоны) и local-lvm (диски гостей); или ZFS
    сеть      мост vmbr0 на сетевой карте, гости — в домашней сети
    пакеты    из pve-no-subscription, система обновлена
    SSH       root — только по ключу
    почта     уведомления доходят: проверено кнопкой Test

    Адреса в примере: домашняя сеть 10.0.0.0/24, роутер 10.0.0.1, хост 10.0.0.2. Свои подставляем из настроек роутера. Адрес хоста — постоянный и вне диапазона, который раздаёт DHCP роутера, иначе роутер однажды выдаст его телефону.

    Понадобятся флешка от 2 ГБ, монитор с клавиатурой на время установки и кабель от хоста к роутеру или свитчу. Wi-Fi для хоста не годится: гости в мосте поверх Wi-Fi остаются без сети («Сеть Proxmox»).

    Шаги

    1. Скачиваем ISO и пишем флешку

      ISO Proxmox VE 9.2 — на proxmox.com, раздел Downloads. Рядом с файлом — сумма SHA256; сверяем:

      sha256sum proxmox-ve_9.2-*.iso       # Linux
      certutil -hashfile proxmox-ve_9.2-1.iso SHA256      # Windows, имя файла — своё

      Флешку пишем побайтово. В Windows — balenaEtcher или Rufus: на вопросе о режиме записи выбираем DD. В Linux — dd, имя устройства флешки проверяем в lsblk дважды, dd перезапишет любой диск:

      lsblk                                         # флешка — например /dev/sdX, размер её
      dd bs=1M conv=fdatasync if=./proxmox-ve_9.2-1.iso of=/dev/sdX
    2. Включаем виртуализацию в BIOS

      В BIOS ищем Intel Virtualization Technology (VT-x) или у AMD — SVM Mode, включаем. Там же VT-d (у AMD — IOMMU): без неё не получится пробросить в машину видеокарту или контроллер дисков. Режим загрузки — UEFI. Secure Boot можно не выключать: с 8.1 Proxmox загружается с ним.

      Если в BIOS есть настройка «что делать после пропадания питания» (Restore on AC Power Loss) — ставим Power On: после отключения света хост поднимется сам, а с ним и гости с автозапуском.

    3. Выбираем диск и файловую систему

      Загружаемся с флешки, пункт Install Proxmox VE (Graphical), соглашаемся с лицензией. На экране Target Harddisk выбираем диск под систему.

      Кнопка Options — файловая система:

      • ext4 — по умолчанию. Один диск, на нём корень хоста и тонкий пул local-lvm под диски гостей.
      • zfs (RAID1) — если дисков два одинаковых: зеркало, хост переживёт смерть одного. Здесь же поле ARC max size — сколько памяти ZFS заберёт под кэш; установщик предлагает 10 % памяти, не больше 16 ГиБ.
      • zfs (RAID0) на одном диске — снимки и сжатие ZFS без зеркала.

      Чем отличаются и что выбрать — «Хранилища Proxmox». Остальные поля Options (размеры корня, подкачки, пула) оставляем как есть: установщик считает их от размера диска.

    4. Страна, пароль и сеть

      Location and Time Zone — страна, свой часовой пояс, раскладка клавиатуры.

      Administration Password and Email — пароль root и почта: на неё Proxmox отправляет письма о бэкапах и ошибках дисков. Дойдут ли они — зависит от отправки почты, её проверяем в последнем шаге. Пароль root — длинный: с ним входят и в веб-интерфейс.

      Management Network Configuration:

      Поле Пример Почему так
      Management Interface enp1s0 карта, в которую воткнут кабель; рядом — её MAC и состояние связи
      Закрепление имён карт (с 9.1) включаем после установки карта станет nic0, и имя не сменится после обновления ядра
      Hostname (FQDN) pve1.home.arpa имя хоста и домен; своего домена нет — home.arpa, он зарезервирован для домашних сетей
      IP Address (CIDR) 10.0.0.2/24 постоянный адрес вне диапазона DHCP роутера
      Gateway 10.0.0.1 роутер
      DNS Server 10.0.0.1 роутер или свой DNS

      Имя и адрес выбираем сразу: поменять их можно и потом, но править придётся в нескольких местах («Имя и адрес узла»).

      На экране Summary проверяем всё ещё раз, оставляем галку Automatically reboot after successful installation и жмём Install. Через несколько минут хост уйдёт в перезагрузку — в этот момент вынимаем флешку, иначе он может снова загрузиться с неё, в установщик.

    5. Входим в веб-интерфейс

      В консоли хоста над приглашением входа написан адрес: https://10.0.0.2:8006/. Открываем его в браузере на компьютере из той же сети — только https, на http порт не отвечает. Браузер предупредит о сертификате: он самоподписанный, принимаем.

      Вход: User name root, пароль из установки, в списке под паролем — Linux PAM standard authentication. Появится окно No valid subscription — закрываем кнопкой OK. Оно будет при каждом входе и на работу не влияет. Насовсем окно убирает только ключ подписки; скрипты, которые правят proxmoxlib.js, работают до следующего обновления пакета proxmox-widget-toolkit.

    6. Подключаем репозиторий без подписки

      После установки включены репозитории enterprise, а они открываются только с ключом подписки: apt update падает с 401 Unauthorized. Переключаем на pve-no-subscription:

      1. Узел (в дереве слева, pve1) › Updates › Repositories.
      2. Строка с pve-enterprise — Disable. Строка с Ceph и компонентом enterprise — тоже Disable.
      3. Add › No-Subscription › Add.

      Сверху страницы останется жёлтое предупреждение, что no-subscription не рекомендован для прода. Для дома и лаборатории это нормальный выбор: пакеты те же, что попадут в enterprise, только раньше. Как это выглядит в файлах .sources — «Репозиторий без подписки».

    7. Обновляемся

      Узел › Updates › Refresh, затем Upgrade — откроется консоль с обновлением. Или в Shell узла:

      apt update
      apt full-upgrade

      Только full-upgrade (или dist-upgrade), как в FAQ Proxmox: обновление Proxmox приносит новые пакеты и меняет зависимости, и apt upgrade оставит часть пакетов недообновлёнными.

      Если обновилось ядро (пакеты proxmox-kernel-…), перезагружаемся: узел › Reboot. Какое ядро работает, а какое установлено — pveversion -v | head -3.

    8. Кладём ключ SSH и закрываем вход по паролю

      С компьютера, где уже есть ключ («Ключи SSH»):

      ssh-copy-id [email protected]
      ssh [email protected] 'hostname'          # входит без пароля, печатает pve1

      Когда вход по ключу работает, запрещаем root входить по SSH с паролем — пароль останется для консоли и веб-интерфейса:

      echo 'PermitRootLogin prohibit-password' > /etc/ssh/sshd_config.d/10-root-key.conf
      sshd -t && systemctl reload ssh

      Файл в sshd_config.d читается раньше основного sshd_config, а в sshd действует первое найденное значение. Перед reload держим открытой вторую сессию («Старая сессия остаётся открытой»).

    9. Проверяем уведомления

      Datacenter › Notifications. Там уже есть получатель mail-to-root — почта из установки. Выбираем его и жмём Test. Письмо не пришло за пару минут, в том числе в спам — добавляем Add › SMTP: сервер почтового сервиса, логин и пароль приложения, — и проверяем им. Без рабочей почты о сбое бэкапа или умирающем диске узнаем, когда будет поздно.

    Если не работает

    После выбора пункта установщика — чёрный экран

    Причина
    Графическому установщику не подошёл видеодрайвер: так бывает со свежими и с серверными видеокартами.
    Делаем
    В меню загрузки — Install Proxmox VE (Terminal UI): тот же установщик в текстовом режиме, графика ему не нужна.

    Флешка не загружается, или установщик не находит установочный носитель

    Причина
    Rufus записал образ в режиме ISO, а нужен побайтовый режим DD. Или флешку готовили UNetbootin — документация Proxmox прямо говорит, что с ним образ не работает, — или Ventoy.
    Делаем
    Пишем заново: Rufus с выбором DD на вопросе о режиме, balenaEtcher или dd в Linux.

    Установщик предупреждает, что нет аппаратной поддержки KVM

    Причина
    В BIOS выключены Intel VT-x или AMD SVM. Proxmox поставится, но виртуальные машины не запустятся.
    Делаем
    Перезагружаемся в BIOS, включаем виртуализацию (шаг 2) и запускаем установку заново.

    Установка прошла, а https://10.0.0.2:8006 не открывается

    Причина
    Адрес или шлюз хоста не из домашней сети, адрес занят другим устройством, или кабель воткнут не в ту карту, что выбрана в установщике.
    Делаем
    В консоли хоста: ip -br addr — адрес на vmbr0, ping 10.0.0.1 — роутер отвечает. Не так — правим /etc/network/interfaces и /etc/hosts («Имя и адрес узла»), затем ifreload -a.

    apt update: 401 Unauthorized от enterprise.proxmox.com

    Причина
    Остался включённым один из enterprise-репозиториев: Proxmox VE или Ceph.
    Делаем
    Узел › Updates › Repositories — у обоих Disable («Репозиторий без подписки»).

    Письма о бэкапах и обновлениях не приходят

    Причина
    Уведомления по умолчанию уходят через локальный postfix прямо на сервер получателя. Почтовые сервисы такие письма с домашнего адреса отклоняют или кладут в спам.
    Делаем
    Datacenter › Notifications › Add › SMTP — через почтовый ящик с паролем приложения; или Gotify, или webhook. Кнопка Test проверяет сразу.

    Как проверить

    В Shell узла:

    pveversion
    # pve-manager/9.2.21/4f6e0ac86f9e8c7f (running kernel: 7.0.14-25-pve)
    pvesm status            # local и local-lvm (или local-zfs) — active
    apt update              # ни одной строки с 401 и Err
    apt list --upgradable   # пусто: всё обновлено
    ip -br addr show vmbr0  # vmbr0  UP  10.0.0.2/24

    С компьютера: ssh [email protected] входит по ключу, а ssh -o PubkeyAuthentication=no [email protected] получает Permission denied — вход по паролю закрыт. Дальше — первая машина из шаблона («Шаблон VM с cloud-init») или контейнер («Первый контейнер LXC»).