dexblog.ro
Acces rapid: Învață AI Învață Programare Specificații Dispozitive Comparații
OLS

Învață OpenLiteSpeed: comenzi explicate cu exemple

50 de comenzi 6 categorii

OpenLiteSpeed este ediția open-source a serverului web de înaltă performanță dezvoltat de LiteSpeed Technologies. Construit pe o arhitectură asincronă ghidată de evenimente (event-driven), similară cu Nginx, OpenLiteSpeed oferă în plus compatibilitate nativă cu regulile de rescriere Apache mod_rewrite (.htaccess) și un motor integrat de caching accelerat (LSCache).

Spre deosebire de serverele tradiționale, OpenLiteSpeed comunică cu PHP prin protocolul dedicat LSAPI (LiteSpeed SAPI), substanțial mai rapid decât FastCGI clasic, și include suport complet din fabrică pentru protocolul de generație următoare HTTP/3 (QUIC) pe UDP 443.

Mai jos găsești cele 50 de comenzi, directive și instrumente esențiale grupate pe categorii: control și administrare din consolă (lswsctrl), configurarea gazdelor virtuale și a listenerelor, mecanismul avansat de stocare în cache (LSCache), compatibilitatea cu regulile de rescriere URL, securitate SSL/TLS și protecție DDoS, precum și optimizarea procesoarelor externe LSPHP.

macOS • Windows • Linux

Ghid de instalare OpenLiteSpeed (OLS) pe fiecare sistem de operare

Instalează serverul web de înaltă performanță OpenLiteSpeed pe Linux (nativ / script oficial), Docker sau WSL2.

Cerințe de sistem: Server Linux 64-bit (Ubuntu 22.04/24.04, Debian 11/12, CentOS/AlmaLinux) sau mediu Docker Desktop; porturile 80, 443, 8088 și 7080 libere.

Terminal macOS (Homebrew / zsh) 
# Pe macOS, rularea recomandată este prin containerul oficial Docker:
docker run -d --name openlitespeed -p 8088:8088 -p 7080:7080 \
  -v ~/lsws/html:/var/www/vhosts/localhost/html \
  litespeedtech/openlitespeed:latest

# Acces în browser:
# Pagina web test: http://localhost:8088
# Consola WebAdmin: https://localhost:7080

Control și CLI server 10 comenzi

Virtual Hosts și Listeners 8 comenzi

LSCache și Optimizare Cache 8 comenzi

Rescrieri URL și Compatibilitate .htaccess 8 comenzi

Securitate, SSL/TLS și Protecție DDoS 8 comenzi

PHP Extern (LSPHP) și Diagnosticare 8 comenzi

Toate comenzile și directivele OpenLiteSpeed

Lista completă a celor 50 de comenzi, directive și instrumente OpenLiteSpeed explicate în această secțiune. Fiecare are propria pagină dedicată, cu explicații în limba română, sintaxă și exemple practice gata de utilizat.

Control și CLI server (10)

