## OpenLiteSpeed Web Server Users' Manual

### Version 1.8 — Rev. 6

- License
- Introduction
- Installation
- Administration
  - Service Manager
  - Real-Time Stats
- Security
- Configuration
  - Server General
  - Server Log
  - Server Tuning
  - Server Security
  - External Apps
  - Fast CGI App
  - Fast CGI Authorizer
  - LSAPI App
  - Servlet Engine
  - Web Server
  - Piped logger
  - Load Balancer
  - Script Handler
  - App Server Settings
  - Module Configuration
  - Listener General
  - Listener SSL
  - Virtual Host Templates
  - Virtual Host Basic
  - Virtual Host General
  - Virtual Host Security
  - Virtual Host SSL
  - Rewrite
  - Context
  - Static Context
  - Java Web App Context
  - Servlet Context
  - Fast CGI Context
  - LSAPI Context
  - Proxy Context
  - CGI Context
  - Load Balancer Context
  - Redirect Context
  - App Server Context
  - Module Handler Context
  - Web Socket Proxy
- Web Console
  - Admin Console General
  - Admin Console Security
  - Admin Listener General
  - Admin Listener SSL

# 服务器常规

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

## Table of Contents

### 服务器名称⇑

#### Description

该服务器的唯一名称。您可以在此填写 $HOSTNAME 。

### 工具人(Workers)的数量⇑

#### Description

指定httpd工作程序的数量.

#### Syntax

Integer value between 1 and 16.

#### 提示

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

### 运行方式⇑

#### Description

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

#### 应用

Reinstall required.

#### 提示

[安全] 服务器不应该以特权用户列如"root"来运行. 将服务器配置为以非特权用户/组运行非常重要 没有登入和Shell的权限 nobody用户(组)通常是个不错的选择.

### 优先级⇑

#### Description

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

#### Syntax

Integer number

#### 提示

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

#### See Also

External App 优先级, CGI优先级

### 处理器亲和性⇑

#### Description

CPU关联将进程绑定到一个或多个CPU（核心）。 始终使用同一CPU对进程来说是有益的，因为这样进程可以利用CPU缓存中剩余的数据。 如果进程移至其他CPU，则不会使用CPU缓存，并且会产生不必要的开销。
CPU Affinity设置控制一个服务器进程将与多少个CPU（核心）相关联。 最小值为0，它将禁用此功能。 最大值是服务器具有的核心数。 通常，1是最佳设置，因为它会最严格地使用CPU亲和力，从而最大程度地利用CPU缓存。
Default value: 0

#### Syntax

Integer value from 0 to 64. (0 will disable this feature)

#### 应用

Reinstall required.

### Cloud-Linux⇑

#### Description

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

#### Syntax

从列表中选择

### 最大的读写缓冲区大小⇑

#### Description

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

#### Syntax

整数

#### 提示

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

#### See Also

交换目录

### 交换目录⇑

#### Description

指定交换文件的存放目录。 服务器在chroot模式启动时，该路径相对于新的根目录， 否则，它相对于真正的根目录。
Litespeed使用自己的虚拟内存 以降低系统的内存使用量。虚拟内存和磁盘交换会用来存储大的请求内容和 动态响应。交换目录应设置在有足够剩余空间的磁盘上。
默认值: /tmp/lshttpd/swap

#### Syntax

绝对路径

#### 提示

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

#### See Also

最大的读写缓冲区大小

### 自动修复503错误⇑

#### Description

指定是否尝试通过平滑重启LiteSpeed修复“503 服务不可用”错误。“503”错误通常是由 发生故障的外部应用程序引起的，Web服务器重新启动往往可以临时修复 错误。如果启用，当30秒内出现超过30次“503”错误时，服务器将自动 重新启动。此功能是默认启用的。

#### Syntax

从单选框选择

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

#### Description

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

#### Syntax

从单选框选择

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

#### Description

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

#### Syntax

int

### 统计输出目录⇑

#### Description

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

#### Syntax

绝对路径

#### 提示

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

### Output JSON reports⇑

#### Description

Output additional JSON formatted report files, with the .json extension, to the /tmp/lshttpd directory.
Default value: No

#### Syntax

从单选框选择

#### 例子

When set to Yes, .status.json and .rtreport.json, .rtreport.2.json, etc report files will be created in addition to the usual .status and .rtreport, .rtreport.2, etc report files.

#### 提示

This is useful for application developers who may want to integrate LiteSpeed status and real-time reports into their applications using standard JSON processing tools built-in to most programming languages.

### MIME设置⇑

#### Description

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

#### Syntax

文件名可以是绝对路径,也可以是相对于$SERVER_ROOT的相对路径。

#### 提示

Click the filename to edit the MIME settings.

### 后缀⇑

#### Description

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

### MIME类型⇑

#### Description

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

