Komut satırı

deckpa komutu, panel kapalıyken bile erişimi geri almanızı, sunucuyu denetlemenizi ve servisleri yönetmenizi sağlar.

Komutu çalıştırma

deckpa komutu panelle birlikte kurulur (/usr/local/bin/deckpa). Sunucuda SSH ile root olarak bağlanıp çalıştırın; root olmayan bir kullanıcı sudo deckpa ... yazmalıdır. Komut ağdan çağrılamaz: panelin kapalı olduğu, parolanın unutulduğu ya da bir IP kuralıyla kendinizi dışarıda bıraktığınız durumlarda panele girmeden yönetim yapmanızı sağlar.

deckpa              # komut listesini gösterir
deckpa version      # ürün adı, sürüm ve kurulum zamanı
deckpa info         # panel adresi, ana bilgisayar adı ve SSH portu

Komutların çıktısı İngilizcedir; panelin dil seçimi komut satırına yansımaz. Kullanıcı adı alan komutlarda adı yazmazsanız komut sorar; ad bulunamazsa mevcut panel kullanıcılarını listeler. Kullanıcıyı ya da erişim kurallarını değiştiren komutlar (reset-user, disable-2fa, unlock, unsuspend, clear-allowlist) yapılan işlemi denetim kaydına yazar; kaydı Loglar sayfasının Denetim sekmesinde görürsünüz.

Erişimi geri alma

Aşağıdaki komutlar kilitli kalmış bir yöneticinin tek çıkış yoludur. Komutlar panelin yerel veritabanıyla ve sistem servisiyle konuşur; internet bağlantısı gerektirmez.

