用户手册
Version 1.9 — Rev. 3

# 虚拟主机常规

### 文档根目录

#### 描述

指定此虚拟主机的文档根目录。 推荐使用$VH_ROOT/html。在Context中，此目录可以用$DOC_ROOT来引用。

#### 语法

路径

### 管理员邮箱

#### 描述

指定这个虚拟主机管理员的电子邮箱地址。

#### 语法

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

### 启用压缩

#### 描述

指定是否为此虚拟主机启用GZIP压缩。 这个设置仅在服务器级别的启用压缩设置为Yes时有效。

#### 语法

布尔值

#### 另请参阅

启用压缩

### Brotli压缩

#### 描述

指定是否为此虚拟主机启用Brotli压缩。 这个设置仅在服务器级别的Brotli压缩等级（静态文件）设置为一个非零值时有效。

#### 语法

布尔值

#### 另请参阅

Brotli压缩等级（静态文件）

### 启用IP地理定位

#### 描述

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

#### 语法

布尔值

#### 另请参阅

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

### cgroups

#### 描述

如果当前操作系统支持(目前支持RedHat/Centos Linux v7.5+和Ubuntu 18.04+)，则将cgroup设置应用于此CGI进程。 。 当前执行的用户将用于确定要应用的cgroup配置。
在服务器级别将此设置为Disabled将在服务器范围内禁用此设置。 在其他情况下，可以在虚拟主机级别覆盖服务器级别的设置。
默认值:
服务器级别: Off
虚拟主机级别: 继承服务器级别设置

#### 语法

从下拉列表选择

### 使用服务器日志

#### 描述

指定是否将虚拟主机的日志信息放置到服务器日志文件中，而不是创建独自的日志文件。

#### 语法

从单选框中选择

### 文件路径

#### 描述

指定日志文件的路径。

#### 语法

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

#### 提示

Performance 将日志文件放在单独的磁盘上。

### 日志级别

#### 描述

指定日志记录级别。可用级别（从高到低）为ERROR、 WARNING、NOTICE、INFO和DEBUG。 只有当消息等级高于或与当前设置相同时才被记录。 如果您希望将此设置为DEBUG，您也需要设置服务器日志级别为DEBUG。 调试的级别只能在服务器级别通过调试级别控制。

#### 语法

从列表中选择

#### 提示

Performance 除非调试级别设置为NONE以外的级别，否则DEBUG日志级别不会影响性能，建议使用。

#### 另请参阅

调试级别

### 轮转大小（字节）

#### 描述

指定当前日志文件何时需要轮转，也称为日志轮转。 当文件大小超过轮转限制后，活动日志文件会在同一目录中重命名 为log_name.mm_dd_yyyy(.sequence)，并创建新的活动日志文件。 轮转后的日志文件实际大小有时会略大于此限制。 设置为0可禁用日志轮转。

#### 语法

整数

#### 提示

Information 可在数字后附加"K"、"M"、"G"分别表示千字节、兆字节和千兆字节。

### 保留天数

#### 描述

指定访问日志文件将被保存在磁盘上多少天。 只有早于指定天数的轮转日志文件会被删除。 当前的日志文件不会被删除，无论它包含了多少天的数据。 如果你不想自动删除过时的、很旧的日志文件， 将该值设置为0。

#### 语法

整数

### 压缩存档

#### 描述

指定是否压缩轮转日志文件以节省磁盘空间。

#### 语法

布尔值

#### 提示

Information 日志文件压缩率很高，建议启用此功能以减少旧日志的磁盘占用。

### 日志管理

#### 描述

指定访问日志的写入位置。有三个选项：

1. 写入服务器的访问日志
2. 为此虚拟主机创建访问日志
3. 禁用访问日志记录

#### 语法

从列表中选择

### 文件名

#### 描述

访问日志文件名。

#### 语法

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

#### 提示

Performance 将访问日志文件放在单独的磁盘上。

### 管道日志记录

#### 描述

指定一个外部应用程序，用来通过其STDIN流上的管道（文件句柄为0）接收LiteSpeed发送的访问日志数据。 指定此字段后，访问日志将仅发送到记录器应用程序，而不发送到上一个条目中指定的访问日志文件。
必须先在外部应用部分定义记录器应用程序。服务器级别的访问日志只能使用在服务器级别定义的外部记录器应用程序。虚拟主机级别的访问日志只能使用在虚拟主机级别定义的记录器应用程序。
记录器进程的启动方式与其他外部（CGI/FastCGI/LSAPI）进程相同。 这意味着它会以虚拟主机外部应用程序设置UID模式设置中指定的用户ID运行， 绝不会代表特权用户运行。
如果配置了记录器应用程序的多个实例，LiteSpeed Web服务器会在多个记录器应用程序之间执行简单的负载均衡。LiteSpeed服务器始终尽量将记录器应用程序数量保持在最低。只有当某个记录器应用程序无法及时处理访问日志条目时，服务器才会尝试启动该记录器应用程序的另一个实例。
如果记录器崩溃，Web服务器会启动另一个实例，但流缓冲区中的日志数据将会丢失。如果外部记录器无法跟上日志流的速度和数量，也可能丢失日志数据。

#### 语法

从下拉列表选择

### 日志格式

#### 描述

