服务器常规

描述

此服务器的唯一名称。可以使用$HOSTNAME作为值。

语法

文本

描述

[仅适用于Web Host Elite许可证]
指定lshttpd worker的数量。 输入0以自动确定此数字。

语法

0到128之间的整数。

提示

性能 设置适当的数字以满足您的需求。 添加更多的进程不一定意味着更好 性能。

描述

指定服务器进程运行所使用的用户/组。 该值在安装期间设置。要更改它，必须下载安装包并通过命令行执行升级。

应用

需要重新安装。

提示

安全 服务器不应以特权用户（如“root”）运行。 请务必将服务器配置为以没有登录/shell访问权限的非特权用户/组组合运行。通常，用户和组使用nobody是不错的选择。

描述

指定服务进程的优先级。数值范围从 -20 到 20。数值越小，优先级越高。

语法

整数

提示

性能 通常，较高的优先级会导致繁忙的服务器上的Web性能稍有提高。 不要将优先级设置为高于数据库进程的优先级。

另请参阅

External App 优先级, CGI优先级

描述

CPU关联将进程绑定到一个或多个CPU（核心）。 始终使用同一CPU对进程来说是有益的，因为这样进程可以利用CPU缓存中剩余的数据。 如果进程移至其他CPU，则不会使用CPU缓存，并且会产生不必要的开销。

CPU Affinity设置控制一个服务器进程将与多少个CPU（核心）相关联。 最小值为0，它将禁用此功能。 最大值是服务器具有的核心数。 通常，1是最佳设置，因为它会最严格地使用CPU亲和力，从而最大程度地利用CPU缓存。

默认值：0

语法

0到64之间的整数。（0将禁用此功能）

应用

需要重新安装。

描述

Enterprise Edition Only 指定chroot环境的根目录。 只有Root用户可以在chroot模式下运行LiteSpeed。是否在chroot环境模式下运行是由 启用Chroot选项控制的。安装程序会自动设置初始chroot环境。 此条目是只读的，如果你想改变它，请在命令行中重新运行安装程序。

在chroot环境中，LiteSpeed及其子进程不能访问chroot监狱以外 的文件系统。Chroot的是一种高级安全功能，可能需要额外的配置以 使其正常工作。所有需要的可执行文件，库文件，配置文件和设备文件应 在chroot监狱中重新创建。

由于根目录发生了变化，当使用绝对路径时，你需要特别注意路径配置 。Unix域套接字或交换目录总是基于 新根目录的相对路径。所有其他路径配置总是基于真正的根目录。

应用

需要重新安装。

提示

安全 使用chroot更安全。

描述

Enterprise Edition Only 指定是否在chroot模式启动LiteSpeed。 新的根目录路径通过安装时对Chroot路径的配置来指定。

语法

布尔值

描述

指定当CloudLinux存在时是否启用CloudLinux的轻量级虚拟 环境（LVE）。您可以搭配使用LiteSpeed与LVE实现更好的资源管理。 欲了解更多信息，请访问 http://www.cloudlinux.com。

语法

从下拉列表选择

描述

指定用于存储请求内容和相应的动态响应的最大缓冲区大小。达到此限制时， 服务器将在交换目录中创建临时交换文件。

语法

非负整数

提示

性能 设置足够大的缓冲区，以容纳所有并发 请求/响应，避免内存和磁盘数据交换。如果交换目录（默认为/tmp/lshttpd/swap/）存在频繁的读写活动，说明缓冲区太小，LiteSpeed正在使用交换文件。

另请参阅

交换目录

描述

指定交换文件的存放目录。 服务器在chroot模式启动时，该路径相对于新的根目录， 否则，它相对于真正的根目录。

LiteSpeed使用自己的虚拟内存 以降低系统的内存使用量。虚拟内存和磁盘交换会用来存储大的请求内容和 动态响应。交换目录应设置在有足够剩余空间的磁盘上。

默认值: /tmp/lshttpd/swap

语法

路径

提示

性能 将交换目录设置在一个单独的磁盘上，或者增加最大读写缓冲区大小以避免交换。

另请参阅

内存读写缓冲区大小

