Plugin'ler

Güncellendi 18 Kas 2026 Markdown

Değiştirilebilir backend'ler için pazar yeri. Bugün iki kategori dağıtılmaktadır:

Web sunucusuOpenLiteSpeed (ücretsiz), LSWS Enterprise (lisans / 15 günlük deneme)
RuntimePython Hosting (ücretsiz), Node.js Hosting (ücretsiz)

Aktivasyon modları: free, trial, license (handler'a özgü). Web sunucusu aktivasyonları her hesabın vhost'larını yeni backend'e yeniden yazar — park alan adları dahil barındırılan her ad, bir adın HTTPS'i de sertifika kaydından (Let's Encrypt kadar yüklenmiş sertifika da; kaydı olmayıp Let's Encrypt kökü olan ad o kökü korur) — canlı ilerleme diyaloğu (SSE) faz-faz durumu gösterir. Nginx ya da Apache'den LSWS Enterprise'a geçiş önce sunucuyu kurar, sonra siteleri onun yapılandırmasına taşır (yapılandırma sunucu kurulunca oluşur). Siteleri OpenLiteSpeed sunarken LSWS Enterprise'a geçiş önce OpenLiteSpeed'i kapatır (LiteSpeed'in kurucusu onun yanında çalışmaz, LiteSpeed Enterprise da onun site dosyalarını okumaz): siteler geldikleri web sunucusuna (Nginx + Apache) döner, LiteSpeed Enterprise kurulurken orada açık kalır ve sonra aynı yolla onun yapılandırmasına taşınır; kurulum başarısız olursa orada kalır, OpenLiteSpeed'i yeniden açmak onları OpenLiteSpeed'e geri götürür. OpenLiteSpeed / LiteSpeed Enterprise'a ya da onlardan her geçiş önce taşınılan web sunucusunun (ve sunucuda çalışan öbür web sunucusunun) yapılandırma testlerini koşar: zaten düşen bir test geçişi hiçbir site taşınmadan reddeder ve sunucuyu adıyla söyler. Hesaplar tek tek taşınır, her hesabın eski site dosyaları kendi web sunucusunca silinir (Nginx sunucusundaki Nginx + Apache hesabı dahil); bir site taşınamazsa geçiş düşer, her site geldiği web sunucusuna döner, eklenti olduğu gibi kalır ve diyalog (ya da API'nin hatası) siteyi nedeniyle birlikte söyler — siteyi OpenLiteSpeed'in ya da LiteSpeed Enterprise'ın yapılandırma testi reddettiyse onu reddettiren satırlarla ([ERROR] satırları ya da siteyi adıyla "configuration failed" diye anan satır; en çok beş, her biri 300 karakterde kesilir). Ajan günlüğü reddin kaydına bu satırlarla başlar, testin bütün çıktısını — standart çıktı ve standart hata — ardından gelen kayıtta tutar. Hesabın kendi istekleri (PHP sürümü, alan adı, SSL) testin çıktısını, başka hesapların sitelerini anabileceği için asla aktarmaz: eskisi gibi yanıtlanır. Geçişin son adımı LiteSpeed sunucusunu tamamen durdurup servisine başlatır; geçiş, o sunucu kuşağı işçilerini başlatıp Nginx'in siteleri ilettiği dinleyiciyi (8088) tuttuğunda ve onu tutan daha eski bir kuşak kalmadığında tamamlanmış sayılır; aksi hâlde her site geldiği web sunucusuna döner ve geçiş hata verir ("OpenLiteSpeed failed to start", "LiteSpeed failed to start"). Paket kurulumunun servisin dışında başlattığı sunucu, hiçbir şey onu yeniden yüklemeden önce servisçe yeniden başlatılır. Değişim her evin ve web kökünün kipini ve grubunu da yeniden uygular (her web sunucusunda 0750 ve web grubu: LiteSpeed işçisi web grubuyla koşar, başka hiçbir hesap bir evden geçemez; önceki bir sürümün LiteSpeed sunucusunda başka hesaplara açık bıraktığı evler (0711) güncellemeden sonraki ilk ajan açılışında bir kez kapatılır, sunucu yapılandırma testi geçerse yumuşak yeniden başlatılır); web kökü tutamaçla ayarlanır, hesabın evinin dışına çıkan bir public_html olduğu gibi bırakılır ve ajan günlüğünde adlandırılır ("web root of … left as it is"). LiteSpeed sunucusu (OpenLiteSpeed ya da LiteSpeed Enterprise) nobody kullanıcısı ve web grubuyla çalışır (Debian / Ubuntu'da www-data, AlmaLinux / Rocky / CentOS Stream'de nginx); bu değişimde ayarlanır ve her ajan açılışında denetlenir (değişiklik bir zarif yeniden başlatma alır), böylece panelin 0640 yazdığı hesap dosyalarını (varsayılan sayfa, Dosya Yöneticisi yüklemeleri) Nginx ve Apache gibi okur; PHP hesabın kimliğiyle çalışmaya devam eder. Siteleri sunduğu sürece onların erişim ve hata günlüklerini hesapların günlük klasörlerine yazar (bkz. Hesap logları ev dizinlerinin dışında) ve hem OpenLiteSpeed hem LiteSpeed Enterprise erişim satırını ziyaretçinin adresiyle Nginx'in combined biçiminde yazar; Loglar sayfaları, trafik sayacı ve web hapisleri onu Nginx'teki gibi okur. LiteSpeed Enterprise'da bir istisna var: gizli bir dosyaya (/.env, /.git/config gibi nokta ile başlayan bir ad) kendiliğinden verdiği 403 satırı Nginx'in adresiyle (127.0.0.1) yazılır ve web hapisleri bu adresi yok sayar, bu yüzden o istekler yasağa sayılmaz; hiçbir sitenin sunmadığı öbür dosyalara gelen istekler (/backup.sql gibi) ziyaretçinin adresiyle 404 alır ve sayılır. LiteSpeed sunucusu 127.0.0.1'den gelen bağlantıda ziyaretçinin adresini Nginx'in X-Forwarded-For başlığından alır; bu yüzden siteleri sunduğu sürece Nginx'in arkasındaki dinleyicisine (8088 portu, sunucunun kendi adreslerinin hepsinde) yalnız root ve web sunucusu kullanıcısı (www-data / nginx) bağlanabilir; barındırma hesaplarının süreçleri orada reddedilir, böylece erişim satırının hangi adresle başlayacağını belirleyip web hapislerine o adresi yasaklatamaz. O porta doğrudan bağlanan bir betik connection refused alır; sitelere eskisi gibi adlarıyla 80 / 443 portlarından ulaşılır. Kural (paket süzgecinde ajan portununki gibi kendi zinciri) OpenLiteSpeed ya da LiteSpeed Enterprise etkinleştirildiğinde, her ajan açılışında ve güvenlik duvarı açıldığında kurulur — her seferinde ajan Nginx üzerinden dinleyiciye hâlâ ulaşıldığını denetler, ulaşılamıyorsa kuralı geri kaldırır (ajan günlüğü bunu yazar) — ve sunucu Nginx'e ya da Nginx + Apache'ye döndüğünde, o portu dinleyen LiteSpeed süreci kalmayınca kalkar. OpenLiteSpeed ya da LiteSpeed Enterprise'ı kapatmak LiteSpeed sunucusu tamamen durana kadar bekler: süren bir isteği bitirmekte olan LiteSpeed süreci beklenir ve yarım dakika içinde bitmezse sonlandırılır; bu yüzden kapatma birkaç saniye uzayabilir, siteler o sırada zaten Nginx / Apache'dedir (bir süreç buna rağmen kalırsa kural yerinde kalır ve ajan günlüğü bunu yazar). LiteSpeed Enterprise kendi sistem hizmeti olarak çalışır (lshttpd, Servisler sayfasında görünür): satıcının kurucusu sunucuyu kendisi başlattığı için etkinleştirme ve LiteSpeed güncellemesi o sunucuyu tamamen durdurup hizmet üzerinden yeniden başlatır (geçişin içinde bir kısa yeniden başlatma daha); ajanın yeniden başlatılması, yeniden dağıtılması ya da güncellenmesi onu durdurmaz. Her ajan açılışında ajanın altında çalışan ya da hizmeti hâlâ etkin görünürken hiç çalışmayan bir LiteSpeed Enterprise sunucusu (örneğin onu ajanın altında bırakan bir sürümden güncellemeden sonra) hizmet üzerinden yeniden başlatılır ve ajan günlüğü bunu yazar; sizin durdurduğunuz hizmet durdurulmuş kalır. Web sunucusunun en çok istemci sayısı ya da keep-alive süresi değişince (Ayarlar → Genel) OpenLiteSpeed / LiteSpeed Enterprise aynı hizmet üzerinden yeniden başlatılır — çalışırken kesintisiz, durmuşsa hizmet tarafından başlatılır. OpenLiteSpeed'de hiçbir sitenin sunmadığı bir ad sunucunun 404'ünü alır: değişim ve her açılış, paketin örnek sitesine giden genel eşlemeyi kaldırır (örnek sitenin PHP'si sunucunun kendi kimliğiyle çalışırdı). Siteleri OpenLiteSpeed ya da LiteSpeed Enterprise sunarken 80 ve 443 portlarını onun önünde Nginx tutar: barındırılan her adın kendi Nginx dosyası vardır; sitenin HTTPS'ini sitenin kendi sertifikasıyla (Let's Encrypt ya da yüklenen, HTTP/2 üzerinden) sunar ve her isteği LiteSpeed'e iletir — statik dosyaları, WAF'ı, sitenin günlüklerini, yönlendirmeleri ve askıyı LiteSpeed sunmaya devam eder; sertifikası olmayan ad HTTP'de aynı yolla iletilir, HTTPS'i panelin sertifikasıyla yanıtlanır. 256 MB'a kadar istek gövdeleri siteye ulaşır (Nginx ve Apache sitelerindeki gibi) ve sertifika yenilemesi Nginx'i de yeniden yükler. Önceki bir sürümden güncellemeden sonra bu dosyaları ilk ajan açılışı yazar (bir çizim, yapılandırma testi ve kesintisiz bir yeniden yükleme). Hiçbir site dosyasının sunmadığı adları Nginx'in varsayılan blokları LiteSpeed'e iletir: ana makine adını, sunucu IP'sini ya da force-SSL ayarını kaydetmek bunu korur, önceki bir sürümdeki kaydın kaldırdığı yerde her ajan açılışı geri koyar. Bir SSL kurulumu (iki panelden ya da API'den; geçişte sertifikası olan ad için de) LiteSpeed yapılandırmasına 443 portunda dinleyici yazmaz; etkinleştirme ve her ajan açılışı orada bulduğu 443 dinleyicisini (önceki bir sürümün yazdığı ya da elle eklenmiş — LiteSpeed'in Nginx olmadan 443'ü kendisinin yanıtlaması desteklenen bir kurulum değildir) LiteSpeed'in yapılandırma testi geçince kaldırır, ardından LiteSpeed bir kez zarif yeniden yüklenir; böylece açılışta ikisinden hangisi önce başlarsa başlasın 443'ü Nginx alır, panel ve siteler açılır. Testi başka bir nedenle zaten başarısız olan yapılandırmada dinleyici kalır (ajan günlüğü nedenini yazar). LiteSpeed zaten tuttuğu bir portu zarif yeniden yüklemede bırakmadığı için ajan açılırken LiteSpeed'i, yapılandırmada orada dinleyici yokken hâlâ 443'ü tutar bulursa (Nginx daha önceki bir açılışta başlayamamışsa) LiteSpeed'i tamamen durdurup hizmeti üzerinden yeniden başlatır ve Nginx'i başlatır — ajan günlüğü bunu yazar, panel ve siteler geri gelir. OpenLiteSpeed'de bir sitenin sertifikasını kurmak ya da kaldırmak siteyi Nginx'in onu ilettiği dinleyiciden çıkarmaz; önceki bir sürümün o dinleyiciden çıkardığı (404 veren) barındırılan siteyi her ajan açılışı, yapılandırma testi geçince geri koyar; paketin örnek sitesi dışarıda kalır. OpenLiteSpeed her açılışta kendi yapılandırma klasörünü çalıştığı gruba verir; bu yüzden web grubundaki süreçler onu okuyabilir (WebAdmin parola dosyası yalnız lsadm'de kalır). OpenLiteSpeed'de hesabın sertifika dosyaları vhost'un kendi klasörüne, hesabın ssl klasörü tutamacıyla kopyalanır: bağlantı olan bir sertifika adı okunmaz, o alan adının SSL adımı durur (ajan günlüğü dosyayı adlandırır). Bir sitenin .htaccess yönlendirme kuralları iki sunucuda da uygulanır (WordPress kalıcı bağlantıları ve benzerleri): OpenLiteSpeed sitenin .htaccess dosyalarındaki yönlendirme kurallarını okur (öteki Apache yönergelerini okumaz), LiteSpeed Enterprise Apache sitelerinin okuduğu .htaccess yönergelerinin aynısını okur (AllowOverride All). Panelde tanımlanan yönlendirmeler de iki sunucuda uygulanır: sitenin kendi yapılandırmasına her klasörden ve .htaccess kurallarından önce yazılır ve Nginx'teki gibi yolun tamamıyla eşleşir. Sitelerinin .htaccess yönlendirme kurallarını okumadığı (kalıcı bağlantılı sayfaların 404 verdiği) ya da panelin yönlendirmelerini uygulamadığı (yönlendirilen yolun 404 verdiği) bir sürümden güncellemeden sonra ajanın ilk açılışı her sitenin yapılandırmasını yeniden yazar (bir çizim, bir yapılandırma testi, bir zarif yeniden başlatma). Geçiş, sunucudaki her PHP sürümü için LiteSpeed'in PHP'sini (LSPHP) o sürümün PHP-FPM'inde olan eklentilerle kurar — MySQL sürücüsü, mbstring, XML, GD, intl, OPcache, cURL ve ötekiler, LiteSpeed deposunun paket adlarıyla; deponun o sürüm için derlemediği eklenti atlanır, kurulamayan bir paket yalnız kendini dışarıda bırakır. Çıplak LSPHP yapısını kuran (o PHP sürümündeki MySQL'li sitenin 500 verdiği) bir sürümden güncellendiğinde zaten OpenLiteSpeed / LiteSpeed Enterprise'da olan sunucu, ajanın ilk açılışından yaklaşık yarım dakika sonra eksik eklentileri arka planda alır — korumalı bir OS güncelleme koşusu ya da başka bir paket işi bittikten sonra — ardından bir zarif yeniden başlatma gelir; ajan günlüğü kurulanları yazar, MySQL sürücüsü hâlâ eksik kalan sürüm sonraki açılışta yeniden denenir. OpenLiteSpeed'i etkinleştirmek ModSecurity modülünü (ols-modsecurity) de kurar ve WAF'ı siteler taşınmadan önce bağlar, böylece taşınan siteler WAF'larını korur (bkz. WAF (ModSecurity)); modül kurulamazsa etkinleştirme yine tamamlanır, agent 30 dakikada bir yeniden dener ve WAF sayfası nedeni söyler. Runtime plugin aktivasyonları aslında sayfanın girişini (admin panelinde ayarlar merkezinde bir kutucuk, client panelinde bir sidebar girişi) ekleyen ve eşleşen API yüzeyini açan bayrak değişiklikleridir.

