Softaculous API error hatası alıyorsan genelde panel işlem yaparken “API error”, “failed to connect”, “invalid response” gibi hatalar görürsün. Kurulum, update, backup gibi işlemler çalışmaz çünkü sistem Softaculous sunucularıyla konuşamaz. Bu durum çoğunlukla bağlantı, DNS, firewall ya da lisans kaynaklıdır. Sorun bu. Aşağıdaki adımları uygulayarak düzeltebilirsin.
Sorun şu:
Softaculous API isteği atıyor ama düzgün cevap alamıyor.
Sunucu API’ye bağlanamıyor ya da yanlış cevap dönüyor. Aşağıdaki adımları uygulayarak düzeltebilirsin.
Çözüm Adımları
1) API bağlantısını test et (ilk kontrol)
Önce sunucu gerçekten Softaculous API’ye çıkabiliyor mu onu test et.
Şuraya gir:
SSH
Şu komutu çalıştır:
curl -I https://api.softaculous.com
Alternatif test:
ping -c 4 api.softaculous.com
Eğer bağlantı yoksa direkt sorun buradadır.
-
timeout → bağlantı engelli
-
could not resolve host → DNS sorunu
Bağlantı varsa 200 OK veya benzeri response görmelisin.
Ardından tekrar dene.
Olmadıysa alttaki adıma geç.
2) Firewall (CSF / iptables) engelini kaldır
Softaculous API error en çok firewall yüzünden çıkar.
Şuraya gir:
WHM → Plugins → ConfigServer Security & Firewall
Kontrol et:
-
Outbound bağlantılar açık mı
-
80 / 443 portları açık mı
SSH ile kontrol:
csf -g api.softaculous.com
iptables -L -n
Gerekirse whitelist ekle.
Geçici test için firewall’ı durdur:
csf -x
(sonra tekrar açmayı unutma: csf -e)
Firewall kapalıyken çalışıyorsa sorun kesin firewall’dır.
Ardından tekrar dene.
Olmadıysa alttaki adıma geç.
3) DNS resolver ayarlarını düzelt
DNS bozuksa API adresi çözülemez ve Softaculous API error verir.
Şuraya gir:
SSH
Şu komutu çalıştır:
nslookup api.softaculous.com
cat /etc/resolv.conf
Test için düzelt:
echo -e "nameserver 1.1.1.1\nnameserver 8.8.8.8" > /etc/resolv.conf
Sonra tekrar test et:
curl -I https://api.softaculous.com
Çalışıyorsa sorun DNS’ti.
Ardından tekrar dene.
Olmadıysa alttaki adıma geç.
4) SSL / Curl desteğini kontrol et
API bağlantısı HTTPS ile yapılır. Curl veya SSL bozuksa Softaculous API error verir.
Şuraya gir:
SSH
Şu komutu çalıştır:
curl --version
SSL destekli mi kontrol et.
Yoksa yükle:
yum install curl -y
yum install openssl -y
Alternatif test:
openssl s_client -connect api.softaculous.com:443
SSL handshake başarısızsa problem burada.
Ardından tekrar dene.
Olmadıysa alttaki adıma geç.
5) Softaculous lisansını kontrol et
API error bazen lisans doğrulama hatasından gelir.
Şuraya gir:
SSH
Şu komutu çalıştır:
/usr/local/cpanel/whostmgr/docroot/cgi/softaculous/cli.php --license
Hata varsa:
-
lisans pasif
-
IP değişmiş
-
lisans eşleşmiyor
Lisans sağlayıcı panelinden kontrol et:
-
aktif mi
-
doğru IP mi
Sonra tekrar doğrulat:
/usr/local/cpanel/whostmgr/docroot/cgi/softaculous/cli.php --license
Ardından tekrar dene.
Olmadıysa alttaki adıma geç.
6) Softaculous update ve cache temizliği yap
Bozuk cache API error hatasına sebep olabilir.
Şuraya gir:
SSH
Şu komutu çalıştır:
rm -rf /var/softaculous/tmp/*
rm -rf /var/softaculous/cache/*
Sonra update çek:
/usr/local/cpanel/whostmgr/docroot/cgi/softaculous/cli.php --update
Paneli yenile.
Şimdi tekrar test et.
Olmadıysa alttaki adıma geç.
7) PHP CLI ve binary yolunu kontrol et
Yanlış PHP ile çalışan cron/API çağrıları hata verebilir.
Şuraya gir:
SSH
Şu komutu çalıştır:
which php
php -v
Doğru binary ile test et:
/usr/bin/php /usr/local/cpanel/whostmgr/docroot/cgi/softaculous/cron.php
Gerekirse cron’u düzelt:
crontab -e
*/5 * * * * /usr/bin/php -q /usr/local/cpanel/whostmgr/docroot/cgi/softaculous/cron.php
Ardından tekrar dene.
Olmadıysa alttaki adıma geç.
8) Log kayıtlarını kontrol et (en net sonuç burada)
Softaculous API error sorununun gerçek nedeni burada çıkar.
Şuraya gir:
SSH
Şu komutu çalıştır:
tail -n 100 /usr/local/cpanel/logs/error_log
tail -n 100 /usr/local/cpanel/whostmgr/docroot/cgi/softaculous/error.log
grep -i api /usr/local/cpanel/logs/error_log | tail -n 50
Görebileceğin hatalar:
-
connection timed out
-
could not resolve host
-
SSL certificate error
-
invalid license
-
curl error
Bu hatalar direkt sorunun kaynağını gösterir.
Log’daki hataya göre doğrudan müdahale et.
cPanel Lisansında %80 Tasarruf Edin!
Bu makaledeki sorunu çözdünüz mü? Peki ya artan lisans maliyetleri? VDS/Dedicated sunucularınız için %100 güncellenebilir, limitsiz paylaşımlı (proxy) cPanel lisansımızı hemen inceleyin.
