LiteSpeed Web Server logo Manual de usuario de LiteSpeed Web Server

Host virtual - General

Tabla de contenido

Configuración principal

Registro del host virtual

Registro de acceso

Archivos de índice

Páginas de error personalizadas

Manejador de scripts

.htaccess

Configuración de expiración

Configuracion estilo Apache

Proxy WebSocket

Raíz de documentos

Descripción

Especifica la raíz de documentos de este virtual host. Se recomienda $VH_ROOT/html. En los contextos, este directorio se referencia como $DOC_ROOT.

Sintaxis

Una ruta que puede ser absoluta, relativa a $SERVER_ROOT o relativa a $VH_ROOT.

Correo electrónico del administrador

Descripción

Especifica las direcciones de correo de los administradores de este virtual host.

Sintaxis

Lista de direcciones de correo separadas por comas

Métodos de compresión

Descripción

Especifica qué métodos de compresión están habilitados para este virtual host. Si este ajuste no está establecido, se usan los métodos de compresión de nivel de servidor.

Sintaxis

Seleccionar mediante casillas

Ver también

Métodos de compresión, Prioridad de compresión

Prioridad de compresión

Descripción

Proporciona un orden preferido de métodos de compresión para Zstandard, Brotli y GZIP para este virtual host cuando puede usarse más de un método habilitado. Si este ajuste no está establecido, se usa la prioridad de compresión de nivel de servidor. Este ajuste es una sugerencia y no fuerza el orden final en cada respuesta.

Sintaxis

Seleccionar de la lista desplegable

Ver también

Prioridad de compresió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,

cgroups

Descripción

Función del kernel Linux que limita, contabiliza y aísla el uso de recursos (CPU, memoria, I/O de disco, red, etc.) de un conjunto de procesos. Debe estar usando cgroups v2, lo cual se determina por la existencia del archivo /sys/fs/cgroup/cgroup.controllers.

Establecer esto en Deshabilitado a nivel de servidor deshabilitará este ajuste en todo el servidor. En todos los demás casos, el ajuste de nivel de servidor se puede sobrescribir a nivel de virtual host.

Valores predeterminados:
Nivel de servidor: Off
Nivel de VH: Heredar el ajuste de nivel de servidor

Sintaxis

Seleccionar de la lista desplegable

Usar el registro del servidor

Descripción

Especifica si los mensajes de registro de este host virtual se colocarán en el archivo de registro del servidor en lugar de crear su propio archivo de registro.

Sintaxis

Seleccionar desde botones de opción

Nombre de archivo

Descripción

Especifica la ruta del archivo de registro.

Sintaxis

Nombre de archivo que puede ser una ruta absoluta o una ruta relativa a $SERVER_ROOT, $VH_ROOT.

Consejos

Rendimiento Coloque el archivo de registro en un disco separado.

Nivel de registro

Descripción

Especifica el nivel de registro. Los niveles disponibles (de mayor a menor) son ERROR, WARNING, NOTICE, INFO y DEBUG. Solo se registrarán los mensajes con un nivel mayor o igual que la configuración actual. Si desea establecerlo en DEBUG, también debe establecer el nivel de registro del servidor en DEBUG. El nivel de depuración se controla exclusivamente a nivel de servidor mediante Nivel de depuración.

Sintaxis

Seleccionar de la lista desplegable

Consejos

Rendimiento A menos que Nivel de depuración esté configurado con un nivel distinto de NONE, el nivel de registro DEBUG no tiene impacto en el rendimiento y se recomienda.

Ver también

Nivel de depuración

Tamaño de rotación (bytes)

Descripción

Especifica cuándo debe rotarse el archivo de registro actual. Cuando el tamaño del archivo supera el límite de rotación, el archivo de registro activo se renombra como log_name.mm_dd_yyyy(.sequence) en el mismo directorio y se crea un nuevo archivo de registro activo. El tamaño real del archivo rotado puede ser ligeramente mayor que este límite. Establézcalo en 0 para desactivar la rotación de registros.

Sintaxis

Número entero

Consejos

Información Agregue "K", "M" o "G" al número para kilobytes, megabytes y gigabytes.

Días de conservación

Descripción

Especifica cuántos días se conservará en disco el archivo de registro de acceso. Solo se eliminarán los archivos de registro rotados que sean más antiguos que el número de días especificado. El archivo de registro actual no se modificará, independientemente de cuántos días de datos contenga. Si no desea eliminar automáticamente registros obsoletos y muy antiguos, establezca este valor en 0.

Sintaxis

Número entero

Comprimir archivo

Descripción

