Proxmox: репозиторий без подписки — настройка и обновление

Ошибка 401 Unauthorized или сообщение «You do not have a valid subscription» при выполнении apt update на сервере Proxmox VE почти всегда означает одно: система пытается обратиться к enterprise-репозиторию, доступ к которому открывается только по платной подписке. Проблема решается переключением на бесплатный репозиторий no-subscription, который официально поддерживается разработчиками Proxmox и не требует лицензионного ключа.

В этой статье разберём, как правильно отключить enterprise-источник, подключить репозиторий без подписки через веб-интерфейс и командную строку, а также как проверить, что обновления устанавливаются корректно. Все шаги обратимы и безопасны: репозитории можно переключать в любой момент без риска для работающих виртуальных машин.

Зачем Proxmox требует подписку и что такое no-subscription

Proxmox VE распространяется бесплатно по лицензии AGPL, однако по умолчанию в свежей установке активирован enterprise-репозиторийenterprise.proxmox.com. Он предназначен для коммерческих пользователей с оплаченной подпиской и содержит пакеты, прошедшие дополнительное тестирование стабильности. Без действующего ключа сервер не может скачать оттуда ни одного пакета, поэтому apt update завершается ошибкой.

Для домашних лабораторий, тестовых стендов и небольших проектов предусмотрен репозиторий no-subscription. Важно понимать: это не «пиратский обход», а официальный источник пакетов, который сам Proxmox рекомендует пользователям без подписки. Пакеты там те же самые, но они попадают туда без дополнительного этапа корпоративной проверки.

  • 🔓 No-subscription — бесплатный репозиторий, не требует ключа, подходит для тестовых и домашних систем.
  • 🏢 Enterprise — платный, с гарантированной стабильностью пакетов и доступом к поддержке.
  • 🧪 Test (ptest) — репозиторий для тестирования новейших пакетов, в продакшене использовать не стоит.

Проверка текущих источников обновлений

Прежде чем что-то менять, посмотрите, какие репозитории уже подключены. Откройте консоль сервера (через веб-интерфейс: узел → Shell) и выполните:

cat /etc/apt/sources.list

ls /etc/apt/sources.list.d/

В зависимости от версии Proxmox конфигурация может лежать в разных местах. В версиях на базе Debian 11 и старше enterprise-источник обычно находится в файле /etc/apt/sources.list.d/pve-enterprise.list. В Proxmox VE 9 (на базе Debian 13) используется новый формат .sources, и файлы могут называться pve-enterprise.sources и debian.sources — проверьте содержимое каталога командой выше.

Если в выводе видна строка с enterprise.proxmox.com и она не закомментирована — это и есть причина ошибки при обновлении. Заодно убедитесь, что стандартные репозитории Debian присутствуют: без них система не получит базовые пакеты.

Отключение enterprise-репозитория

Самый простой способ — через веб-интерфейс. Перейдите в раздел узла → UpdatesRepositories. Здесь отображаются все настроенные источники. Выделите строку с enterprise-репозиторием и нажмите кнопку Disable. Статус изменится, и источник перестанет участвовать в обновлении.

Тот же результат достигается из консоли — закомментируйте строку, добавив символ # в начало:

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

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

⚠️ Внимание: не удаляйте файл enterprise-репозитория полностью. Если позже вы приобретёте подписку, достаточно будет раскомментировать строку или включить источник обратно через веб-интерфейс. Удалённый файл придётся восстанавливать вручную.

Подключение репозитория no-subscription

В том же разделе Updates → Repositories нажмите кнопку Add и выберите из списка No-Subscription. Веб-интерфейс сам сформирует корректную запись под вашу версию Proxmox — это самый надёжный способ, исключающий опечатки в адресе и кодовом имени релиза Debian.

Если предпочитаете работать через терминал, создайте файл с источником вручную. Для Proxmox VE 8 (Debian 12, bookworm) запись выглядит так:

echo "deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription" > /etc/apt/sources.list.d/pve-no-subscription.list

Кодовое имя релиза должно соответствовать вашей версии системы: для PVE 7 это bullseye, для PVE 8 — bookworm, для PVE 9 — trixie. Узнать текущее имя можно командой cat /etc/os-release. Не копируйте строку из чужих инструкций вслепую — несовпадение кодового имени приведёт к ошибкам при обновлении.

☑️ Настройка репозитория без подписки

Выполнено: 0 / 5

Обновление системы после переключения

