OpenLiteSpeed logo OpenLiteSpeed-Benutzerhandbuch

Virtueller Host - Allgemein

Inhaltsverzeichnis

Kerneinstellungen

Protokoll des virtuellen Hosts

Zugriffsprotokoll

Indexdateien

Angepasste Fehlerseiten

Ablaufeinstellungen

Datei-Upload

Skript-Handler

Ablaufeinstellungen

PHP-INI-Überschreibung

Dokumentstamm

Beschreibung

Gibt den Dokumentstamm für diesen virtuellen Host an. $VH_ROOT/html wird empfohlen. In Kontexten wird dieses Verzeichnis als $DOC_ROOT referenziert.

Syntax

Ein Pfad, der absolut, relativ zu $SERVER_ROOT oder relativ zu $VH_ROOT sein kann.

Administrator-E-Mail

Beschreibung

Gibt die E-Mail-Adresse(n) der Administratoren dieses virtuellen Hosts an.

Syntax

Durch Kommas getrennte Liste von E-Mail-Adressen

Komprimierung aktivieren

Beschreibung

Gibt an, ob die GZIP-Komprimierung für diesen virtuellen Host aktiviert wird. Diese Einstellung ist nur wirksam, wenn Komprimierung aktivieren auf Serverebene auf Yes gesetzt ist.

Syntax

Aus Optionsfeldern auswählen

Siehe auch

Komprimierung aktivieren

GeoLocation-Suche aktivieren

Beschreibung

Gibt an, ob die IP-Geolocation-Suche aktiviert/deaktiviert werden soll. Kann auf Server-, Virtual-Host- oder Kontextebene gesetzt werden. IP Geolocation ist standardmaessig deaktiviert, wenn der Wert "Not Set" verwendet wird.

Syntax

Aus Optionsfeldern auswählen

Siehe auch

Client-IP im Header verwenden, DB-Dateipfad,

cgroups

Beschreibung

Eine Linux-Kernel-Funktion, die die Ressourcennutzung (CPU, Speicher, Festplatten-I/O, Netzwerk usw.) einer Sammlung von Prozessen begrenzt, abrechnet und isoliert. Sie müssen cgroups v2 verwenden, was durch das Vorhandensein der Datei /sys/fs/cgroup/cgroup.controllers bestimmt wird.

Wenn dies auf Serverebene auf Disabled gesetzt wird, wird diese Einstellung serverweit deaktiviert. In allen anderen Fällen kann die Einstellung auf Serverebene auf Virtual-Host-Ebene überschrieben werden.

Standardwerte:
Serverebene: Off
VH-Ebene: Einstellung der Serverebene übernehmen

Syntax

Aus Dropdown-Liste auswählen

Serverprotokoll verwenden

Beschreibung

Gibt an, ob Protokollmeldungen dieses virtuellen Hosts in die Serverprotokolldatei geschrieben werden, anstatt eine eigene Protokolldatei zu erstellen.

Syntax

Aus Optionsfeldern auswählen

Dateiname

Beschreibung

Gibt den Pfad für die Protokolldatei an.

Syntax

Dateiname, der ein absoluter Pfad oder ein Pfad relativ zu $SERVER_ROOT, $VH_ROOT sein kann.

Tipps

Performance Legen Sie die Protokolldatei auf einem separaten Datenträger ab.

Protokollstufe

Beschreibung

Gibt die Protokollstufe an. Verfügbare Stufen (von hoch bis niedrig) sind ERROR, WARNING, NOTICE, INFO und DEBUG. Nur Meldungen mit einer Stufe, die höher oder gleich der aktuellen Einstellung ist, werden protokolliert. Wenn Sie dies auf DEBUG setzen möchten, müssen Sie auch die Serverprotokollstufe auf DEBUG setzen. Die Debug-Stufe wird ausschließlich auf Serverebene durch Debug-Stufe gesteuert.

Syntax

Aus Dropdown-Liste auswählen

Tipps

Performance Sofern Debug-Stufe nicht auf eine andere Stufe als NONE gesetzt ist, hat die Protokollstufe DEBUG keine Leistungsauswirkung und wird empfohlen.

Siehe auch

Debug-Stufe

Rotationsgröße (Byte)

Beschreibung