描述

指定是否尝试通过平滑重启服务器来修复“503 Service Unavailable”错误。 “503”错误通常由发生故障的外部应用程序引起，重启Web服务器通常可以临时修复该错误。 如果启用，当30秒内出现超过30个“503”错误时，服务器将自动重启。

默认值：否

语法

从单选框中选择

描述

指定是否通过非加密TCP连接启用HTTP/2。 默认设置为禁用。

语法

布尔值

描述

平滑重启时，即使新的服务器实例已经启动，旧的实例仍将继续 处理现有的请求。此项超时设置定义了旧实例等待多长时间后中止。 默认值是300秒。 -1表示永远等待。 0表示不等待，立即中止。

语法

整数

描述

为此服务器指定包含MIME设置的文件。 在chroot模式中提供了绝对路径时，该文件路径总是相对于真正的根。 点击文件名可查看/编辑详细的MIME项。

语法

文件路径

提示

信息 点击文件名可编辑MIME设置。

描述

你可以列出相同MIME类型的多个后缀，用逗号分隔。

描述

MIME类型由类型和子类型组成，格式为“类型/子类型”.

描述

指定是否在启动时禁用服务器错误日志文件轮换。标准安装默认启用初始日志轮换。 但是，使用cPanel的服务器始终写入Apache错误日志，因此会忽略此设置。

语法

布尔值

描述

指定是否在响应头的Server参数中显示服务器签名和版本号。 有三个选项：当设置为隐藏版本时，只显示LiteSpeed。当设置为 显示版本，显示LiteSpeed和版本号。 Enterprise Edition Only 设置为隐藏全部头时，整个Server头都不会显示在响应报头中。

语法

从下拉列表选择

提示

安全 如果你不想暴露服务器的版本号，设置为隐藏版本。

描述

指定是否在默认的错误页面显示以下内容

Powered By LiteSpeed Web Server.
LiteSpeed Technologies is not responsible for administration and contents of this web site!"

语法

布尔值

描述

Enterprise Edition Only 指定是否启用IP地理定位查找。 可以在服务器、虚拟主机或上下文级别设置。使用“Not Set”值时，默认禁用IP地理定位。

语法

布尔值

另请参阅

使用报头中的客户端IP, 数据库文件路径,

描述

指定是否将在HTTP请求报头中的X-Forwarded-For参数列出的IP地址，用于 所有的IP地址相关的功能，包括 连接/带宽限制、访问控制和IP地理定位。

如果你的Web服务器放置在负载均衡器或代理服务器之后，此功能非常有用。 如果您选择了“仅限受信任的IP”，只有在请求来自受信任IP时，X-Forwarded-For 中的IP才会被使用。受信任IP可在服务器级别的允许列表中定义。

保留来自受信任IP的头部与仅限受信任的IP相同，但是用于后端的X-Forwarded-For头不会被修改为包含连接对端地址。

使用最后一个IP（对于AWS ELB）将使用“X-Forwarded-For”列表中的最后一个IP地址。如果您正在使用AWS Elastic Load Balancer，或期望真实IP被追加到“X-Forwarded-For”列表末尾，请选择此选项。

语法

从下拉列表选择

描述

当客户端断开与服务器的连接时，LiteSpeed Web Server可以自动终止正在为该客户端生成响应的外部应用程序进程。不过，有些用户可能有一些长时间运行的进程，希望无论客户端是否仍然连接都继续运行。

此设置有三个选项：

• 不终止：绝不因为连接断开而终止外部应用程序。
• 仅终止来自外部IP的请求：只有由外部IP请求启动的进程才会因为连接断开而被自动终止。这是默认设置。如果有一些内部长时间运行的进程，例如某些cron作业，这是一个合适的设置。
• 终止所有请求：无论请求来源如何，只要连接断开，外部应用程序进程都会被自动终止。

语法

从下拉列表选择

描述

指定更新进程检查新版本的周期。可以选择“每天”，“每周”或“每月”,或者是禁用.

语法

从下拉列表选择

描述

指定当新版本可用时是否自动下载新版本的文件。如果一个新文件已经成功下载，可以在WebAdmin 控制台的 服务管理器 - 版本管理中一键在线升级。

