LiteSpeed Web Server logo Manual de usuario de LiteSpeed Web Server

Contexto CGI

Tabla de contenido

Contexto CGI

Contexto CGI

Descripción

Un contexto CGI define los scripts de un directorio determinado como scripts CGI. Este directorio puede estar dentro o fuera de la raiz de documentos. Cuando se solicita un archivo de este directorio, el servidor siempre intentara ejecutarlo como script CGI, sea ejecutable o no. De esta forma, el contenido de los archivos bajo un contexto CGI siempre queda protegido y no puede leerse como contenido estatico. Se recomienda colocar todos los scripts CGI en un directorio y configurar un contexto CGI para acceder a ellos.

URI

Descripción

Especifica la URI para este contexto.

Sintaxis

La URI puede ser una URI simple (que empieza con "/") o una URI de expresion regular compatible con Perl (que empieza con "exp:"). Si una URI simple termina con "/", este contexto incluira todas las sub-URI bajo esta URI. Si el contexto se mapea a un directorio del sistema de archivos, debe agregarse una "/" final.

Ver también

Ubicación

Ruta

Descripción

Especifica la ubicacion de los scripts CGI.

Sintaxis

La ruta puede ser un directorio que contiene un grupo de scripts CGI, como $VH_ROOT/myapp/cgi-bin/. En este caso, el contexto URI debe terminar con "/", como /app1/cgi/. La Ruta tambien puede especificar un solo script CGI, como $VH_ROOT/myapp/myscript.pl. Este script debe tener el URI correspondiente /myapp/myscript.pl.

Operaciones de encabezado

Descripción

Especifica encabezados de respuesta/solicitud adicionales que se agregaran. Se pueden agregar varias directivas de encabezado, una por linea. "NONE" puede usarse para deshabilitar la herencia de encabezados padre. Si no se proporciona una directiva, se asume 'Header'.

Sintaxis

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

Ejemplo

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

Consejos

Información La sintaxis y el uso son similares a las directivas mod_headers de Apache para las operaciones admitidas.

Información La directiva 'Header' es opcional y puede excluirse o conservarse al copiar reglas desde otro lugar sin problema.

Permitir Set UID

Descripción

Especifica si se permite el bit set UID para scripts CGI. Si el bit set UID esta permitido y habilitado para un script CGI, sin importar en nombre de que usuario se inicio el script CGI, el ID de usuario del proceso CGI cambiara al ID de usuario del propietario del script CGI.
El valor predeterminado es "Off".

Sintaxis

Seleccionar desde botones de opción

Consejos

Seguridad No permita scripts CGI Set UID siempre que sea posible, ya que es inherentemente un riesgo de seguridad.

Permitir Override

Descripción

Especifica que directivas estan permitidas en un archivo de control de acceso. Un archivo de control de acceso puede colocarse en un directorio para controlar la accesibilidad de los archivos bajo ese directorio.

  • Cuando no se marca nada, se usaran los ajustes predeterminados heredados.
  • Cuando se marca Ninguno, los archivos de control de acceso se ignoraran.
  • Cuando se marca Límite, se permiten las directivas "Allow", "Deny" y "Order". Las directivas <Limit> y <LimitExcept> tambien se permiten con soporte limitado para solicitudes GET, HEAD y POST.
  • Cuando se marca Autenticación, se permiten las directivas "AuthGroupFile", "AuthName", "AuthType", "AuthUserFile", "Require" y "Satisfy". Las directivas <Limit> y <LimitExcept> tambien se permiten con soporte limitado para solicitudes GET, HEAD y POST.
  • Cuando se marca Info de Archivo, se permiten las directivas "AddDefaultCharset", "AddType", "DefaultType", "ForceType", "Redirect", "RedirectPermanent", "RedirectTemp", "RewriteBase", "RewriteCond", "RewriteEngine", "RewriteOptions" y "RewriteRule".
  • Cuando se marca Índices, se permiten las directivas "DirectoryIndex", "ExpiresActive", "ExpiresByType" y "ExpiresDefault".
  • Cuando se marca Opciones, se permite la directiva "Options".

La configuracion Allow Override esta disponible en los niveles de servidor, virtual host y contexto. Si una configuracion no esta marcada en el nivel de servidor, esas directivas controladas se deshabilitaran para todo el servidor sin importar los ajustes en niveles inferiores. Los niveles inferiores pueden deshabilitar una opcion habilitada en un nivel superior, pero no pueden habilitar una opcion deshabilitada en un nivel superior.

Valores predeterminados:
Nivel de servidor: "None" (ignorar archivo de control de acceso)
Nivel de VH: heredar el ajuste del nivel de servidor
Nivel de contexto heredar el ajuste del nivel de VH

Sintaxis

Seleccionar mediante casillas

Consejos

Rendimiento Si no necesita personalizacion de configuracion a nivel de directorio, marque Ninguno.

Realm

Descripción

Especifica el realm de autorizacion para este contexto. Cuando se especifica, deben proporcionarse un nombre de usuario y una contrasena validos para acceder a este contexto. Realms de autorización se configuran en la seccion Host virtual - Seguridad. Esta opcion usa el Nombre del Realm de cada realm.

