jezahost
· güncellendi: 15 Kasım 2026
  • ipv6
  • windows-server
  • proxmox
  • cloudbase-init

cloudbase-init ile Windows Server'da IPv6: neden bozuluyor ve misafir sisteme dokunmadan nasıl düzelttik

Proxmox'ta bir Windows VM'in ipconfig0'ına ip6= eklemek IPv4'ü siliyor. cloudbase-init'in bunu neden yaptığını, reddettiğimiz iki bariz çözümü ve hayata geçirdiğimiz metadata tabanlı yaklaşımı anlatıyoruz.

Kısa süre önce sunduğumuz tüm VPS'lere native IPv6 getirdik. Linux tarafı olaysız geçti: Proxmox adresi cloud-init sürücüsüne yazıyor, cloud-init bir sonraki açılışta uyguluyor, iş bitiyor. Windows Server'da ise hikâye farklıydı. Bu yazıda neyin ters gittiğini, nedenini ve sonunda vardığımız yaklaşımı anlatıyoruz. Proxmox üzerinde cloudbase-init ile Windows misafir sistemler çalıştırıyorsanız, yazının ilk yarısı muhtemelen size yarım gün kazandıracak.

Kurulum

Windows imajlarımız standart Windows Server 2025 şablonları: cloudbase-init kurulu ve Proxmox ConfigDrive'ını okuyacak şekilde yapılandırılmış. Proxmox config-2 etiketli bir ISO üretiyor; içinde openstack/latest/meta_data.json ve bir ağ yapılandırma dosyası var. cloudbase-init bunu ilk açılışta okuyor: hostname, yönetici parolası, ağ ayarları. Bu kısım aylardır sorunsuz çalışıyordu.

IPv6 için bariz olanı yaptık ve VM'in ipconfig0'ına ip6=...,gw6=... ekledik, tıpkı Linux'ta olduğu gibi.

Ne oldu

Test VM'i IPv6 adresiyle açıldı ama IPv4 yoktu. Adaptörde yalnızca bir APIPA (169.254.x.x) adresi vardı. Sunucuya IPv6 üzerinden erişilebiliyordu, ama ona giden tüm IPv4 yolları, provisioning pipeline'ımızın dayandığı yol da dahil, ortadan kalkmıştı.

Neden

Proxmox ağ yapılandırmasını Debian ENI biçiminde (/etc/network/interfaces tarzında) yazıyor. Dual-stack bir arayüz için iki stanza üretiyor:

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 ayrıştırıcısı (debiface.py) IPv4 düşünülerek yazılmış. inet6 stanzasını aynı arayüz olarak ele almıyor. Bunun yerine iki stanzayı iki ayrı arayüz tanımı olarak okuyor ve ikincisinde IPv4 alanları olmadığı için adaptörü bir kez daha, yalnızca IPv6 stanzasına göre yapılandırıyor. Bu sırada IPv4 ayarlarının üzerine yazılıyor. cloudbase-init'in ENI ayrıştırıcısıyla IPv6 almanın belgelenmiş yolu bir post-up ip -6 addr add ... satırı; Proxmox ise bu satırı üretmiyor.

Yani sorun ne Windows'ta ne de Proxmox'ta. Dual-stack için hiç birlikte test edilmemiş iki araç arasındaki bir biçim uyuşmazlığı.

Reddettiğimiz 1. seçenek: guest agent exec

Akla gelen ilk çözüm cloudbase-init'i atlayıp adresi QEMU guest agent üzerinden göndermek: qm guest exec <vmid> -- netsh interface ipv6 add address .... Çalışıyor. Yine de reddettik.

Proxmox'ta guest-exec'e izin veren yetki VM.GuestAgent.Unrestricted. "Yalnızca bu tek komutu çalıştır" gibi daha dar bir yetki yok. Bunu müşteri portalımızın kullandığı token'a vermek, portalın kümedeki her misafir sistemin içinde SYSTEM olarak istediği komutu çalıştırabilmesi demekti. Portal internete açık bir web uygulaması. Bir IPv6 adresi için bu takası yapmaya razı değildik.

Reddettiğimiz 2. seçenek: instance'ı yeniden oluşturmak

cloudbase-init eklentilerini her instance ID için bir kez çalıştırıyor. ID'yi değiştirmek, ağ eklentisi dahil her şeyin yeniden çalışmasını sağlıyor. Ama bu SetUserPassword'ü de yeniden çalıştırıyor ve yönetici parolasını metadata'da ne varsa ona sıfırlıyor. Provisioning'den sonra parolasını değiştirmiş bir müşteri için bu tatsız bir sürpriz.