语法

从下拉列表选择

描述

指定服务器管理员的电子邮箱地址。 如果设置了电子邮箱地址，管理员将收到重要事件的电子邮件通知（例如， LiteSpeed服务因崩溃而自动重启或者授权即将过期）。

语法

以逗号分隔的电子邮件地址列表。

提示

信息 电子邮件提醒功能只有在服务器有活动的MX服务器（如postfix、exim或sendmail）的情况下才会生效。

描述

指定URL映射到目录时按顺序查找的索引文件名称。 您可以在服务器、虚拟主机和上下文级别对其进行自定义。

语法

以逗号分隔的索引文件名列表。

提示

性能 只设置你需要的索引文件。

描述

在目录中，当索引文件中所列的索引文件不可用时，指定运行时是否即时生成目录索引。
此选项可以在虚拟主机级别和Context级别中设置，并可以顺着目录树继承，直到被显式覆盖。 您可以自定义生成的索引页面。请查看在线Wiki操作指南。

语法

布尔值

提示

安全 建议尽可能关闭自动索引，以防止泄露机密数据。

另请参阅

索引文件, 自动索引URI

描述

在目录中，当索引文件中所列出的索引文件（index）不可用时，指定用来生成索引页面的URI。 LiteSpeed Web服务器使用一个外部脚本来生成索引页面，从而为定制提供最大的灵活性。 默认的脚本生成一个类似于Apache的索引页面。 如需自定义生成的索引页面，请查看在线Wiki操作指南。 待索引目录会通过环境变量"LS_AI_PATH"传递给脚本。

语法

URI

另请参阅

索引文件, 自动索引

描述

目录级访问控制文件（.htaccess文件）支持以下指令。

• 认证
  • AuthGroupFile
  • AuthName
  • AuthType
  • AuthUserFile
  • Require
  • Satisfy
  • <Limit>（仅GET、HEAD、POST）
  • <LimitExcept>（仅GET、HEAD、POST）
• 访问控制
  • Allow
  • Deny
  • Order
  • <Limit>（仅GET、HEAD、POST）
  • <LimitExcept>（仅GET、HEAD、POST）
• 文件信息
  • AddDefaultCharset
  • AddType
  • DefaultType
  • ForceType
  • Redirect
  • RedirectPermanent
  • RedirectTemp
  • RewriteBase
  • RewriteCond
  • RewriteEngine
  • RewriteOptions
  • RewriteRule
• 其他
  • DirectoryIndex
  • ExpiresActive
  • ExpiresByType
  • ExpiresDefault
  • Options

描述

指定访问控制文件中允许使用哪些指令。访问控制文件可以放在目录中，用于控制该目录下文件的可访问性。

• 如果未勾选任何选项，将使用继承的默认设置。
• 如果勾选无，访问控制文件将被忽略。
• 如果勾选限制，将允许使用"Allow"、"Deny"和"Order"指令。也允许使用<Limit>和<LimitExcept>指令，但仅有限支持GET、HEAD和POST请求。
• 如果勾选认证，将允许使用"AuthGroupFile"、"AuthName"、"AuthType"、"AuthUserFile"、"Require"和"Satisfy"指令。也允许使用<Limit>和<LimitExcept>指令，但仅有限支持GET、HEAD和POST请求。
• 如果勾选文件信息，将允许使用"AddDefaultCharset"、"AddType"、"DefaultType"、"ForceType"、"Redirect"、"RedirectPermanent"、"RedirectTemp"、"RewriteBase"、"RewriteCond"、"RewriteEngine"、"RewriteOptions"和"RewriteRule"指令。
• 如果勾选索引，将允许使用"DirectoryIndex"、"ExpiresActive"、"ExpiresByType"和"ExpiresDefault"指令。
• 如果勾选选项，将允许使用"Options"指令。

语法

复选框

提示

性能 如果不需要目录级配置自定义，请勾选无。

描述

指定访问控制文件的名称。只有启用允许覆盖时才会使用这些文件。默认名称为.htaccess。可以在服务器级别和虚拟主机级别配置此项。服务器级别为默认设置，虚拟主机级别可以覆盖它。