• deckpa info — panel adresini (https://<ip>:<port>), sunucunun ana bilgisayar adını ve yapılandırmadaki SSH portunu yazar. Adresi ya da portu unuttuysanız ilk bakılacak komuttur.
• deckpa list-users — panel kullanıcılarını rol, askıya alınma ve iki adımlı doğrulama durumuyla listeler.
• deckpa reset-user [kullanıcı] — yeni parolayı iki kez sorar (en az 12 karakter) ve kaydeder. Kullanıcının açık tüm panel oturumları ile phpMyAdmin ve OpenLiteSpeed yönetim oturumları kapatılır. Ardından iki adımlı doğrulamanın da sıfırlanıp sıfırlanmayacağı sorulur; y derseniz yeni bir gizli anahtar üretilir, ekrana yazılır ve eski kurtarma kodları silinir.
• deckpa disable-2fa [kullanıcı] — iki adımlı doğrulamayı tümüyle kapatır ve kurtarma kodlarını siler; kullanıcı yalnızca parolayla girer. Doğrulama cihazı kaybolduğunda kullanılır.
• deckpa unlock [kullanıcı] — başarısız girişlerden doğan giriş kilidini kaldırır. Kilit, 15 dakika içinde 5 başarısız denemeden sonra devreye girer.
• deckpa unsuspend [kullanıcı] — askıya alınmış bir panel kullanıcısını yeniden etkinleştirir.
• deckpa setup-link — henüz hiç kullanıcı yokken kaybolmuş ilk kurulum bağlantısını yeniden yazar. Yönetici hesabı oluşturulduysa bunun yerine reset-user kullanmanızı söyler.
• deckpa clear-allowlist — panelin IP izin listesini boşaltır. Liste boşken panel her IP adresinden erişilebilir. Kötü bir kuralla kendinizi dışarıda bıraktıysanız Ağ & Erişim sayfasına girmenin tek yolu budur.
• deckpa set-port [port] — panel portunu panel arayüzündeki işlemle aynı adımlarla değiştirir (bkz. Panel ayarları). Portu yanlış girip panele ulaşamıyorsanız kullanın. Panel birkaç saniye sonra yeni portta yeniden başlar.
• deckpa fix-ssh-port — config.yaml içindeki SSH portu kaydını, SSH servisinin gerçekte dinlediği portla eşitler.

deckpa doctor: sunucu denetimi

Sunucunun beklenen güvenlik ve yapılandırma durumunda olup olmadığını ölçer; panelin Sağlık Kontrolü sayfasıyla aynı kontrolleri kullanır. Komut hiçbir şeyi değiştirmez. Her çalıştırmada taze ölçüm yapar ve ölçümü root yetkili sistem servisi gerçekleştirir.

deckpa doctor                        # tam rapor
deckpa doctor --quiet                # geçen satırları gizler
deckpa doctor --tier host            # tek katman
deckpa doctor --only ssh-hardening,disk-free
deckpa doctor --json                 # makine tarafından okunur çıktı

Kontroller beş katmanda toplanır; --tier için geçerli adlar host, privilege, tenant, service ve panel'dir. --only bir ya da birden çok kontrol kimliği alır; kimlikler rapor satırlarında görünür (örneğin firewall-ports, cert-expiry, backup-freshness). Rapor sunucunun künyesiyle başlar, katman katman sonuçları gösterir ve sonda düzeltme komutlarını önem sırasına göre tek blokta toplar.

Çıkış kodu betiklerde kullanılabilir:

• 0 — kritik ya da uyarı düzeyinde sorun yok.
• 1 — en az bir kritik kontrol başarısız.
• 3 — kritik sorun yok, ama uyarı var.
• 2 — tanınmayan bir seçenek yazıldı.

Ölçülemeyen kontroller atlanmış olarak işaretlenir ve çıkış kodunu etkilemez. Komutun sistem servisine ulaşamaması da hata sayılır: executor unreachable benzeri bir ileti görürseniz önce deckpa status ile servislerin çalıştığını doğrulayın.

deckpa top: şu anda ne oluyor

doctor sunucunun doğru yapılandırılıp yapılandırılmadığını, top ise o an ne olduğunu gösterir: yük ortalaması (çekirdek sayısıyla birlikte), bellek, takas alanı, disk bekleme oranı ve en çok kaynak kullanan süreçler. Tablo PID, kullanıcı, CPU yüzdesi, RSS bellek, iş parçacığı sayısı, süre ve komut sütunlarından oluşur.

deckpa top                      # en ağır 50 süreç
deckpa top -n 100               # daha uzun liste
deckpa top --watch              # 2 saniyede bir yenilenen canlı ekran
deckpa top --watch --interval 5 # 5 saniyede bir
deckpa top --json               # tek örnek, makine tarafından okunur

Liste kesildiyse komut kaç sürecin gösterildiğini ve toplamı yazar; daha fazlası için -n kullanın. --watch yalnızca terminalde çalışır; aralık 1 ile 60 saniye arasında olmalıdır ve --json ile birlikte kullanılamaz. Canlı ekrandan Ctrl-C ile çıkılır. Süreç bilgisini okumak için root yetkisi gerektiğinden ölçümü yine sistem servisi yapar.

deckpa vhost-custom: siteye özel OpenLiteSpeed yapılandırması

Bir sitenin OpenLiteSpeed yapılandırmasına panelin üretmediği ek bölümler eklemeniz gerekirse bunları /usr/local/lsws/conf/vhosts/<alan adı>/custom.d/NN-ad.conf biçiminde dosyalara yazarsınız (sahibi root, izni 0644). Bu komut dosyaları denetler ve etkinleştirir.

deckpa vhost-custom check                 # tüm siteleri denetler
deckpa vhost-custom check example.com     # tek site
deckpa vhost-custom apply example.com     # dosyaları siteye dahil eder, gerekirse OpenLiteSpeed'i yeniden yükler
deckpa vhost-custom restore example.com   # yedekten gelen bekleyen dosyaları etkinleştirir
deckpa vhost-custom discard example.com   # yedekten gelen bekleyen dosyaları siler

Denetim her dosya için ad, tür, sahip, izin, boyut ve söz dizimi kontrolü yapar. Kabul koşulları şunlardır:

• Dosya adı harf, rakam, ., _ ve - içerir ve .conf ile biter. Sembolik bağlantılar reddedilir.
• Dosyanın sahibi root ya da lsadm olmalı; grup ya da diğer kullanıcılar tarafından yazılabilir olmamalıdır (chmod 644). custom.d dizini için aynı kural 755 izniyle geçerlidir.
• Üst düzeyde yalnızca extprocessor, context, websocket, realm ve accessControl bölümleri kabul edilir; include reddedilir. Panelin ayırdığı bağlam yolları (sertifika doğrulama, askıya alma ve hata sayfaları) kullanılamaz.
• Süslü parantezler dengeli olmalı ve açılan <<< blokları kapatılmalıdır.

Yedekten geri yüklenen özel yapılandırma dosyaları otomatik etkinleşmez: sitenin custom.d.restored/ dizininde bekler. İçeriklerini inceledikten sonra restore ile etkinleştirin ya da discard ile atın. Bir sorun bulunduğunda komut 1 koduyla çıkar.

Servis komutları ve güncelleme

Bu komutlar doğrudan systemctl ve journalctl çağırır, root gerektirir ve panel olmadan da çalışır.

• deckpa restart, start, stop — panelin iki sistem servisini (deckpa-executor ve deckpa-api) birlikte yönetir ve sonda her birinin durumunu yazar.
• deckpa status ve deckpa logs — servis durumunu gösterir; panel günlüklerini canlı izler.
• deckpa lockdown [on|off] — acil durum komutudur. on (varsayılan) paneli kapatır; SSH ve bu komutlar çalışmaya devam eder. off paneli yeniden açar.
• deckpa bans — fail2ban tarafından engellenmiş IP adreslerini panel ve SSH koruma kurallarına göre listeler. deckpa unban [ip] bir engeli kaldırır; IP vermezseniz tüm engelleri kaldırır.
• deckpa reboot — sunucuyu yeniden başlatır. Önce onay ister; -y ya da --yes onayı atlar.
• deckpa update — kanaldaki en son sürümü indirir, doğrular ve kurar; panelin Güncelleme sayfasındaki düğmeyle aynı yoldur (bkz. Güncelleme ve sürüm kanalları).

Panele hiçbir yoldan ulaşamıyorsanız önerilen sıra şudur: deckpa status ile servisleri görün, deckpa info ile adresi doğrulayın, gerekirse deckpa unban ve deckpa clear-allowlist ile engelleri kaldırın, son olarak deckpa reset-user ile parolayı yenileyin.