Especifica si se deben comprimir los archivos de registro rotados para ahorrar espacio en disco.

Sintaxis

Seleccionar desde botones de opción

Consejos

Información Los archivos de registro se comprimen muy bien y se recomienda activar esta opción para reducir el uso de disco de registros antiguos.

Control de registro

Descripción

Dónde debe escribirse el registro de acceso. Hay tres opciones:

  1. Escribir en el registro de acceso del servidor
  2. Crear un registro de acceso para este host virtual
  3. Desactivar el registro de acceso

Sintaxis

Seleccionar de la lista desplegable

Nombre de archivo

Descripción

Nombre de archivo del registro de acceso.

Sintaxis

Nombre de archivo que puede ser una ruta absoluta o una ruta relativa a $SERVER_ROOT, $VH_ROOT.

Consejos

Rendimiento Coloque el archivo de registro de acceso en un disco separado.

Registrador por tubería

Descripción

Especifica la aplicación externa que recibirá los datos del registro de acceso enviados por LiteSpeed mediante una tubería en su flujo STDIN (el descriptor de archivo es 0). Cuando este campo se especifica, el registro de acceso se enviará solo a la aplicación registradora y no al archivo de registro de acceso especificado en la entrada anterior.

La aplicación registradora debe definirse primero en la sección Aplicaciones externas. El registro de acceso a nivel de servidor solo puede usar una aplicación registradora externa definida a nivel de servidor. El registro de acceso a nivel de host virtual solo puede usar una aplicación registradora definida a nivel de host virtual.

El proceso registrador se inicia del mismo modo que otros procesos externos (CGI/FastCGI/LSAPI). Esto significa que se ejecutará con el ID de usuario especificado en la configuración Modo Set UID de app externa del host virtual y nunca se ejecutará en nombre de un usuario privilegiado.

LiteSpeed web server realiza balanceo de carga simple entre varias aplicaciones registradoras si se configura más de una instancia. El servidor LiteSpeed siempre intenta mantener el número de aplicaciones registradoras lo más bajo posible. Solo cuando una aplicación registradora no procesa las entradas del registro de acceso a tiempo, el servidor intenta iniciar otra instancia.

Si un registrador falla, el servidor web iniciará otra instancia, pero se perderán los datos de registro del búfer de flujo. Es posible perder datos de registro si los registradores externos no pueden seguir la velocidad y el volumen del flujo de registro.

Sintaxis

Seleccionar de la lista desplegable

Formato de registro

Descripción

Especifica el formato del registro de acceso. Cuando se establece el formato de registro, anula la configuración Encabezados de registro.

Sintaxis

Cadena. La sintaxis del formato de registro es compatible con el formato de registro personalizado de Apache 2.0.

Ejemplo

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"

Ver también

Encabezados de registro

Encabezados de registro

Descripción

Especifica si se deben registrar los encabezados de solicitud HTTP: Referer, UserAgent y Host.

Sintaxis

Seleccionar mediante casillas

Consejos

Rendimiento Desactive esto si no necesita estos encabezados en el registro de acceso.

Ver también

Formato de registro

Registro de bytes

Descripción

Especifica la ruta del archivo de registro de bytes de ancho de banda. Cuando se especifica, se creará un registro de ancho de banda compatible con cPanel. Esto registrará el total de bytes transferidos para una solicitud, incluidos los cuerpos de solicitud y respuesta.

Sintaxis

Nombre de archivo que puede ser una ruta absoluta o una ruta relativa a $SERVER_ROOT.

Consejos

Rendimiento Coloque el archivo de registro en un disco separado.

Usar archivos de índice del servidor

Descripción

Especifica si se usan los ajustes de archivos de índice del servidor. Si se establece en Sí, solo se usarán los ajustes del servidor. Si se establece en No, no se usarán los ajustes del servidor. Si se establece en Addition, se pueden agregar archivos de índice adicionales a la lista de archivos de índice del servidor para este virtual host. Si desea deshabilitar los archivos de índice para este virtual host, puede establecer el valor en No y dejar vacío el campo de archivos de índice.

Sintaxis

Seleccionar de la lista desplegable

Archivos índice

Descripción

Especifica los nombres de archivos indice que se buscaran secuencialmente cuando una URL se mapee a un directorio. Puede personalizarlo a nivel de servidor, virtual host y contexto.

Sintaxis

Lista separada por comas de nombres de archivo indice.

Consejos

Rendimiento Configure solo los archivos indice que necesite.

Índice automático

Descripción

