LiteSpeed Web Server logo Manuel utilisateur LiteSpeed Web Server

Hôte virtuel - Général

Table des matières

Paramètres principaux

Journal de l'hôte virtuel

Journal d'accès

Fichiers index

Pages d'erreur personnalisées

Gestionnaire de scripts

.htaccess

Paramètres d'expiration

Configuration de style Apache

Proxy WebSocket

Racine des documents

Description

Indique la racine des documents de cet hôte virtuel. $VH_ROOT/html est recommandé. Dans les contextes, ce répertoire est référencé comme $DOC_ROOT.

Syntaxe

Un chemin pouvant être absolu, relatif à $SERVER_ROOT ou relatif à $VH_ROOT.

E-mail de l'administrateur

Description

Indique les adresses e-mail des administrateurs de cet hôte virtuel.

Syntaxe

Liste d'adresses e-mail séparées par des virgules

Méthodes de compression

Description

Spécifie les méthodes de compression activées pour cet hôte virtuel. Si ce réglage n'est pas défini, les méthodes de compression au niveau serveur sont utilisées.

Syntaxe

Sélectionner avec des cases à cocher

Voir aussi

Méthodes de compression, Priorité de compression

Priorité de compression

Description

Fournit un ordre préféré des méthodes de compression pour Zstandard, Brotli et GZIP pour cet hôte virtuel lorsque plusieurs méthodes activées peuvent être utilisées. Si ce réglage n'est pas défini, la priorité de compression au niveau serveur est utilisée. Ce réglage est une indication et ne force pas l'ordre final dans chaque réponse.

Syntaxe

Sélectionner dans la liste déroulante

Voir aussi

Priorité de compression

Activer la recherche de géolocalisation

Description

Enterprise Edition Only Indique s’il faut activer/desactiver la recherche IP Geolocation. Peut etre defini aux niveaux serveur, hote virtuel ou contexte. IP Geolocation est desactivee par defaut lorsque la valeur "Not Set" est utilisee.

Syntaxe

Sélectionner avec les boutons radio

Voir aussi

Utiliser l'IP client dans l'en-tête, Chemin du fichier de BD,

cgroups

Description

Fonction du noyau Linux qui limite, comptabilise et isole l’utilisation des ressources (CPU, mémoire, I/O disque, réseau, etc.) d’un ensemble de processus. Vous devez utiliser cgroups v2, ce qui est déterminé par l’existence du fichier /sys/fs/cgroup/cgroup.controllers.

Définir ceci sur Désactivé au niveau serveur désactivera ce réglage pour tout le serveur. Dans tous les autres cas, le réglage de niveau serveur peut être remplacé au niveau virtual host.

Valeurs par défaut:
Niveau serveur: Off
Niveau VH: Hériter du réglage de niveau serveur

Syntaxe

Sélectionner dans la liste déroulante

Utiliser le journal du serveur

Description

Spécifie si les messages de journal de cet hôte virtuel doivent être placés dans le fichier journal du serveur au lieu de créer son propre fichier journal.

Syntaxe

Sélectionner avec les boutons radio

Nom de fichier

Description

Spécifie le chemin du fichier journal.

Syntaxe

Nom de fichier pouvant être un chemin absolu ou un chemin relatif à $SERVER_ROOT, $VH_ROOT.

Conseils

Performance Placez le fichier journal sur un disque séparé.

Niveau de journalisation

Description

Spécifie le niveau de journalisation. Les niveaux disponibles (du plus élevé au plus bas) sont ERROR, WARNING, NOTICE, INFO et DEBUG. Seuls les messages dont le niveau est supérieur ou égal au paramètre actuel seront journalisés. Si vous voulez le définir sur DEBUG, vous devez également définir le niveau de journalisation du serveur sur DEBUG. Le niveau de débogage est contrôlé uniquement au niveau serveur par Niveau de débogage.

Syntaxe

Sélectionner dans la liste déroulante

Conseils

Performance Sauf si Niveau de débogage est défini sur un niveau autre que NONE, le niveau de journalisation DEBUG n'a pas d'impact sur les performances et est recommandé.

Voir aussi

Niveau de débogage

Taille de rotation (octets)

Description

Spécifie quand le fichier journal actuel doit être renouvelé. Lorsque la taille du fichier dépasse la limite de rotation, le fichier journal actif est renommé en log_name.mm_dd_yyyy(.sequence) dans le même répertoire et un nouveau fichier journal actif est créé. La taille réelle du fichier journal rotatif peut être légèrement supérieure à cette limite. Définissez sur 0 pour désactiver la rotation des journaux.