"Çözüldü olarak işaretle" amber banner'ı bir aktivasyon pipeline'ı uçuş ortasında öldürüldüğünde (agent çökmesi, OOM kill) görünür. Bir tıklama marker'ı temizler; sistem yöneticisi bunu yapmadan önce sistem durumunu doğrulamalıdır.

Bir etkinleştirme isteği, hem engelleyen hem de arka plan yolunda, herhangi bir şey çalışmadan önce denetlenir: bilinmeyen eklenti 404 PLUGIN_NOT_FOUND, desteklenmeyen mod ya da bozuk serial anahtarı 400 PLUGIN_VALIDATION_ERROR döndürür ve reddedilen istek için görev oluşturulmaz. Serial anahtarları kırpılır ve yalnız harf, rakam, tire ve alt çizgiden oluşmalıdır. Eklenti durumu (maskelenmiş serial anahtarı dahil) /etc/whost/plugins.json dosyasında tutulur (root, 0600); liste ucu serial anahtarını hiç döndürmez, tek eklenti ucu maskelenmiş halini döndürür. Web sunucusu eklentisi kurulumları LiteSpeed depo betiğini ve LSWS arşivini LiteSpeed'den HTTPS ile indirir; ilan edilen sürüm ve build yalnız düz sayı olarak kabul edilir. OpenLiteSpeed kurulduğu yoldan güncellenir: güncelleme (POST /api/v1/plugins/openlitespeed/update; OpenLiteSpeed kartında güncelleme düğmesi yoktur) openlitespeed paketini LiteSpeed deposundan sunucunun paket yöneticisiyle yükseltir (Debian / Ubuntu'da apt, RHEL ailesinde dnf; sizin değiştirdiğiniz yapılandırma dosyası sizin sürümünüzde kalır) ve paket sürümü değiştiyse OpenLiteSpeed'i hizmeti üzerinden yeniden başlatır; paket zaten en yeni sürümse yanıt Plugin is already the newest version der ve hiçbir şey yeniden başlatılmaz. Yanıttaki update_result paketin önceki ve sonraki sürümünü verir.