Gibt an, wann die aktuelle Protokolldatei rotiert werden muss. Wenn die Dateigröße das Rotationslimit überschreitet, wird die aktive Protokolldatei im selben Verzeichnis in log_name.mm_dd_yyyy(.sequence) umbenannt und eine neue aktive Protokolldatei erstellt. Die tatsächliche Größe der rotierten Datei kann etwas größer als dieses Limit sein. Setzen Sie den Wert auf 0, um die Protokollrotation zu deaktivieren.

Syntax

Ganzzahl

Tipps

Information Hängen Sie "K", "M" oder "G" an die Zahl an, um Kilo-, Mega- und Gigabyte anzugeben.

Aufbewahrungstage

Beschreibung

Gibt an, wie viele Tage die Zugriffsprotokolldatei auf der Festplatte aufbewahrt wird. Nur rotierte Protokolldateien, die älter als die angegebene Anzahl von Tagen sind, werden gelöscht. Die aktuelle Protokolldatei wird nicht verändert, unabhängig davon, wie viele Tage Daten sie enthält. Wenn veraltete und sehr alte Protokolldateien nicht automatisch gelöscht werden sollen, setzen Sie dies auf 0.

Syntax

Ganzzahl

Archiv komprimieren

Beschreibung

Gibt an, ob rotierte Protokolldateien komprimiert werden sollen, um Speicherplatz zu sparen.

Syntax

Aus Optionsfeldern auswählen

Tipps

Information Protokolldateien lassen sich stark komprimieren; diese Option wird empfohlen, um den Speicherbedarf alter Protokolle zu reduzieren.

Protokollsteuerung

Beschreibung

Wo das Zugriffsprotokoll geschrieben werden soll. Es gibt drei Optionen:

  1. In das Zugriffsprotokoll des Servers schreiben
  2. Ein Zugriffsprotokoll für diesen virtuellen Host erstellen
  3. Zugriffsprotokollierung deaktivieren

Syntax

Aus Dropdown-Liste auswählen

Dateiname

Beschreibung

Der Dateiname des Zugriffsprotokolls.

Syntax

Dateiname, der ein absoluter Pfad oder ein Pfad relativ zu $SERVER_ROOT, $VH_ROOT sein kann.

Tipps

Performance Legen Sie die Zugriffsprotokolldatei auf einem separaten Datenträger ab.

Piped Logger

Beschreibung

Gibt die externe Anwendung an, die die von LiteSpeed über eine Pipe an ihren STDIN-Stream gesendeten Zugriffsprotokolldaten empfängt (Dateihandle ist 0). Wenn dieses Feld angegeben ist, wird das Zugriffsprotokoll nur an die Logger-Anwendung gesendet und nicht an die in der vorherigen Eingabe angegebene Zugriffsprotokolldatei.

Die Logger-Anwendung muss zuerst im Abschnitt Externe Anwendungen definiert werden. Zugriffsprotokollierung auf Serverebene kann nur eine externe Logger-Anwendung verwenden, die auf Serverebene definiert ist. Zugriffsprotokollierung auf Ebene des virtuellen Hosts kann nur eine Logger-Anwendung verwenden, die auf Ebene des virtuellen Hosts definiert ist.

Der Logger-Prozess wird genauso gestartet wie andere externe Prozesse (CGI/FastCGI/LSAPI). Das bedeutet, dass er mit der Benutzer-ID ausgeführt wird, die in den Set-UID-Modus externer Apps-Einstellungen des virtuellen Hosts angegeben ist, und niemals im Namen eines privilegierten Benutzers ausgeführt wird.

LiteSpeed web server führt eine einfache Lastverteilung zwischen mehreren Logger-Anwendungen durch, wenn mehr als eine Instanz konfiguriert ist. Der LiteSpeed-Server versucht stets, die Anzahl der Logger-Anwendungen so niedrig wie möglich zu halten. Nur wenn eine Logger-Anwendung Zugriffsprotokolleinträge nicht rechtzeitig verarbeitet, versucht der Server, eine weitere Instanz zu starten.

Wenn ein Logger abstürzt, startet der Webserver eine weitere Instanz, aber die Protokolldaten im Stream-Puffer gehen verloren. Protokolldaten können verloren gehen, wenn externe Logger mit Geschwindigkeit und Umfang des Protokollstroms nicht Schritt halten können.