Syntaxe

Nombre entier

Conseils

Information Ajoutez "K", "M" ou "G" au nombre pour indiquer kilo-, méga- et giga-octets.

Jours de conservation

Description

Spécifie le nombre de jours pendant lesquels le fichier journal d'accès sera conservé sur le disque. Seuls les fichiers journaux rotatifs plus anciens que le nombre de jours spécifié seront supprimés. Le fichier journal actuel ne sera pas modifié, quel que soit le nombre de jours de données qu'il contient. Si vous ne voulez pas supprimer automatiquement les journaux obsolètes et très anciens, définissez cette valeur sur 0.

Syntaxe

Nombre entier

Compresser l'archive

Description

Spécifie s'il faut compresser les fichiers journaux rotatifs afin d'économiser de l'espace disque.

Syntaxe

Sélectionner avec les boutons radio

Conseils

Information Les fichiers journaux se compressent très bien; cette option est recommandée pour réduire l'utilisation du disque par les anciens journaux.

Contrôle du journal

Description

Emplacement où le journal d'accès doit être écrit. Trois options sont disponibles:

  1. Écrire dans le journal d'accès du serveur
  2. Créer un journal d'accès pour cet hôte virtuel
  3. Désactiver la journalisation d'accès

Syntaxe

Sélectionner dans la liste déroulante

Nom de fichier

Description

Nom du fichier journal d'accès.

Syntaxe

Nom de fichier pouvant être un chemin absolu ou un chemin relatif à $SERVER_ROOT, $VH_ROOT.

Conseils

Performance Placez le fichier journal d'accès sur un disque séparé.

Journaliseur par tube

Description

Spécifie l'application externe qui recevra les données du journal d'accès envoyées par LiteSpeed via un tube sur son flux STDIN (le descripteur de fichier est 0). Lorsque ce champ est spécifié, le journal d'accès est envoyé uniquement à l'application de journalisation et non au fichier journal d'accès spécifié dans l'entrée précédente.

L'application de journalisation doit d'abord être définie dans la section Applications externes. La journalisation d'accès au niveau serveur ne peut utiliser qu'une application de journalisation externe définie au niveau serveur. La journalisation d'accès au niveau hôte virtuel ne peut utiliser qu'une application de journalisation définie au niveau hôte virtuel.

Le processus de journalisation est lancé de la même manière que les autres processus externes (CGI/FastCGI/LSAPI). Cela signifie qu'il s'exécutera avec l'ID utilisateur spécifié dans les paramètres Mode Set UID de l'app externe de l'hôte virtuel et ne s'exécutera jamais au nom d'un utilisateur privilégié.

LiteSpeed web server effectue un équilibrage de charge simple entre plusieurs applications de journalisation si plusieurs instances sont configurées. Le serveur LiteSpeed essaie toujours de garder le nombre d'applications de journalisation aussi bas que possible. Ce n'est que lorsqu'une application de journalisation ne traite pas les entrées du journal d'accès à temps que le serveur essaie de lancer une autre instance.

Si un journaliseur plante, le serveur web démarre une autre instance, mais les données de journal dans le tampon de flux seront perdues. Des données de journal peuvent être perdues si les journaliseurs externes ne suivent pas la vitesse et le volume du flux de journal.

Syntaxe

Sélectionner dans la liste déroulante

Format du journal

Description

Spécifie le format du journal d'accès. Lorsque le format du journal est défini, il remplace le paramètre En-têtes de journal.

Syntaxe

Chaîne. La syntaxe du format de journal est compatible avec le format de journal personnalisé d'Apache 2.0.

Exemple

Common Log Format (CLF)
"%h %l %u %t \"%r\" %>s %b"

Common Log Format with Virtual Host
"%v %h %l %u %t \"%r\" %>s %b"

NCSA extended/combined log format
"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"

Log cookie value of Foobar
"%{Foobar}C"

Voir aussi

En-têtes de journal

En-têtes de journal

Description

Spécifie s'il faut journaliser les en-têtes de requête HTTP: Referer, UserAgent et Host.

Syntaxe

Sélectionner avec des cases à cocher

Conseils

Performance Désactivez cette option si vous n'avez pas besoin de ces en-têtes dans le journal d'accès.

Voir aussi

Format du journal

Journal des octets

Description

Spécifie le chemin du fichier journal des octets de bande passante. Lorsque ce champ est spécifié, un journal de bande passante compatible cPanel est créé. Il journalise le total des octets transférés pour une requête, y compris les corps de requête et de réponse.

