Ayarlar
Topbar'daki dişli menüsünde Tüm Ayarlar (ya da komut paletinde Ayarlar) ayarlar merkezini açar. Kutucuklar altı bölümdedir: Sunucu — Genel, Sunucu Bilgileri, IP Yönetimi, Eklentiler (§10); Hosting — PHP, FTP (§11), Spam Filtresi, Yasaklı Kelimeler; Araçlar — Zamanlanmış Görevler (§11), Taşıma (§8) ve eklentileri etkinken Python Uygulamaları (§12) ile Node.js Uygulamaları (§13); Güvenlik — Güvenlik, Fail2Ban, ModSecurity WAF (§7); Panel — Bildirimler (§15), Whitelabel, Güncellemeler (§9), Lisans; Entegrasyonlar — API Erişimi, Webhook'lar (§14). Profil, hesap menüsünden açılır.
Profil
E-posta, dil tercihi, avatar (≤ 2 MB; MIME türü ve magic-byte ile JPEG/PNG/WebP; SVG ve HTML reddedilir; yükleme ucu dakikada beş denemeye izin verir). Otomatik (varsayılan) giriş yaptığınız dili korur; açık bir seçim paneli her girişte o dile çevirir ve bölge varyantları ile üç harfli etiketler dahil gönderilen her locale'i kabul eder (pt-BR, zh-TW, fil, …). Kurtarma adresini, dili ya da profil fotoğrafını değiştirmek bir settings_updated denetim satırı yazar; hiçbir şeyi değiştirmeyen kayıt satır yazmaz. Parola değişikliği diğer oturumları geçersiz kılar; yeni parola en az 8 karakter, en fazla 72 bayttır (UTF-8). İki faktörlü doğrulama kaydı bir doğrulayıcı uygulama (TOTP) ya da kurtarma adresine e-postayla gönderilen kod sunar; e-posta faktörü bu adresi burada değiştirdiğinizde adresle birlikte taşınır, böylece bir sonraki kod her zaman güncel adrese gider; 2FA kapatılınca adres temizlenir. E-posta kodları, agent.conf içindeki admin.two_factor.smtp_* başka bir SMTP sunucusu belirtmedikçe sunucunun yerel posta aktarıcısı üzerinden gönderilir.
Güvenlik
- Yönetici IP izin listesi (CIDR listesi veya herhangi biri için boş). Değişmiş dolu bir liste kaydedildiğinde (bir kayıt eklendi ya da silindi) oturum gizli anahtarı yenilenir: diğer bütün yönetici tarayıcı oturumları ve bütün müşteri oturumları kapanır, yeniden giriş gerekir; kaydeden yöneticinin kendi adresi yeni listedeyse o yönetici yeni bir oturum çereziyle oturumda kalır (sayfa bunu söyler; listede olmayan bir adresten force ile kaydedilirse o oturum da kapanır ve panel giriş sayfasına gider); yenileme nedeniyle birlikte bir
secret_rotateddenetim satırına (Günlükler › Denetim, filtre Sır Döndürüldü) yazılır — aynı satır yönetici parolası değiştirildiğinde de yazılır. Liste değişmeden kaydedilen sayfa (örneğin yalnız oturum süresi düzenlendiğinde) oturumları korur. API anahtarları etkilenmez. Saklı değerlere eşit değerler yazımdan önce düşürülür; değişmeyen kayıt yapılandırma da denetim satırı da yazmaz. Reddedilen değer Genel sayfası gibi422 VALIDATION_ERRORdöner (400yalnız kendini kilitleme korumasında kalır); sayı ya da anahtar beklenen yere metin reddedilir. - 2FA zorunluluğu (off / TOTP / e-posta / her ikisi). Anahtar açıkken giriş ve oturum uçları, ikinci faktör kaydetmemiş bir kimlik için
requires_2fa_setup(istenen yöntemle birlikte) bildirir ve paneller buna göre davranır: böyle bir giriş kayıt sayfasına iner (yönetici: Ayarlar › Profil, müşteri: Ayarlar › Güvenlik) — kurulum diyaloğu açık, nedenini anlatan bir uyarıyla; ikinci faktör etkinleşene kadar diğer her panel sayfası oraya yönlendirir (çıkış yapılabilir). Anahtar tek bir yöntem istiyorsa diyalog yalnız o yöntemi sunar;bothseçimi kullanıcıya bırakır. Zaten ikinci faktörü olan kimlikler etkilenmez. - SSH yapılandırma sekmesi — port, root login, parola / anahtar kimlik doğrulama, izinli IP'ler (sshd_config'e geri yazar; yeniden yükleme manuel onay gerektirir). Port boş olmalıdır: panelin kendi tuttuğu portlar (80, 443, 2000) ve başka bir servisin zaten dinlediği her port
PORT_IN_USEile reddedilir, çünküsshd -tbir bind çakışmasını yakalamaz. sshd yeni ayarlarla geri gelmezse önceki SSH yapılandırması, firewall kuralı ve fail2ban portu geri yüklenir ve kayıt bir uyarı döndürür. - Root parolası — Linux
rootparolasını değiştirir. Yönetici tarayıcı oturumu gerektirir: HMAC API anahtarları, diğer tüm kimlik bilgisi değişikliklerinde olduğu gibiHMAC_FORBIDDEN_FOR_CREDENTIAL_MUTATIONile reddedilir. Kontrol karakterleri (satır sonu) reddedilir. - Spam eşikleri (Rspamd reject / add-header / greylist skorları) bu sayfada değildir: Spam Filtresi sayfasında (Ayarlar → Spam Filtresi, Genel Bakış ve Yapılandırma sekmesi) ayarlanır. Orada da skorların okuması başarısız olursa form yerine hata görünümü çıkar.
- Bu ayarların okuması başarısız olursa (bir hata ya da sınırlayıcı yanıtı) form yerine Yeniden dene düğmeli bir hata görünümü çıkar; böylece Kaydet, saklı ayarların üzerine varsayılanları ya da önceki ziyaretten kalan yanıtı asla yazamaz.
Genel
Hostname, ilan edilen sunucu IP'si, zaman dilimi, nameserver'lar, varsayılan PHP / web sunucusu, MariaDB / FTP / posta ayarları, SSL varsayılanları, varsayılan dil ve müşteri paneli özellik anahtarları. Sunucu IP'si yönlendirilebilir bir unicast IPv4 adresi olmalıdır (loopback, unspecified, broadcast, multicast, link-local, rezerve ve başında sıfır olan biçimler INVALID_IP / VALIDATION_ERROR ile reddedilir); değiştirilmesi her zone'da eski adresi taşıyan A kayıtlarını ve SPF girdilerini yeniden yazar (DNS hatası yanıttaki dns_errors listesinde verilir ve değişikliği durdurmaz), eski adresi kullanan hesaplara yeni adresi verir ve panel vhost'unu yeniden üretir; hesap siteleri her adresi dinlediği için vhost'larına dokunulmaz. Makineye adres eklemez ya da kaldırmaz — o iş IP Yönetimi'nindir. IP Yönetimi ayrı bir sayfadır (/admin/ip-management; Genel'den değil, Ayarlar sayfasındaki IP Yönetimi kutucuğundan açılır; yalnız IPv4): liste host'un taşıdığı her adresi ve host'un artık taşımadığı, Bağlı değil olarak işaretli saklı kayıtları gösterir — bunlar hesaplara asla sunulmaz. Adres eklemek onu hemen bağlar ve netplan (Debian) ya da nmcli connection modify (NetworkManager, RHEL) ile kalıcılaştırır; kalıcılaştırma adımı başarısız olursa yanıt bir warnings listesi taşır: adres şimdi bağlıdır ama yeniden başlatmada kalmaz. Yapılandırılmış birincil adres, host'un varsayılan rotasının kullandığı adres ve varsayılan arayüzün ilk adresi kaldırılamaz; bir hesaba hâlâ atanmış bir adres de kaldırılamaz (sayı mesajdadır). Bağlı değil kaydı yine de güncellenip silinebilir; güncelleme ve silmede 404 NOT_FOUND yalnız ne bağlı ne kayıtlı olan adrese döner. Denetim satırları operatörü ve adresini taşır; ilan edilen sunucu IP'sini değiştirmek listenin kullandığı hesap dizinini yeniler.
Sayı ya da anahtar beklenen yere metin gönderilmesi ("10000", "yes") ve formun tanımlamadığı alanlar 422 VALIDATION_ERROR ile reddedilir; nameserver'lar sırayla doldurulur (ns2 boşken ns3 bir üst yuvaya kaymak yerine reddedilir) ve MariaDB tampon boyutları sıfırdan farklı bir K/M/G değeri alır (0K reddedilir). Hiçbir şeyi değiştirmeyen kayıt yapılandırma yazmaz, servise dokunmaz ve denetim satırı bırakmaz; gerçek bir değişikliğin settings_updated satırı yalnız değişen alanları (özellik anahtarı için client_features.<ad>) adlandırır ve operatörü adresiyle taşır. Reddedilen değerin agent tarafındaki gerekçesi toast'a ulaşır, alt sınırı 0 olan sayısal alanlara (Keep-Alive) 0 yazılabilir ve okuma başarısız olursa varsayılanlarla dolu bir form yerine Yeniden dene butonlu hata görünümü gösterilir. API'nin kabul ettiği iki FTP alanı, ftp_bandwidth_limit ve ftp_passive_mode, yalnız saklanır: kayıt bunları tutar ve geri döndürür, ama Pure-FTPd direktifi yazılmaz ve form bunları göstermez.
Dosya Yöneticisi yükleme sınırı. Dosya Yöneticisi bölümü tek yüklemede taşınabilecek en büyük dosyayı MB cinsinden belirler (1–10240, varsayılan 256; API'de file_upload_max_mb, agent.conf'ta files.max_upload_mb). Sınır yönetici ve müşteri panelindeki Dosya Yöneticisi için geçerlidir: panel daha büyük bir dosyayı eklendiği anda, hiçbir şey göndermeden reddeder; iki Dosya Yöneticisi yükleme yolunda (/api/v1/accounts/<kullanıcı>/files/upload, /api/v1/client/files/upload) ajan ve panelin nginx'i sınırın 1 MB fazlasına kadar gövde kabul eder. Yeni değeri kaydetmek panelin nginx konum parçasını yeniden yazar ve nginx'i yeniden yükler; nginx -t parçayı reddederse yanıt bir uyarı taşır ve nginx önceki sınırda kalır. Öteki yükleme yolları (uygulama arşivi, taşıma, avatar, geri bildirim) 300 MB tavanını korur. Yükleme tek istekle gider: sürerken sunucuda dosya boyutunun yaklaşık iki ila üç katı boş disk alanı gerekir (nginx'in istek tamponu, ajanın geçici kopyası ve yazılan dosya) ve yarıda kesilen yükleme baştan başlar — çok büyük dosyalar için FTP ya da SFTP kullanın.
Sunucu adı sertifikası. Genel sayfasında ayrı bir bölüm (/admin/settings/general#hostname-certificate; kurulum rehberinin maddesi onu yeni sekmede açar) panelin (nginx / Apache), postanın (Postfix, Dovecot) ve FTP'nin (Pure-FTPd) sunucu adında sunduğu sertifikayı gösterir: kimin imzaladığı, kapsadığı adlar, bitiş tarihi ve durumu (Geçerli, Kendinden imzalı, Süresi dolmuş, Başka bir ad için). Sertifika al (kuruluysa Yeniden al) Let's Encrypt'ten sertifika ister; Let's Encrypt adı panelin kendi doğrulama klasörü üzerinden 80 numaralı porttan denetler, bu yüzden adın A kaydı bu sunucuyu göstermeli ve 80 numaralı port internetten erişilebilir olmalıdır. Herkese açık sertifika taşıyamayan bir ad — henüz sunucu adı yok, IP adresi, noktasız ad, .test, .local, .localhost ve diğer özel kullanım adları — kartta açıklanır ve düğme kapalı kalır (422 HOSTNAME_CERT_NOT_ISSUABLE); çözümlenmeyen ad 422 HOSTNAME_CERT_DNS_MISSING alır. Sertifikayı anan her yapılandırma yeniden yüklemeden önce test edilir; reddedilen test ya da başarısız yeniden yükleme önceki dosyaları geri koyar (500 HOSTNAME_CERT_INSTALL_FAILED); Let's Encrypt'in reddi de (502 HOSTNAME_CERT_ISSUE_FAILED) hiçbir şeyi değiştirmez — hata bildirimi ve kartın son denemesi o zaman verdiği nedeni gösterir (sertifika otoritesinin her ad için bildirdiği sorun ya da certbot'un kendi hata satırı). Aynı anda tek istek çalışır (409 HOSTNAME_CERT_IN_PROGRESS). certbot'un zamanlayıcısı sertifikayı yeniler, kancası yenilenen dosyaları aynı yolla kurar. İlk Let's Encrypt sertifikası kurulmadan önce yerindeki çift — kurucunun kendinden imzalı sertifikası ya da sizin kurduğunuz bir sertifika (örneğin Cloudflare Origin CA: Yeniden al onun yerine Let's Encrypt'inkini koyar) — /etc/whost/ssl/fallback/'te saklanır; Let's Encrypt sertifikası yenilenmeden süresi dolarsa ajan 15 dakika içinde o çifti panele, postaya ve FTP'ye geri koyar ve sizi bilgilendirir (Server name certificate expired, denetim satırı ssl_replaced). agent.conf'ta ssl.staging: true iken istekler Let's Encrypt'in test hizmetine gider; onun sertifikasına tarayıcılar güvenmez, kart bunu söyler. Kullanılan uçlar: GET / POST /system/hostname/certificate.
Sunucu Bilgileri
Topbar'daki dişli menüsünde Sunucu Bilgileri (sondan ikinci, Tüm Ayarlar'ın hemen üstünde), ayarlar merkezinin Sunucu bölümündeki Sunucu Bilgileri kutucuğu ya da komut paleti /admin/server-info sayfasını açar: makinenin tamamı tek sayfada. Sayfa yalnız yöneticiye aittir — müşteri panelinde karşılığı yoktur ve aşağıdaki üç uç müşteri oturumunu 401 ile reddeder.
- Genel bakış — sunucu adı, işletim sistemi ve çekirdek, platform (fiziksel sunucu ya da sanal makine ve türü), üretici, anakart, tarihiyle BIOS / donanım yazılımı, çalışma süresi ve açılış zamanı, saat dilimi ve saat eşitlemesi, panelin IP adresi ve web sunucusu, güvenlik modülü (SELinux kipi ya da zorlamadaki profilleriyle AppArmor). CPU, bellek, disk ve takas göstergeleri gösterge panelindedir; bu sayfada gösterge yoktur.
- İşlemci — soket / çekirdek / iş parçacığı sayısıyla model, hemen altında canlı yük (1 / 5 / 15 dakika ve çalışma kuyruğu); ardından üretici, soket, taban, azami ve anlık frekans, önbellekler, aile / model / stepping, mikrokod, sanallaştırma ve hipervizör, adres genişlikleri, NUMA düğümleri, frekans ölçekleme sürücüsü ve yöneticisi; CPU zamanının dağılımı, her CPU'nun yükü, saniyedeki bağlam geçişi ve kesme sayısı; komut seti uzantıları ve çekirdeğin CPU güvenlik açığı raporu (savunmasız / önlem alınmış / etkilenmiyor, ayrıntılarıyla). İşlemci ve Bellek kartlarının yan yana durduğu geniş ekranda İşlemci kartı Bellek kartının yüksekliğini alır ve sabit başlığının altında kendi içinde kayar; dar ekranda iki kart da tam yüksekliğinde kalır.
- Bellek — takılı miktar ve şu an kullanılabilen, azami kapasite ve dolu yuvalar, hata düzeltme, canlı dağılım (kullanılan, tampon / önbellek, boş, paylaşılan, çekirdek slab, büyük sayfalar), donanım yazılımının DMI tablosundaki her bellek modülü (yuva, boyut, tür, hız, üretici, parça numarası, seri numarası, rank / voltaj; boş yuvalar da listelenir) ve öncelikleriyle takas aygıtları, takastan okuma / takasa yazma hızları.
- Diskler — her fiziksel disk modeli, boyutu ve türüyle: ortam (NVMe SSD, SSD ya da
smartctlbildiriyorsa dönüş hızıyla HDD) ve veri yolu (SATA, SAS, SCSI, USB, VirtIO…;lsblk'ten,lsblkbildirmiyorsa — virtio-scsi diskte olduğu gibi — udev veritabanından). Sanal disk, hipervizörün bildirdiği ortamı gösterir (dönmeyen → SSD, dönen → HDD), Sanal ve Hipervizörün bildirdiği işaretiyle — alttaki depolama farklı olabilir. Ardından seri numarası, donanım yazılımı, sektör boyutları, G/Ç zamanlayıcısı ve bölümleriyle (boyut, dosya sistemi, bağlama noktası, onu kullanan RAID dizisi ya da birim). SMART sağlığısmartmontoolskuruluysasmartctlile okunur (uykudaki disk uyandırılmaz; Uykuda, uyandırılmadı yazar); kurulu değilse NVMe disk kendi denetleyicisinin sağlık günlüğünden okunur (sıcaklık, açık kalma süresi, güç döngüleri, aşınma, yedek kapasite, yazılan ve okunan veri, ortam hataları, güvensiz kapanmalar, hata günlüğü kayıtları), SATA / SAS disklerde ise sağlığınsmartmontoolsgerektirdiğini söyleyen bir not görünür. Kurucusmartmontoolskurmaz. - Dosya sistemleri (kullanım, boş alan, inode, salt okunur işaretleri), disk etkinliği (okuma ve yazma hızları, IOPS, meşguliyet) ve RAID dizileri (yazılım RAID: sağlıklı ya da bozulmuş, etkin / arızalı / yedek üyeler, yeniden eşitleme ya da yeniden oluşturma ilerlemesi).
- Ağ — arayüzler (tür, adresler, bağlantı durumu, hız ve çift yönlülük, sürücü ve donanım, canlı trafik, toplamlar, hatalar ve düşürülen paketler), varsayılan rotalar ve IPv4 / IPv6 ağ geçitleri, DNS sunucuları (yerel
systemd-resolvedarkasındaysa onun üst sunucuları) ve arama alan adları, TCP bağlantı durumları ve protokolü, adresi (tüm arayüzler ya da yalnız yerel) ve süreciyle her dinleyen port. Yönlendirme ve DNS ile Dinleyen portlar kartlarının yan yana durduğu geniş ekranda Dinleyen portlar kartı Yönlendirme ve DNS kartının yüksekliğini alır ve sabit başlığının altında kendi içinde kayar; dar ekranda port listesi kendi kutusunda kayar. - Süreçler — süreç tablosu (PID, kullanıcı, komut satırı, durum, CPU, bellek, iş parçacıkları, başlangıç zamanı; en yoğun önce, ad, komut, kullanıcı ya da PID ile aranır, duruma göre süzülür) ile toplam, iş parçacığı ve çekirdek iş parçacığı sayıları. CPU, bir önceki okumadan bu yana bütün makinedeki paydır (tüm CPU'lar = %100); en çok 3.000 süreç listelenir.
- Yazılım sürümleri — panel ve kurulu yığın (web sunucuları, varsayılanı işaretli PHP sürümleri, veritabanları, DNS, e-posta, FTP, güvenlik, uygulama çalışma ortamları, sistem), paket veritabanından tek sorguyla okunur. Her satırda bileşen adı, sağda sürümü, altında paket adı ve paket sürümü durur. Kart sayfanın tam genişliğini kaplar; kart yeterince genişse kategoriler iki sütuna yerleşir (bir kategori bölünmez), dar ekranda tek sütundur.
- Sürücüleriyle PCI aygıtları ve geniş ekranda yanlarında sağlık: başarısız systemd birimleri, kaynak baskısı bilgisi (CPU, bellek, G/Ç; 10 / 60 / 300 saniyede kısmi ve tam), oturum açmış kullanıcılar ve açık dosya tanıtıcıları. Geniş ekranda PCI aygıtları kartı sağlık kartının yüksekliğini alır ve aygıt listesi sabit başlığının altında kendi içinde kayar; dar ekranda liste kendi kutusunda kayar. Sayfada donanım sensörü tablosu yoktur; ajanın canlı yanıtı sensör okumalarını (sınırlarıyla sıcaklıklar ve fanlar) taşımaya devam eder ve JSON indir bunları dosyaya yazar. Bir diskin sıcaklığı Diskler kartında SMART sağlığının içinde kalır.
Ajan donanım ve yazılım envanterini bir kez toplar ve saklar: on dakikadan sonraki bir ziyaret saklanan yanıtı yeniden okunuyor işaretiyle gösterirken yeni toplama arka planda koşar; Yenile yeni toplamayı bekler. Yenile'nin solundaki JSON indir, sayfanın elindekini — envanteri, son canlı ölçümleri ve süreç tablosunu, ajanın verdiği yanıtlar olduğu gibi, exported_at ve sunucu adıyla — server-info-<sunucu>-<YYYYAAGG-SSDD>.json adlı tek dosya olarak indirir; dosyayı tarayıcı sayfanın verisinden kurar (ek istek yok), envanter gelene kadar düğme devre dışıdır. Süreç komut satırları dosyada yer alır; sayfa bunları tarayıcı sekmesinde hiç saklamaz. Sayfa açıkken canlı ölçümler 5 saniyede, süreç tablosu 10 saniyede bir yenilenir; hızlar iki okuma arasından ölçülür. 2 vCPU'lu bir sunucuda açık sayfa ajanın yüküne tek çekirdeğin yaklaşık %2'si kadar ekler. Lisansın donanım parmak izinin kullandığı makine kimlikleri (ürün UUID'si, machine-id, açılış kimliği) gösterilmez.
Kullanılan uç noktalar: GET /system/server-info (?refresh=true yeni toplamayı bekler), GET /system/server-info/live, GET /system/server-info/processes.
API Anahtarları
Yeni anahtar oluştur (isteğe bağlı IP allowlist ile), iptal et, sil, erişim loglarını görüntüle (anahtar başına son 100 çağrı zaman damgası, IP, endpoint, durum ile). Gizli anahtar oluşturma sırasında bir kez gösterilir — sistem yöneticisi hemen kopyalamalıdır. Default API Key, kurucunun agent.conf'taki çiftidir; iptal etmek ya da silmek onu kalıcı olarak emekliye ayırır. Bir anahtar her zaman en az bir kapsam taşır: boş kapsam listesiyle anahtar oluşturmak ya da güncellemek 422 VALIDATION_ERROR döner. Tam Erişim anahtarı, Default API Key dahil, hesabın parolasını da değiştirebilir (PATCH /accounts/{username}/password — hesabın panel girişi, sistem kullanıcısı ve varsayılan FTP kullanıcısı; faturalama sisteminin Parola Değiştir düğmesi için); Sadece Denetim Okuma anahtarı değiştiremez (403 SCOPE_DENIED). Her değişiklik denetim günlüğüne aktörü anahtar olan Parola Değiştirildi satırı olarak yazılır.
Bayi anahtarları. ACL planı API Access iznini veren bayi, kendi anahtarlarını client panelden (Settings → API Access) üretir. Böyle bir anahtar bayi hesabına bağlıdır: Owner sütunu hesabı gösterir (sunucu geneli anahtarlarda Server yazar), kapsamı Reseller (client API) olarak sabittir ve genişletilemez; onunla imzalanan her istek /api/v1/client/* üzerinde o bayi adına sunulur — bayinin tarayıcı oturumuyla aynı sahiplik kontrolleri ve aynı ACL planı, hiçbir zaman yönetici API'si değil; istek yanında hangi oturum çerezi gelirse gelsin. Planda API Access kapatılınca hem üretim hem de mevcut anahtarla imzalanan her istek reddedilir; hesabın askıya alınması da aynı sonucu verir. Sistem yöneticisi bayi anahtarlarını burada diğer anahtarlar gibi görür, iptal eder ve siler; bir bayi en fazla 10 anahtar tutar.
Müşteri giriş bağlantıları. Tam erişimli sunucu geneli bir anahtar, müşteriyi parola girmeden hesabın müşteri paneline sokan tek kullanımlık bir bağlantı oluşturabilir (POST /accounts/{username}/login-token; faturalama sisteminin "panele git" düğmesi için — API referansı, Müşteri giriş bağlantıları). Bağlantı bir kez kullanılır, en çok beş dakikada süresi dolar, müşterinin adresine bağlanabilir ve hesabın ikinci adımını atlar; oturum müşterinin kendisinindir ve hesabın öteki müşteri oturumlarını kapatır. Denetim günlüğü her bağlantıyı Müşteri Giriş Bağlantısı Oluşturuldu, kullanımını müşteri Başarılı Giriş (yöntem login_link) olarak kaydeder. Bağlantı jetonunu # işaretinden sonra taşır (/api/v1/auth/client/login-link#token=…); tarayıcı bu kısmı sunucuya göndermediği için jeton web sunucusunun ve Cloudflare'in kayıtlarına düşmez, açılan sayfa jetonu kendisi gönderir. Önceki ?token= biçimi giriş yaptırmaya devam eder ve kullanımdan kalkıyor (WHost artık üretmez). Müşteri olarak oturum aç da müşteri panelini aynı yolla açar.
Whitelabel
Markalama override'ları: şirket adı, logo (light + dark), favicon, renk teması, giriş sayfalarının arka plan videosu. whitelabel lisans eklentisi arkasında kapatılmıştır — hepsi, şirket adı, logolar ve renkler dahil; eklenti ayrı satılır ve hiçbir lisans planına dahil değildir. Renkler, şirket adı ve her logonun adresi /var/www/whost/panel/config.json aracılığıyla statik frontend'e yayılır, böylece bir sonraki sayfa yüklenmesi yeniden build yapmadan bunları alır; logo görsellerinin kendisi ayrı dosyalardır (aşağıda), bu yüzden config.json logolar ne kadar ağır olursa olsun birkaç yüz bayt kalır.
Marka eklentiyi izler: bir lisans denetimi eklentiyi verilmiş ya da geri alınmış bulduğunda config.json hemen yeniden yazılır, böylece bir sonraki sayfa yüklemesi markayı agent yeniden başlatılmadan gösterir ya da bırakır; agent'ın yazdığı hesap sayfaları (yeni hesabın varsayılan sayfası, askı sayfası) yayımlanan renkleri yalnız eklenti lisanslı ve özellik açıkken kullanır. Purchase Addon ve Renew Now WHost ürün sayfasını (https://wisecp.com/whost) açar. Özellik açık ve hide_login_branding işaretliyken (varsayılan) giriş ekranları şirket logosunu ve adını taşır — yönetici formunun alt başlığı da şirketi adlandırır; her ekran formuyla birlikte hemen boyanır, logo ve ad sayfa yüklenirken görünür, önce WHost varsayılanları hiç görünmez. Ayar, Giriş Sayfası Videosu bölümünün başındaki Giriş sayfalarında markanız anahtarıdır; kapatılınca paneller markalı kalırken giriş ekranları WHost logosunu ve adını korur. Lisans servisinin hâlâ aktif bildirdiği ama bitiş tarihi geçmiş bir eklentiyi panelin kendisi de süresi dolmuş sayar: sayfa Renew Now düğmeli süresi dolmuş bandını gösterir, marka bir sonraki lisans denetiminde yayımlanan sayfalardan kalkar (yayıncı süresi dolan eklentiyi normalde önce askıya alır; bu, panelin kendi güvencesidir).
Renk teması iki paneli iki temada da boyar; admin ve client kenar çubukları aynı görünümü paylaşır. Açık temada kenar çubuğu rengi iki kenar çubuğunu renklendirir: ikisi de bu renkten karıştırılmış koyu bir zeminde durur, menü yazısı da aynı tonun soluk bir rengidir; böylece renk ne olursa olsun okunur kalır (koyu temada yazı tonunu birincil renkten alır). Bulunulan sayfa ikincil renkle işaretlenir: girişinin arkasında açık bir dolgu ve kenar çubuğunun kenarında kısa bir çubuk. Koyu kenar çubuğu rengi koyu temada sayfa zeminine, kartlara, ikincil yüzeylere ve çizgilere tonunu ve doygunluğunu verir, böylece sayfa tek bir renk skalası olarak görünür; koyu temada iki kenar çubuğu da aynı kart yüzeyinde, bulanıklığın üzerinde hafif saydam durur. Bu yüzeyler panelin ikincil yazısının 4,5:1 kontrastı koruyacağı kadar koyu kalır: daha açık bir koyu kenar çubuğu renginde (örneğin orta tonlu bir logodan alınan renkte) kenar çubuğunun kendi açıklığı yerine aynı tonun daha koyu bir basamağını alır. Birincil ve ikincil renk iki kenar çubuğunun üst köşesinde logonun arkasına kısa bir ışıma çizer (sağdan sola dillerde sağ üstte); ışıma iki temada da açık tema renk çiftini kullanır ve her ikisinde aynı görünür. Birincil ve ikincil renk üzerindeki yazı (düğmeler, rozetler, ipuçları) 4,5:1 kontrastı koruduğu sürece beyaz kalır; daha açık bir marka renginde aynı tonun koyusuna döner.
Koyu yüzeyler — kenar çubuğu ve daraltılmış simgesi — koyu logoyu ve koyu favicon'u gösterir; yalnız açık varyant yüklüyse açık olan onun yerine geçer (kenar çubuğu için fazla koyuysa açık bir çerçeve içinde), WHost işareti orada yalnız iki varyant da yüklenmemişse görünür. Hiç favicon yüklenmemişse tarayıcı sekmesi ve daraltılmış kenar çubuğu WHost simgesi yerine üretilmiş bir işaret gösterir: ana renk üzerinde şirket adının (şirket adı yoksa sunucu adının) baş harfi. Sayfa eklenti durumunu ya da ayarları okuyamazsa (limit yanıtı, ağ hatası) satın alma bandı ve kilitli form yerine Yenile düğmeli bir hata gösterir; gösterge panelindeki satın alma penceresi de yalnız gerçek bir "lisanssız" yanıtında açılır.
Yüklenen logo neyi taşıyabilir. Dosya tipi beyan edilen içerik tipine değil ilk baytlara bakılarak belirlenir: JPEG, PNG, WebP ve SVG kabul edilir, başkası 415 ile reddedilir, tavan 2 MB'tır. SVG saklanmadan önce yeniden yazılır — XML entity'leri doğrudan reddedilir (file:// okuması ve genişletme bombası yok), <script>, <foreignObject>, on* işleyicileri, javascript: bağlantıları, bir bağlantı hedefini (hangi önekle olursa olsun) değiştiren ya da değerlerinden birinde betik veya dış adres taşıyan animasyonlar, ikinci bir belge çeken stil blokları ve stil / sunum öznitelikleri (CSS bir tarayıcının okuduğu gibi, kaçışları çözülerek okunur — yalnız dosyanın içini gösteren url(#…) kalır), xml:base ve aynı dosyanın bir parçası ya da gömülü bir PNG / JPEG / GIF / WebP görsel dışındaki her şeye giden bağlantılar kaldırılır. Sıradan şekiller, animasyon ve stil korunur. Bir SVG XML bildirimi, uzunluğu ne olursa olsun bir yorum ya da doctype ile başlayabilir — türü kök öğe belirler.
Logo nasıl saklanır. JPEG, PNG ya da WebP saklanmadan önce biçimlendirilir: logo 512 px genişlik × 160 px yükseklik kutusuna sığacak şekilde küçültülür — panel bir logoyu en fazla 160 px genişlikte ve 48 px yükseklikte gösterir, bu kutu en keskin ekranları da karşılar (oranı korunur, küçük görsel asla büyütülmez, biçimi değişmez); favicon en fazla 256 px'lik kare bir PNG olur — kare olmayan görsel şeffaf bir karenin ortasına yerleştirilir, hiçbir yeri kırpılmaz. Fotoğrafın kamera yönü uygulanır. Zaten sığan küçük bir görselin (256 KB'a kadar) pikselleri bayt bayt aynen saklanır; sığan hareketli bir logo animasyonunu korur, daha büyüğü ilk karesini. Bir kameranın ya da düzenleyicinin piksellerin yanına yazdığı bilgi (EXIF, XMP, metin yorumları: konum, cihaz, tarih) saklanan her görselden, logolardan da giriş kapaklarından da silinir, çünkü giriş sayfası onları herkese gösterir; renk profili kalır. 25 megapikselden büyük görsel hiçbir şey çözülmeden başlığından 400 IMAGE_DIMENSIONS_TOO_LARGE ile, bozuk ya da kesik dosya 400 INVALID_IMAGE ile reddedilir. Yükleme yanıtı her dosyanın önceki ve sonraki boyutunu bildirir (optimized). SVG vektör olarak kalır. Saklanan dosyayı panelin web sunucusu /branding/<ad> adresinde sunar; ad görsel her değiştiğinde değişir, bu yüzden tarayıcılar dosyayı bir yıl saklar ve yeni logoyu bir sonraki sayfa yüklemesinde alır. Logoyu değiştirmek ya da kaldırmak ve sıfırlama eski dosyayı siler. Dosyalar sunucuda /var/lib/whost/branding/ altındadır — bu klasörü sunucu yedeklerine dahil edin.
Giriş sayfası videosu. Giriş Sayfası Videosu bölümü yönetici ve müşteri giriş sayfasının arka plan videosunu değiştirir, her biri kendi kartında (rozet Varsayılan ya da Özel yazar; önizleme fareyle üzerine gelince ya da tıklayınca oynar). Video Yükle bir MP4, MOV (telefonların ve kameraların kaydettiği), WebM ya da MKV dosyası alır ve göndermeden önce tarayıcıda hazırlar; hangi biçimde gelirse gelsin saklanan dosya MP4'tür. 5 MB'a sığan H.264 bir video yalnız yeniden paketlenir (MOV ya da MKV yeniden kodlanmadan MP4 olur). Başka bir kodekte olup sınıra sığan video (örneğin telefondan HEVC, WebM'den VP9) kendi görüntü kalitesine yakın H.264'e dönüştürülür — en fazla kendi bit hızının üç katıyla, çünkü H.264 aynı görüntü için o kadar fazlasını ister — ve 5 MB'ı dolduracak şekilde büyütülmez; kart bu sırada Video dönüştürülüyor yazar, bildirim MP4'e dönüştürüldüğünü söyler. Daha büyüğü H.264 olarak yeniden kodlanır — 1920 × 1080 kutusuna (dik videoda 1080 × 1920, telefonun döndürmesi uygulanarak) sığdırılır, saniyede en fazla 30 kare, 5 MB'a yakın hedeflenerek: tarayıcının kodlayıcısı çoğu zaman kendisine verilen bit hızının epey altında kalır (ya da üstüne çıkar), bu yüzden yaklaşık 4,25 MB'ın altında ya da 5 MB'ın üstünde biten bir geçiş ölçtüğü farkla yeniden kodlanır ve kart bu geçiş boyunca Video ince ayarlanıyor yazar. Kodlanan genişlik 16'nın katıdır (dörde bölünmeyen bir genişlik verilen donanım kodlayıcısı görüntünün ayrıntısının çoğunu kaybeder) ve anahtar kare 10 saniyede bir yazılır, böylece 5 MB'ın daha büyük kısmı görüntüye kalır. 5 MB içinde 10–20 saniyelik bir klip ayrıntısının çoğunu korur; uzun bir video ya da her yerinde hızlı hareket ve ince doku olan bir video gözle görülür şekilde kayıp verir — aynı sahnenin kısa bir klibi uzun bir videonun tamamından daha iyi görünür. 640 × 360'ta bile yaklaşık 300 kbit/sn'nin altına düşecek kadar uzun bir video sığan uzunluğa kısaltılır ve panel kaç saniyenin tutulduğunu söyler. Her iki yolda da ses izi ve dosyanın tanımlayıcı etiketleri (kamera, konum, tarih) atılır — giriş sayfası sessiz oynatır. Sayfanın video oynayana kadar gösterdiği kapak videonun ilk karesinden alınır, böylece oynatma başlarken görüntü sıçramaz; Kapağı Değiştir onu kendi JPEG, PNG ya da WebP görselinizle değiştirir (tarayıcıda ve sunucuda yine aynı kutuya sığdırılır, en fazla 2 MB); yeni bir video yine kendi ilk kare kapağını getirir. Varsayılana Dön videoyu ve kapağını kaldırır, sayfa varsayılan videoyu gösterir. Küçültme WebCodecs destekli bir tarayıcı ister (güncel Chrome, Edge, Firefox ve Safari); başka bir tarayıcıda en fazla 5 MB'lık bir MP4 olduğu gibi, kapaksız yüklenir; daha büyüğü ya da MOV, WebM, MKV reddedilir. Agent videoyu yapısını okuduktan sonra geldiği gibi saklar (sunucuda hiçbir kare çözülmez); tanımlayıcı etiketleri, XMP paketi ve oluşturma zamanları silinir — olduğu gibi yüklenen bir MP4 de bunları sunucuda kaybeder: video izi H.264 olan bir MP4 olmalıdır (aksi hâlde 415 UNSUPPORTED_MEDIA_TYPE kodeki adıyla söyler), en fazla 5 MB (400 FILE_TOO_LARGE); bozuk dosya 400 INVALID_VIDEO, kendi videosu olmayan bir sayfa için gönderilen kapak 400 LOGIN_VIDEO_REQUIRED döner, kapaksız gönderilen yeni video eski kapağı düşürür. Video ve kapak logolar gibi /branding/ altındaki dosyalardır ve eklentiyi ve özellik anahtarını aynı şekilde izler: eklenti sona erdiğinde ya da whitelabel kapatıldığında iki giriş sayfası da bir sonraki sayfa yüklemesinde varsayılan videoyu oynatır. Giriş sayfası videosunu panel betiği markayı okuduktan sonra yükler; böylece kendi videosu olan bir sunucu varsayılan videoyu hiç indirmez, o ana kadar kapak gösterilir.
Her değişiklik — ayar kaydı, logo yükleme, logo silme, giriş sayfası videosu yükleme ya da kaldırma, sıfırlama — settings_updated denetim satırı yazar (scope: whitelabel); hiçbir şeyi değiştirmeyen kayıt satır yazmaz. Renkler aralık içinde HSL üçlüsüdür (ton 0–360, doygunluk ve parlaklık 0–100), iki anahtar boolean'dır ("yes" reddedilir). Yüklü olmayan bir logoyu silmek 404 LOGO_NOT_FOUND, yüklü olmayan bir giriş sayfası videosunu kaldırmak 404 LOGIN_VIDEO_NOT_FOUND döner. Eklenti lisanssızken ya da özellik kapalıyken form fare için olduğu gibi klavye için de devre dışıdır; eklenti lisanssızken agent ayar kaydını, logo ya da giriş sayfası videosu yükleme ve kaldırmayı ve sıfırlamayı 403 LICENSE_ADDON_REQUIRED ile reddeder, böylece panelin yayımlamayacağı hiçbir değer saklanamaz (zaten saklı değerler olduğu gibi kalır, public markalama okuması pasif kalır). Herhangi bir kayıtta limit yanıtı hata olarak bildirilir; otomatik kaydı reddedilen renk alanları saklı değere geri döner.
Denetim Logları
Her kimlik doğrulama, mutasyon ve yönetici aksiyonu /var/log/whost/audit.jsonl dosyasına düşer ve bu sayfada filtreler (actor, olay, zaman aralığı) ile yüzeye çıkarılır. Client tarafı kimlik olayları da dahildir: client giriş/çıkış ve 2FA adımları; ayrıca her iki panelde yapılan parola değişimi (e-postayla gönderilen bağlantıyla sıfırlama dahil), 2FA aç/kapa, yedek kod yenileme ve kurtarma e-postası değişimi. Reddedilen bir giriş, yönetici ve müşteri formu için aynı biçimde bir login_failed kaydıdır (kaydın ayrıntısı nedeni — bilinmeyen kimlik, yanlış parola, yanlış ikinci faktör kodu — ve formu söyler). Deneme sayacı bir giriş formunu ya da 2FA adımını bir süreliğine kapattığında bunu bir login_locked ya da 2fa_locked kaydı tutar (yönetici ve müşteri formları için aynı; kilit süresi kaydın ayrıntısında). Sunucunun kendi durumu da buradadır: her lisans geçişi için bir license_state_changed kaydı (iki durum ve tetikleyici ayrıntıda — kayıt anahtarı asla taşımaz), çalışan ajanın kendi denetimi kodunun ya da manifestinin değiştiğini bulduğunda (ajan kendini durdurmadan önce yazılır, denetimi adlandırır) ya da açılıştaki manifest denetimi ajanı başlatmayı reddettiğinde bir integrity_alert kaydı ve bir yazılım güncellemesinin update_install_started / update_installed / update_failed kayıtları. Yalnızca-ekleme; 10.000 kaydı aşınca en eskiler yanındaki audit.jsonl.1 dosyasına taşınır (50 MB'ı aşan arşiv bir öncekinin yerine .2 olur) ve canlı dosya en yeni 8.000 kaydı tutar — sayfa canlı dosyayı okur.
Yasaklı Kelimeler
Yasaklı terim listeleri. Listeler uygulanır: yasaklı kelime taşıyan bir hesap adı, birincil alan adı, addon alan adı ya da alt alan adı oluşturulurken ya da değiştirilirken 403 BANNED_WORD ile reddedilir (yanıt kelimeyi ve listeyi söyler). Eşleştirme büyük-küçük harf duyarsızdır ve alt dizgiyle yapılır: değerin kendisi ve ., -, _, /, @ ile bölünen parçaları etkin her listenin her kelimesiyle karşılaştırılır; malware bu yüzden antimalware-tools'u da yakalar — listelerin kelimelerini özgül tutun. Panelle sekiz yerleşik liste gelir (beşi etkin); yerleşik liste kapatılıp düzenlenebilir ama silinemez (422). Değer Kontrol Et kutusu kapıların koşturduğu kontrolün aynısını sorar. /etc/whost/wordlists/ altında okunamayan bir liste dosyası sayfada bir uyarıyla adlandırılır ve uygulanmaz.
Kullanılan uç noktalar: GET/POST /banned-words, GET/PUT/DELETE /banned-words/{wordlist_id}, POST /banned-words/check.
Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.