# Sorun Giderme

| Belirti | Olası neden | Çözüm |
|---|---|---|
| Girişten sonra pano yerine lisans sayfası açılıyor veya mevcut admin oturumu lisans sayfasına yönlendiriliyor | Lisans `SUSPENDED` veya `NOT_ACTIVATED` | Mevcut lisansın geçerliliğini sağlayıcıda geri getirip **Şimdi Doğrula**'yı kullanın ya da yeni kurulumun anahtarını bu sayfadaki forma girin. Girişin kendisi reddedilmez: oturum, nedenin gösterildiği lisans sayfasına ulaşır, başka hiçbir şeye ulaşmaz. |
| Lisans sayfasında sunucu uyarısı ve kalan saat gösteriliyor | Lisans servisine erişilemiyor veya çok sayıda restart nedeniyle hız sınırı uygulanıyor | Giden HTTPS erişimini kontrol edin. Tolerans süresinde agent 9–18 dakika içinde yeniden dener ve doğrulama başarılı olduğunda otomatik toparlanır. Uyarı lisans sayfasında ve her sayfada yönetici üst çubuğundaki bantta gösterilir. |
| Yedekler başarısız oluyor — *Backup Failed* bildirimi (operatörün kopyası hatayı taşır), `backup_failed` denetim satırı ve `backup.failed` webhook'u | `/var/whost/backups/` üzerinde disk basıncı | Diski artırın veya saklamayı kısaltın |
| Plugin'ler sayfasında "interrupted" banner'ı | Aktivasyon uçuş ortasında öldürüldü | Sistem durumunu doğrulayın, ardından "Çözüldü olarak işaretle"ye tıklayın |
| OS yükseltmesi sonsuza dek "running" durumunda takıldı | apt kilidi başka bir process tarafından tutuluyor | Sunucuda `lsof /var/lib/dpkg/lock-frontend`; çözün ve yeniden deneyin |
| SSH tarafı yapılandırma düzenlemesinden sonra her istekte 401 | Oturum gizli anahtarı değişti | Yeniden giriş yapın ve devam edin |
| Aynı adresten art arda girişlerin hemen ardından açılan panel birkaç saniye geç boyanıyor | Edge her `/api/v1/auth/*` çağrısını adres başına sınırlar (12/dk) ve shell'in oturum kontrolüne `429` verdi | Bir şey gerekmez — shell bildirilen süreyi bekleyip yeniden sorar; oturumu yalnız `401`/`403` yanıtı bitirir |

Daha derin araştırma için, `agent.log` (`/var/log/whost/agent.log`) kanonik yerdir. Yayımlanan paneller tarayıcı hata ayıklama beacon'ı kapalı gelir; tarayıcı tarafındaki sorunlar tarayıcının DevTools'undan (Console ve Network sekmeleri) okunur.

Müşteri tarafı eşdeğeri için bkz. [`docs/user/client-user-guide.md`](../user/client-user-guide.md). Yalnızca HMAC API kullanımı için bkz. [`docs/developer/api-reference.md`](../developer/api-reference.md).