Yapılandırma Referansı

Yapılandırma Dosyası

Konum: /etc/whost/agent.conf (YAML formatı)

Dosya izinleri: 600, sahibi root (yalnızca root tarafından okunabilir). Agent her açılışta izni 600'e geri çeker.

Kurulum aracı, makul varsayılanlarla çalışan bir yapılandırma yazar — çoğu sistem yöneticisinin dosyayı doğrudan düzenlemesi gerekmez: aşağıdaki anahtarların çoğu panelden değiştirilir; panel bu dosyayı yazar ve değişikliği ilgili servise uygular. Aşağıdaki bölümler, ayarlanması gerektiğinde nereye bakacağınızı bilmeniz için her bloğun neyi yönettiğini açıklar.

Dosya nasıl yazılır. İlk sürümü kurucu, ihtiyaç duyduğu bloklarla yazar. Bundan sonra agent, bellekte tuttuğu ayarlardan dosyanın tamamını yeniden yazar: ilk açılışında (aşağıdaki her bloğu varsayılan değerleriyle ekler) ve panelden kaydedilen her değişiklikte. Elle eklenen yorumlar, anahtar sırası ve biçim korunmaz; agent'ın tanımadığı bir anahtar (yanlış yazılmış olanı da) uyarı verilmeden yok sayılır ve bir sonraki yazımda düşer. Bozuk YAML ya da yanlış tipte bir değer (sayı veya true/false beklenen yerde metin) agent'ın açılmasını durdurur; nedeni /var/log/whost/agent.log dosyasına eklenir.

Sırlar. Parolalar ve sırlar bu dosyada düz metin olarak durur (yönetici parolası bcrypt özeti olarak). Agent çalışırken bunları bellekteki bir kasaya taşır; diskte tek korumaları dosyanın 600 root iznidir — dosyanın her kopyasını ve yedeğini aynı sıkılıkta koruyun.

Başka yerde tutulan ayarlar. Güncelleme tercihleri (/etc/whost/update_settings.json, son bölüme bakın), Ayarlar › Bildirimler'in kanalları ve aktarıcısı (/etc/whost/notification_prefs.json), uzak yedek hedefleri (/etc/whost/remote_backup.json), API anahtarları (/var/lib/whost/api_keys.json), eklenti durumu (/etc/whost/plugins.json) ve sunucu saat dilimi (bir sistem ayarı) bu dosyada değildir.

Tabloları okuma. Varsayılan, anahtar yoksa agent'ın kullandığı değerdir; kurucu farklı bir değer yazıyorsa o da belirtilir. Değiştirildiği yer panel sayfasını adlandırır. dosya — yalnız bu dosya düzenlenerek (sondaki Değişiklikleri Uygulama bölümüne bakın). agent — kurucu ya da agent yazar: düzenlemeyin, elle yazılan değer onu kullanan servisi bozar. — — anahtarın bu sürümde etkisi yoktur.

Bölüm Detayları

server

Sunucunun kimliği ve agent'ın kendi dinleyicisi.

Panel sertifikası. /etc/whost/ssl/cert.pem ve /etc/whost/ssl/key.pem çifti kurulumda host adı için self-signed olarak üretilir. Aynı çift panelin 443 portundaki nginx vhost'una, Postfix ve Dovecot TLS'ine, siteleri LiteSpeed sunuyorsa OpenLiteSpeed dinleyicisine ve agent'ın loopback dinleyicisine hizmet eder. Güvenilir bir sertifika sunmak için iki dosyayı değiştirin (cert.pem içinde sertifika ve zinciri), nginx -t ile kontrol edin, ardından nginx, Postfix ve Dovecot'u reload edin.

auth

API isteklerinin HMAC-SHA256 kimlik doğrulaması (makineden makineye; paneller oturum çerezi kullanır).

webserver

Siteleri hangi web sunucu yığınının sunduğu ve genel bağlantı ayarları. type şunlardan birini alır:

• nginx: Tüm HTTP trafiğini doğrudan Nginx yönetir
• apache: Tüm HTTP trafiğini doğrudan Apache yönetir
• nginx_apache: Reverse proxy olarak Nginx (port 80/443) + Apache backend (apache_port, 8080)
• openlitespeed, litespeed: OpenLiteSpeed ya da LiteSpeed Enterprise; ilgili eklenti Eklentiler sayfasında etkinleştirildiğinde ayarlanır; PHP bu durumda LSAPI üzerinden çalışır