语法

以"."开头的文件名

另请参阅

允许覆盖

描述

指定是否为静态文件生成Expires头。如果启用，将根据 默认过期和按类型过期生成Expires头。

这可以在服务器、虚拟主机和上下文级别设置。低级别的设置将 覆盖高级别的设置。例如，上下文级别的设置将覆盖虚拟主机级别的设置， 虚拟主机级别的设置将覆盖服务器级别的设置。

语法

布尔值

描述

指定生成Expires头的默认设置。该设置在启用过期 设为“启用”时有效。它可以被按类型过期覆盖。 除非必要，否则不要在服务器或虚拟主机级别设置该默认值。 因为它会为所有网页生成Expires头。大多数时候，应该是 为不常变动的某些目录在上下文级别设置。如果没有默认设置，按类型过期中未指定的类型不会生成Expires头。

语法

A|Mseconds
文件将在基准时间（A|M）加指定秒数的时间后失效。 “A”代表基准时间为客户端的访问时间，“M”代表文件的最后修改时间。

描述

为各个MIME类型分别指定Expires头设置。

语法

逗号分隔的“MIME-类型=A|M秒数”的列表。 文件将在基准时间（A|M）加指定秒数的时间后失效。

“A”代表基准时间为客户端的访问时间，“M”代表文件的最后修改时间。 MIME-类型可使用通配符“*”，如image/*。

描述

多个MaxMind地理定位数据库可以在这里指定。MaxMind有以下数据库类型: 国家，地区，城市，组织，ISP和NETSPEED。如果混合配置“国家”，“地区”，和“城市”类型数据库，则最后一项将会生效。

描述

指定MaxMind GeoIP数据库路径。

语法

路径

示例

描述

MaxMind GeoIP数据库名称。从GeoIP2开始，此设置是必需的。

从GeoIP升级到GeoIP2时，将此设置设为"COUNTRY_DB"、"CITY_DB"或"ASN_DB"，会自动使用一些与GeoIP兼容的条目（在下面的数据库名称值中列出）填充PHP的$_SERVER变量，以简化迁移。
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'和'GEOIP_CITY'。
COUNTRY_DB: 'GEOIP_COUNTRY_CODE', 'GEOIP_COUNTRY_NAME', 'GEOIP_CONTINENT_CODE', 和'GEOIP_COUNTRY_CONTINENT'。
ASN_DB: 'GEOIP_ORGANIZATION'和'GEOIP_ISP'。

语法

文本

示例

描述

将数据库查找的结果分配给环境变量。

语法

Variable_Name mapped_DB_data

每行一个条目。数据路径可以使用映射键或从0开始的数组索引，两者都用/分隔。

示例

描述

有效数据库文件的位置。

语法

文件路径

描述

使用的缓存方法。 默认值为Memory。

语法

从下拉列表选择

描述

指定LiteSpeed是否读取并使用Apache配置文件来配置Web服务器。当LiteSpeed内部配置与基于Apache的配置发生冲突时，原生配置具有更高优先级。

语法

布尔值

描述

指定如何应用Apache配置更改。设置为"Yes"时，只要Apache配置文件被修改，LSWS就会执行平滑重启。在更新Apache配置时，这可能导致LSWS多次重启。更好的方案（3.3.8版本引入）是"Use Apache binary wrapper"。它会用包装脚本替换Apache httpd二进制文件。每当请求Apache启动、停止或重启时，该脚本都会通知LSWS执行相应操作。 要使用此设置，必须设置Apache二进制文件路径。对于标准安装，默认值为"No"。对于cPanel服务器，默认值为"Use Apache binary wrapper"。 （"Override cPanel restart HTTPD script"是一个可选的变通方案，仅应在"Use Apache binary wrapper"选项出现问题时使用。） 对于其他控制面板，默认值为"Yes"。

语法

布尔值

另请参阅

Apache二进制文件路径

描述

指定Apache二进制文件的位置。通常位于/usr/local/apache/bin/httpd或/usr/local/apache2/bin/httpd等位置。当更改时自动重新加载使用"Use Apache binary wrapper"时，必须设置此选项。

另请参阅

更改时自动重新加载

描述

指定Apache配置文件的位置。通常位于/usr/local/apache/conf/httpd.conf或/etc/httpd/conf/httpd.conf。

描述

指定要添加到Apache配置文件中监听TCP端口的偏移值。在测试阶段，这允许LiteSpeed与Apache在不同端口上并行运行，而无需在生产服务器上来回切换LiteSpeed和Apache。
如果设置为0或未设置，LiteSpeed将使用Apache配置文件中指定的端口。测试时，请将此设置设为非零值。LiteSpeed会将此偏移值加到Apache配置中指定的端口并使用得到的端口。确认一切正常后，可以停止Apache，将此选项改回0，然后重启LiteSpeed。

描述

指定要添加到Apache配置文件中监听IP地址的偏移值。这样在测试阶段LiteSpeed可以与Apache并行运行，而无需在生产服务器上来回切换LiteSpeed和Apache。计算得到的IP地址必须在此服务器上可用。

语法

偏移值应设置为整数（允许负数），而不是IP地址。加上"256"会使C类子网的值增加1。此选项仅适用于IPv4地址。

描述

指定要传递给后端Apache处理的资源。此功能要求Apache与LiteSpeed在另一个IP或不同端口上并行运行，因此"Apache端口偏移"或"Apache IP偏移"应设置为非零值。

语法

资源通过逗号分隔的URI、文件后缀或正则表达式列表指定。URI以"/"开头；后缀以"."开头；正则表达式以"exp:"开头。例如："/svn/, .shtml"表示让Apache处理URI以"/svn/"开头或以".shtml"结尾的请求。使用正则表达式"exp:^/svn/, exp:\.shtml$"也可以达到相同效果。

描述

指定LiteSpeed解析Apache配置文件时应忽略的Apache模块名称列表。LiteSpeed会将列出的模块视为不支持。这会使匹配的<IfModule>或<IfDefined>标签中与这些模块相关的配置指令被忽略。

语法

以逗号分隔的模块名称列表

描述

启用即时配置后，Web服务器不会在启动时加载所有配置，而是在虚拟主机首次被访问时才最终确定该虚拟主机的配置。这样可以节省内存并加快服务器启动速度。

语法

布尔值

描述

指定当虚拟主机设置了"user"和"group"时，是否以suEXEC模式运行PHP脚本。设置为是时，PHP脚本将在指定的用户（以及组，除非设置了强制GID）身份下执行。设置为仅用户主目录时，用户主目录之外的脚本将以Web服务器运行所用的全局用户/组身份运行。使用DirectAdmin时，建议使用仅用户主目录。默认值为否。

语法

布尔值

另请参阅

强制GID

描述

指定以suEXEC模式运行PHP脚本时，LSWS可为每个用户创建的最大并发PHP进程数。默认值为5。

语法

非负整数

提示

信息 此限制按每个lshttpd进程的每个用户计算。因此，如果您有2-CPU许可证，此限制将加倍；如果是4-CPU许可证，则为4倍，依此类推。

描述

指定是否显式启用Microsoft FrontPage Server Extension。通常，当Apache httpd.conf中加载了"frontpage"模块时，LSWS会启用它。但是，当mod_frontpage静态链接到Apache二进制文件中时，FrontPage模块的配置不在httpd.conf中，因此需要在此处显式启用。默认值为"disabled"。

语法

布尔值

描述

对于Apache配置文件中使用的shell环境变量，LSWS会用此处设置的值替换"${ENVVAR}"。如果此处未设置ENVVAR变量，"${ENVVAR}"出现的位置将保持不变。

语法

名称和值对，每行一对，格式为ENV=VALUE

另请参阅

Apache Env Syntax reference

描述

指定要在LiteSpeed原生配置文件中使用的Apache配置指令（LiteSpeed支持的指令）。例如，要覆盖默认PHP配置（php.ini条目），服务器需要使用四个指令："php_value"、"php_flag"、"php_admin_value"和"php_admin_flag"。

语法

与Apache配置文件相同。