Sorun giderme ve sık karşılaşılan hatalar

Çoğu sorun birkaç komutla teşhis edilir: panel, bipanel adlı systemd birimi olarak çalışır ve günlüğü journalctl -u bipanel ile okunur; yönetici parolası panel kapalıyken bile sudo bipanel admin reset-password ile sıfırlanır; diğer servislerin durumu ve günlükleri Sunucu Yönetimi → Servisler ekranındadır.

#Panele ulaşılamıyor

Sunucu kurulumunda Sunucu Yönetimi https://sunucu-adınız:2087/admin, kullanıcı paneli https://sunucu-adınız:2083 adresindedir. İlk girişteki tarayıcı uyarısı normaldir: sunucu adı için Let's Encrypt sertifikası alınana kadar panel kendinden imzalı sertifika kullanır (Sunucu Yönetimi → SSL ve AutoSSL).

Önce panel servisinin çalışıp çalışmadığına bakın. Panel içeride 127.0.0.1:2080 adresinde dinler ve /api/health adresine yanıt verir:

$ sudo systemctl status bipanel
$ sudo journalctl -u bipanel -n 100 --no-pager
$ curl -fsS http://127.0.0.1:2080/api/health

Servis çalışıyor ama tarayıcıdan açılmıyorsa sorun büyük olasılıkla ağ tarafındadır:

Güvenlik duvarı: Kurulum, UFW'de (Debian/Ubuntu) ya da firewalld'de (AlmaLinux/Rocky/RHEL) 2082–2083 ve 2086–2087 TCP portlarını açar. Sağlayıcınızın bulut güvenlik duvarında da bu portlar açık olmalıdır.
IP adresiniz engellendi: Kendinizi kilitlediyseniz sunucu konsolundan, panel kapalıyken de çalışan şu komutları kullanabilirsiniz:

Komut	Ne yapar
`sudo bipanel firewall allow-ip ADRES`	Adresinize tüm portları açar (UFW'de en başa izin kuralı, firewalld'de "trusted" bölgesi)
`sudo bipanel firewall off`	Güvenlik duvarını hemen kapatır; panelde Güvenlik duvarı ekranından yeniden açılır
`sudo bipanel ddos unban ADRES`	Adresin DDoS ve saldırı tespiti engelini kaldırır
`sudo bipanel crowdsec unban ADRES`	CrowdSec ve Fail2Ban engellerini kaldırır
`sudo bipanel geoip off`	Sunucu geneli ülke engellemeyi kaldırır

Komutların tam listesi API ve komut satırı sayfasındadır.

#Yönetici parolasını unuttum

Parola, panel veritabanına doğrudan yazan yerel bir komutla sıfırlanır; bu yüzden panel çalışmıyorken de işler. Kullanıcı adı verilmezse ilk sunucu yöneticisi seçilir; --password-stdin verilmezse güçlü bir parola üretilip ekrana yazılır:

$ sudo bipanel admin reset-password
$ sudo bipanel admin reset-password admin --disable-2fa

Sıfırlama o kullanıcının açık oturumlarını kapatır ve paneldeki tüm IP engellerini kaldırır; --disable-2fa iki aşamalı doğrulamayı da kapatır. Barındırma hesaplarında yalnızca panel parolası değişir; hesabın sistem (SSH/FTP) parolası için bipanel account password kullanın. Komut satırı aracının tokenı panelden iptal edildiyse ya da /etc/bipanel/cli.token silindiyse sudo bipanel admin reset-token yenisini üretir.

#Servis durumu ve günlükler

Sunucu Yönetimi → Servisler ekranı Apache, MariaDB, PHP-FPM, e-posta, FTP ve DNS gibi servisleri durumlarıyla listeler ve her birinin son 100–1000 satırlık günlüğünü gösterir. Servisler dakikada bir denetlenir; izleme açıksa çöken servis kendiliğinden yeniden başlatılır. Aynısı komut satırından da yapılır:

$ sudo bipanel service list
$ sudo bipanel service restart apache

Nerede	İçerik
`journalctl -u bipanel`	Panel servisinin günlüğü
`/var/log/bipanel-install.log`	Kurulum betiğinin günlüğü
`/root/bipanel-kurulum.txt`	Kurulum özeti: adresler ve ilk yönetici bilgileri
`/var/log/bipanel/`	Panelin günlük dizini: site erişim günlükleri (`domlogs`), uygulama ve güncelleme günlükleri
`/var/lib/bipanel/jobs/`	Arka plan işlerinin (SSL, yedek, bileşen kurulumu…) günlükleri; `sudo bipanel job show İŞ-NO --log` ile de okunur

Panelde yapılan işlemler, kimin yaptığıyla birlikte Sistem → İşlem geçmişi ekranında listelenir.

#SELinux retleri

AlmaLinux, Rocky Linux ve RHEL'de SELinux zorlayıcı (enforcing) kipte kalır; panel hesap web köklerinin etiketlerini, panel portlarını ve gereken mantıksal değerleri kendisi yönetir. Bir site dosya yazamıyorsa ya da bir servis erişim hatası veriyorsa Güvenlik → Güvenlik duvarı ekranının SELinux bölümüne bakın: bugünkü AVC retleri (süreç, izin, hedef), son etiketleme hataları ve Yeniden etiketle düğmesi buradadır. Aynı bölümdeki Hesap web kökleri ayarı, uygulamaların kendini güncelleyebildiği önerilen kip ile yalnızca uygulama veri dizinlerinin yazılabildiği sıkı kip arasında seçim yapar.