Especifica si se genera un índice de directorio al vuelo cuando los archivos de índice indicados en Archivos índice no están disponibles en un directorio. Esta opción se puede personalizar a nivel de virtual host y de contexto, y se hereda a lo largo del árbol de directorios hasta que se sobrescribe explícitamente. Puede personalizar la página de índice generada. Consulte los How-tos del wiki en línea.

Sintaxis

Seleccionar desde botones de opción

Consejos

Seguridad Se recomienda desactivar Índice automático siempre que sea posible para evitar revelar datos confidenciales.

Ver también

Archivos índice, URI de índice automático

URI de índice automático

Descripción

Especifica la URI que se usará para generar la página de índice cuando los archivos de índice indicados en Archivos índice no estén disponibles en un directorio. LiteSpeed web server usa un script externo para generar la página de índice, lo que proporciona la máxima flexibilidad de personalización. El script predeterminado produce una página de índice con el mismo aspecto que la de Apache. Para personalizar la página de índice generada, consulte los How-tos del wiki en línea. El directorio que se va a indexar se pasa al script mediante una variable de entorno "LS_AI_PATH".

Sintaxis

URI

Ver también

Archivos índice, Índice automático

Páginas de error personalizadas

Descripción

Siempre que el servidor tenga un problema al procesar una solicitud, el servidor devolvera un codigo de error y una pagina html como mensaje de error al cliente web. Los codigos de error se definen en el protocolo HTTP (consulte RFC 2616). El servidor web LiteSpeed tiene una pagina de error predeterminada integrada para cada codigo de error, pero tambien puede configurarse una pagina personalizada para cada codigo de error. Estas paginas de error pueden personalizarse aun mas para que sean unicas para cada virtual host.

Código de error

Descripción

Especifica el código de estado HTTP de la página de error. Solo el código de estado HTTP seleccionado tendrá esta página de error personalizada.

Sintaxis

Seleccionar de la lista desplegable

URL

Descripción

Especifica la URL de la página de error personalizada. El servidor reenviará la solicitud a esta URL cuando se devuelva el código de estado HTTP correspondiente. Si esta URL hace referencia a un recurso inexistente, se usará la página de error integrada. La URL puede ser un archivo estático, una página generada dinámicamente o una página de otro sitio web (una URL que empiece por "http(s)://"). Al hacer referencia a una página de otro sitio web, el cliente recibirá un código de estado de redirección en lugar del código de estado original.

Sintaxis

URL

Sufijos

Descripción

Especifica los sufijos de archivo de script que gestionará este manejador de scripts. Los sufijos deben ser únicos.

Sintaxis

Lista separada por comas; no se permite el carácter de punto ".".

Consejos

Información El servidor agregará automáticamente un tipo MIME especial ("application/x-httpd-[suffix]") para el primer sufijo de la lista. Por ejemplo, se agregará el tipo MIME "application/x-httpd-php53" para el sufijo "php53". Los sufijos posteriores deben configurarse en los ajustes de Configuración MIME.
Aunque se enumeran sufijos en este campo, los manejadores de scripts usan tipos MIME, no sufijos, para decidir qué scripts gestionar.
RendimientoSeguridad Especifique solo los sufijos que realmente necesite.

Tipo de manejador

Descripción

Especifica el tipo de aplicación externa que procesa estos archivos de script. Los tipos disponibles son: LSAPI app, Servidor Web (Proxy), Fast CGI, SCGI, CGI, Load balancer, Motor de Servlet, uWSGI o Manejador del Módulo. Excepto para los tipos de manejador CGI y Manejador del Módulo, Nombre del manejador también debe configurarse con una aplicación externa definida previamente en la sección Aplicaciones externas.

Sintaxis

Seleccionar de la lista desplegable

Nombre del manejador

Descripción

Especifica el nombre de la aplicación externa que procesa los archivos de script cuando el tipo de manejador es LSAPI app, Web Server (Proxy), Fast CGI, SCGI, Load balancer, Servlet Engine o uWSGI.

Sintaxis

Seleccionar de la lista desplegable

.htaccess

Descripción

Las siguientes directivas son compatibles en un archivo de control de acceso a nivel de directorio (archivo .htaccess).

  • Autenticacion
    • AuthGroupFile
    • AuthName
    • AuthType
    • AuthUserFile
    • Require
    • Satisfy
    • <Limit> (solo GET, HEAD, POST)
    • <LimitExcept> (solo GET, HEAD, POST)
  • Control de acceso
    • Allow
    • Deny
    • Order
    • <Limit> (solo GET, HEAD, POST)
    • <LimitExcept> (solo GET, HEAD, POST)
  • File Info
    • AddDefaultCharset
    • AddType
    • DefaultType
    • ForceType
    • Redirect
    • RedirectPermanent
    • RedirectTemp
    • RewriteBase
    • RewriteCond
    • RewriteEngine
    • RewriteOptions
    • RewriteRule
  • Otros
    • DirectoryIndex
    • ExpiresActive
    • ExpiresByType
    • ExpiresDefault
    • Options

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.

