LiteSpeed Web Server logo LiteSpeed Web Server-Benutzerhandbuch

CGI-Kontext

Inhaltsverzeichnis

CGI-Kontext

CGI-Kontext

Beschreibung

Ein CGI-Kontext definiert Skripte in einem bestimmten Verzeichnis als CGI-Skripte. Dieses Verzeichnis kann innerhalb oder ausserhalb des Dokumentstammverzeichnisses liegen. Wenn eine Datei in diesem Verzeichnis angefordert wird, versucht der Server immer, sie als CGI-Skript auszufuehren, unabhaengig davon, ob sie ausfuehrbar ist. Dadurch ist Dateiinhalte unter einem CGI-Kontext stets geschuetzt und koennen nicht als statische Inhalte gelesen werden. Es wird empfohlen, alle CGI-Skripte in einem Verzeichnis abzulegen und einen CGI-Kontext fuer den Zugriff darauf einzurichten.

URI

Beschreibung

Gibt die URI fuer diesen Kontext an.

Syntax

Die URI kann eine einfache URI sein (beginnend mit "/") oder eine Perl-kompatible regulaere Ausdrucks-URI (beginnend mit "exp:"). Wenn eine einfache URI mit "/" endet, umfasst dieser Kontext alle Unter-URIs darunter. Wenn der Kontext einem Verzeichnis im Dateisystem zugeordnet ist, muss ein abschliessendes "/" hinzugefuegt werden.

Siehe auch

Speicherort

Pfad

Beschreibung

Gibt den Speicherort der CGI-Skripte an.

Syntax

Der Pfad kann ein Verzeichnis sein, das eine Gruppe von CGI-Skripten enthaelt, wie $VH_ROOT/myapp/cgi-bin/. In diesem Fall muss der Kontext URI mit "/" enden, wie /app1/cgi/. Der Pfad kann auch nur ein einzelnes CGI-Skript angeben, wie $VH_ROOT/myapp/myscript.pl. Dieses Skript sollte das entsprechende URI /myapp/myscript.pl haben.

Header-Operationen

Beschreibung

Gibt zusaetzliche Antwort-/Anfrage-Header an, die hinzugefuegt werden sollen. Mehrere Header-Direktiven koennen mit einer Direktive pro Zeile angegeben werden. "NONE" deaktiviert die Vererbung uebergeordneter Header. Wenn keine Direktive angegeben ist, wird 'Header' angenommen.

Syntax

[Header]|RequestHeader [condition] set|append|merge|add|unset header [value] [early|env=[!]variable]

Beispiel

set Cache-control no-cache
append Cache-control no-store
Header set My-header cust_header_val
RequestHeader set My-req-header cust_req_header_val

Tipps

Information Syntax und Verwendung entsprechen den Apache mod_headers-Direktiven fuer unterstuetzte Operationen.

Information Die Direktive 'Header' ist optional und kann beim Kopieren von Regeln ohne Problem entfernt oder beibehalten werden.

Set UID erlauben

Beschreibung

Gibt an, ob das set UID-Bit fuer CGI-Skripte erlaubt ist. Wenn es erlaubt und fuer ein CGI-Skript aktiviert ist, wechselt die Benutzer-ID des CGI-Prozesses zur Benutzer-ID des Skriptbesitzers, unabhaengig davon, im Namen welchen Benutzers das Skript gestartet wurde.
Standard ist "Off".

Syntax

Aus Optionsfeldern auswählen

Tipps

Sicherheit Erlauben Sie Set UID-CGI-Skripte moeglichst nicht, da dies grundsaetzlich ein Sicherheitsrisiko ist.

Override erlauben

Beschreibung

Gibt an, welche Direktiven in einer Zugriffskontrolldatei erlaubt sind. Eine Zugriffskontrolldatei kann in einem Verzeichnis abgelegt werden, um den Zugriff auf Dateien unter diesem Verzeichnis zu steuern.

  • Wenn nichts markiert ist, werden geerbte Standardeinstellungen verwendet.
  • Wenn Keiner markiert ist, werden Zugriffskontrolldateien ignoriert.
  • Wenn Limit markiert ist, sind die Direktiven "Allow", "Deny" und "Order" erlaubt. <Limit> und <LimitExcept> sind mit begrenzter Unterstuetzung fuer GET-, HEAD- und POST-Anfragen ebenfalls erlaubt.
  • Wenn Auth markiert ist, sind "AuthGroupFile", "AuthName", "AuthType", "AuthUserFile", "Require" und "Satisfy" erlaubt.
  • Wenn FileInfo markiert ist, sind "AddDefaultCharset", "AddType", "DefaultType", "ForceType", "Redirect", "RedirectPermanent", "RedirectTemp", "RewriteBase", "RewriteCond", "RewriteEngine", "RewriteOptions" und "RewriteRule" erlaubt.
  • Wenn Indizes markiert ist, sind "DirectoryIndex", "ExpiresActive", "ExpiresByType" und "ExpiresDefault" erlaubt.
  • Wenn Optionen markiert ist, ist die Direktive "Options" erlaubt.