Funcție Ce face
lswsctrl start Pornește serverul web OpenLiteSpeed și procesele asociate LSPHP.
/usr/local/lsws/bin/lswsctrl start
lswsctrl stop Oprește serverul OpenLiteSpeed și eliberează porturile de rețea ascultate.
/usr/local/lsws/bin/lswsctrl stop
lswsctrl restart Repornește elegant (graceful) serverul OpenLiteSpeed fără a întrerupe conexiunile active.
/usr/local/lsws/bin/lswsctrl restart
lswsctrl reload Reîncarcă configurația OpenLiteSpeed în memorie fără a reseta procesul binar principal.
/usr/local/lsws/bin/lswsctrl reload
lswsctrl status Verifică dacă demonul OpenLiteSpeed rulează și afișează PID-ul procesului principal.
/usr/local/lsws/bin/lswsctrl status
openlitespeed (binar CLI) Afișează versiunea exactă a binarului OpenLiteSpeed și testează sintaxa fișierelor de configurare.
/usr/local/lsws/bin/openlitespeed -v
admpass.sh Resetează sau configurează numele de utilizator și parola pentru consola web de administrare WebAdmin.
/usr/local/lsws/admin/misc/admpass.sh
Tuning parametri kernel & ulimit Configurează limitele de fișiere deschise (file descriptors) și stiva TCP pentru trafic intens.
ulimit -n 65535
openlitespeed.sh (Instalare automată) Descarcă și rulează scriptul oficial de configurare a depozitului OLS și instalare automată.
bash <( curl -k https://openlitespeed.org/packages/openlitespeed.sh )
Schimbare versiune LSPHP Comută versiunea globală de PHP folosită de server sau instalează o versiune nouă de LSPHP.
sudo ln -sf /usr/local/lsws/lsphp83/bin/lsphp /usr/local/lsws/fcgi-bin/lsphp5

Virtual Hosts și Listeners (8)

Funcție Ce face
Directiva virtualhost Definește o gazdă virtuală (vHost) independentă în fișierul principal de configurare httpd_config.conf.
virtualhost ExempluSite {
Directiva docRoot Stabilește directorul public rădăcină de unde sunt servite fișierele HTML, PHP și statice.
docRoot $VH_ROOT/html/
vhDomain și vhAliases Specifică domeniul principal și aliasurile recunoscute de gazda virtuală pentru mapare.
vhDomain exemplu.ro
Directiva listener Configurează socket-urile de rețea (adrese IP și porturi) pe care serverul ascultă cereri.
listener HTTP {
Mapare Virtual Host (map) Leagă o gazdă virtuală de un Listener prin specificarea numelor de domeniu deservite.
map <Nume_vHost> <Domenii>
Directiva context Definește reguli speciale de procesare pentru anumite prefixe de URL (Static, Proxy, CGI, Redirect).
context /static/ {
Directiva indexFiles Specifică lista fișierelor căutate automat atunci când un client accesează un director.
indexFiles index.php, index.html, index.htm
Directiva errorPage Configurează pagini HTML personalizate pentru codurile de eroare HTTP (404, 403, 500, 503).
errorPage 404 /eroare-404.html

LSCache și Optimizare Cache (8)

Funcție Ce face
Modulul cache (module cache) Activează și configurează modulul intern de caching de mare viteză la nivel de server.
module cache {
Directiva enableCache Comută starea de funcționare a cache-ului la nivel de server, virtual host sau context.
enableCache 1
Directiva storagePath Stabilește calea directorului de pe disc unde sunt salvate paginile comprimate din cache.
storagePath /tmp/lscache
Structura cacheKeyObject Mecanismul intern prin care OpenLiteSpeed calculează amprenta unică a fiecărei pagini stocate în cache.
cacheKeyObject [vHost]_[URI]_[QueryString]_[Cookie]
Purjare LSCache (Purge) Invalidează și șterge obiectele din cache prin antet HTTP, taguri sau direct de pe disc.
curl -X PURGE https://exemplu.ro/articol-actualizat/
Directiva staleCache Servește vizitatorilor conținutul expirat din cache în timp ce pagina este regenerată în fundal.
staleCache 1
Crawler LSCache (Pre-încălzire) Activează robotul intern de parcurgere pentru pre-încălzirea automată a cache-ului.
enableCrawler 1
Directiva qsCache Controlează dacă cererile care conțin parametri Query String (?parametru=valoare) sunt stocate în cache.
qsCache 1

Rescrieri URL și Compatibilitate .htaccess (8)

Funcție Ce face
Directiva rewrite enable Activează motorul intern de rescriere URL și citirea automată a fișierelor .htaccess.
rewrite {
Directiva rules (.htaccess) Permite scrierea directă a regulilor de rescriere în fișierul de configurare vhost.conf.
rewrite {
Directiva rewriteInherit Stabilește dacă un context sau subdirector moștenește regulile de rescriere ale părintelui.
rewriteInherit 1
Directiva RewriteBase Setează prefixul URL implicit folosit pentru substituțiile relative de căi.
RewriteBase /
Directiva RewriteCond Definește condiții bazate pe variabile de server care trebuie îndeplinite pentru executarea unei reguli.
RewriteCond %{HTTPS} !=on
Indicatori RewriteRule ([L], [R], [QSA]) Modifică comportamentul regulilor de rescriere (redirecționare 301, oprire execuție L, păstrare query string QSA).
RewriteRule tipar substitutie [indicatori]
Forțare HTTPS prin rescriere Regula optimizată pentru redirecționarea automată și permanentă a întregului trafic HTTP către HTTPS.
RewriteEngine On
Protecție Hotlinking imagini Împiedică alte site-uri web să includă direct imaginile tale și să consume lățimea de bandă.
RewriteEngine On

Securitate, SSL/TLS și Protecție DDoS (8)

Funcție Ce face
Directivele certFile și keyFile Configurează certificatul SSL/TLS, cheia privată și lanțul de autorități intermediare.
keyFile /etc/letsencrypt/live/exemplu.ro/privkey.pem
Directiva sslProtocol Selectează versiunile de protocoale criptografice TLS permise pentru negociere.
sslProtocol 30
Directiva ciphers Stabilește lista algoritmilor de criptare simetrică și asimetrică acceptați de server.
ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384
QUIC și HTTP/3 Activează protocolul de generație următoare HTTP/3 bazat pe UDP pentru viteză extremă pe mobil.
enableQuic 1
Directiva perClientConnLimit Limitează numărul maxim de conexiuni TCP simultane acceptate de la o singură adresă IP.
perClientConnLimit 100
Mecanismul Request Throttle Limitează frecvența cererilor HTTP per secundă pentru a preveni atacurile brute-force și abuzurile de API.
reqThrottle 1
Blocare acces directoare sensibile Interzice accesul public la fișiere și directoare critice (.git, .env, wp-config.php).
context /\.git/ {
Automatizare SSL cu acme.sh Utilitarul recomandat oficial de LiteSpeed pentru emiterea și reînnoirea automată a certificatelor Let’s Encrypt.
/root/.acme.sh/acme.sh --issue -d exemplu.ro -d www.exemplu.ro -w /var/www/vhosts/exemplu.ro/html

PHP Extern (LSPHP) și Diagnosticare (8)

Funcție Ce face
Directiva extProcessor Configurează procesorul extern FastCGI / LiteSpeed SAPI (LSAPI) pentru execuția scripturilor PHP.
extprocessor lsphp83 {
Directiva maxConns (LSPHP) Setează numărul maxim de procese copil PHP concurente alocate pentru procesarea cererilor.
maxConns 35
Directiva env (PHP_LSAPI_CHILDREN) Transmite variabile de mediu către procesul master LSPHP pentru controlul ciclului de viață.
env PHP_LSAPI_CHILDREN=35
Directiva errorlog (Jurnal de erori) Configurează calea, nivelul de detaliu și politica de rotație pentru jurnalul de erori.
errorlog /usr/local/lsws/logs/error.log {
Directiva accesslog (Jurnal de acces) Înregistrează fiecare cerere HTTP procesată de server în format standard Apache Combined.
accesslog /usr/local/lsws/logs/access.log {
Statistici în timp real (.rtreport) Afișează metricele de performanță în timp real ale nucleului OLS (conexiuni, cereri/secundă, lscache).
cat /tmp/lshttpd/.rtreport
Directiva logLevel Stabilește pragul de filtrare a gravității mesajelor înscrise în jurnalele de erori.
logLevel ERROR
Repornire procese PHP (killall lsphp) Forțează reciclarea imediată a tuturor proceselor externe PHP fără a opri serverul web.
killall -9 lsphp