Nombre del archivo de acceso

Descripción

Especifica el nombre de los archivos de control de acceso. Estos archivos solo se usaran si Permitir Override esta habilitado. El nombre predeterminado es .htaccess. Puede configurarlo a nivel de servidor y de virtual host. El nivel de servidor es el ajuste predeterminado y puede sobrescribirse a nivel de virtual host.

Sintaxis

Nombre de archivo que empieza con "."

Ver también

Permitir Override

Habilitar Expires

Descripción

Especifica si se debe generar un encabezado Expires para archivos estaticos. Si esta habilitado, se generara un encabezado Expires basado en Expires predeterminado y Expires por tipo.

Puede establecerse a nivel de servidor, virtual host y contexto. Las opciones de nivel inferior reemplazaran las de nivel superior, es decir, las opciones de contexto reemplazaran las de virtual host y las de virtual host reemplazaran las del servidor.

Sintaxis

Seleccionar desde botones de opción

Expires predeterminado

Descripción

Especifica la configuracion predeterminada para generar el encabezado Expires. Esta opcion tiene efecto cuando Habilitar Expires se establece en "Yes". Puede ser reemplazada por Expires por tipo. No establezca este valor predeterminado a nivel de servidor o virtual host salvo que sea necesario, ya que generara encabezados Expires para todas las paginas. La mayoria de las veces debe establecerse a nivel de contexto para ciertos directorios que no cambian con frecuencia. Si no hay configuracion predeterminada, no se generara encabezado Expires para tipos no especificados en Expires por tipo.

Sintaxis

A|Msegundos
El archivo expirara despues del tiempo base (A|M) mas los segundos especificados. El tiempo base "A" establece el valor al tiempo de acceso del cliente y "M" al tiempo de ultima modificacion del archivo.

Expires por tipo

Descripción

Especifica configuraciones del encabezado Expires para tipos MIME individuales.

Sintaxis

Lista separada por comas de "MIME-type=A|Mseconds". El archivo expirara despues del tiempo base (A|M) mas los segundos especificados.

El tiempo base "A" establece el valor al tiempo de acceso del cliente y "M" al tiempo de ultima modificacion del archivo. MIME-type acepta comodin "*", como image/*.

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.

URI

Descripción

Especifica las URI que usarán este backend WebSocket. El tráfico hacia esta URI solo se reenviará al backend WebSocket cuando contenga una solicitud de upgrade WebSocket.

El tráfico sin esta solicitud de upgrade se reenviará automáticamente al contexto al que pertenece esta URI. Si no existe ningún contexto para esta URI, LSWS tratará este tráfico como si accediera a un contexto estático con la ubicación $DOC_ROOT/URI.

Sintaxis

Una URI simple (que empiece por "/"). Si la URI termina con "/", este backend WebSocket incluirá todas las sub-URI bajo esta URI.

Ejemplo

Usar el proxy WebSocket junto con un contexto permite servir distintos tipos de tráfico de distintas formas en la misma página, optimizando así el rendimiento. Puede enviar el tráfico WebSocket al backend WebSocket y configurar un contexto estático para que LSWS sirva el contenido estático de la página, o un contexto LSAPI para que LSWS sirva contenido PHP (ambas opciones son más eficientes en LSWS que en el backend WebSocket).

Dirección

Descripción

Una dirección de socket única usada por el backend WebSocket. Se admiten sockets IPv4, sockets IPv6 y Unix Domain Sockets (UDS). Los sockets IPv4 e IPv6 pueden usarse para comunicación por red. UDS solo puede usarse cuando el backend WebSocket reside en la misma máquina que el servidor.

Sintaxis

dirección IPv4/IPv6:puerto, UDS://ruta, o unix:ruta

Ejemplo

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

Consejos

Seguridad Si el backend WebSocket se ejecuta en la misma máquina, se prefiere UDS. Si debe usar un socket IPv4 o IPv6, establezca la dirección IP en localhost o 127.0.0.1 para que el backend WebSocket no sea accesible desde otras máquinas.
Rendimiento Unix Domain Sockets generalmente ofrecen mayor rendimiento que los sockets IPv4 o IPv6.