OpenLiteSpeed logo Manual de usuario de OpenLiteSpeed

General del servidor

Ajustes generales para todo el servidor. Cuando un ajuste requiere informacion de ruta, puede ser absoluta o relativa a $SERVER_ROOT. $SERVER_ROOT es la ubicacion donde se instalo el servidor web LiteSpeed (por ejemplo, your_home_dir/lsws o /opt/lsws). El ejecutable del servidor esta en $SERVER_ROOT/bin.

Tabla de contenido

Proceso del servidor

Configuración general

Archivos de índice

Configuración de expiración

Control de Rewrite

Carga de archivos

Base de datos GeoIP MaxMind

Base de datos IP2Location

Nombre del servidor

Descripción

Un nombre unico para este servidor. Si esta vacio, se usara de forma predeterminada el hostname del servidor.

Numero de workers

Descripción

Especifica el numero de workers httpd.

Sintaxis

Valor entero entre 1 y 16.

Consejos

Performance Establezca un numero adecuado para sus necesidades. Agregar mas workers no necesariamente significa mejor rendimiento.

Ejecutando como

Descripción

Especifica el usuario/grupo con el que se ejecuta el proceso del servidor. Esto se establece usando los parametros "--with-user" y "--with-group" al ejecutar el comando configure antes de la instalacion. Para restablecer estos valores, debe volver a ejecutar configure y reinstalar.

Aplicar

Se requiere reinstalar.

Consejos

Security El servidor no debe ejecutarse como un usuario privilegiado como "root". Es critico que el servidor este configurado para ejecutarse con una combinacion de usuario/grupo no privilegiada que no tenga acceso de login/shell. Un usuario/grupo nobody suele ser una buena opcion.

Prioridad

Descripción

Especifica la prioridad de los procesos del servidor. El valor va de -20 a 20. Un numero menor significa mayor prioridad.

Sintaxis

Numero entero

Consejos

Performance Normalmente, una prioridad mayor ofrece un rendimiento web ligeramente mejor en un servidor ocupado. No establezca una prioridad mayor que la de los procesos de base de datos.

Ver también

External App Prioridad, Prioridad CGI

Afinidad de CPU

Descripción

La afinidad de CPU vincula un proceso a una o mas CPU (nucleos). Es beneficioso que un proceso use siempre la misma CPU porque asi puede aprovechar los datos que quedan en la cache de CPU. Si el proceso se mueve a otra CPU, no se usa la cache de CPU y se requiere sobrecarga innecesaria.

La opcion Afinidad de CPU controla con cuantas CPU (nucleos) se asociara un proceso de servidor. El valor minimo es 0, que deshabilita esta funcion. El valor maximo es el numero de nucleos del servidor. Por lo general, 1 es la mejor opcion porque crea el uso mas estricto de afinidad de CPU y aprovecha mejor la cache de CPU.

Valor predeterminado: 0

Sintaxis

Valor entero de 0 a 64. (0 deshabilitara esta funcion)

Aplicar

Se requiere reinstalar.

CloudLinux

Descripción

Especifica si se debe habilitar Lightweight Virtual Environment (LVE) de CloudLinux cuando existe. Puede usar LiteSpeed con LVE para lograr una mejor gestion de recursos. Para mas informacion, consulte http://www.cloudlinux.com.

Sintaxis

Seleccionar de la lista desplegable

Tamano del buffer de E/S de memoria

Descripción

Especifica el tamano maximo de buffer usado para almacenar el cuerpo de la solicitud y su respuesta generada dinamicamente. Cuando se alcanza este limite, el servidor empezara a crear archivos temporales de swapping bajo Directorio de swapping.

Sintaxis

Número entero

Consejos

Performance Establezca un tamano de buffer suficientemente grande para alojar todas las solicitudes/respuestas concurrentes y evitar swapping de memoria a disco. Si hay actividad frecuente de E/S en el directorio swap, de forma predeterminada /tmp/lshttpd/swap/, este tamano de buffer es demasiado bajo y LiteSpeed esta haciendo swapping a disco.

Ver también

Directorio de swapping

Directorio de swapping

Descripción

Especifica el directorio donde deben colocarse los archivos de swapping. Cuando el servidor se inicia en modo chroot, este directorio es relativo al nuevo directorio raiz; de lo contrario, es relativo al directorio raiz real.

El servidor usa su propia memoria virtual para reducir el uso de memoria del sistema. La memoria virtual y el disk swapping se usan para almacenar cuerpos de solicitud grandes y respuestas generadas dinamicamente. El directorio de swapping debe colocarse en un disco con espacio suficiente.

