用户手册
Version 1.9 — Rev. 3

# 服务器常规

整个服务器的常规设置。 当设置中需要路径信息时，它可以是绝对路径，也可以相对于$SERVER_ROOT。 $SERVER_ROOT是LiteSpeed Web服务器的安装位置（例如，your_home_dir/lsws或/opt/lsws）。 服务器可执行文件位于$SERVER_ROOT/bin下。

### 服务器名称

#### 描述

此服务器的唯一名称。如果留空，默认使用服务器主机名。

#### 语法

文本

### Worker数量

#### 描述

指定httpd worker的数量。

#### 语法

1到16之间的整数。

#### 提示

[性能] 设置适当的数量以满足您的需求。增加更多worker不一定意味着性能更好。

### 运行方式

#### 描述

指定服务器进程运行所使用的用户/组。该值在安装前运行configure命令时，通过“--with-user”和“--with-group”参数设置。要重置这些值，必须重新运行configure命令并重新安装。

#### 应用

需要重新安装。

#### 提示

[安全] 服务器不应以特权用户（如“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将禁用此功能）

#### 应用

需要重新安装。

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

#### 语法

从单选框中选择

### 启用 明文TCP上的HTTP/2

#### 描述

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

#### 语法

布尔值

### 平滑重启超时时长(secs)

#### 描述

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

#### 语法

整数

### 统计输出目录

#### 描述

实时统计报告文件将写入的目录。 默认目录是 /tmp/lshttpd/ .

#### 语法

路径

#### 提示

Information 在服务器操作期间，.rtreport文件将每秒写入一次。 为避免不必要的磁盘写入，请将其设置为RAM磁盘。
.rtreport文件可以与第三方监控软件一起使用，以跟踪服务器的运行状况。

### 输出JSON报告

#### 描述

将带有.json扩展名的其他JSON格式报告文件输出到/tmp/lshttpd目录。
默认值：No

#### 语法

从单选框中选择

#### 示例

设置为Yes时，除常规的.status、.rtreport、.rtreport.2等报告文件外， 还会创建.status.json、.rtreport.json、.rtreport.2.json等报告文件。

#### 提示

[信息] 这对应用程序开发者很有用，他们可能希望使用大多数编程语言内置的标准JSON 处理工具，将LiteSpeed状态和实时报告集成到自己的应用程序中。

### MIME设置

#### 描述

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

#### 语法

文件路径

#### 提示

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

### 后缀

#### 描述

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

### MIME类型

#### 描述

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

### 禁用初始日志轮换

#### 描述

指定在启动时是否启用/禁用服务器错误日志文件的轮换。 使用值为“未设置”时，默认启用初始日志轮转。

#### 语法

布尔值

### 服务器签名

#### 描述

指定是否在响应头的Server参数中显示服务器签名和版本号。 有三个选项：当设置为Hide Version时，只显示LiteSpeed。当设置为 Show Version，显示LiteSpeed和版本号。 设置为Hide Full Header时，整个Server头都不会显示在响应报头中。

#### 语法

从下拉列表选择

#### 提示

[安全建议] 如果你不想暴露服务器的版本号，设置为Hide Version。

### 启用IP地理定位

#### 描述

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

#### 语法

布尔值

#### 另请参阅

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

### 使用报头中的客户端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）的情况下才会生效。

### 索引文件

#### 描述

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

#### 语法

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

#### 提示

[性能建议] 只设置你需要的索引文件。

### 自动索引

#### 描述

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

#### 语法

布尔值

#### 提示

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

#### 另请参阅

索引文件, 自动索引URI

### 自动索引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示例。

#### 另请参阅

Hook::HTTP_BEGIN 优先级

### 临时文件路径

#### 描述

请求正文解析器工作期间，上传到服务器的文件会存储在此临时目录中。 默认值为/tmp/lshttpd/。

#### 语法

绝对路径，或以$SERVER_ROOT开头的路径（服务器和虚拟主机级别），或以$VH_ROOT开头的路径（虚拟主机级别）。

### 临时文件权限

#### 描述

确定临时目录中所存文件使用的文件权限。 服务器级别设置为全局设置，可在虚拟主机级别覆盖。

#### 语法

3位八进制数。默认值为666。

### 通过文件路径传递上传数据

#### 描述

指定是否按文件路径传递上传数据。 如果启用，则上传时文件路径以及其他一些信息将发送到后端处理程序，而不是文件本身。 这样可以节省CPU资源和文件传输时间，但需要一些更新才能实现。 如果禁用，则文件内容将传输到后端处理程序，请求主体仍解析为文件。

#### 语法

布尔值

#### 提示

[性能] 如果向下兼容不是问题，启用此功能可加快文件上传处理速度。

### IP地理定位数据库

#### 描述

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

### 数据库文件路径

#### 描述

指定MaxMind GeoIP数据库路径。

#### 语法

路径

#### 示例

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

### 数据库名称

#### 描述

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

#### 语法

文本

#### 示例

COUNTRY_DB

### 环境变量

#### 描述

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

#### 语法

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

#### 示例

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

### IP2Location数据库文件路径

#### 描述

有效数据库文件的位置。

#### 语法

文件路径

### 数据库缓存类型

#### 描述

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

#### 语法

从下拉列表选择