Syntaxe

Nom de fichier pouvant être un chemin absolu ou un chemin relatif à $SERVER_ROOT.

Conseils

Performance Placez le fichier journal sur un disque séparé.

Utiliser les fichiers d'index du serveur

Description

Indique s’il faut utiliser les paramètres de fichiers d’index du serveur. Si la valeur est Oui, seuls les paramètres du serveur seront utilisés. Si la valeur est Non, les paramètres du serveur ne seront pas utilisés. Si la valeur est Addition, des fichiers d’index supplémentaires peuvent être ajoutés à la liste de fichiers d’index du serveur pour cet hôte virtuel. Si vous voulez désactiver les fichiers d’index pour cet hôte virtuel, vous pouvez définir la valeur sur Non et laisser le champ des fichiers d’index vide.

Syntaxe

Sélectionner dans la liste déroulante

Fichiers d'index

Description

Indique les noms des fichiers index qui seront recherches sequentiellement lorsqu’une URL est mappee vers un repertoire. Vous pouvez le personnaliser aux niveaux serveur, hote virtuel et contexte.

Syntaxe

Liste de noms de fichiers index separes par des virgules.

Conseils

Performance Ne definissez que les fichiers index dont vous avez besoin.

Index automatique

Description

Indique s’il faut générer à la volée un index de répertoire lorsque les fichiers d’index listés dans Fichiers d'index ne sont pas disponibles dans un répertoire. Cette option est personnalisable au niveau hôte virtuel et contexte, et elle est héritée le long de l’arborescence de répertoires jusqu’à être explicitement remplacée. Vous pouvez personnaliser la page d’index générée. Consultez les How-tos du wiki en ligne.

Syntaxe

Sélectionner avec les boutons radio

Conseils

Sécurité Il est recommandé de désactiver Index automatique partout où c’est possible afin d’éviter de révéler des données confidentielles.

Voir aussi

Fichiers d'index, URI d'index automatique

URI d'index automatique

Description

Indique l’URI qui sera utilisée pour générer la page d’index lorsque les fichiers d’index listés dans Fichiers d'index ne sont pas disponibles dans un répertoire. LiteSpeed web server utilise un script externe pour générer la page d’index, ce qui offre une flexibilité de personnalisation maximale. Le script par défaut produit une page d’index ayant la même apparence que celle d’Apache. Pour personnaliser la page d’index générée, consultez les How-tos du wiki en ligne. Le répertoire à indexer est transmis au script via une variable d’environnement "LS_AI_PATH".

Syntaxe

URI

Voir aussi

Fichiers d'index, Index automatique

Pages d'erreur personnalisées

Description

Chaque fois que le serveur rencontre un probleme lors du traitement d'une requete, il renvoie un code d'erreur et une page html comme message d'erreur au client web. Les codes d'erreur sont definis dans le protocole HTTP (voir RFC 2616). Le serveur web LiteSpeed dispose d'une page d'erreur par defaut integree pour chaque code d'erreur, mais une page personnalisee peut aussi etre configuree pour chaque code d'erreur. Ces pages d'erreur peuvent etre personnalisees davantage pour etre uniques a chaque virtual host.

Code d'erreur

Description

Indique le code d’état HTTP de la page d’erreur. Seul le code d’état HTTP sélectionné aura cette page d’erreur personnalisée.

Syntaxe

Sélectionner dans la liste déroulante

URL

Description

Indique l’URL de la page d’erreur personnalisée. Le serveur transférera la requête vers cette URL lorsque le code d’état HTTP correspondant sera retourné. Si cette URL fait référence à une ressource inexistante, la page d’erreur intégrée sera utilisée. L’URL peut être un fichier statique, une page générée dynamiquement ou une page sur un autre site web (une URL commençant par "http(s)://"). Lorsqu’elle fait référence à une page sur un autre site web, le client reçoit un code d’état de redirection au lieu du code d’état d’origine.

Syntaxe

URL

Suffixes

Description

Spécifie les suffixes des fichiers de script qui seront gérés par ce gestionnaire de scripts. Les suffixes doivent être uniques.

Syntaxe

Liste séparée par des virgules; le caractère point "." est interdit.

Conseils

Information Le serveur ajoute automatiquement un type MIME spécial ("application/x-httpd-[suffix]") pour le premier suffixe de la liste. Par exemple, le type MIME "application/x-httpd-php53" sera ajouté pour le suffixe "php53". Les suffixes suivants doivent être configurés dans les paramètres Paramètres MIME.
Même si ce champ liste des suffixes, les gestionnaires de scripts utilisent les types MIME, et non les suffixes, pour décider quels scripts gérer.
PerformanceSécurité Spécifiez uniquement les suffixes dont vous avez réellement besoin.