Valor predeterminado: /tmp/lshttpd/swap

Sintaxis

Ruta absoluta

Consejos

Performance Coloque el directorio de swapping en un disco separado o aumente el tamano del buffer de E/S de memoria para eliminar el swapping.

Ver también

Tamano del buffer de E/S de memoria

Corregir automaticamente error 503

Descripción

Especifica si se debe intentar corregir el error "503 Service Unavailable" reiniciando el servidor de forma graceful. Un error "503" suele estar causado por aplicaciones externas defectuosas y un reinicio del servidor web a menudo puede corregir temporalmente el error. Si esta habilitado, el servidor se reiniciara automaticamente cuando haya mas de 30 errores "503" en un periodo de 30 segundos.

Valor predeterminado: No

Sintaxis

Seleccionar desde botones de opción

Habilitar HTTP/2 sobre TCP en claro

Descripción

Especifica si se debe habilitar HTTP/2 sobre conexiones TCP no cifradas. El valor predeterminado es deshabilitado.

Sintaxis

Seleccionar desde botones de opción

Timeout de reinicio graceful (seg)

Descripción

Durante un reinicio graceful, incluso despues de que la nueva instancia del servidor este activa, la instancia anterior continuara gestionando las solicitudes existentes. Este timeout define cuanto tiempo debe esperar la instancia anterior antes de salir. El valor predeterminado es 300 segundos. -1 significa esperar para siempre. 0 significa no esperar y abortar inmediatamente.

Sintaxis

Número entero

Directorio de salida de estadisticas

Descripción

El directorio donde se escribira el archivo de informe de Real-Time Stats. El directorio predeterminado es /tmp/lshttpd/ .

Sintaxis

Ruta absoluta

Consejos

Information Durante la operacion del servidor, el archivo .rtreport se escribira cada segundo. Para evitar escrituras de disco innecesarias, establezca esto en un RAM Disk.
El archivo .rtreport puede usarse con software de monitoreo de terceros para supervisar la salud del servidor.

Generar informes JSON

Descripción

Genera archivos de informe adicionales con formato JSON, con extension .json, en el directorio /tmp/lshttpd.

Valor predeterminado: No

Sintaxis

Seleccionar desde botones de opción

Ejemplo

Cuando se establece en Yes, se crearan archivos de informe .status.json y .rtreport.json, .rtreport.2.json, etc., ademas de los archivos habituales .status y .rtreport, .rtreport.2, etc.

Consejos

Information Esto es util para desarrolladores de aplicaciones que deseen integrar informes de estado y tiempo real de LiteSpeed en sus aplicaciones usando herramientas estandar de procesamiento JSON integradas en la mayoria de lenguajes de programacion.

Configuracion MIME

Descripción

Especifica el archivo que contiene la configuracion MIME para este servidor. Siempre es relativo a la raiz real cuando se proporciona una ruta absoluta en modo chroot. Haga clic en el nombre de archivo para ver/editar las entradas MIME detalladas.

Sintaxis

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

Consejos

Information Haga clic en el nombre de archivo para editar la configuracion MIME.

Sufijos

Descripción

Puede listar varios sufijos para el mismo tipo MIME, usando comas para separarlos.

Tipo MIME

Descripción

Un tipo MIME consta de un tipo y subtipo con el formato "type/subtype".

Deshabilitar rotacion inicial de logs

Descripción

Especifica si se debe habilitar/deshabilitar la rotacion del archivo de log de errores del servidor al inicio. La rotacion inicial de logs esta habilitada de forma predeterminada cuando se usa el valor "Not Set".

Sintaxis

Seleccionar desde botones de opción

Firma del servidor

Descripción

Especifica si se debe mostrar la firma del servidor y el numero de version en el valor "Server" del encabezado de respuesta. Hay tres opciones: cuando se establece en Hide Version, solo se muestra LiteSpeed. Cuando se establece en Show Version, se muestran LiteSpeed y el numero de version. Cuando se establece en Hide Full Header, no se mostrara todo el encabezado Server en el encabezado de respuesta.

Sintaxis

Seleccionar de la lista desplegable

Consejos

Security Establezcalo en Hide Version si no desea exponer el numero de version del servidor.

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,

Usar IP de cliente en el encabezado

Descripción

Especifica si se debe usar la primera direccion IP mas valida listada en el encabezado de solicitud HTTP "X-Forwarded-For" para todas las funciones relacionadas con direccion IP, incluida la limitacion de conexiones/ancho de banda, control de acceso y geolocalizacion IP.