Allow Override ist auf Server-, Virtual-Host- und Kontext-Ebene verfuegbar. Wenn eine Option auf Serverebene nicht markiert ist, sind die entsprechenden Direktiven fuer den gesamten Server deaktiviert, unabhaengig von niedrigeren Ebenen. Niedrigere Ebenen koennen eine auf hoeherer Ebene aktivierte Option deaktivieren, aber keine auf hoeherer Ebene deaktivierte Option aktivieren.

Standardwerte:
Serverebene: "None" (Zugriffskontrolldatei ignorieren)
VH-Ebene: Servereinstellung erben
Kontextebene VH-Einstellung erben

Syntax

Per Kontrollkästchen auswählen

Tipps

Leistung Wenn keine Verzeichniskonfiguration angepasst werden muss, markieren Sie Keiner.

Realm

Beschreibung

Gibt den Autorisierungs-Realm fuer diesen Kontext an. Wenn angegeben, muessen ein gueltiger Benutzername und ein Passwort angegeben werden, um auf diesen Kontext zuzugreifen. Autorisierungs-Realms werden im Abschnitt Virtueller Host - Sicherheit eingerichtet. Diese Einstellung verwendet Realm-Name jedes Realms.

Syntax

Aus Dropdown-Liste auswählen

Authentifizierungsname

Beschreibung

Gibt einen alternativen Namen fuer den Autorisierungs-Realm des aktuellen Kontextes an. Wenn nicht angegeben, wird der urspruengliche Realm-Name verwendet. Der Authentifizierungsname wird im Login-Popup des Browsers angezeigt.

Require (autorisierte Benutzer/Gruppen)

Beschreibung

Gibt an, welche Benutzer/Gruppen auf diesen Kontext zugreifen duerfen. Dadurch koennen Sie eine Benutzer-/Gruppendatenbank (angegeben in Realm) fuer mehrere Kontexte verwenden, aber nur bestimmte Benutzer/Gruppen daraus fuer diesen Kontext zulassen.

Syntax

Die Syntax ist mit der Apache-Require-Direktive kompatibel. Zum Beispiel:

  • user username [username ...]
    Nur aufgelistete Benutzer koennen auf diesen Kontext zugreifen.
  • group groupid [groupid ...]
    Nur Benutzer, die zu den aufgelisteten Gruppen gehoeren, koennen auf diesen Kontext zugreifen.
Wenn diese Einstellung nicht angegeben ist, duerfen alle gueltigen Benutzer auf diese Ressource zugreifen.

Zugriff erlaubt

Beschreibung

Gibt an, welche IPs oder Subnetze auf Ressourcen unter diesem Kontext zugreifen duerfen. Zusammen mit Zugriff verweigert und der Zugriffskontrolle auf Server-/Virtual-Host-Ebene wird die Zugaenglichkeit durch den kleinsten Bereich bestimmt, in den die IP-Adresse des Clients faellt.

Syntax

Kommagetrennte Liste von IPs/Subnetzen.

Beispiel

Subnetze koennen als 192.168.1.0/255.255.255.0, 192.168.1 oder 192.168.1.* geschrieben werden.

Zugriff verweigert

Beschreibung

Gibt an, welche IPs oder Subnetze NICHT auf Ressourcen unter diesem Kontext zugreifen duerfen. Zusammen mit Zugriff erlaubt und der Zugriffskontrolle auf Server-/Virtual-Host-Ebene wird die Zugaenglichkeit durch den kleinsten Bereich bestimmt, in den die IP-Adresse des Clients faellt.

Syntax

Kommagetrennte Liste von IPs/Subnetzen.

Beispiel

Subnetze koennen als 192.168.1.0/255.255.255.0, 192.168.1 oder 192.168.1.* geschrieben werden.

Authorizer

Beschreibung

Gibt eine externe Anwendung an, die autorisiert/nicht autorisiert-Entscheidungen erzeugen kann. Derzeit ist nur der FastCGI Authorizer verfuegbar. Weitere Details zur Rolle FastCGI Authorizer finden Sie unter https://fastcgi-archives.github.io/ .

Syntax

Aus Dropdown-Liste auswählen

Standardzeichensatz hinzufügen

Beschreibung