Installer nginx_apache ya da nginx yazar; diğer değerleri reddeder (bkz. Kurulum).

php

Birden fazla PHP sürümü aynı anda kurulabilir ve her hosting hesabı farklı bir sürüm kullanabilir.

Yedi default_* değeri, hesap kendi değerlerini kaydedene kadar hesabın havuzunun üretildiği ini değerleridir; hesabın kaydettiği değerler meta verisinde tutulur ve sürüm, işlemci ya da paket değişiminden sağ çıkar. Bir varsayılanı değiştirmek mevcut havuzları yeniden yazmaz: kendi değeri olmayan bir hesap yeni varsayılanı, havuzu bir sonraki üretilişinde alır.

python

Python uygulama barındırma (Python Hosting eklentisi). Eklentinin açık/kapalı durumu bu bloğun anahtarı değil, client_features.python_apps'tir.

node

Node.js uygulama barındırma (Node.js Hosting eklentisi). Eklentinin açık/kapalı durumu bu bloğun anahtarı değil, client_features.node_apps'tir.

mysql

Agent'ın MariaDB bağlantısı ve sizin yerinize uyguladığı MariaDB ayarları.

Ayarlar › Genel'den bir veritabanı değerini değiştiren kayıt, /etc/mysql/mariadb.conf.d/99-whost-tuning.cnf (RHEL'de /etc/my.cnf.d/) drop-in dosyasını agent'ın şablonundan sekiz değerin tamamıyla yeniden yazar ve her birini SET GLOBAL ile canlı uygular; bu yüzden yeniden başlatma gerekmez. Drop-in ayrıca MariaDB'nin bir sonraki yeniden başlatmada okuduğu local_infile = 0 ve secure_file_priv = /var/lib/mysql-files satırlarını taşır. Kurucu bu dosyanın sunucunun RAM'ine göre boyutlandırılmış kendi sürümünü yazar (InnoDB buffer pool RAM'in %37,5'i, en az 256 MB; max_connections = 300; InnoDB log ve flush ayarları); panelden yapılan ilk veritabanı kaydı onu sayfanın gösterdiği sekiz değerle değiştirir. Bu anahtarları dosyada düzenlemek MariaDB'yi değiştirmez.

dns

HTTP API üzerinden PowerDNS entegrasyonu.

mail

Postfix (SMTP) + Dovecot (IMAP/POP3) + OpenDKIM. Posta sistemi sanal posta kutusu yönetimi için bir MariaDB veritabanı kullanır.

ssl

certbot üzerinden Let's Encrypt entegrasyonu. Siparişler HTTP üzerinden domainin kendi document root'undan doğrulanır, domainin adını alır ve vhost'un gösterdiği dosyaları tazeleyip web sunucuyu reload eden bir yenileme kancası kurar; yenilemeler certbot'un kendi takviminde çalışır (systemd zamanlayıcısı ya da zamanlayıcı yoksa kurucunun eklediği günlük cron satırı). Bir sertifikayı silmek lineage'ı da kaldırır.

ftp

MariaDB kimlik doğrulamalı Pure-FTPd. Her hosting hesabı birden fazla FTP alt hesabına sahip olabilir.

passive_ports, max_clients ya da max_per_ip değerini değiştiren kayıt üç direktifi yazar (Debian/Ubuntu'da /etc/pure-ftpd/conf/, RHEL'de /etc/pure-ftpd/pure-ftpd.conf) ve Pure-FTPd'yi yeniden başlatır; elle düzenleme Pure-FTPd'yi değiştirmez.

backup

Yerel yedek deposu ve saklama süresi.

Zamanlayıcı agent ile birlikte yalnız enabled ve schedule.enabled ikisi de true iken başlar ve schedule.check_interval o anda okunur: schedule.enabled değişikliği — panelden kaydedilse de — bir sonraki agent açılışında etkili olur; açılışta kapalı olan enabled'ı yeniden açmak da öyle. Zamanlayıcı çalışmıyorken ne zamanlanmış yedekler ne de saklama budaması çalışır.

Uzak hedefler bu dosyada yapılandırılmaz: panelden yönetilir (Yedekler › Uzak Depolama) ve /etc/whost/remote_backup.json dosyasında şifreli saklanır (hesaba ait olanlar /etc/whost/accounts/<user>/remote_backup.json altında).

