CPanel Otomatik Yedekleme Nasıl Yapılır?

Gözlerini kapat… Bir sabah uyanıyorsun, web siten açılmıyor. E-posta kutunda panik mesajları… “Site çalışmıyor!”

İçin sıkışıyor, çünkü son yedeğin ne zaman alındığını hatırlamıyorsun. İşte tam o anda cPanel otomatik yedekleme sistemi, seni gecenin köründe uyandıran kabusun yerine sıcak bir kahve gibi huzur veriyor.

cPanel’in güçlü bir yedekleme özelliği var ama elle tıklamak, beklemek, indirmek… hele ki birden fazla site yönetiyorsan tam bir zaman tuzağı. O yüzden sana, artık çalışmayan eski yöntemler yerine, yeni cPanel UAPI + API Token ile kendi hostingine ve uzak FTP’ye otomatik yedekleme yolunu göstereceğim.

Bu dersimiz, sitenin hayat sigortası gibi olacak 💡

Neden 2018’deki Script Artık Çalışmıyor?

2018’de bunun için bir çözüm paylaşmıştım: Küçük bir PHP scripti, cron’a ekliyorsun, cPanel’de tam yedek alıp sana e-posta atıyor.
O zamanlar harika çalışıyordu.
Ama sonra… Oyunun kuralları değişti.

Eğer o scripti bugün çalıştırırsan, muhtemelen hiçbir şey olmayacak. Sebepler net:

1. Paper Lantern Teması Kalktı
   Script, /frontend/paper_lantern/backup/fullbackup.html yoluna POST atıyordu.
   Artık Paper Lantern yok, Jupiter tema var. Eski yol tamamen silindi.
2. HTML Form Hack Devri Bitti
   cPanel, formlarına CSRF koruması ekledi.
   Yani token / oturum olmadan eski usul POST gönderme devri kapandı.
3. Artık Resmi API Zorunlu
   Bu işi yapmak için, cPanel artık UAPI kullanmamızı istiyor.
   HTML’yi “taklit etmek” yerine, doğru endpoint’e istek atmak gerekiyor.
4. Şifre Yerine API Token
   Eskiden kullanıcı adı + şifre ile işlem yapılabiliyordu.
   Artık API Token hem daha güvenli hem de uzun vadede sorunsuz.

Yani problemler belli: Eski script tarihe karıştı.
Yeni oyuncu UAPI.

Neden FTP’ye otomatik yedek?

• Sunucu bozulsa bile verilerin başka bir yerde güvende olur.
• Gözün arkada kalmaz, çünkü sistem sen uyurken çalışır.
• Tek tıkla değil, hiç tık atmadan yedek alır :))

Adım Adım Yeni Nesil cPanel Otomatik Yedekleme

Artık elimizde eskisinden çok daha güvenli, hızlı ve esnek bir yöntem var:
cPanel UAPI + API Token.

Bu sayede hem kendi hostingine hem de uzak FTP veya bulut depolama alanına otomatik yedekleme yapabilirsin.

Şimdi nasıl yapıldığına bakalım.

API Token Oluşturma

Önce cPanel’de API Token oluşturmalısın:

1. cPanel’e giriş yap.
2. Security → Manage API Tokens menüsüne git.
3. Create Token butonuna tıkla.
4. Token’ına anlamlı bir isim ver (ör: otomatik-yedek).
5. Token’ı kaydet – çünkü tekrar göremeyeceksin.

Bu token, komutun cPanel’e güvenli şekilde bağlanmasını sağlar. Kullanıcı adı + şifre derdi yok, ayrıca saldırılara karşı çok daha güvenlidir.

Home Dizinine cPanel Otomatik Yedek Alma Yöntemi

Bazen en güvenli yedek, hemen elinin altında olandır.
Bu yöntemle aldığın tam yedek, cPanel hesabının home dizininde saklanır. Yani indirmek için acele etmen gerekmez; dilediğin zaman FTP veya Dosya Yöneticisi üzerinden erişebilirsin.

Avantajları:

• Hızlıdır – Yedek aynı sunucu içinde alındığı için transfer beklemezsin.
• Kolay erişim sağlar – İstediğin zaman indirip başka bir yerde saklayabilirsin.
• Esnektir – Daha sonra bu yedeği uzak FTP’ye, bulut depolamaya ya da başka bir sunucuya taşıyabilirsin.

Aşağıdaki komut, cPanel UAPI kullanarak tam yedeği home dizinine kaydeder. Tek yapman gereken kendi bilgilerini yerlerine koymak:

curl -sS \
  -H "Authorization: cpanel CPANEL_KULLANICI_ADI:API_TOKEN" \
  "https://ALANADIN:2083/execute/Backup/fullbackup_to_homedir?email=mail@domainadi.com"

Değiştirmen gereken yerler:

