jezahost
· yenilənib: 15 noyabr 2026
  • ipv6
  • windows-server
  • proxmox
  • cloudbase-init

cloudbase-init ilə Windows Server-də IPv6: niyə sınır və onu qonaq sistemə toxunmadan necə düzəltdik

Proxmox-da Windows VM-in ipconfig0-ına ip6= əlavə edəndə IPv4 silinir. cloudbase-init-in bunu niyə etdiyini, rədd etdiyimiz iki ilk ağla gələn həlli və tətbiq etdiyimiz metadata əsaslı yanaşmanı izah edirik.

Bu yaxınlarda təklif etdiyimiz bütün VPS-lərə native IPv6 verdik. Linux-da heç bir sürpriz olmadı: Proxmox ünvanı cloud-init diskinə yazır, cloud-init onu növbəti açılışda tətbiq edir, vəssalam. Windows Server-də isə hekayə başqa cür oldu. Bu yazı nəyin səhv getdiyini, niyə belə olduğunu və sonda hansı yanaşmaya gəldiyimizi təsvir edir. Əgər Proxmox-da cloudbase-init ilə Windows qonaq sistemləri işlədirsinizsə, məqalənin ilk yarısı yəqin ki, sizə bir günortaya qənaət edəcək.

Quruluş

Windows imicimiz standart Windows Server 2025 şablonlarıdır: cloudbase-init quraşdırılıb və Proxmox ConfigDrive-ı oxumağa sazlanıb. Proxmox config-2 etiketli ISO yaradır, onun içində openstack/latest/meta_data.json və şəbəkə konfiqurasiya faylı olur. cloudbase-init onu ilk açılışda oxuyur: hostname, administrator parolu, şəbəkə ayarları. Bu hissə aylardır problemsiz işləyirdi.

IPv6 üçün ən sadə yolu seçdik və VM-in ipconfig0-ına ip6=...,gw6=... əlavə etdik, eynilə Linux-da olduğu kimi.

Nə baş verdi

Test VM öz IPv6 ünvanı ilə açıldı, amma IPv4 yox idi. Adapterdə yalnız APIPA (169.254.x.x) ünvanı vardı. Serverə IPv6 ilə çatmaq olurdu, amma ona aparan bütün IPv4 yolları, o cümlədən provisioning pipeline-ımızın asılı olduğu yol, itmişdi.

Niyə

Proxmox şəbəkə konfiqurasiyasını Debian ENI formatında (/etc/network/interfaces üslubunda) yazır. Dual-stack interfeys üçün iki stanza yaradır:

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

cloudbase-init-in ENI parseri (debiface.py) IPv4 nəzərə alınaraq yazılıb. O, inet6 stanzasını eyni interfeys kimi qəbul etmir. Bunun əvəzinə hər iki stanzanı iki ayrı interfeys tərifi kimi oxuyur və ikincisində IPv4 sahələri olmadığından adapteri bir daha, yalnız IPv6 stanzasına əsasən konfiqurasiya edir. Bu zaman IPv4 ayarları üzərinə yazılır. cloudbase-init-in ENI parseri vasitəsilə IPv6 almağın sənədləşdirilmiş yolu post-up ip -6 addr add ... sətridir, Proxmox isə belə sətir yaratmır.

Deməli, problem nə Windows-dadır, nə də Proxmox-da. Bu, dual-stack üçün heç vaxt birlikdə test edilməmiş iki alət arasında format uyğunsuzluğudur.

Rədd etdiyimiz 1-ci variant: guest agent exec

Ağla gələn ilk həll cloudbase-init-i kənara qoyub ünvanı QEMU guest agent vasitəsilə ötürməkdir: qm guest exec <vmid> -- netsh interface ipv6 add address .... Bu işləyir. Yenə də rədd etdik.

Proxmox-da guest-exec-ə icazə verən hüquq VM.GuestAgent.Unrestricted-dir. «Yalnız bu bir əmri işlət» kimi daha dar hüquq yoxdur. Onu müştəri portalımızın istifadə etdiyi token-ə versək, portal klasterdəki hər qonaq sistemin içində SYSTEM adından istənilən əmri icra edə bilərdi. Portal internetə açıq veb tətbiqdir. Bir IPv6 ünvanı üçün belə güzəştə getməyə hazır deyildik.

Rədd etdiyimiz 2-ci variant: instansiyanı yenidən yaratmaq

cloudbase-init plaginlərini hər instance ID üçün bir dəfə işlədir. ID-ni dəyişmək hamısını, o cümlədən şəbəkə plaginini yenidən işə salır. Amma bu, SetUserPassword-u da yenidən işlədir və administrator parolunu metadata-da nə varsa ona sıfırlayır. Provisioning-dən sonra parolunu dəyişmiş müştəri üçün bu, xoşagəlməz sürprizdir.