指定访问日志的格式。 设置之后，它将覆盖日志头部 的设定。

#### 语法

字符串。日志格式语法与Apache 2.0的自定义 日志格式兼容。

#### 示例

一般日志格式（CLF）
"%h %l %u %t \"%r\" %>s %b"
支持虚拟主机的一般日志格式
"%v %h %l %u %t \"%r\" %>s %b"
NCSA扩展/组合日志格式
"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"
记录Foobar的cookie值
"%{Foobar}C"

#### 另请参阅

日志头部

### 日志头部

#### 描述

指定是否记录HTTP请求头：Referer、 UserAgent和Host。

#### 语法

从复选框选择

#### 提示

[性能] 如果不需要在访问日志中记录这些头部信息，请关闭此功能。

#### 另请参阅

日志格式

### 字节记录

#### 描述

指定带宽字节日志文件的路径。设置后，将创建一份兼容cPanel面板的带宽日志。这将记录 一个请求传输的总字节数，包括请求内容和响应内容。

#### 语法

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

#### 提示

Performance 将日志文件放在单独的磁盘上。

### 使用服务器索引文件

#### 描述

指定是否使用服务器的索引文件。 如果设置为Yes，那么只有服务器的设置将被使用。 如果设置为No，那么服务器的设置将不会被使用。 如果设置为Addition，那么附加的索引文件可以被添加到此虚拟主机服务器的索引文件列表中。 如果想要禁用此虚拟主机的索引文件，您可以将该值设置为No，并将索引文件栏留空。

#### 语法

从下拉列表选择

### 索引文件

#### 描述

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

#### 语法

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

#### 提示

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

### 自动索引

#### 描述

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

#### 语法

布尔值

#### 提示

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

#### 另请参阅

索引文件, 自动索引URI

### 自动索引URI

#### 描述

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

#### 语法

URI

#### 另请参阅

索引文件, 自动索引

### 自定义错误页面

#### 描述

当服务器在处理请求时遇到问题， 服务器将向网络客户端返回错误代码和html页面作为错误消息。 错误代码在HTTP协议中定义（请参阅RFC 2616）。 LiteSpeed Web服务器为每个错误代码都有一个内置的默认错误页面，但是也可以为每个错误代码配置一个自定义页面。 这些错误页面还可以进一步自定义，使其对每个虚拟主机都保持唯一。

### 错误代码

#### 描述

指定错误页面的HTTP状态码。 只有特定的HTTP状态码才可以自定义错误页面。

#### 语法

从下拉列表选择

### URL

#### 描述

指定自定义错误页的URL。 当返回相应HTTP状态时服务器会将请求转发到该URL。 如果此URL指向不存在的资源，将使用内置错误页面。 该URL可以是静态文件、动态生成的页面，或其他网站的页面 （以"http(s)://"开头的URL）。 当引用其他网站上的页面时，客户端会收到重定向状态码， 而不是原始状态码。

#### 语法

URL

### 启用过期

#### 描述

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

#### 语法

布尔值

### 默认过期

#### 描述

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

#### 语法

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

### 按类型过期

#### 描述

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

#### 语法

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

### 文件上传

#### 描述

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

#### 另请参阅

Hook::HTTP_BEGIN 优先级

### 临时文件路径

#### 描述

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

#### 语法

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

### 临时文件权限

#### 描述

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

#### 语法

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

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

#### 描述

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

#### 语法

布尔值

#### 提示

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

### 后缀

#### 描述

指定将由此脚本处理程序处理的脚本文件后缀。后缀必须唯一。

#### 语法

逗号分隔列表，禁止使用句点“.”字符。

#### 提示

Information 服务器会自动为列表中的第一个后缀添加特殊MIME类型（“application/x-httpd-[suffix]”）。 例如，会为后缀“php53”添加MIME类型“application/x-httpd-php53”。第一个之后的后缀需要在MIME设置设置中配置。
尽管我们在此字段中列出了后缀，但是脚本处理程序使用MIME类型而非后缀来确定要处理的脚本。
Performance Security 仅指定确实需要的后缀。

### 处理器类型

#### 描述

指定处理这些脚本文件的外部应用程序类型。可用类型包括： LSAPI app、Web Server (Proxy)、Fast CGI、SCGI、CGI、Load balancer、 Servlet Engine、uWSGI或Module Handler。除CGI和Module Handler 处理器类型外，处理器名称还必须设置为外部应用部分中已预先定义的外部应用程序。

#### 语法

从列表中选择

### 处理器名称

#### 描述

当处理器类型为LSAPI app、Web Server (Proxy)、Fast CGI、SCGI、Load balancer、 Servlet Engine或uWSGI时，指定处理脚本文件的外部应用程序名称。

#### 语法

从列表中选择

### php.ini覆盖

#### 描述

用于覆盖当前Context（虚拟主机级别或Context级别）中的php.ini设置。
支持的指令是：
php_value
php_flag
php_admin_value
php_admin_flag
所有其他行/指令将被忽略。

#### 语法

覆盖语法类似于Apache：每行一个指令及其值，每个指令前根据需要加上php_value、php_flag、php_admin_value或php_admin_flag。

#### 示例

php_value include_path ".:/usr/local/lib/php"
php_admin_flag engine on
php_admin_value open_basedir "/home"