Sintaxis

Seleccionar de la lista desplegable

Nombre de autenticación

Descripción

Especifica un nombre alternativo para el realm de autorizacion del contexto actual. Si no se especifica, se usara el nombre de realm original. El nombre de autenticacion se muestra en la ventana emergente de login del navegador.

Require (usuarios/grupos autorizados)

Descripción

Especifica que usuario/grupo puede acceder a este contexto. Esto permite usar una base de datos de usuarios/grupos (especificada en Realm) en varios contextos, pero permitir que solo ciertos usuarios/grupos de esa base de datos accedan a este contexto.

Sintaxis

La sintaxis es compatible con la directiva Require de Apache. Por ejemplo:

  • user username [username ...]
    Solo los usuarios listados pueden acceder a este contexto.
  • group groupid [groupid ...]
    Solo los usuarios pertenecientes a los grupos listados pueden acceder a este contexto.
Si esta opcion no se especifica, todos los usuarios validos podran acceder a este recurso.

Acceso permitido

Descripción

Especifica que IPs o subredes pueden acceder a recursos bajo este contexto. Junto con Acceso denegado y el control de acceso a nivel de servidor/virtual host, la accesibilidad se determina por el ambito mas pequeno en el que cae la direccion IP del cliente.

Sintaxis

Lista de IPs/subredes separada por comas.

Ejemplo

Las subredes pueden escribirse como 192.168.1.0/255.255.255.0, 192.168.1 o 192.168.1.*.

Acceso denegado

Descripción

Especifica que IPs o subredes NO pueden acceder a recursos bajo este contexto. Junto con Acceso permitido y el control de acceso a nivel de servidor/virtual host, la accesibilidad se determina por el ambito mas pequeno en el que cae la direccion IP del cliente.

Sintaxis

Lista de IPs/subredes separada por comas.

Ejemplo

Las subredes pueden escribirse como 192.168.1.0/255.255.255.0, 192.168.1 o 192.168.1.*.

Autorizador

Descripción

Especifica una aplicacion externa que puede usarse para generar decisiones de autorizado/no autorizado. Actualmente, solo esta disponible FastCGI Authorizer. Para mas detalles sobre el rol FastCGI Authorizer, visite https://fastcgi-archives.github.io/ .

Sintaxis

Seleccionar de la lista desplegable

Agregar conjunto de caracteres predeterminado

Descripción

Especifica si se debe agregar una etiqueta de juego de caracteres al encabezado de respuesta "Content-Type", cuando el tipo de contenido sea "text/html" o "text/plain" sin parametros. Cuando se establece en Apagado, esta funcion se deshabilita. Cuando se establece en Encendido, se agregara el juego de caracteres especificado por Charset predeterminado personalizado o el predeterminado "iso-8859-1".

Sintaxis

Seleccionar desde botones de opción

Habilitar reescritura

Descripción

Especifica si se habilita el motor de reescritura de URL de LiteSpeed. Esta opción puede personalizarse a nivel de virtual host o contexto, y se hereda a lo largo del árbol de directorios hasta que se sobrescribe explícitamente.

Sintaxis

Seleccionar desde botones de opción

Heredar reescritura

Descripción

Especifica si se deben heredar reglas rewrite de contextos padre. Si rewrite esta habilitado y no se hereda, se usaran la base rewrite y las reglas rewrite definidas en este contexto.

Sintaxis

Seleccionar desde botones de opción

Base de reescritura

Descripción

Especifica la URL base para las reglas rewrite.

Sintaxis

URL

Reglas de reescritura

Descripción

Especifica una lista de reglas de reescritura a nivel de virtual host.

NO agregue aquí reglas de reescritura de nivel de raíz de documentos. Si tiene reglas de reescritura de nivel de raíz de documentos desde .htaccess, debe crear en su lugar un contexto estático con uri "/" y agregar allí las reglas de reescritura.

Una regla de reescritura consta de una directiva RewriteRule y, opcionalmente, puede ir precedida por varias directivas RewriteCond.

  • Cada directiva debe ocupar una sola línea.
  • RewriteCond y RewriteRule siguen la sintaxis de directivas rewrite de Apache. Simplemente copie y pegue directivas rewrite desde sus archivos de configuración de Apache.
  • Hay pequeñas diferencias entre las implementaciones de LiteSpeed y Apache mod_rewrite:
    • %\{LA-U:variable\} y %\{LA-F:variable\} son ignoradas por el motor de reescritura de LiteSpeed
    • Se agregan dos nuevas variables de servidor al motor de reescritura de LiteSpeed: %\{CURRENT_URI\} representa la URI actual que procesa el motor de reescritura y %\{SCRIPT_NAME\} tiene el mismo significado que la variable de entorno CGI correspondiente.
    • El motor de reescritura de LiteSpeed dejará de procesar reglas de reescritura después de encontrar una marca [L] para evitar bucles, mientras que Apache mod_rewrite dejará de procesar reglas de reescritura solo para la iteración actual. Este comportamiento es similar al de la marca [END] en Apache mod_rewrite.