Type de gestionnaire

Description

Spécifie le type d'application externe qui traite ces fichiers de script. Les types disponibles sont: LSAPI app, Serveur Web (Proxy), Fast CGI, SCGI, CGI, Load balancer, Moteur de servlet, uWSGI ou Gestionnaire de module. Sauf pour les types de gestionnaire CGI et Gestionnaire de module, Nom du gestionnaire doit également être défini sur une application externe précédemment définie dans la section Applications externes.

Syntaxe

Sélectionner dans la liste déroulante

Nom du gestionnaire

Description

Spécifie le nom de l'application externe qui traite les fichiers de script lorsque le type de gestionnaire est LSAPI app, Web Server (Proxy), Fast CGI, SCGI, Load balancer, Servlet Engine ou uWSGI.

Syntaxe

Sélectionner dans la liste déroulante

.htaccess

Description

Les directives suivantes sont prises en charge dans un fichier de controle d'acces au niveau repertoire (fichier .htaccess).

  • Authentification
    • AuthGroupFile
    • AuthName
    • AuthType
    • AuthUserFile
    • Require
    • Satisfy
    • <Limit> (GET, HEAD, POST uniquement)
    • <LimitExcept> (GET, HEAD, POST uniquement)
  • Controle d'acces
    • Allow
    • Deny
    • Order
    • <Limit> (GET, HEAD, POST uniquement)
    • <LimitExcept> (GET, HEAD, POST uniquement)
  • File Info
    • AddDefaultCharset
    • AddType
    • DefaultType
    • ForceType
    • Redirect
    • RedirectPermanent
    • RedirectTemp
    • RewriteBase
    • RewriteCond
    • RewriteEngine
    • RewriteOptions
    • RewriteRule
  • Autre
    • DirectoryIndex
    • ExpiresActive
    • ExpiresByType
    • ExpiresDefault
    • Options

Autoriser Override

Description

Indique quelles directives sont autorisees dans un fichier de controle d'acces. Un fichier de controle d'acces peut etre place dans un repertoire pour controler l'accessibilite des fichiers sous ce repertoire.

  • Si rien n'est coche, les reglages par defaut herites seront utilises.
  • Si Aucun est coche, les fichiers de controle d'acces seront ignores.
  • Si Limite est coche, les directives "Allow", "Deny" et "Order" sont autorisees. Les directives <Limit> et <LimitExcept> sont aussi autorisees avec une prise en charge limitee des requetes GET, HEAD et POST.
  • Si Auth est coche, les directives "AuthGroupFile", "AuthName", "AuthType", "AuthUserFile", "Require" et "Satisfy" sont autorisees.
  • Si FileInfo est coche, les directives "AddDefaultCharset", "AddType", "DefaultType", "ForceType", "Redirect", "RedirectPermanent", "RedirectTemp", "RewriteBase", "RewriteCond", "RewriteEngine", "RewriteOptions" et "RewriteRule" sont autorisees.
  • Si Index est coche, les directives "DirectoryIndex", "ExpiresActive", "ExpiresByType" et "ExpiresDefault" sont autorisees.
  • Si Options est coche, la directive "Options" est autorisee.

La configuration Allow Override est disponible aux niveaux serveur, virtual host et contexte. Si une option n'est pas cochee au niveau serveur, les directives concernees seront desactivees pour tout le serveur, quels que soient les reglages des niveaux inferieurs. Les niveaux inferieurs peuvent desactiver un reglage active a un niveau superieur, mais ne peuvent pas activer un reglage desactive a un niveau superieur.