Gibt an, ob dem Antwort-Header "Content-Type" ein Zeichensatz-Tag hinzugefuegt werden soll, wenn der Content-Type entweder "text/html" oder "text/plain" ohne Parameter ist. Bei Aus ist diese Funktion deaktiviert. Bei An wird entweder der durch Angepasster Standard-Charset angegebene Zeichensatz oder der Standard "iso-8859-1" hinzugefuegt.

Syntax

Aus Optionsfeldern auswählen

Angepasster Standard-Charset

Beschreibung

Gibt einen Zeichensatz an, der verwendet wird, wenn Standardzeichensatz hinzufügen auf An steht. Dies ist optional. Standardwert ist iso-8859-1. Dieser Eintrag hat keine Wirkung, wenn Standardzeichensatz hinzufügen auf Aus steht.

Syntax

Name eines Zeichensatzes.

Beispiel

utf-8

Rewrite aktivieren

Beschreibung

Gibt an, ob LiteSpeeds URL-Rewrite-Engine aktiviert wird. Diese Option kann auf Virtual-Host- oder Kontextebene angepasst werden und wird entlang des Verzeichnisbaums vererbt, bis sie ausdrücklich überschrieben wird.

Syntax

Aus Optionsfeldern auswählen

Rewrite erben

Beschreibung

Gibt an, ob Rewrite-Regeln von uebergeordneten Kontexten geerbt werden sollen. Wenn Rewrite aktiviert und nicht geerbt ist, werden die in diesem Kontext definierten Rewrite-Basis und Rewrite-Regeln verwendet.

Syntax

Aus Optionsfeldern auswählen

Rewrite-Basis

Beschreibung

Gibt die Basis-URL fuer Rewrite-Regeln an.

Syntax

URL

Rewrite-Regeln

Beschreibung

Gibt eine Liste von Rewrite-Regeln auf Virtual-Host-Ebene an.

Fügen Sie hier KEINE Rewrite-Regeln auf Dokumentstammebene hinzu. Wenn Sie Rewrite-Regeln auf Dokumentstammebene aus .htaccess haben, sollten Sie stattdessen einen statischen Kontext mit uri "/" erstellen und die Rewrite-Regeln dort hinzufügen.

Eine Rewrite-Regel besteht aus einer Direktive RewriteRule und kann optional von mehreren Direktiven RewriteCond eingeleitet werden.

  • Jede Direktive sollte nur eine Zeile belegen.
  • RewriteCond und RewriteRule folgen der Rewrite-Direktivensyntax von Apache. Kopieren Sie Rewrite-Direktiven einfach aus Ihren Apache-Konfigurationsdateien und fügen Sie sie ein.
  • Es gibt kleinere Unterschiede zwischen der Implementierung von LiteSpeed und Apache mod_rewrite:
    • %\{LA-U:variable\} und %\{LA-F:variable\} werden von der LiteSpeed-Rewrite-Engine ignoriert
    • Zwei neue Servervariablen werden der LiteSpeed-Rewrite-Engine hinzugefügt: %\{CURRENT_URI\} steht für die aktuelle URI, die von der Rewrite-Engine verarbeitet wird, und %\{SCRIPT_NAME\} hat dieselbe Bedeutung wie die entsprechende CGI-Umgebungsvariable.
    • Die LiteSpeed-Rewrite-Engine stoppt die Verarbeitung von Rewrite-Regeln nach einer [L]-Markierung, um Schleifen zu vermeiden, während Apache mod_rewrite die Verarbeitung von Rewrite-Regeln nur für die aktuelle Iteration stoppt. Dieses Verhalten ähnelt dem der [END]-Markierung in Apache mod_rewrite.

Die Implementierung der LiteSpeed-Rewrite-Engine folgt den Spezifikationen der Apache-Rewrite-Engine. Weitere Details zu Rewrite-Regeln finden Sie in der Apache mod_rewrite-Dokumentation und im Apache-Leitfaden zur URL-Umschreibung .

Syntax

Zeichenkette

Alter abgelaufener Cache (Sekunden)

Beschreibung

Legt fest, wie lange ein Objekt nach Ablauf weiterhin aus dem Cache bereitgestellt wird, bevor eine neue zwischengespeicherte Kopie verfuegbar ist. Standard ist "10" Sekunden.

Syntax

Ganzzahl

Alles öffentlich cachen

Beschreibung

Alle URLs, die unter dem aktuellen Kontext bereitgestellt werden, oeffentlich cachen (Virtual Host oder Kontextebene).