logging

license

license.state_file, kalıcı lisans durumu dosyasını seçer; varsayılan değer /etc/whost/license.state yoludur. HMAC dosyası bu yola .hmac eklenerek bulunur. Durum yükleme, kaydetme ve bağımsız endpoint, servis, startup ve çalışma zamanı kontrolleri seçilen dosyayı kullanır. Varsayılan konumdaki eski dosya, yapılandırılmış konumda bulunmayan dosyanın yerine kullanılmaz.

İki dosyanın sahibi root, izinleri 0600 olmalıdır. Startup izinleri 0600 olarak düzeltir. Ayarı değiştirdikten sonra agent'ı yeniden başlatın; lisans doğrulama kotasını tüketen art arda yeniden başlatmalardan kaçının. Kurulumun boot token'ı /etc/whost/.boot_token konumunda kalır; seçilen veya varsayılan durum dosyasındaki önceki aktivasyon kanıtı, eksik ya da bozuk token'ın sessizce yeniden üretilmesini engeller.

Lisans grace süresi ve önbellekteki token'ın geçerliliği, lisans sunucusunun doğrulanmış UTC zamanının geçen kernel açılış süresiyle ilerletilmesiyle hesaplanır. Sistem saatini geri almak grace süresi eklemez. Durum HMAC'i saat çapasını da korur; böylece aynı işletim sistemi açılışı içindeki bir agent yeniden başlatması geçen süreyi korur. İşletim sistemi yeniden başlatıldıktan sonra ya da bu çapayı taşımayan bir önbellek yükseltilirken, önbellekteki grace kullanılmadan önce agent çevrimiçi lisans doğrulaması ister. NTP'yi açık tutun: TLS sertifika doğrulaması ve diğer sistem servisleri hâlâ sistem saatine bağlıdır.

Önbellekteki aktivasyon ve grace durumu, lisans sunucusunun özgün RSA imzalı yanıtını ve bu yanıtın geçerlilik süresini gerektirir. Yerel HMAC'in geçerli olması tek başına önbellekten erişim sağlamaz. İmza alanları veya imzalı süre eksikse, yanıt değiştirilmişse ya da token süresi dolmuşsa önbellek atılır ve çevrimiçi doğrulama gerekir. Aktivasyon ve periyodik doğrulama, imzalı yanıtı birlikte kaydeder. Durum dosyasını geri yüklerken token alanlarını değiştirmeyin veya kaldırmayın.

Bu bloğun diğer anahtarlarını agent yönetir — düzenlemeyin. key ve lisans sırları, lisans Lisans sayfasında etkinleştirildiğinde yazılır; etkinleştirilen anahtardan farklı, elle düzenlenmiş bir key bir sonraki açılışta etkinleştirilen anahtarla değiştirilir.

rate_limit

İstemci adresi başına API hız sınırlama (agent'ın panelin nginx'i arkasında çözdüğü ziyaretçi adresi), slowapi ile. Sınırını aşan istek Retry-After başlığıyla 429 RATE_LIMIT yanıtı alır. Değerler {count}/{period} formatını takip eder (örn. 120/minute, 5/minute).

rate_limit:
  default: "60/minute"
  read: "120/minute"
  write: "30/minute"
  delete: "20/minute"
  heavy: "5/minute"
  auth: "5/minute"

Altı değerin altısı da agent açılışında bu dosyadan okunur ve uygulanır.

fail2ban

modsecurity

WHost ModSecurity'yi nginx katmanında uygular (nginx ve nginx_apache); başka bir web sunucuyla ayarlar kaydedilir ama trafiğe uygulanmaz. /etc/modsecurity/modsecurity.conf bu bloktan, WAF sayfası bir ayarı ya da kuralı değiştirdiğinde — web sunucu yapılandırma testinden sonra — üretilir; bu yüzden elle düzenleme ona ancak bir sonraki böyle değişiklikte ulaşır.

security

admin

Yerleşik yönetici, iki panelin giriş koruması ve oturum süreleri.

frontend

nginx'in sunduğu statik panel paketi.

client_features