Esta funcion es util si su servidor web esta detras de un load balancer o un servidor proxy. Si selecciona Trusted IP Only, la IP de X-Forwarded-For se usara solo cuando la solicitud provenga de IPs confiables definidas en Lista permitida a nivel de servidor.

Keep Header from Trusted IP es igual a Trusted IP Only, pero el encabezado X-Forwarded-For usado para el backend no se modificara para incluir la direccion del peer que se conecta.

Use Last IP (for AWS ELB) usara la ultima direccion IP en la lista "X-Forwarded-For". Seleccione esta opcion si usa AWS Elastic Load Balancer o espera que la IP real se agregue al final de la lista "X-Forwarded-For".

Sintaxis

Seleccionar de la lista desplegable

Email del administrador

Descripción

Especifica las direcciones de email del administrador del servidor. Si se especifican, los administradores seran notificados por email sobre eventos importantes (por ejemplo, cuando el servicio LiteSpeed se reinicia automaticamente debido a deteccion de bloqueo o cuando la licencia esta por expirar).

Sintaxis

Lista de direcciones de email separada por comas.

Consejos

Information La funcion de alerta por email solo funcionara si el servidor tiene un servidor MX activo como postfix, exim o sendmail.

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

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 automatica desde .htaccess

Descripción

Carga automaticamente reglas rewrite contenidas en el archivo .htaccess de un directorio al acceder por primera vez a ese directorio si aun no existe un HttpContext para ese directorio que use la directiva rewritefile. Una vez cargado inicialmente, debe realizarse un reinicio graceful para que cualquier cambio posterior en ese archivo .htaccess tenga efecto.

La opcion de nivel Virtual Host reemplaza la opcion de nivel Servidor. Valores predeterminados:

Nivel Servidor: No

Nivel VH: Heredar configuracion de nivel Servidor

Sintaxis

Seleccionar desde botones de opción

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.

Base de datos GeoIP MaxMind

Descripción

Aqui se pueden especificar varias bases de datos de geolocalizacion MaxMind. MaxMind tiene los siguientes tipos de bases de datos: Country, Region, City, Organization, ISP y Netspeed. Si se configuran varias bases de datos de tipos "Country", "Region" y "City", la ultima configuracion sera efectiva.

Ruta del archivo DB

Descripción

Especifica la ruta a la base de datos GeoIP de MaxMind.

Sintaxis

Ruta absoluta

Ejemplo

/usr/local/share/GeoIP/GeoLite2-Country.mmdb

Nombre de DB

Descripción

Nombre de base de datos GeoIP de MaxMind. A partir de GeoIP2, esta opcion es obligatoria.

Al actualizar de GeoIP a GeoIP2, usar los valores "COUNTRY_DB", "CITY_DB" o "ASN_DB" para esta opcion completara automaticamente la variable PHP $_SERVER con algunas entradas compatibles con GeoIP (listadas abajo por valor de DB Name) para facilitar esta transicion.

CITY_DB: 'GEOIP_COUNTRY_CODE', 'GEOIP_COUNTRY_NAME', 'GEOIP_CONTINENT_CODE', 'GEOIP_COUNTRY_CONTINENT', 'GEOIP_DMA_CODE', 'GEOIP_METRO_CODE', 'GEOIP_LATITUDE', 'GEOIP_LONGITUDE', 'GEOIP_POSTAL_CODE', y 'GEOIP_CITY'.
COUNTRY_DB: 'GEOIP_COUNTRY_CODE', 'GEOIP_COUNTRY_NAME', 'GEOIP_CONTINENT_CODE', y 'GEOIP_COUNTRY_CONTINENT'.
ASN_DB: 'GEOIP_ORGANIZATION' y 'GEOIP_ISP'.

Ejemplo

COUNTRY_DB

Variables de entorno

Descripción

Asigna los resultados de busquedas en la base de datos a variables de entorno.

Sintaxis

Variable_Name mapped_DB_data

Una entrada por linea. La ruta a los datos puede usar claves de mapa o indices de arreglo basados en 0, ambos separados por /.

Ejemplo

COUNTRY_CODE COUNTRY_DB/country/iso_code
REGION_CODE CITY_DB/subdivisions/0/iso_code

Ruta del archivo DB IP2Location

Descripción

La ubicacion de un archivo de base de datos valido.

Sintaxis

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

Tipo de cache de DB

Descripción

El metodo de cache usado. El valor predeterminado es Memory.

Sintaxis

Seleccionar de la lista desplegable