$ sudo bipanel selinux status
$ sudo bipanel selinux relabel
$ sudo bipanel selinux relabel HESAP

SELinux'u kapatmanız gerekmez. SELinux kapalıyken de panel kurallarını politika deposunda tutar ve SELinux açıldıktan sonraki ilk başlangıçta hesapları yeniden etiketler.

#Disk kotaları uygulanmıyor

Kotalar açık değilse panel disk kullanımını yalnızca izler ve paket sınırı aşıldığında uyarır. Kotaları Sistem → Bileşenler → Disk kotası bileşeni açar:

ext4: /etc/fstab dosyasına usrquota eklenir (dosya yedeklenir, doğrulanmadan yazılmaz) ve kotalar hemen etkinleşir.
XFS (AlmaLinux/Rocky/RHEL varsayılanı): Kotalar yalnızca bağlama sırasında açılabilir; ayrı bir /home bölümüne uquota seçeneği, kök dosya sistemine çekirdek parametresi eklenir. Sunucuyu yeniden başlatmanız gerekir.
btrfs, zfs ve diğerleri desteklenmez.

Kotaların neden kapalı olduğu ve sorunu gideren komutlar Hesaplar → Kaynak sınırları ekranında gösterilir.

#E-posta gitmiyor ya da gelmiyor

Teslimat takibi (Sunucu Yönetimi → Sunucu) her iletinin teslim edildiğini, ertelendiğini ya da geri döndüğünü Postfix günlüğünden gösterir. Posta kuyruğu E-posta sunucusu ekranındadır.
Kullanıcı panelindeki E-posta → Teslim Edilebilirlik ekranı alan adının SPF, DKIM ve DMARC kayıtlarını denetler.
Sunucunuz 25 portundan doğrudan gönderim yapamıyorsa SMTP aktarıcı (Sunucu Yönetimi → Sunucu) ekranından bir gönderim sağlayıcısı tanımlayın.
Ham günlük, dağıtıma göre /var/log/mail.log (Debian/Ubuntu) ya da /var/log/maillog (AlmaLinux/Rocky/RHEL) dosyasında ya da yalnızca journald'de tutulur.

Ayrıntılar e-posta sayfasındadır.

#SSL sertifikası alınamıyor

AutoSSL 6 saatte bir çalışır ve geçerli sertifikası olmayan alan adları için Let's Encrypt sertifikası ister. En sık neden, alan adının DNS kaydının sunucuyu göstermemesidir: Bu durumda alan adı atlanır ve SSL/TLS ekranında bu durum gösterilir. A kaydını sunucunun IP adresine yönlendirin; alan adını yönetebilen bir DNS sağlayıcısı tanımlıysa panel DNS doğrulamasını da dener. Başarısız olan bir alan adını AutoSSL 24 saat sonra yeniden dener; hata ayrıntısı SSL/TLS ekranında ve işin günlüğündedir. Beklemeden denemek için alan adını ya da sunucu adını verin:

$ sudo bipanel ssl issue ornek.com
$ sudo bipanel ssl issue --hostname

Ayrıntılar SSL sertifikaları sayfasındadır.

#Güncelleme başarısız oldu

Panelden başlatılan güncellemede yeni sürüm 90 saniye içinde yanıt vermezse önceki kurulum ve veritabanı yedeği kendiliğinden geri konur; güncelleme geçmişinde Geri alındı görünür. İnceleme için:

/var/log/bipanel/update-SÜRÜM.log: güncelleme betiğinin günlüğü
/opt/bipanel.failed: açılamayan kurulum
sudo bipanel update status: son durum

Bağımlılıklar sunucuda npm ile kurulduğundan sunucunun npm paket deposuna erişebilmesi gerekir. Panel hiç açılmıyorsa update.sh ile elle güncelleyebilirsiniz; bkz. panel güncellemeleri.

#Docker ve Railway kurulumlarında

Konteynerde systemd yoktur: Günlükler konteyner çıktısında ve /data/logs altında, iş günlükleri /data/jobs altındadır. Komut satırı aracı imajda hazırdır:

$ docker compose logs -f bipanel
$ docker compose exec bipanel bipanel admin reset-password

502 hatası: Panel henüz açılmamıştır (ilk açılış birkaç dakika sürebilir) ya da bellek yetersizdir.
Sertifika: Docker Compose'da TLS'i Caddy, Railway'de platform sağlar. Caddy yalnızca panelde kayıtlı alan adları için sertifika ister; alan adının panelde ekli olduğunu ve DNS kaydının sunucuyu gösterdiğini denetleyin.
Konteynerde olmayanlar: E-posta sunucusu, disk kotaları, SELinux ve sunucu güvenlik duvarı.
BIPANEL_ADMIN_PASSWORD yalnızca ilk yönetici oluşturulurken kullanılır; sonradan değiştirmek parolayı sıfırlamaz.

Ayrıntılar Docker ve Railway sayfasındadır. Pro'ya özgü bir özellik görünmüyorsa ya da dördüncü hesap açılamıyorsa (Topluluk sürümü en fazla 3 barındırma hesabına izin verir) lisans sayfasına ve fiyatlara bakın.