jezahost
· обновлено 15 ноября 2026 г.
  • ipv6
  • windows-server
  • proxmox
  • cloudbase-init

IPv6 на Windows Server с cloudbase-init: почему ломается и как мы это исправили, не трогая гостевую систему

Если на Proxmox добавить ip6= в ipconfig0 Windows-VM, IPv4 пропадает. Объясняем, почему cloudbase-init так делает, какие два очевидных решения мы отвергли и какой подход на основе metadata в итоге внедрили.

Недавно мы включили нативный IPv6 на всех наших VPS. С Linux всё прошло спокойно: Proxmox записывает адрес на диск cloud-init, cloud-init применяет его при следующей загрузке, и всё. С Windows Server вышла другая история. Здесь мы описываем, что пошло не так, почему, и к какому подходу мы в итоге пришли. Если вы запускаете Windows-гостей на Proxmox с cloudbase-init, первая половина статьи, скорее всего, сэкономит вам полдня.

Исходная конфигурация

В качестве Windows-образов у нас стандартные шаблоны Windows Server 2025 с установленным cloudbase-init, настроенным на чтение Proxmox ConfigDrive. Proxmox создаёт ISO с меткой config-2, в котором лежат openstack/latest/meta_data.json и файл сетевой конфигурации. cloudbase-init читает его при первой загрузке: hostname, пароль администратора, сетевые настройки. Эта часть месяцами работала без проблем.

Для IPv6 мы сделали очевидное и добавили ip6=...,gw6=... в ipconfig0 виртуальной машины, точно так же, как для Linux.

Что произошло

Тестовая VM поднялась с IPv6-адресом и без IPv4. На адаптере был только адрес APIPA (169.254.x.x). Сервер был доступен по IPv6, но все IPv4-пути к нему, включая тот, на который опирается наш provisioning pipeline, пропали.

Почему

Proxmox записывает сетевую конфигурацию в формате Debian ENI (в стиле /etc/network/interfaces). Для dual-stack интерфейса он генерирует две секции (stanza):

auto eth0
iface eth0 inet static
    address 10.0.0.5
    netmask 255.255.255.0
    gateway 10.0.0.1

iface eth0 inet6 static
    address 2001:db8::5
    netmask 64
    gateway 2001:db8::1

ENI-парсер cloudbase-init (debiface.py) писался с расчётом на IPv4. Секцию inet6 он не считает тем же интерфейсом. Вместо этого он читает обе секции как два определения интерфейса, и поскольку во второй нет IPv4-полей, в итоге настраивает адаптер ещё раз, только по секции IPv6. Настройки IPv4 при этом перезаписываются. Документированный способ получить IPv6 через ENI-парсер cloudbase-init: строка post-up ip -6 addr add ..., а Proxmox её не генерирует.

Так что проблема не в Windows и не в Proxmox. Это несовпадение форматов между двумя инструментами, которые никогда не тестировали вместе в dual-stack.

Отвергнутый вариант 1: guest agent exec

Первое, что приходит в голову: обойти cloudbase-init и передать адрес через QEMU guest agent: qm guest exec <vmid> -- netsh interface ipv6 add address .... Это работает. И всё же мы от этого отказались.

В Proxmox право, разрешающее guest-exec, называется VM.GuestAgent.Unrestricted. Более узкой привилегии вроде «выполнить только эту команду» нет. Выдать его токену, которым пользуется наш клиентский портал, значило бы позволить порталу выполнять произвольные команды от имени SYSTEM внутри каждой гостевой системы кластера. А портал представляет собой веб-приложение, доступное из интернета. Ради IPv6-адреса мы на такой размен не пошли.

Отвергнутый вариант 2: пересоздать instance

cloudbase-init запускает свои плагины один раз для каждого instance ID. Смена ID заставляет всё выполниться заново, включая сетевой плагин. Но заново выполняется и SetUserPassword, который сбрасывает пароль администратора на тот, что указан в metadata. Для клиента, сменившего пароль после provisioning, это неприятный сюрприз.

Что мы сделали вместо этого

Гостевая система настраивает себя сама по metadata, к которой у неё уже есть доступ, и нигде не нужны новые привилегии.

  1. Metadata. Портал записывает в meta_data.json дополнительный ключ с префиксом вендора (примерно такой: "<vendor>": {"ipv6": {"address": ..., "prefix": 64, "gateway": ..., "mac": ...}}). Незнакомые ключи cloudbase-init игнорирует. ipconfig0 остаётся только с IPv4, поэтому ENI-парсер никогда не видит секцию inet6, и IPv4 остаётся нетронутым.
  2. Обновление диска. Записав ключ, портал просит Proxmox пересоздать диск cloud-init (PUT /nodes/{node}/qemu/{vmid}/cloudinit). Для этого хватает прав, которые у портала уже были. Гостевая система сразу видит новое содержимое ISO, без перезагрузки.
  3. Небольшой скрипт синхронизации в шаблоне. C:\ProgramData\<vendor>\<script>.ps1, его запускает задание планировщика от имени SYSTEM при старте и каждые две минуты. Скрипт:
    • находит том с меткой config-2 и читает meta_data.json;
    • ищет адаптер по MAC, а не по имени (зависеть от того, «Ethernet» он или «Ethernet 2», не стоит);
    • ждёт, пока у адаптера появится настоящий IPv4-адрес, прежде чем что-либо делать, поэтому никогда не гоняется с cloudbase-init при первой загрузке;
    • если ключ есть, а адреса нет: netsh interface ipv6 add address ... store=persistent плюс маршрут по умолчанию, и записывает сделанное в небольшой файл состояния;
    • если ключа больше нет, а файл состояния говорит, что адрес добавляли мы: удаляет его;
    • никогда не трогает IPv4.
  4. Проверка. Портал подтверждает результат через вызов guest agent network-get-interfaces, который работает только на чтение и требует лишь привилегии audit. Строка показывает статус «применено» только тогда, когда адрес действительно виден внутри гостевой системы, а не когда мы считаем, что он должен там быть.

Два подводных камня с заданием планировщика:

  • Register-ScheduledTask отвергает RepetitionDuration = [TimeSpan]::MaxValue с ошибкой "The task XML contains a value which is incorrectly formatted or out of range". Просто не указывайте длительность; на Server 2016+ это означает «бессрочно».
  • Сделайте установщик идемпотентным (снять регистрацию, перезаписать, зарегистрировать заново). Пока собираете шаблон, вы запустите его не один раз.

Результаты

Включение из портала: адрес появляется в гостевой системе примерно через 60 секунд, IPv4 не затронут. Переживает перезагрузку. Выключение: адрес исчезает примерно через 60 секунд. Пересборка VM из шаблона применяет его заново без ручных шагов, потому что ключ metadata переносится. Клиентский заказ Windows с отмеченным IPv6 получает адрес примерно через пять минут после первой загрузки: это собственный цикл specialize и перезагрузки cloudbase-init плюс один интервал задания.

На существующих VM, собранных из старого шаблона, скрипта нет. Мы решили не дорабатывать их задним числом; IPv6 на Windows доступен для новых серверов и для пересборок.

Выводы

  • Proxmox + cloudbase-init + dual-stack ipconfig0 из коробки не работает. Протестируйте, прежде чем выпускать.
  • У совета «просто используй guest exec» есть цена в правах доступа, которую легко недооценить.
  • Дать гостевой системе самой забирать конфигурацию из metadata, которой она и так доверяет, скучно, не требует новых привилегий, и именно этот подход действительно себя оправдал.