Valeurs par defaut:
Niveau serveur: "None" (ignorer le fichier de controle d'acces)
Niveau VH: heriter du reglage du niveau serveur
Niveau contexte heriter du reglage du niveau VH

Syntaxe

Sélectionner avec des cases à cocher

Conseils

Performance S'il n'est pas necessaire de personnaliser la configuration au niveau repertoire, cochez Aucun.

Nom du fichier d'accès

Description

Indique le nom des fichiers de controle d'acces. Ces fichiers ne seront utilises que si Autoriser Override est active. Le nom par defaut est .htaccess. Vous pouvez configurer ce parametre au niveau serveur et au niveau virtual host. Le niveau serveur est le reglage par defaut, et vous pouvez le remplacer au niveau virtual host.

Syntaxe

Nom de fichier commencant par "."

Voir aussi

Autoriser Override

Activer les expirations

Description

Indique s’il faut generer un en-tete Expires pour les fichiers statiques. Si active, un en-tete Expires sera genere selon Expiration par défaut et Expiration par type.

Cela peut etre defini aux niveaux serveur, hote virtuel et contexte. Les parametres de niveau inferieur remplaceront ceux de niveau superieur, c’est-a-dire que les parametres de contexte remplaceront ceux de l’hote virtuel et les parametres de l’hote virtuel remplaceront ceux du serveur.

Syntaxe

Sélectionner avec les boutons radio

Expiration par défaut

Description

Indique les parametres par defaut pour la generation de l’en-tete Expires. Ce parametre prend effet lorsque Activer les expirations est defini sur "Yes". Il peut etre remplace par Expiration par type. Ne definissez pas ce defaut au niveau serveur ou hote virtuel sauf si necessaire, car il generera des en-tetes Expires pour toutes les pages. La plupart du temps, cela doit etre defini au niveau contexte pour certains repertoires qui ne changent pas souvent. S’il n’y a pas de parametre par defaut, aucun en-tete Expires ne sera genere pour les types non indiques dans Expiration par type.

Syntaxe

A|Mseconds
Le fichier expirera apres le temps de base (A|M) plus les secondes indiquees. Le temps de base "A" definit la valeur sur le temps d’acces du client et "M" sur le temps de derniere modification du fichier.

Expiration par type

Description

Indique les parametres d’en-tete Expires pour des types MIME individuels.

Syntaxe

Liste separee par des virgules de "MIME-type=A|Mseconds". Le fichier expirera apres le temps de base (A|M) plus les secondes indiquees.

Le temps de base "A" definit la valeur sur le temps d’acces du client et "M" sur le temps de derniere modification du fichier. MIME-type accepte le caractere generique "*", comme image/*.

Configurations de style Apache

Description

Indique les directives de configuration Apache (prises en charge par LiteSpeed) que vous souhaitez utiliser dans le fichier de configuration natif LiteSpeed. Par exemple, pour remplacer les configurations PHP par defaut (entrees php.ini), le serveur aura besoin de quatre directives: "php_value", "php_flag", "php_admin_value" et "php_admin_flag".

Syntaxe

Identique au fichier de configuration Apache.

URI

Description

Indique les URI qui utiliseront ce backend WebSocket. Le trafic vers cette URI ne sera transféré au backend WebSocket que s'il contient une demande d'upgrade WebSocket.

Le trafic sans cette demande d'upgrade sera automatiquement transféré au contexte auquel appartient cette URI. Si aucun contexte n'existe pour cette URI, LSWS traitera ce trafic comme s'il accédait à un contexte statique avec l'emplacement $DOC_ROOT/URI.

Syntaxe

Une URI simple (commençant par "/"). Si l’URI se termine par "/", ce backend WebSocket inclura toutes les sous-URI sous cette URI.

Exemple

Utiliser le proxy WebSocket avec un contexte permet de servir différents types de trafic de différentes façons sur la même page, ce qui optimise les performances. Vous pouvez envoyer le trafic WebSocket au backend WebSocket tout en configurant un contexte statique afin que LSWS serve le contenu statique de la page, ou un contexte LSAPI afin que LSWS serve le contenu PHP (dans les deux cas, LSWS le fait plus efficacement que le backend WebSocket).

Adresse

Description

Adresse de socket unique utilisée par le backend WebSocket. Les sockets IPv4, les sockets IPv6 et les Unix Domain Sockets (UDS) sont pris en charge. Les sockets IPv4 et IPv6 peuvent être utilisés pour la communication sur le réseau. UDS ne peut être utilisé que lorsque le backend WebSocket réside sur la même machine que le serveur.

Syntaxe

adresse IPv4/IPv6:port, UDS://chemin, ou unix:chemin

Exemple

127.0.0.1:5434
UDS://tmp/lshttpd/php.sock
unix:/tmp/lshttpd/php.sock

Conseils

Sécurité Si le backend WebSocket fonctionne sur la même machine, UDS est préférable. Si vous devez utiliser un socket IPv4 ou IPv6, définissez l’adresse IP sur localhost ou 127.0.0.1 afin que le backend WebSocket soit inaccessible depuis d’autres machines.
Performance Les Unix Domain Sockets offrent généralement de meilleures performances que les sockets IPv4 ou IPv6.