• CPANEL_KULLANICI_ADI → cPanel giriş kullanıcı adın (ör. wolinka).
• API_TOKEN → cPanel’de “Manage API Tokens” bölümünden oluşturduğun API token.
• ALANADIN → cPanel’in bağlı olduğu alan adın veya sunucu adresin (ör. wolinka.com.tr veya server123.hostingfirmasi.com).
• mail@domainadi.com → Yedekleme tamamlandığında bildirim alacağın e-posta adresi.

💡 Not: Yedek home dizininde tutulacağı için zamanla disk kotanı doldurabilir. Düzenli olarak indirip silmeyi unutma.

cPanel Üzerinde cURL Komutunu Çalıştırma

cPanel’e giriş yap
Tarayıcından cPanel hesabına giriş yap.

Cron Jobs menüsüne git
“Advanced” (Gelişmiş) bölümünde Cron Jobs linkine tıkla.

Yeni bir cron job ekle
“Common Settings / Ortak Ayarlar” menüsünden komutun çalışmasını istediğin sıklığı seç (örneğin, “Once Per Week” – haftada 1 kez).
İstersen dakika, saat, gün alanlarını manuel de girebilirsin.

Komut satırına cURL komutunu yaz
Düzenlediğin cURL komut satırını ekle.

curl -sS -H "Authorization: cpanel CPANEL_KULLANICI_ADI:API_TOKEN" "https://ALANADIN:2083/execute/Backup/fullbackup_to_homedir?email=mail@domainadi.com"

Kaydet
Add New Cron Job butonuna tıklayınca, cPanel artık bu komutu belirlediğin zaman aralıklarında otomatik çalıştırır ve backup-YYYY_MM_DD...tar.gz dosyasını home dizinine bırakır.

İpucu:

• Eğer yedeğin her gece saat 02:00’de alınmasını istiyorsan, cron ayarına şunu girebilirsin:
  2 * * *
• Eğer bu komut çalışmazsa, bazı hosting firmaları cURL kullanımını kısıtlamış olabilir. O durumda wget ile alternatif komut yazmak gerekebilir.

Uzak Sunucuya cPanel Otomatik Yedekleme (FTP veya SCP)

Home dizinine yedek almak güzel ama ya sunucu çökerse?
O yedek de onunla beraber gider. İşte bu yüzden, yedeği fiziksel olarak farklı bir noktaya göndermek gerçek güvenlik sağlar.

Burada devreye “Uzak Sunucuya Yedekleme” giriyor. Yani verilerini, başka bir hosting hesabına ya da tamamen farklı bir veri merkezine gönderebilirsin.

Bu işlemi cPanel’in UAPI komutlarıyla tek satırda yapmak mümkün.

1. Yöntem: FTP Üzerinden Yedekleme

FTP yıllardır kullanılan, basit ama hala iş gören bir yöntem.
Avantajı, hemen her yerde desteklenmesi. Dezavantajı ise, verilerin şifrelenmeden aktarılmasıdır (o yüzden şifreli SCP seçeneğini de aşağıda göstereceğim).

Adımlar:

1. Uzak sunucuda bir FTP hesabı aç
   Hedef dizinini belirle (örn. /backups/site1).
2. cPanel API Token’ını hazırla
   Daha önce anlattığımız gibi, Security → Manage API Tokens bölümünden oluşturduğun token’ı kullanacağız.
3. Aşağıdaki cURL komutunu düzenle ve çalıştır

curl -sS \
  -H "Authorization: cpanel CPANEL_KULLANICI_ADI:API_TOKEN" \
  "https://ALANADIN:2083/execute/Backup/fullbackup_to_ftp?host=FTP_HOST_ADI_YA_DA_IP&username=FTP_KULLANICI&password=FTP_SIFRE&directory=%2Fbackups%2Fsite1&email=mail@domainadi.com&variant=passive&port=21&homedir=include"

Düzenlemen gereken alanlar:

• CPANEL_KULLANICI_ADI: cPanel kullanıcı adın
• API_TOKEN: Az önce oluşturduğun token
• ALANADIN: Sunucu adı veya alan adın (ör. wolinka.com.tr)
• FTP_HOST_ADI_YA_DA_IP: Uzak sunucunun adresi
• FTP_KULLANICI / FTP_SIFRE: Uzak FTP hesabın bilgileri
• directory: Yedeğin gideceği klasör (URL-encode ile)
• variant=passive: Bağlantı sorunlarını azaltmak için pasif mod
• homedir=include: Home dizinini de dahil et

4. Cron ile otomatikleştir
   cPanel → Cron Jobs bölümünden yukarıdaki komutu ekle.
   Örneğin her gece saat 02:00’de çalışması için:

0 2 * * *

💡 İpucu: Uzak FTP’de haftalık veya aylık temizlik politikası uygula, yoksa depo alanın dolabilir.

2. Yöntem: SCP ile Güvenli (Şifreli) Yedekleme