Bir web sunucusu eklentisinin etkinleştirilmesi, devre dışı bırakılması ve güncellenmesi web sunucusunun paketlerini, dosyalarını ve birimlerini değiştirir; bu yüzden panelden başlatılan paket işi olarak, aynı anda yalnız biri çalışır: denetimli OS güncelleme koşusu ya da bir işletim sistemi paket güncellemesi (409 OS_UPGRADE_IN_PROGRESS), bir PHP sürümü kurma ya da kaldırma (409 PHP_PACKAGE_JOB_IN_PROGRESS) veya başka bir web sunucusu eklentisinin işi (409 PLUGIN_TASK_IN_PROGRESS) sürerken reddedilir ve "Etkinleştirme başarısız" (ya da "Devre dışı bırakma başarısız", "Güncelleme başarısız") bildirimi süren işi adlandırır. Reddedilen etkinleştirme görev oluşturmaz ve ilerleme penceresi kapanır; panel engelleyen uca yalnız arka plan ucu yoksa (eski bir ajan) geçer. İş sürerken başlayan denetimli koşu onu bekler (en çok bir saat); arka plan etkinleştirmesinden bir an önce başlamış koşu onun görevini hiçbir şey değiştirmeden başarısız bitirir. Etkin olmayan bir eklentinin güncellemesi önce bu nedenle reddedilir (400 PLUGIN_VALIDATION_ERROR). Çalışma zamanı eklentileri yalnız ayar değiştirir, bekletilmez.

