Ana içeriğe geç
Pazartesi - Cuma: 09:00 - 18:00
Otomasyon Modülleri

Proxmox Modülü

WHMCS üzerinden Proxmox VE sanal makineleri ve konteynerleri için otomatik provizyon ve yaşam döngüsü yönetimi sağlar.

5 dk Güncelleme: 29 Temmuz 2026 v1.0.0 WHMCS 8.x / 9.x

Ön koşullar

  • WHMCS 8.x/9.x desteklenen sürüm
  • PHP 8.1+, cURL, JSON, mbstring ve XML
  • Proxmox HTTPS API erişimi; varsayılan port 8006
  • API Token ve sınırlandırılmış Proxmox rolü
  • Cloud-init uyumlu şablon

Kurulum adımları

  1. 1

    Yedek ve ön kontrol

    WHMCS dosyaları ile veritabanını yedekleyin; işlemi önce staging ortamında uygulayın.

  2. 2

    Dosyaları yükleyin

    Paket dizin yapısını bozmadan şu hedeflere yükleyin: modules/servers/proxmoxcloud/, modules/addons/proxmoxcloud_admin/

  3. 3

    İzinleri doğrulayın

    Klasörleri normalde 750/755, dosyaları 640/644 tutun; web sunucusu sahibini doğru ayarlayın ve 777 kullanmayın.

  4. 4

    Bağımlılıkları kurun

    Paket vendor klasörü içermiyorsa, composer.json bulunan modül klasöründe üretim bağımlılıklarını kurun.

    Komut
    composer install --no-dev --optimize-autoloader
  5. 5

    Modülü etkinleştirin

    WHMCS yönetiminde sunucu modülünü ve varsa yönetici eklentisini etkinleştirin.

  6. 6

    İlk yapılandırmayı kaydedin

    Aşağıdaki modüle özel alanları doldurun; test tamamlanmadan canlı ortam/kimlik bilgilerine geçmeyin.

Yapılandırma

Bağlantı profili

Proxmox adresi, port 8006, realm, kullanıcı ve API Token ID/Secret bilgilerini ekleyin.

Kaynak eşlemesi

Node/cluster, storage, bridge/VLAN, şablon, CPU, RAM, disk ve IP havuzunu ürüne bağlayın.

Cloud-init

Şablonda cloud-init diskini ve guest agent'ı doğrulayın; test kullanıcı/SSH anahtarıyla klonlayın.

Cron

Ana işlemler WHMCS cron ile yürür. Yönetici kuyruğu/ölçüm görevlerini yalnız paketinizdeki dosya ve ayarlara göre ekleyin.

*/5 * * * * php -q /WHMCS_PATH/crons/cron.php

Testler

  • Test kaynak havuzunda bir VM oluşturun; VMID, node, ağ ve disk değerlerini karşılaştırın.
  • Cloud-init hostname, kullanıcı ve ağ yapılandırmasını doğrulayın.
  • Askıya alma, yeniden etkinleştirme ve sonlandırmayı kontrollü test hizmetinde deneyin.

Güvenlik

  • root@pam parolası yerine ayrı kullanıcı ve API Token kullanın.
  • curl -k veya SSL doğrulamasını kapatma yöntemini canlı çözüm olarak kullanmayın.

Sorun giderme

API bağlantısı kurulamıyor

Port 8006, TLS zinciri, realm, Token ID/Secret ve Proxmox ACL kapsamını kontrol edin.

Cloud-init çalışmıyor

Şablonun cloud-init diskini, guest agent'ı ve klon tipini Proxmox üzerinde elle test edin.