Bunun əvəzinə nə etdik

Qonaq sistem özünü artıq çıxışı olan metadata əsasında özü konfiqurasiya edir və heç yerdə yeni hüquq lazım olmur.

  1. Metadata. Portal meta_data.json-a əlavə, vendor prefiksli açar yazır (təxminən belə: "<vendor>": {"ipv6": {"address": ..., "prefix": 64, "gateway": ..., "mac": ...}}). cloudbase-init tanımadığı açarlara məhəl qoymur. ipconfig0 yalnız IPv4 olaraq qalır, ona görə də ENI parseri heç vaxt inet6 stanzası görmür və IPv4 toxunulmaz qalır.
  2. Diskin yenilənməsi. Açarı yazdıqdan sonra portal Proxmox-dan cloud-init diskini yenidən yaratmağı xahiş edir (PUT /nodes/{node}/qemu/{vmid}/cloudinit). Bunun üçün portalın onsuz da olan hüquqları kifayətdir. Qonaq sistem yeni ISO məzmununu dərhal görür, yenidən yükləmə olmadan.
  3. Şablonda kiçik sinxronizasiya skripti. C:\ProgramData\<vendor>\<script>.ps1, planlaşdırılmış tapşırıq onu SYSTEM adından açılışda və hər iki dəqiqədən bir işlədir. Skript:
    • config-2 etiketli tomu tapır və meta_data.json-u oxuyur;
    • adapteri adı ilə yox, MAC ilə tapır («Ethernet» və ya «Ethernet 2»: bundan asılı olmaq istəməzsiniz);
    • nəsə etməzdən əvvəl adapterdə real IPv4 ünvanı olana qədər gözləyir, beləliklə ilk açılışda cloudbase-init ilə heç vaxt yarışmır;
    • açar varsa və ünvan yoxdursa: netsh interface ipv6 add address ... store=persistent və default route, etdiyini kiçik vəziyyət faylına qeyd edir;
    • açar yoxa çıxıbsa və vəziyyət faylı ünvanı bizim əlavə etdiyimizi göstərirsə: onu silir;
    • IPv4-ə heç vaxt toxunmur.
  4. Yoxlama. Portal nəticəni guest agent-in yalnız oxuyan network-get-interfaces çağırışı ilə təsdiqləyir, bunun üçün yalnız audit hüququ lazımdır. Sətir «tətbiq olunub» statusunu yalnız ünvan qonaq sistemin içində həqiqətən görünəndə göstərir, bizim belə olmalıdır deyə düşündüyümüz anda yox.

Planlaşdırılmış tapşırıqla bağlı iki tələ:

  • Register-ScheduledTask RepetitionDuration = [TimeSpan]::MaxValue dəyərini "The task XML contains a value which is incorrectly formatted or out of range" xətası ilə rədd edir. Müddəti sadəcə göstərməyin; Server 2016+ versiyalarında bu, limitsiz deməkdir.
  • Quraşdırıcını idempotent edin (qeydiyyatdan çıxar, üzərinə yaz, yenidən qeydiyyata al). Şablonu qurarkən onu bir dəfədən çox işlədəcəksiniz.

Nəticələr

Portaldan aktivləşdirmə: ünvan təxminən 60 saniyəyə qonaq sistemdə görünür, IPv4-ə toxunulmur. Yenidən yükləmədən sonra da qalır. Deaktivləşdirmə: ünvan təxminən 60 saniyəyə yox olur. VM-i şablondan yenidən qurmaq onu heç bir əl addımı olmadan yenidən tətbiq edir, çünki metadata açarı köçürülür. IPv6 seçilmiş Windows sifarişi ünvanını ilk açılışdan təxminən beş dəqiqə sonra alır: bu, cloudbase-init-in öz specialize və yenidən yükləmə dövrü üstəgəl bir tapşırıq intervalıdır.

Köhnə şablondan qurulmuş mövcud VM-lərdə bu skript yoxdur. Onlara sonradan əlavə etməmək qərarına gəldik; Windows-da IPv6 yeni serverlər və yenidən qurulanlar üçün mövcuddur.

Əsas dərslər

  • Proxmox + cloudbase-init + dual-stack ipconfig0 hazır halda sınıqdır. İstifadəyə verməzdən əvvəl test edin.
  • «Sadəcə guest exec işlət» yanaşmasının asanlıqla azımsanan hüquq bədəli var.
  • Qonaq sistemin konfiqurasiyasını onsuz da etibar etdiyi metadata-dan özünün götürməsi darıxdırıcıdır, yeni hüquq tələb etmir və həqiqətən dayanıqlı çıxan yanaşma məhz budur.