Etkin bir web sunucusu eklentisinin kartı kurulu sunucu sürümünü gösterir (kapalı kart eklentinin kendi sürümünü); Eklenti Yönetimi penceresinde LiteSpeed Yeniden Başlat — sunucunun servisi üzerinden tam yeniden başlatma — ve PHP Süreçlerini Yeniden Başlat vardır: PHP ayrı bir servis olarak değil LiteSpeed sunucusunun altında (LSAPI) çalışır; bu düğme LiteSpeed'i zarifçe yeniden başlatır ve siteler sunulmaya devam ederken her hesabın PHP süreçleri yeniden başlar (panelin bir PHP ayarı değişince kullandığı yeniden başlatmanın aynısı); bir ret, nedeniyle birlikte Yeniden başlatma başarısız olarak görünür. LiteSpeed Enterprise etkinken OpenLiteSpeed'i etkinleştirmek önce LiteSpeed Enterprise'ı, onu kapatıp OpenLiteSpeed'e dönmenin yaptığı gibi kaldırır: LiteSpeed Enterprise tamamen durdurulur — bu sırada siteleri başka bir web sunucusu sunmadığından bir isteği bitirmekte olan süreç durdurmadan beş saniye sonra sonlandırılır ve o istek kesilir —, ardından openlitespeed paketi ve ModSecurity modülü paketi (ols-modsecurity) LiteSpeed Enterprise kurucusunun değiştirdiği dosyaların üzerine yeniden kurulur ve OpenLiteSpeed'in servis birimi geri yüklenir; siteler OpenLiteSpeed'e bundan sonra taşınır. Paketlerin yeniden kurulumu bu geçişi yarım dakika kadar uzatır, siteler bu sırada yanıt vermez.