Varsayılanı hepsi true olan ve Ayarlar › Genel'den düzenlenen on bir anahtar (file_manager, dns, backups, cron, ssl, php, email, ftp, databases, python_apps, node_apps). Kapalı bir anahtar, o yüzeyin her müşteri rotasında API'de uygulanır (409 FEATURE_DISABLED, istek yoluna göre — email için /client/emails ve /client/spam, file_manager için /client/files, php için domain başına /client/domains/{domain}/php/* rotaları); müşteri profili anahtarları features olarak taşır ve müşteri paneli kapalı bir yüzeyin kenar çubuğu girdisini ve dashboard kutucuklarını gizler. Kapalı bir anahtar yedek zamanlayıcısını durdurmaz: backups kapalıyken yalnız müşterinin yedek rotaları reddedilir, hesabın mevcut zamanlamaları çalışmaya devam eder.

python_apps ve node_apps aynı zamanda Python Hosting ve Node.js Hosting eklentilerinin açık/kapalı durumudur: eklentiyi Eklentiler sayfasında etkinleştirmek ya da devre dışı bırakmak bunları ayarlar (uygulamalar dağıtılmışken devre dışı bırakma reddedilir); biri kapalıyken her Python ya da Node.js uygulama rotası — yöneticininkiler dahil — 503 PLUGIN_DISABLED döndürür.

whitelabel

enabled, company_name, dört logo adresi (logo_light, logo_dark, favicon, favicon_dark), her panel için giriş sayfası videosu ve kapağı (login_video_admin, login_poster_admin, login_video_client, login_poster_client; boş = varsayılan video), altı HSL rengi (primary_color, secondary_color, nav_color ve _dark ikizleri; H 0–360, S ve L 0–100 aralığında "H S% L%") ve hide_login_branding (varsayılan true). Whitelabel sayfasından (sağ üstteki hesap menüsü) düzenlenir; her değişiklik bir settings_updated denetim satırı yazar ve panel ağaçlarındaki config.json dosyasını yeniden yazar. whitelabel lisans eklentisi etkin değilken sayfanın kayıtları, logo ve giriş videosu yüklemeleri ve kaldırmaları ve sıfırlaması 403 LICENSE_ADDON_REQUIRED ile reddedilir; bu blokta zaten bulunan değerler kalır ve herkese açık marka okuması eklenti etkinleşene kadar active: false döndürür. Eklentiyi veren ya da geri alan bir lisans denetimi config.json'u hemen yeniden yazar, panel yeniden başlatma olmadan izler. Elle düzenleme, eklenti etkinken bir sonraki agent açılışında yayımlanır.

Bir logo alanı, agent'ın /var/lib/whost/branding/ altında sakladığı bir dosyanın adresini tutar — /branding/<alan>.<özet>.<png|jpg|webp|svg>; dosyayı panelin nginx'i (/etc/nginx/snippets/whost-panel-locations.conf içinde location ^~ /branding/) bir yıllık değişmez önbellek ve korumalı alan (sandbox) içerik politikasıyla sunar; ad içerikle birlikte değişir, değiştirilen ya da kaldırılan logonun dosyası silinir. Yalnız böyle bir adres (ya da aşağıdaki satır içi data:image/ URL'i) yayımlanır; elle yazılmış başka bir değer yayımlanmaz. Yüklemeler (dosya başına 2 MB) saklanmadan önce biçimlendirilir: raster logo 512 × 160 px (genişlik × yükseklik) kutusuna, favicon şeffaf dolgulu en fazla 256 px'lik kare bir PNG'ye; 25 megapikselden büyük görsel (400 IMAGE_DIMENSIONS_TOO_LARGE) ve türü olarak çözülemeyen dosya (400 INVALID_IMAGE) reddedilir; SVG temizlenip korunur. Giriş videosu alanı /branding/login_video_<admin|client>.<özet>.mp4 adresini tutar — video izi H.264 olan, en fazla 5 MB'lık bir MP4, yüklendiği gibi saklanır (panel daha büyük bir videoyu yüklemeden önce tarayıcıda küçültür) — kapağı ise /branding/login_poster_<admin|client>.<özet>.<jpg|png|webp>, 1920 × 1080 kutusuna (dik görselde 1080 × 1920) sığdırılır; her alan yalnız kendisi için yazılmış bir dosyayı yayımlar. Önceki bir sürümün satır içi data: URL'i olarak sakladığı logolar, panel nginx'inin /branding/ sunduğunu gören ilk agent açılışında dosyalara taşınır: özgün değerler önce /var/lib/whost/branding-legacy-<zaman>.yaml dosyasına (mod 0600) kopyalanır, logolar yüklemeler gibi biçimlendirilir ve blok bir kez kaydedilir; çözülemeyen bir değer olduğu gibi kalır. /var/lib/whost/branding/ klasörünü sunucu yedeklerine dahil edin.

güncelleme tercihleri (agent.conf bloğu değildir)

agent.conf'ta update: bloğu yoktur; eski bir kurulumdan kalan update: bloğu hiçbir kod tarafından okunmaz ve agent dosyayı bir sonraki yazışında düşer. Güncelleme tercihleri /etc/whost/update_settings.json (root, 0600) dosyasında durur: channel (stable | beta), auto_update, auto_update_type (all | security | patch | minor), backup_before_update, notify_available, notify_installed, os_packages_check_enabled, os_packages_notify_security, allow_vendor_critical_override. auto_update_type neyin kendiliğinden kurulacağını belirler: security yalnız satıcının kritik işaretlediği sürümleri (ve yalnız allow_vendor_critical_override açıkken), patch bir patch adımını, minor bir minor ya da patch adımını, all her sürümü; satıcının kritik işaretlediği bir sürüm, allow_vendor_critical_override açıkken diğer tiplerde de kurulur. Kurucu dosyayı yeni bir sunucuda bir kez, kurduğu sürümün kanalıyla yazar (-beta.N bir sürümde beta, aksi hâlde stable) ve var olan dosyaya dokunmaz; sonrasında dosyayı Güncellemeler sayfası yazar (Ayarlar sekmesi, PUT /system/update/settings), kurulum hattı ve zamanlayıcı okur; dosya yoksa varsayılanlar geçerlidir (satıcının kritik işaretlediği sürümlerin otomatik kurulumu açık), ayrıştırılamayan bir dosya loglanır ve onarılana kadar auto_update: false sayılır. Kontrol kadansı sabittir: her agent açılışından beş dakika sonra, ardından 24 saatte bir (en çok 30 dakika jitter).

Ortam Değişkenleri

Agent ayarlarını yalnızca bu YAML dosyasından okur; bu dosyanın hiçbir anahtarı ortam değişkeniyle verilemez. Servis birimi (/etc/systemd/system/whost-agent.service) agent'ın çalıştığı ortamı — aralarında bu dosyanın yolu olan WHOST_CONFIG_PATH=/etc/whost/agent.conf — sertleştirme anahtarlarıyla birlikte ayarlar. Birimi kurulduğu gibi bırakın: kurucu ve agent'ın açılıştaki izin kontrolü /etc/whost/agent.conf üzerinde çalışır.

Değişiklikleri Uygulama

Panelden kaydedilen ayarlar hemen etkili olur: agent bu dosyayı kendisi yazar ve değişikliği, tabloların anlattığı gibi ilgili servise uygular. Panelin sunmadığı bir anahtarı (tablolarda dosya) değiştirmek için:

1. Bir kopya alın, örneğin cp -p /etc/whost/agent.conf /root/agent.conf.bak — kopya aynı sırları taşır, 600 izninde tutun.
2. Dosyayı düzenleyin, ardından panelde bir şey kaydetmeden önce agent'ı yeniden başlatın; yeniden başlatmaya kadar panelden yapılan bir sonraki kayıt, agent'ın bellekteki ayarlarını düzenlemenin üzerine yazar.
3. Agent'ın geri geldiğini kontrol edin: açılış bittiğinde (birkaç saniye) curl -sk https://127.0.0.1:2000/health {"status":"ok",...} yanıtı verir. Vermiyorsa /var/log/whost/agent.log dosyasının sonunu okuyun.

systemctl restart whost-agent
curl -sk https://127.0.0.1:2000/health

Elle düzenleme agent'ın okuduğunu değiştirir; panel kaydının yazdığı servis yapılandırmalarını (web sunucu ayarları, MariaDB, Pure-FTPd, Postfix ileti boyutu, sshd, nginx yönetici beyaz listesi, DNS bölgeleri, panel vhost'u) yeniden yazmaz. Bu anahtarları panelden değiştirin. Her agent açılışı lisansı lisans sunucusuyla doğrular; art arda yeniden başlatmalardan kaçının.

Geliştirici: WISECP LLC. İletişim: [email protected]