La implementación del motor de reescritura de LiteSpeed sigue las especificaciones del motor de reescritura de Apache. Para más detalles sobre las reglas de reescritura, consulte documentación mod_rewrite de Apache y guía de reescritura de URL de Apache .

Sintaxis

cadena

Edad de caché obsoleta (segundos)

Descripción

Especifica cuanto tiempo se seguira sirviendo un objeto desde cache despues de expirar pero antes de que haya una nueva copia en cache disponible. El valor predeterminado es "10" segundos.

Sintaxis

Número entero

Cachear todo públicamente

Descripción

Almacena publicamente en cache todas las URL servidas bajo el contexto actual (host virtual o nivel de contexto).

Los hosts virtuales configurados mediante httpd.conf de Apache pueden usar las directivas "CacheEnable" y "CacheDisable" en el nivel de servidor, host virtual, contexto, archivo y ubicacion o en .htaccess. Las directivas "CacheEnable" y "CacheDisable" son compatibles con las directivas mod_cache de Apache. Sin embargo, cuando se usan en el nivel de contexto, archivo o ubicacion, o en .htaccess, "CacheEnable" y "CacheDisable" solo se aplicaran a los directorios por debajo del nivel actual. Los parametros de URL se ignoraran.

Sintaxis

Seleccionar desde botones de opción

Consejos

Información Desactivado de forma predeterminada. No active esta opcion si usa algun plugin LSCache.

Tiempo de expiración de caché (segundos)

Descripción

Especifica cuanto tiempo se almacenara un objeto en cache. El valor predeterminado es "86400" segundos (un dia).

Sintaxis

Número entero

Micro caché de respuesta 5XX

Descripción

Almacena en cache durante 10 segundos las paginas que respondan con codigo de estado HTTP 5xx (500, 503, etc.) cuando el encabezado de respuesta de cache indica que la pagina puede almacenarse en cache.

Valores predeterminados:
Nivel de servidor: Yes
Nivel de VH: Heredar la opcion del nivel del servidor
Nivel de contexto Heredar la opcion del nivel de VH

Sintaxis

Seleccionar desde botones de opción

Consejos

Rendimiento Activar esta opcion es util para evitar solicitudes incorrectas, pero tambien puede aportar proteccion DDoS adicional.

Cachear todo privadamente

Descripción

Almacena privadamente en cache todas las URL servidas bajo el contexto actual (host virtual o nivel de contexto).

Se creara una copia en cache separada por usuario basada en su IP y cookies establecidas.

Los hosts virtuales configurados mediante httpd.conf de Apache pueden usar las directivas "CacheEnable private /url" y "CacheDisable private /url" en niveles de servidor, host virtual, directorio, archivo y ubicacion o en un archivo .htaccess. "CacheEnable private" y "CacheDisable private" son compatibles con las directivas mod_cache de Apache y se aplicaran a todos los directorios por debajo del nivel actual. Sin embargo, cuando se usan en el nivel de directorio, archivo o ubicacion, o en un archivo .htaccess, "CacheEnable private" y "CacheDisable private" solo se aplicaran a los directorios por debajo del nivel actual. Los parametros de URL se ignoraran.

Sintaxis

Seleccionar desde botones de opción

Consejos

Información Desactivado de forma predeterminada. No active esta opcion si usa algun plugin LSCache.

Tiempo de expiración de caché privada (segundos)

Descripción

Especifica cuanto tiempo se almacenara un objeto en cache privada. El valor predeterminado es "60" segundos.

Sintaxis

Número entero

Activar caché POST

Descripción

Especifica si las solicitudes POST se pueden almacenar en cache usando el encabezado "x-litespeed-cache-control".

Valor predeterminado: No

Sintaxis

Seleccionar desde botones de opción

Habilitar búsqueda de geolocalización

Descripción

Enterprise Edition Only Especifica si se debe habilitar/deshabilitar la busqueda de IP Geolocation. Puede establecerse a nivel de servidor, virtual host o contexto. IP Geolocation esta deshabilitada de forma predeterminada cuando se usa el valor "Not Set".

Sintaxis

Seleccionar desde botones de opción

Ver también

Usar IP de cliente en el encabezado, Ruta del archivo DB,

Activar optimizacion PageSpeed

Descripción

Elija si desea activar o no la optimizacion PageSpeed.

Sintaxis

Seleccionar desde botones de opción

Consejos

Información Esto puede configurarse en el nivel del servidor y sobrescribirse en los niveles de host virtual y contexto. Las opciones del nivel de contexto sobrescribiran las opciones del nivel de host virtual.

Configuración de PageSpeed

Descripción

Establece parametros usando los conjuntos de filtros predeterminados de Google.

Ejemplo


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

Configuraciones estilo Apache

Descripción

Especifica las directivas de configuracion de Apache (compatibles con LiteSpeed) que desea usar en el archivo de configuracion nativo de LiteSpeed. Por ejemplo, para sobrescribir las configuraciones PHP predeterminadas (entradas php.ini), el servidor necesitara cuatro directivas: "php_value", "php_flag", "php_admin_value" y "php_admin_flag".

Sintaxis

Igual que el archivo de configuracion de Apache.