Adları yalnız IPv6 üzerinden çözen sunucuda LiteSpeed Enterprise. LiteSpeed Enterprise deneme sürümünü ya da lisansını LiteSpeed'in lisans sunucusuyla, sunucunun ad çözücüsü üzerinden denetler; /etc/resolv.conf yalnız IPv6 ad sunucusu listeliyorsa (bazı sağlayıcıların AlmaLinux, Rocky Linux ve CentOS Stream imajlarında böyledir) bu denetim lisans sunucusuna ulaşamaz. Bu yüzden etkinleştirme hiçbir şey indirmeden durur ve nedenini söyler: LiteSpeed Enterprise was not installed: /etc/resolv.conf lists only IPv6 nameservers (…) — hiçbir şey değişmez. Çözücüye bir IPv4 ad sunucusu ekleyin (örneğin sağlayıcının IPv4 çözücüsü) ve yeniden etkinleştirin. LiteSpeed Enterprise başka bir nedenle başlamazsa (örneğin denetimin reddettiği bir lisans) etkinleştirme geri alınır ve hatası sunucunun birim günlüğündeki kendi satırlarını taşır, örneğin lshttpd did not start from its unit. LiteSpeed reported: [LICENSE] Failed to contact license server. [FATAL] license problem, try switching back to Apache!