### 禁用初始日志轮换⇑

#### Description

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

#### Syntax

从单选框选择

### 服务器签名⇑

#### Description

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

#### Syntax

从列表中选择

#### 提示

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

### 启用IP地理定位⇑

#### Description

指定是否启用IP地理定位查找。 可以在服务器级别，虚拟主机级别，或context级别设置。

#### Syntax

从单选框选择

#### See Also

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

### 使用报头中的客户端IP⇑

#### Description

指定是否将在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 "列表的末尾，请选择此选项。

#### Syntax

从列表中选择

### 管理员电子邮箱⇑

#### Description

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

#### Syntax

Comma delimited list of email address.

#### 提示

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

### 索引文件⇑

#### Description

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

#### Syntax

Comma-delimited list of index filenames.

#### 提示

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

### 自动索引⇑

#### Description

在目录中，当索引文件中所列的索引文件不可用时，指定运行时是否即时生成目录索引。
此选项可以在虚拟主机级别和context级别中设置，并可以顺着目录树继承，直到被覆盖。 您可以自定义生成的索引页面。请访问在线百科了解如何操作。

#### Syntax

从单选框选择

#### 提示

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

#### See Also

索引文件, 自动索引URI

### 自动索引URI⇑

#### Description

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

#### Syntax

URI

#### See Also

索引文件, 自动索引

### 启用过期⇑

#### Description

指定是否为静态文件生成Expires头。如果启用，将根据 默认过期和按类型过期生成Expires头。
这可以在服务器，虚拟主机和Context级别设置。低级别的设置将 覆盖高级别的设置。例如，Context级别的设置将覆盖虚拟主机级别的设置， 虚拟主机级别的设置将覆盖服务器级别的设置。

#### Syntax

从单选框选择

### 默认过期⇑

#### Description

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

#### Syntax

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

### 按类型过期⇑

#### Description

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

#### Syntax

逗号分隔的“MIME-类型=A|M秒数”的列表。 文件将在基准时间（A|M）加指定秒数的时间后失效。
“A”代表基准时间为客户端的访问时间，“M”代表文件的最后修改时间。 MIME-类型可使用通配符“*”，如image/*。

### 自动加载.htaccess⇑

#### Description

如果使用rewritefile指令的目录的HttpContext不存在，则在初次访问该目录时自动加载.htaccess文件中包含的重写规则。 最初加载后，必须执行正常重启才能使对该.htaccess文件的修改生效。
虚拟主机级别设置将覆盖服务器级别设置。 默认值：
Server-level: No
VH-Level: Inherit Server-level setting

#### Syntax

从单选框选择

### 文件上传⇑

#### Description

通过使用请求正文解析器将文件解析到服务器本地目录中来上传文件时，提供了附加的安全功能。第三方模块可以轻松地在文件本地目录中扫描文件是否存在危害。 当启用通过文件路径传递上传数据或模块在LSI_HKPT_HTTP_BEGIN级别调用LSIAPI的set_parse_req_body时，将使用请求正文解析器。 源代码包中提供的API示例。

#### See Also

Hook::HTTP_BEGIN Priority

### 临时文件路径⇑

#### Description

在扫描请求正文工作时，上传到服务器的文件将存放在临时目录中 默认值为/tmp/lshttpd/.

#### Syntax

Absolute path or path starting with $SERVER_ROOT (for Server and VHost levels) or $VH_ROOT (for VHost levels).

### 临时文件权限⇑

#### Description

设置临时文件路径目录中的文件权限。 服务器级别是全局设置，可以被虚拟主机级别的设置覆盖。

#### Syntax

3 digits octet number. Default value is 666.

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

#### Description

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

#### Syntax

从单选框选择

#### 提示

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

### IP地理定位数据库⇑

#### Description

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

### 数据库文件路径⇑

#### Description

指定MaxMind GeoIP数据库路径。

#### Syntax

绝对路径

#### 例子

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

### 数据库名称⇑

#### Description

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', and 'GEOIP_CITY'.
COUNTRY_DB: 'GEOIP_COUNTRY_CODE', 'GEOIP_COUNTRY_NAME', 'GEOIP_CONTINENT_CODE', and 'GEOIP_COUNTRY_CONTINENT'.
ASN_DB: 'GEOIP_ORGANIZATION' and 'GEOIP_ISP'.

#### 例子

COUNTRY_DB

### 环境变量⇑

#### Description

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

#### Syntax

Variable_Name mapped_DB_data
One entry per line. Path to data can use map keys or 0-based array indexes, both being separated by /.

#### 例子

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

### IP2Location数据库文件路径⇑

#### Description

有效数据库文件的位置。

#### Syntax

文件名可以是绝对路径,也可以是相对于$SERVER_ROOT的相对路径。

### 数据库缓存类型⇑

#### Description

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

#### Syntax

从列表中选择