Bunun yerine ne yaptık

Misafir sistem kendini, zaten erişimi olan metadata'dan kendisi yapılandırıyor; hiçbir yerde yeni yetki gerekmiyor.

  1. Metadata. Portal meta_data.json'a ek, vendor önekli bir anahtar yazıyor (aşağı yukarı şöyle: "<vendor>": {"ipv6": {"address": ..., "prefix": 64, "gateway": ..., "mac": ...}}). cloudbase-init tanımadığı anahtarları yok sayıyor. ipconfig0 yalnızca IPv4 olarak kalıyor, bu yüzden ENI ayrıştırıcısı hiçbir zaman bir inet6 stanzası görmüyor ve IPv4 bozulmadan kalıyor.
  2. Sürücünün yenilenmesi. Anahtarı yazdıktan sonra portal Proxmox'tan cloud-init sürücüsünü yeniden üretmesini istiyor (PUT /nodes/{node}/qemu/{vmid}/cloudinit). Bunun için portalın zaten sahip olduğu yetkiler yeterli. Misafir sistem yeni ISO içeriğini hemen görüyor, yeniden başlatma olmadan.
  3. Şablonda küçük bir senkronizasyon betiği. C:\ProgramData\<vendor>\<script>.ps1; zamanlanmış bir görev onu SYSTEM olarak açılışta ve iki dakikada bir çalıştırıyor. Betik:
    • config-2 etiketli birimi bulup meta_data.json'u okuyor;
    • adaptörü adıyla değil, MAC adresiyle buluyor ("Ethernet" mi "Ethernet 2" mi, buna bağımlı olmak istemezsiniz);
    • bir şey yapmadan önce adaptörün gerçek bir IPv4 adresi almasını bekliyor, böylece ilk açılışta asla cloudbase-init ile yarışmıyor;
    • anahtar varsa ve adres yoksa: netsh interface ipv6 add address ... store=persistent artı bir varsayılan rota ekliyor ve yaptığını küçük bir durum dosyasına kaydediyor;
    • anahtar kalkmışsa ve durum dosyası adresi bizim eklediğimizi söylüyorsa: adresi kaldırıyor;
    • IPv4'e asla dokunmuyor.
  4. Doğrulama. Portal sonucu guest agent'ın salt okunur network-get-interfaces çağrısıyla teyit ediyor; bunun için yalnızca audit yetkisi gerekiyor. Bir satır "uygulandı" durumunu yalnızca adres misafir sistemin içinde gerçekten göründüğünde gösteriyor, bizim öyle olması gerektiğini düşündüğümüzde değil.

Zamanlanmış görevle ilgili iki tuzak:

  • Register-ScheduledTask, RepetitionDuration = [TimeSpan]::MaxValue değerini "The task XML contains a value which is incorrectly formatted or out of range" hatasıyla reddediyor. Süreyi hiç belirtmeyin; Server 2016+ sürümlerinde bu süresiz anlamına geliyor.
  • Kurulum betiğini idempotent yapın (kaydı sil, üzerine yaz, yeniden kaydet). Şablonu hazırlarken onu birden fazla kez çalıştıracaksınız.

Sonuçlar

Portaldan etkinleştirme: adres yaklaşık 60 saniyede misafir sistemde görünüyor, IPv4'e dokunulmuyor. Yeniden başlatmadan sonra da kalıyor. Devre dışı bırakma: adres yaklaşık 60 saniyede kayboluyor. VM'i şablondan yeniden kurmak, metadata anahtarı aktarıldığı için hiçbir elle adım olmadan adresi yeniden uyguluyor. IPv6 işaretlenmiş bir Windows siparişi adresini ilk açılıştan yaklaşık beş dakika sonra alıyor: bu, cloudbase-init'in kendi specialize ve yeniden başlatma döngüsü artı bir görev aralığı.

Eski şablondan kurulmuş mevcut VM'lerde bu betik yok. Onlara sonradan eklememeye karar verdik; Windows'ta IPv6 yeni sunucular ve yeniden kurulumlar için kullanılabilir.

Çıkarımlar

  • Proxmox + cloudbase-init + dual-stack ipconfig0 kutudan çıktığı haliyle bozuk. Yayına almadan önce test edin.
  • "Sadece guest exec kullan" önerisinin hafife alınması kolay bir yetki maliyeti var.
  • Misafir sistemin yapılandırmasını zaten güvendiği metadata'dan kendisinin çekmesi sıkıcı, yeni yetki gerektirmiyor ve gerçekten ayakta kalan yaklaşım bu oldu.