Syntax

Aus Dropdown-Liste auswählen

Protokollformat

Beschreibung

Gibt das Format für das Zugriffsprotokoll an. Wenn das Protokollformat gesetzt ist, überschreibt es die Einstellung Protokoll-Header.

Syntax

Zeichenfolge. Die Syntax des Protokollformats ist mit dem benutzerdefinierten Protokollformat von Apache 2.0 kompatibel.

Beispiel

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"

Siehe auch

Protokoll-Header

Protokoll-Header

Beschreibung

Gibt an, ob HTTP-Anfrageheader protokolliert werden sollen: Referer, UserAgent und Host.

Syntax

Per Kontrollkästchen auswählen

Tipps

Performance Deaktivieren Sie dies, wenn Sie diese Header im Zugriffsprotokoll nicht benötigen.

Siehe auch

Protokollformat

Byte-Protokoll

Beschreibung

Gibt den Pfad zur Bandbreiten-Byte-Protokolldatei an. Wenn angegeben, wird ein mit cPanel kompatibles Bandbreitenprotokoll erstellt. Es protokolliert die insgesamt für eine Anfrage übertragenen Bytes einschließlich Anfrage- und Antwortkörper.

Syntax

Dateiname, der ein absoluter Pfad oder ein Pfad relativ zu $SERVER_ROOT sein kann.

Tipps

Performance Legen Sie die Protokolldatei auf einem separaten Datenträger ab.

Indexdateien des Servers verwenden

Beschreibung

Gibt an, ob die Indexdateieinstellungen des Servers verwendet werden. Wenn auf Yes gesetzt, werden nur die Servereinstellungen verwendet. Wenn auf No gesetzt, werden die Servereinstellungen nicht verwendet. Wenn auf Addition gesetzt, können zusätzliche Indexdateien zur serverseitigen Indexdateiliste für diesen virtuellen Host hinzugefügt werden. Wenn Sie Indexdateien für diesen virtuellen Host deaktivieren möchten, können Sie den Wert auf No setzen und das Feld für Indexdateien leer lassen.

Syntax

Aus Dropdown-Liste auswählen

Indexdateien

Beschreibung

Gibt die Namen von Indexdateien an, die nacheinander gesucht werden, wenn eine URL einem Verzeichnis zugeordnet wird. Sie koennen dies auf Server-, Virtual-Host- und Kontextebene anpassen.

Syntax

Kommagetrennte Liste von Indexdateinamen.

Tipps

Performance Legen Sie nur die Indexdateien fest, die Sie benoetigen.

Automatischer Index

Beschreibung

Gibt an, ob ein Verzeichnisindex dynamisch erzeugt wird, wenn die in Indexdateien aufgeführten Indexdateien in einem Verzeichnis nicht verfügbar sind. Diese Option kann auf Virtual-Host- und Kontextebene angepasst werden und wird entlang des Verzeichnisbaums vererbt, bis sie ausdrücklich überschrieben wird. Sie können die erzeugte Indexseite anpassen. Lesen Sie dazu die Online-Wiki-How-tos.

Syntax

Aus Optionsfeldern auswählen

Tipps

Security Es wird empfohlen, den automatischen Index nach Möglichkeit zu deaktivieren, um die Offenlegung vertraulicher Daten zu verhindern.

Siehe auch

Indexdateien, URI für automatischen Index

URI für automatischen Index

Beschreibung

Gibt die URI an, die zum Erzeugen der Indexseite verwendet wird, wenn die in Indexdateien aufgeführten Indexdateien in einem Verzeichnis nicht verfügbar sind. LiteSpeed web server verwendet ein externes Skript zur Erzeugung der Indexseite und bietet dadurch maximale Anpassungsflexibilität. Das Standardskript erzeugt eine Indexseite mit demselben Aussehen wie bei Apache. Informationen zum Anpassen der erzeugten Indexseite finden Sie in den Online-Wiki-How-tos. Das zu indexierende Verzeichnis wird dem Skript über die Umgebungsvariable "LS_AI_PATH" übergeben.

Syntax

URI

Siehe auch

Indexdateien, Automatischer Index

Angepasste Fehlerseiten

Beschreibung

