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
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
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
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:
- Écrire dans le journal d'accès du serveur
- Créer un journal d'accès pour cet hôte virtuel
- 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
"%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
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
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
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
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
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
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
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.