FTP iyi bir başlangıç ama bir eksiği var: veriler şifrelenmeden transfer ediliyor.
Yani aktarım sırasında ağ dinlenirse, bilgiler yakalanabilir.

İşte bu yüzden SCP (Secure Copy Protocol) çok daha güvenli bir seçenek.
SCP, verileri aktarırken SSH protokolünü kullanır ve tüm iletişimi şifreler. Bu, verilerinin hem transfer sırasında hem de hedef sunucuda güvende kalmasını sağlar.

Avantajları:

• Tam güvenlik: Tüm veri akışı şifrelenir.
• SSH anahtar desteği: Şifre girmeden, güvenli kimlik doğrulama.
• Yüksek uyumluluk: Çoğu Linux tabanlı sunucu SCP’yi destekler.
• Otomasyon dostu: Cron ile düzenli çalıştırma imkânı.

Adım 1 – Hedef Sunucuda Hazırlık

1. Yedeklerin gideceği sunucuya SSH erişimi olmalı.
   (Bu, başka bir hosting hesabı, VPS veya fiziksel sunucu olabilir.)
2. Hedef sunucuda /backups/site1 gibi bir klasör oluştur.
3. Kaynak sunucuda, SSH anahtarı oluşturup hedef sunucuya tanımla.
   Böylece her yedekleme sırasında parola girmen gerekmez.

Not: Bazı hosting firmaları SSH erişimi sunmaz. Böyle durumlarda SCP yöntemi çalışmaz, bunun yerine FTP yedekleme kullanmalısın. SSH erişimi varsa, anahtarı cPanel’de Security → SSH Access → Manage SSH Keys menüsünden oluşturabilir, “Authorize” ederek etkinleştirebilirsin. Oluşan public key’i de hedef sunucuya eklemelisin.

Adım 2 – cPanel’de API Token Oluştur

Bu adımı FTP yöntemiyle aynı şekilde yapıyoruz:

1. Security → Manage API Tokens menüsüne git.
2. Create Token butonuna bas.
3. Token’a anlamlı bir isim ver (ör: scp-yedek).
4. Token’ı kaydet.

Adım 3 – SCP Komutunu Düzenle

Aşağıdaki cURL komutu, cPanel UAPI kullanarak tam yedeği SCP üzerinden uzak sunucuya gönderecek:

curl -sS \
  -H "Authorization: cpanel CPANEL_KULLANICI_ADI:API_TOKEN" \
  "https://ALANADIN:2083/execute/Backup/fullbackup_to_scp_with_key?host=SCP_HEDEF&key_name=ANAHTAR_ADI&key_passphrase=ANAHTAR_SIFRESI&directory=%2Fbackups%2Fsite1&email=mail@domainadi.com&port=22&homedir=include"

Düzenlemen gereken alanlar:

• CPANEL_KULLANICI_ADI → cPanel kullanıcı adın (ör: wolinka)
• API_TOKEN → cPanel’de oluşturduğun token
• ALANADIN → Alan adın veya cPanel sunucu adresin (ör: wolinka.com.tr)
• SCP_HEDEF → Hedef sunucunun IP adresi veya domaini
• ANAHTAR_ADI → Hedef sunucuya bağlanmak için oluşturduğun SSH anahtarının adı
• ANAHTAR_SIFRESI → SSH anahtar şifresi (varsa)
• directory → Yedeğin hedef klasörü (URL encode ile %2Fbackups%2Fsite1)
• email → Yedek tamamlandığında bilgi alacağın e-posta adresi

Adım 4 – Cron ile Otomatikleştir

1. cPanel → Cron Jobs bölümüne gir.
2. “Common Settings”ten sıklığı seç (ör: her gece 02:00).
3. Komut satırına düzenlediğin SCP komutunu yapıştır.
4. Kaydet.

Her gece saat 02:00 için cron ayarı:

0 2 * * *

Artık sistem, her gece sitenin tam yedeğini SCP ile güvenli bir şekilde uzak sunucuya gönderecek.

Ekstra Güvenlik Önerileri

• Hedef sunucuda depolama politikası uygula. Eski yedekleri otomatik silmek için script yazabilirsin.
• SSH anahtarını koru. Yetkisiz erişimi önlemek için sadece gerekli kullanıcıya yetki ver.
• İlk testleri manuel yap. Yedekleme dosyasının tam ve bozulmamış olduğundan emin ol.

Sonuç

Home dizininde tutulan yedek, bir yangın tüpü gibidir: Yakındaki sorunlara karşı anında çözüm. SCP ile uzak sunucuya gönderilen yedek ise yangın sigortasıdır: Ev yansa bile, kaybın olmaz.

Bir kere kurarsın, gerisini sistem halleder.
Sen sabah kahveni yudumlarken, verilerin çoktan güvenli bir şekilde saklanmış olur.

Kurulumla uğraşmak istemiyorsan, Wolinka senin için yapar. Bize ulaş ve sitenin yedekleme sistemini hemen aktif edelim.

Sevgiler 🫶