Immer wenn der Server ein Problem bei der Verarbeitung einer Anfrage hat, gibt der Server einen Fehlercode und eine html-Seite als Fehlermeldung an den Webclient zurueck. Fehlercodes sind im HTTP-Protokoll definiert (siehe RFC 2616). Der LiteSpeed-Webserver hat fuer jeden Fehlercode eine eingebaute Standard-Fehlerseite, aber fuer jeden Fehlercode kann auch eine angepasste Seite konfiguriert werden. Diese Fehlerseiten koennen weiter angepasst werden, sodass sie fuer jeden virtuellen Host eindeutig sind.

Fehlercode

Beschreibung

Gibt den HTTP-Statuscode für die Fehlerseite an. Nur der ausgewählte HTTP-Statuscode verwendet diese angepasste Fehlerseite.

Syntax

Aus Dropdown-Liste auswählen

URL

Beschreibung

Gibt die URL der angepassten Fehlerseite an. Der Server leitet die Anforderung an diese URL weiter, wenn der entsprechende HTTP-Statuscode zurückgegeben wurde. Wenn diese URL auf eine nicht vorhandene Ressource verweist, wird die integrierte Fehlerseite verwendet. Die URL kann eine statische Datei, eine dynamisch erzeugte Seite oder eine Seite auf einer anderen Website sein (eine URL, die mit "http(s)://" beginnt). Beim Verweis auf eine Seite auf einer anderen Website erhält der Client statt des ursprünglichen Statuscodes einen Weiterleitungsstatuscode.

Syntax

URL

Expires aktivieren

Beschreibung

Gibt an, ob fuer statische Dateien ein Expires-Header erzeugt werden soll. Wenn aktiviert, wird ein Expires-Header basierend auf Expires-Standard und Expires nach Typ erzeugt.

Dies kann auf Server-, Virtual-Host- und Kontextebene gesetzt werden. Einstellungen niedrigerer Ebenen ueberschreiben hoehere Ebenen, d. h. Kontexteinstellungen ueberschreiben Virtual-Host-Einstellungen und Virtual-Host-Einstellungen ueberschreiben Servereinstellungen.

Syntax

Aus Optionsfeldern auswählen

Expires-Standard

Beschreibung

Gibt Standardeinstellungen fuer die Erzeugung des Expires-Headers an. Diese Einstellung wird wirksam, wenn Expires aktivieren auf "Yes" gesetzt ist. Sie kann durch Expires nach Typ ueberschrieben werden. Setzen Sie diesen Standardwert nicht auf Server- oder Virtual-Host-Ebene, sofern es nicht noetig ist, da er Expires-Header fuer alle Seiten erzeugt. Meist sollte dies auf Kontextebene fuer bestimmte Verzeichnisse gesetzt werden, die sich nicht haeufig aendern. Gibt es keine Standardeinstellung, wird fuer nicht in Expires nach Typ angegebene Typen kein Expires-Header erzeugt.

Syntax

A|Mseconds
Die Datei laeuft nach Basiszeit (A|M) plus angegebenen Sekunden ab. Basiszeit "A" setzt den Wert auf die Zugriffszeit des Clients und "M" auf die letzte Aenderungszeit der Datei.

Expires nach Typ

Beschreibung

Gibt Expires-Header-Einstellungen fuer einzelne MIME-Typen an.

Syntax

Kommagetrennte Liste von "MIME-type=A|Mseconds". Die Datei laeuft nach Basiszeit (A|M) plus angegebenen Sekunden ab.