Virtual Hosts, die ueber Apaches httpd.conf konfiguriert sind, koennen die Direktiven "CacheEnable" und "CacheDisable" auf Server-, Virtual-Host-, Kontext-, Datei- und Standortebene oder in .htaccess verwenden. "CacheEnable"- und "CacheDisable"-Direktiven sind mit Apache-mod_cache-Direktiven kompatibel. Wenn sie jedoch auf Kontext-, Datei- oder Standortebene oder in .htaccess verwendet werden, werden "CacheEnable" und "CacheDisable" nur auf Verzeichnisse unterhalb der aktuellen Ebene angewendet. URL-Parameter werden ignoriert.

Syntax

Aus Optionsfeldern auswählen

Tipps

Information Standardmaessig deaktiviert. Aktivieren Sie diese Einstellung nicht, wenn Sie LSCache-Plugins verwenden.

Cache-Ablaufzeit (Sekunden)

Beschreibung

Legt fest, wie lange ein Objekt gecacht wird. Standard ist "86400" Sekunden (ein Tag).

Syntax

Ganzzahl

Micro-Cache für 5XX-Antwort

Beschreibung

Seiten mit HTTP-Statuscode 5xx (500, 503 usw.) fuer 10 Sekunden cachen, wenn der Cache-Antwortheader angibt, dass die Seite cachebar ist.

Standardwerte:
Serverebene: Yes
VH-Ebene: Serverebenen-Einstellung erben
Kontextebene VH-Ebenen-Einstellung erben

Syntax

Aus Optionsfeldern auswählen

Tipps

Leistung Das Aktivieren dieser Einstellung ist nuetzlich, um fehlerhafte Anfragen zu vermeiden, kann aber auch als zusaetzlicher DDoS-Schutz dienen.

Alles privat cachen

Beschreibung

Alle URLs, die unter dem aktuellen Kontext bereitgestellt werden, privat cachen (Virtual Host oder Kontextebene).

Pro Benutzer wird basierend auf IP und gesetzten Cookies eine separate Cache-Kopie erstellt.

Virtual Hosts, die ueber Apaches httpd.conf konfiguriert sind, koennen die Direktiven "CacheEnable private /url" und "CacheDisable private /url" auf Server-, Virtual-Host-, Verzeichnis-, Datei- und Standortebene oder in einer .htaccess-Datei verwenden. "CacheEnable private" und "CacheDisable private" sind mit Apaches mod_cache-Direktiven kompatibel und werden auf alle Verzeichnisse unterhalb der aktuellen Ebene angewendet. Wenn sie jedoch auf Verzeichnis-, Datei- oder Standortebene oder in einer .htaccess-Datei verwendet werden, werden "CacheEnable private" und "CacheDisable private" nur auf Verzeichnisse unterhalb der aktuellen Ebene angewendet. URL-Parameter werden ignoriert.

Syntax

Aus Optionsfeldern auswählen

Tipps

Information Standardmaessig deaktiviert. Aktivieren Sie diese Einstellung nicht, wenn Sie LSCache-Plugins verwenden.

Ablaufzeit privater Cache (Sekunden)

Beschreibung

Legt fest, wie lange ein Objekt im privaten Cache gespeichert wird. Standard ist "60" Sekunden.

Syntax

Ganzzahl

POST-Cache aktivieren

Beschreibung

Legt fest, ob POST-Anfragen mit dem Header "x-litespeed-cache-control" zwischengespeichert werden koennen.

Standardwert: NEIN

Syntax

Aus Optionsfeldern auswählen

GeoLocation-Suche aktivieren

Beschreibung

Enterprise Edition Only 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,

PageSpeed-Optimierung aktivieren

Beschreibung

Waehlen Sie, ob PageSpeed-Optimierung aktiviert werden soll.

Syntax

Aus Optionsfeldern auswählen

Tipps

Information Dies kann auf Serverebene gesetzt und auf Virtual-Host- und Kontextebene ueberschrieben werden. Einstellungen auf Kontextebene ueberschreiben Einstellungen auf Virtual-Host-Ebene.

PageSpeed-Einstellungen

Beschreibung

Parameter mit den Google-Standardfiltersaetzen setzen.

Beispiel


pagespeed FileCachePath /tmp/lshttpd/pagespeed;
pagespeed RewriteLevel CoreFilters;

Konfigurationen im Apache-Stil

Beschreibung

Gibt Apache-Konfigurationsdirektiven (von LiteSpeed unterstuetzt) an, die Sie in der nativen LiteSpeed-Konfigurationsdatei verwenden moechten. Um z.B. die Standard-PHP-Konfigurationen (php.ini-Eintraege) zu ueberschreiben, benoetigt der Server vier Direktiven: "php_value", "php_flag", "php_admin_value" und "php_admin_flag".

Syntax

Wie in der Apache-Konfigurationsdatei.