OpenLiteSpeed logo Manual de usuario de OpenLiteSpeed

Host virtual - General

Tabla de contenido

Configuración principal

Registro del host virtual

Registro de acceso

Archivos de índice

Paginas de error personalizadas

Configuración de expiración

Carga de archivos

Manejador de scripts

Configuración de expiración

Anulación de PHP INI

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 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

Habilitar compresión

Descripción

Especifica si se habilita la compresión GZIP para este virtual host. Este ajuste solo es efectivo cuando Habilitar compresión está configurado como Yes a nivel de servidor.

Sintaxis

Seleccionar desde botones de opción

Ver también

Habilitar compresión

Habilitar busqueda GeoLocation

Descripción

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 Disabled 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

Performance 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

Performance 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

Information 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

Information 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

Performance 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

Performance 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

Performance 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 Yes, 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 indice

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

Performance 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 indice 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

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

Ver también

Archivos indice, 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 indice 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 indice, Índice automático

Paginas 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

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/*.

Carga de archivos

Descripción

Proporciona funciones de seguridad adicionales al cargar archivos mediante un Request Body Parser que analiza los archivos hacia un directorio local del servidor, donde modulos de terceros pueden escanearlos facilmente en busca de intencion maliciosa. Request Body Parser se usa cuando Pasar datos de carga por ruta de archivo esta habilitado o cuando un modulo llama a set_parse_req_body de LSIAPI en el nivel LSI_HKPT_HTTP_BEGIN. Se proporcionan ejemplos de API en el paquete fuente.

Ver también

Prioridad de Hook::HTTP_BEGIN

Ruta de archivo temporal

Descripción

Directorio temporal donde se almacenarán los archivos que se cargan al servidor mientras trabaja el analizador del cuerpo de la solicitud. El valor predeterminado es /tmp/lshttpd/.

Sintaxis

Ruta absoluta o ruta que empiece por $SERVER_ROOT (para niveles de servidor y VHost) o $VH_ROOT (para niveles de VHost).

Permiso de archivo temporal

Descripción

Determina los permisos de archivo usados para los archivos almacenados en el directorio temporal. El ajuste de nivel de servidor es global y puede sobrescribirse a nivel de VHost.

Sintaxis

Número octal de 3 dígitos. El valor predeterminado es 666.

Pasar datos de carga por ruta de archivo

Descripción

Especifica si se deben pasar o no los datos de archivo cargado por ruta. Si esta habilitado, la ruta del archivo junto con otra informacion se envia al backend handler en lugar del archivo mismo durante la carga. Esto ahorra recursos de CPU y tiempo de transferencia de archivos, pero requiere algunas actualizaciones en el backend para implementarlo. Si esta deshabilitado, el contenido del archivo se transferira al backend handler; el cuerpo de la solicitud aun se analiza en archivos.

Sintaxis

Seleccionar desde botones de opción

Consejos

Performance Habilite esto para acelerar el procesamiento de carga de archivos si la compatibilidad hacia atras no es un problema.

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

Information 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 Configuracion MIME.
Aunque se enumeran sufijos en este campo, los manejadores de scripts usan tipos MIME, no sufijos, para decidir qué scripts gestionar.
PerformanceSecurity 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, Web Server (Proxy), Fast CGI, SCGI, CGI, Load balancer, Servlet Engine, uWSGI o Module Handler. Excepto para los tipos de manejador CGI y Module Handler, 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

Anulación de php.ini

Descripción

Se usa para sobrescribir ajustes de php.ini en el contexto actual (nivel de virtual host o nivel de contexto).

Las directivas admitidas son:
php_value
php_flag
php_admin_value
php_admin_flag

Todas las demás líneas/directivas se ignorarán.

Sintaxis

La sintaxis de anulación es similar a Apache: una lista de directivas y sus valores separada por saltos de línea, con cada directiva precedida por php_value, php_flag, php_admin_value o php_admin_flag según corresponda.

Ejemplo

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