Basiszeit "A" setzt den Wert auf die Zugriffszeit des Clients und "M" auf die letzte Aenderungszeit der Datei. MIME-type akzeptiert den Platzhalter "*", zum Beispiel image/*.

Datei-Upload

Beschreibung

Stellt zusaetzliche Sicherheitsfunktionen beim Hochladen von Dateien bereit, indem ein Request Body Parser Dateien in ein lokales Serververzeichnis parst, wo sie leicht von Drittanbieter-Modulen auf boesartige Absicht gescannt werden koennen. Request Body Parser wird verwendet, wenn Upload-Daten per Dateipfad uebergeben aktiviert ist oder ein Modul LSIAPIs set_parse_req_body auf der Ebene LSI_HKPT_HTTP_BEGIN aufruft. API-Beispiele werden im Quellpaket bereitgestellt.

Siehe auch

Priorität Hook::HTTP_BEGIN

Pfad für temporäre Dateien

Beschreibung

Temporäres Verzeichnis, in dem Dateien gespeichert werden, die zum Server hochgeladen werden, während der Parser des Anforderungstextes arbeitet. Der Standardwert ist /tmp/lshttpd/.

Syntax

Absoluter Pfad oder Pfad, der mit $SERVER_ROOT beginnt (für Server- und VHost-Ebenen), oder $VH_ROOT (für VHost-Ebenen).

Berechtigung temporärer Dateien

Beschreibung

Bestimmt die Dateiberechtigungen für Dateien, die im temporären Verzeichnis gespeichert werden. Die Einstellung auf Serverebene ist global und kann auf VHost-Ebene überschrieben werden.

Syntax

Dreistellige Oktalzahl. Der Standardwert ist 666.

Upload-Daten per Dateipfad uebergeben

Beschreibung

Gibt an, ob Upload-Dateidaten per Pfad uebergeben werden sollen. Wenn aktiviert, wird beim Upload der Dateipfad zusammen mit weiteren Informationen an den Backend-Handler gesendet, statt der Datei selbst. Dies spart CPU-Ressourcen und Dateiuebertragungszeit, erfordert aber Backend-Aktualisierungen zur Implementierung. Wenn deaktiviert, wird der Dateiinhalt an den Backend-Handler uebertragen; der Request-Body wird weiterhin in Dateien geparst.

Syntax

Aus Optionsfeldern auswählen

Tipps

Performance Aktivieren Sie dies, um die Verarbeitung von Datei-Uploads zu beschleunigen, wenn Abwaertskompatibilitaet kein Problem ist.

Suffixe

Beschreibung

Gibt die Suffixe der Skriptdateien an, die von diesem Skript-Handler verarbeitet werden. Suffixe müssen eindeutig sein.

Syntax

Durch Kommas getrennte Liste; das Punktzeichen "." ist nicht zulässig.

Tipps

Information Der Server fügt automatisch einen speziellen MIME-Typ ("application/x-httpd-[suffix]") für das erste Suffix in der Liste hinzu. Zum Beispiel wird der MIME-Typ "application/x-httpd-php53" für das Suffix "php53" hinzugefügt. Weitere Suffixe müssen in den MIME-Einstellungen-Einstellungen eingerichtet werden.
Obwohl in diesem Feld Suffixe aufgeführt werden, verwenden Skript-Handler MIME-Typen und nicht Suffixe, um zu entscheiden, welche Skripte verarbeitet werden.
PerformanceSecurity Geben Sie nur die Suffixe an, die Sie wirklich benötigen.

Handler-Typ

Beschreibung

Gibt den Typ der externen Anwendung an, die diese Skriptdateien verarbeitet. Verfügbare Typen sind: LSAPI app, Web Server (Proxy), Fast CGI, SCGI, CGI, Load balancer, Servlet Engine, uWSGI oder Module Handler. Mit Ausnahme der Handler-Typen CGI und Module Handler muss Handler-Name ebenfalls auf eine zuvor im Abschnitt Externe Anwendungen definierte externe Anwendung gesetzt werden.

Syntax

Aus Dropdown-Liste auswählen

Handler-Name

Beschreibung

Gibt den Namen der externen Anwendung an, die die Skriptdateien verarbeitet, wenn der Handler-Typ LSAPI app, Web Server (Proxy), Fast CGI, SCGI, Load balancer, Servlet Engine oder uWSGI ist.

Syntax

Aus Dropdown-Liste auswählen

php.ini-Überschreibung

Beschreibung

Wird verwendet, um php.ini-Einstellungen im aktuellen Kontext (Virtual-Host-Ebene oder Kontextebene) zu überschreiben.

Unterstützte Direktiven sind:
php_value
php_flag
php_admin_value
php_admin_flag

Alle anderen Zeilen/Direktiven werden ignoriert.

Syntax

Die Überschreibungssyntax ähnelt Apache: eine durch Zeilenumbrüche getrennte Liste von Direktiven und ihren Werten, wobei jeder Direktive je nach Bedarf php_value, php_flag, php_admin_value oder php_admin_flag vorangestellt wird.

Beispiel

php_value include_path ".:/usr/local/lib/php"
php_admin_flag engine on
php_admin_value open_basedir "/home"