OpenLiteSpeed用户手册
服务器常规
目录
服务器进程
常规设置
索引文件
Expires设置
重写控制
文件上传
IP地理定位数据库
IP2Location 数据库
运行方式
描述
指定服务器进程运行所使用的用户/组。该值在安装前运行configure命令时，通过“--with-user”和“--with-group”参数设置。要重置这些值，必须重新运行configure命令并重新安装。
应用
需要重新安装。
提示
[安全] 服务器不应以特权用户（如“root”）运行。 请务必将服务器配置为以没有登录/shell访问权限的非特权用户/组组合运行。通常，用户/组使用nobody是不错的选择。
优先级
描述
指定服务进程的优先级。数值范围从 -20 到 20。数值越小，优先级越高。
语法
整数
提示
[性能] 通常，较高的优先级会导致繁忙的服务器上的Web性能稍有提高。 不要将优先级设置为高于数据库进程的优先级。
另请参阅
处理器亲和性
描述
CPU关联将进程绑定到一个或多个CPU（核心）。 始终使用同一CPU对进程来说是有益的，因为这样进程可以利用CPU缓存中剩余的数据。 如果进程移至其他CPU，则不会使用CPU缓存，并且会产生不必要的开销。
CPU Affinity设置控制一个服务器进程将与多少个CPU（核心）相关联。 最小值为0，它将禁用此功能。 最大值是服务器具有的核心数。 通常，1是最佳设置，因为它会最严格地使用CPU亲和力，从而最大程度地利用CPU缓存。
默认值：0
语法
0到64之间的整数。（0将禁用此功能）
应用
需要重新安装。
CloudLinux
描述
指定当CloudLinux存在时是否启用CloudLinux的轻量级虚拟 环境（LVE）。您可以搭配使用LiteSpeed与LVE实现更好的资源管理。 欲了解更多信息，请访问 http://www.cloudlinux.com。
语法
从下拉列表选择
内存读写缓冲区大小
描述
指定用于存储请求内容和相应的动态响应的最大缓冲区大小。达到此限制时， 服务器将在交换目录中创建临时交换文件。
语法
非负整数
提示
[性能] 设置足够大的缓冲区，以容纳所有并发 请求/响应，避免内存和磁盘数据交换。如果交换目录（默认为/tmp/lshttpd/swap/）存在频繁的读写活动，说明缓冲区太小，LiteSpeed正在使用交换文件。
另请参阅
交换目录
描述
指定交换文件的存放目录。 服务器在chroot模式启动时，该路径相对于新的根目录， 否则，它相对于真正的根目录。
LiteSpeed使用自己的虚拟内存 以降低系统的内存使用量。虚拟内存和磁盘交换会用来存储大的请求内容和 动态响应。交换目录应设置在有足够剩余空间的磁盘上。
默认值: /tmp/lshttpd/swap
语法
路径
提示
[性能建议] 将交换目录设置在一个单独的磁盘上，或者增加最大读写缓冲区大小以避免交换。
另请参阅
自动修复503错误
描述
指定是否尝试通过平滑重启服务器来修复“503 Service Unavailable”错误。 “503”错误通常由发生故障的外部应用程序引起，重启Web服务器通常可以临时修复该错误。 如果启用，当30秒内出现超过30个“503”错误时，服务器将自动重启。
默认值：No
语法
从单选框中选择
平滑重启超时时长(secs)
描述
平滑重启时，即使新的服务器实例已经启动，旧的实例仍将继续 处理现有的请求。此项超时设置定义了旧实例等待多长时间后中止。 默认值是300秒。 -1表示永远等待。 0表示不等待，立即中止。
语法
整数
统计输出目录
描述
实时统计报告文件将写入的目录。 默认目录是 /tmp/lshttpd/ .
语法
路径
提示
Information 在服务器操作期间，.rtreport文件将每秒写入一次。 为避免不必要的磁盘写入，请将其设置为RAM磁盘。
.rtreport文件可以与第三方监控软件一起使用，以跟踪服务器的运行状况。
输出JSON报告
描述
将带有.json扩展名的其他JSON格式报告文件输出到/tmp/lshttpd目录。
默认值：No
语法
从单选框中选择
示例
提示
[信息] 这对应用程序开发者很有用，他们可能希望使用大多数编程语言内置的标准JSON 处理工具，将LiteSpeed状态和实时报告集成到自己的应用程序中。
MIME设置
描述
为此服务器指定包含MIME设置的文件。 在chroot模式中提供了绝对路径时，该文件路径总是相对于真正的根。 点击文件名可查看/编辑详细的MIME项。
语法
文件路径
提示
Information 点击文件名可编辑MIME设置。
服务器签名
描述
指定是否在响应头的Server参数中显示服务器签名和版本号。 有三个选项：当设置为Hide Version时，只显示LiteSpeed。当设置为 Show Version，显示LiteSpeed和版本号。 设置为Hide Full Header时，整个Server头都不会显示在响应报头中。
语法
从下拉列表选择
提示
[安全建议] 如果你不想暴露服务器的版本号，设置为Hide Version。
使用报头中的客户端IP
描述
指定是否将在HTTP请求报头中的X-Forwarded-For参数列出的IP地址，用于 所有的IP地址相关的功能，包括 连接/带宽限制、访问控制和IP地理定位。
如果你的Web服务器放置在负载均衡器或代理服务器之后，此功能非常有用。 如果您选择了“仅限受信任的IP”，只有在请求来自受信任IP时，X-Forwarded-For 中的IP才会被使用。受信任IP可在服务器级别的允许列表中定义。
Keep Header from Trusted IP与Trusted IP Only相同，但是用于后端的X-Forwarded-For头不会被修改为包含连接对端地址。
Use Last IP (for AWS ELB)将使用“X-Forwarded-For”列表中的最后一个IP地址。如果您正在使用AWS Elastic Load Balancer，或期望真实IP被追加到“X-Forwarded-For”列表末尾，请选择此选项。
语法
从下拉列表选择
管理员电子邮箱
描述
指定服务器管理员的电子邮箱地址。 如果设置了电子邮箱地址，管理员将收到重要事件的电子邮件通知（例如， LiteSpeed服务因崩溃而自动重启或者授权即将过期）。
语法
以逗号分隔的电子邮件地址列表。
提示
Information 电子邮件提醒功能只有在服务器有活动的MX服务器（如postfix、exim或sendmail）的情况下才会生效。
自动索引
描述
在目录中，当索引文件中所列的索引文件不可用时，指定运行时是否即时生成目录索引。
此选项可以在虚拟主机级别和Context级别中设置，并可以顺着目录树继承，直到被显式覆盖。 您可以自定义生成的索引页面。请查看在线Wiki操作指南。
语法
布尔值
提示
[安全] 建议尽可能关闭自动索引，以防止泄露机密数据。
另请参阅
自动索引URI
描述
在目录中，当索引文件中所列出的索引文件（index）不可用时，指定用来生成索引页面的URI。 LiteSpeed Web服务器使用一个外部脚本来生成索引页面，从而为定制提供最大的灵活性。 默认的脚本生成一个类似于Apache的索引页面。 如需自定义生成的索引页面，请查看在线Wiki操作指南。 待索引目录会通过环境变量"LS_AI_PATH"传递给脚本。
语法
URI
另请参阅
启用过期
描述
指定是否为静态文件生成Expires头。如果启用，将根据 默认过期和按类型过期生成Expires头。
这可以在服务器、虚拟主机和上下文级别设置。低级别的设置将 覆盖高级别的设置。例如，上下文级别的设置将覆盖虚拟主机级别的设置， 虚拟主机级别的设置将覆盖服务器级别的设置。
语法
布尔值
默认过期
描述
指定生成Expires头的默认设置。该设置在启用过期 设为“启用”时有效。它可以被按类型过期覆盖。 除非必要，否则不要在服务器或虚拟主机级别设置该默认值。 因为它会为所有网页生成Expires头。大多数时候，应该是 为不常变动的某些目录在上下文级别设置。如果没有默认设置，按类型过期中未指定的类型不会生成Expires头。
语法
A|Mseconds
文件将在基准时间（A|M）加指定秒数的时间后失效。 “A”代表基准时间为客户端的访问时间，“M”代表文件的最后修改时间。
按类型过期
描述
为各个MIME类型分别指定Expires头设置。
语法
逗号分隔的“MIME-类型=A|M秒数”的列表。 文件将在基准时间（A|M）加指定秒数的时间后失效。
“A”代表基准时间为客户端的访问时间，“M”代表文件的最后修改时间。 MIME-类型可使用通配符“*”，如image/*。
自动加载.htaccess
描述
如果使用rewritefile指令的目录还没有对应的HttpContext，则在首次访问该目录时自动加载.htaccess文件中包含的重写规则。首次加载后，必须执行平滑重启才能使对该.htaccess文件的后续修改生效。
虚拟主机级别设置将覆盖服务器级别设置。 默认值：
服务器级别：No
虚拟主机级别：继承服务器级别设置
语法
布尔值
文件上传
描述
上传文件时，通过使用请求正文解析器将文件解析到服务器本地目录，可以提供附加的安全功能。第三方模块可以轻松扫描本地目录中的文件是否存在危害。当启用通过文件路径传递上传数据，或模块在LSI_HKPT_HTTP_BEGIN级别调用LSIAPI的set_parse_req_body时，将使用请求正文解析器。 源代码包中提供的API示例。
另请参阅
临时文件路径
描述
请求正文解析器工作期间，上传到服务器的文件会存储在此临时目录中。 默认值为/tmp/lshttpd/。
语法
绝对路径，或以$SERVER_ROOT开头的路径（服务器和虚拟主机级别），或以$VH_ROOT开头的路径（虚拟主机级别）。
通过文件路径传递上传数据
描述
指定是否按文件路径传递上传数据。 如果启用，则上传时文件路径以及其他一些信息将发送到后端处理程序，而不是文件本身。 这样可以节省CPU资源和文件传输时间，但需要一些更新才能实现。 如果禁用，则文件内容将传输到后端处理程序，请求主体仍解析为文件。
语法
布尔值
提示
[性能] 如果向下兼容不是问题，启用此功能可加快文件上传处理速度。
IP地理定位数据库
描述
多个MaxMind地理定位数据库可以在这里指定。MaxMind有以下数据库类型: 国家，地区，城市，组织，ISP和NETSPEED。如果混合配置“国家”，“地区”，和“城市”类型数据库，则最后一项将会生效。
数据库名称
描述
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'。
语法
文本