После смены источников обновите индексы пакетов и установите доступные обновления. В Proxmox вместо привычного apt upgrade рекомендуется использовать dist-upgrade — он корректно обрабатывает изменения зависимостей, что критично для пакетов гипервизора:

apt update

apt dist-upgrade

Если команда apt update завершилась без строк с ошибками 401 или Failed to fetch — репозиторий настроен правильно. В процессе обновления может обновиться и ядро: в этом случае потребуется перезагрузка сервера. Заранее мигрируйте виртуальные машины на другие узлы кластера или корректно выключите их, если сервер один.

📊 Где вы используете Proxmox без подписки?
Домашняя лаборатория
Тестовый стенд на работе
Небольшой продакшен
Только изучаю платформу
⚠️ Внимание: перед первым крупным обновлением сделайте резервные копии конфигурации (/etc/pve) и важных виртуальных машин. Репозиторий no-subscription получает пакеты без дополнительного этапа enterprise-тестирования, поэтому для критичных систем стоит выдерживать паузу в несколько дней после выхода обновлений и следить за сообщениями на официальном форуме Proxmox.

Ошибки обновления и уведомление о подписке

Даже после правильной настройки репозитория при входе в веб-интерфейс будет появляться всплывающее окно «No valid subscription». Это лишь информационное напоминание — на функциональность оно не влияет: все возможности гипервизора, включая кластер, миграцию и бэкапы, работают без ограничений. Окно просто закрывается кнопкой OK.

В сети встречаются инструкции по правке файлов интерфейса для подавления этого сообщения. Учтите: такие правки перезаписываются при обновлении пакетов веб-интерфейса, и их придётся повторять. Кроме того, вмешательство в код панели — потенциальный источник проблем при апгрейде, поэтому безопаснее смириться с уведомлением.

ПроблемаВероятная причинаРешение
Ошибка 401 при apt updateАктивен enterprise-репозиторий без подпискиОтключить его, подключить no-subscription
Failed to fetch, неверное имя релизаКодовое имя Debian не совпадает с версией PVEСверить с /etc/os-release и исправить строку
Окно «No valid subscription» при входеШтатное напоминание для систем без лицензииЗакрыть, на работу не влияет
Пакеты не находятся после смены источникаНе выполнен apt updateОбновить индексы пакетов

Стоит ли покупать подписку

Для домашнего сервера и учебных целей репозитория no-subscription достаточно — вы получаете те же обновления безопасности и новые версии пакетов. Подписка имеет смысл в коммерческих сценариях: она даёт доступ к стабилизированному enterprise-репозиторию, технической поддержке разработчиков и юридически чистую схему использования в бизнесе.

Разработчики честно называют no-subscription источником, не рекомендованным для продакшена. На практике многие небольшие компании используют его годами без инцидентов, но решение о рисках остаётся за вами. Компромиссный вариант — подписка младшего уровня на критичные узлы и no-subscription на тестовых стендах.

Аналогичная настройка для Proxmox Backup Server

Proxmox Backup Server использует ту же схему: по умолчанию включён enterprise-репозиторий, а бесплатный называется pbs-no-subscription. Отключается и подключается он аналогично — через раздел Repositories в веб-интерфейсе PBS или правкой файлов в /etc/apt/sources.list.d/.

Часто задаваемые вопросы

Законно ли использовать репозиторий no-subscription?

Да. Это официальный репозиторий, предоставляемый самой компанией Proxmox для пользователей без подписки. Его подключение не является обходом лицензии — Proxmox VE распространяется под свободной лицензией AGPL.

Чем пакеты no-subscription отличаются от enterprise?

Содержимое пакетов идентично, но в enterprise они проходят дополнительный этап тестирования стабильности перед публикацией. В no-subscription обновления появляются раньше, что повышает шанс столкнуться со свежими недоработками.

Пропадут ли виртуальные машины при смене репозитория?

Нет. Изменение источников apt никак не затрагивает виртуальные машины, хранилища и конфигурацию кластера. Работающие ВМ продолжают работу даже во время установки обновлений.

Почему apt update всё равно выдаёт ошибку после настройки?

Проверьте, что enterprise-строка действительно закомментирована во всех файлах каталога /etc/apt/sources.list.d/, и что кодовое имя релиза в новой записи совпадает с версией системы из /etc/os-release. После правок повторите apt update.

Нужно ли обновлять Proxmox VE 7 до новой версии?

Старые мажорные версии со временем перестают получать обновления, а их репозитории могут быть переведены в архив. Если ваша версия достигла конца поддержки, планируйте обновление до актуального релиза по официальной документации Proxmox.