LiteSpeed Enterprise kurucusu LiteSpeed'in sunucularına ulaşamazsa. Satıcının kurucusu etkinleştirme sırasında LiteSpeed'in sunucularından indirme yapar (örneğin www.quic.cloud'dan QUIC.cloud adres listesi). Bunlardan biri yanıt vermezse kurucu bekler; WHost 5 dakika sonra kurucuyu başlattığı bütün indirmelerle birlikte durdurur, hiçbir şey geçirilmez ve etkinleştirmenin hatası kurucunun hâlâ çalıştırdığı komutu ve son çıktı satırını söyler (örneğin … it was still running: wget … https://www.quic.cloud/ips?ln). Sunucunun o adrese HTTPS ile ulaştığını denetleyin (curl -sI https://www.quic.cloud/ips?ln) ve yeniden etkinleştirin. Böyle bir denemeden sonra OpenLiteSpeed'i açmak önce OpenLiteSpeed'in paketini, WAF modülünü ve servis birimini kurucunun bıraktığı dosyaların üzerine geri koyar.

Kullanılan endpoint'ler: GET /plugins, POST /plugins/{id}/activate/async, GET /plugins/tasks/{id}/events (SSE), POST /plugins/{id}/deactivate, POST /plugins/{id}/reset-state, POST /plugins/{id}/update, POST /system/service/lsws?action=restart|reload (Yönetim penceresinin iki yeniden başlatma düğmesi).

Hâlâ Yardıma mı İhtiyacınız Var?

Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.