LiteSpeed Web Server logo LiteSpeed Web Server用户手册
配置

Virtual Host General

目录

核心设置

虚拟主机日志

访问日志

索引文件

自定义错误页面

脚本处理程序定义

.htaccess

过期设置

Apache风格配置

WebSocket代理

文档根目录

描述

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

语法

路径

管理员邮箱

描述

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

语法

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

压缩方法

描述

指定为此虚拟主机启用哪些压缩方法。如果此设置未设置，则使用服务器级别的压缩方法。

语法

从复选框中选择

另请参阅

压缩方法, 压缩优先级

压缩优先级

描述

当可以使用多个已启用的压缩方法时，为此虚拟主机提供Zstandard、Brotli和GZIP的首选压缩方法顺序。如果此设置未设置，则使用服务器级别的压缩优先级。此设置只是提示，不会强制每个响应的最终顺序。

语法

从列表中选择

另请参阅

压缩优先级

启用IP地理定位

描述

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

语法

布尔值

另请参阅

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

cgroups

描述

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

语法

从下拉列表选择

使用服务器日志

描述

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

语法

从单选框中选择

文件名

描述

指定日志文件的路径。

语法

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

提示

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

日志级别

描述

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

语法

从列表中选择

提示

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

另请参阅

调试级别

轮转大小（字节）

描述

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

语法

整数

提示

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

保留天数

描述

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

语法

整数

压缩存档

描述

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

语法

布尔值

提示

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

日志管理

描述

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

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

语法

从列表中选择

文件名

描述

访问日志文件名。

语法

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

提示

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

管道日志记录

描述

指定一个外部应用程序，用来通过其STDIN流上的管道（文件句柄为0）接收LiteSpeed发送的访问日志数据。 指定此字段后，访问日志将仅发送到记录器应用程序，而不发送到上一个条目中指定的访问日志文件。

必须先在外部应用部分定义记录器应用程序。服务器级别的访问日志只能使用在服务器级别定义的外部记录器应用程序。虚拟主机级别的访问日志只能使用在虚拟主机级别定义的记录器应用程序。

记录器进程的启动方式与其他外部（CGI/FastCGI/LSAPI）进程相同。 这意味着它会以虚拟主机外部应用程序设置UID模式设置中指定的用户ID运行， 绝不会代表特权用户运行。

如果配置了记录器应用程序的多个实例，LiteSpeed Web服务器会在多个记录器应用程序之间执行简单的负载均衡。LiteSpeed服务器始终尽量将记录器应用程序数量保持在最低。只有当某个记录器应用程序无法及时处理访问日志条目时，服务器才会尝试启动该记录器应用程序的另一个实例。

如果记录器崩溃，Web服务器会启动另一个实例，但流缓冲区中的日志数据将会丢失。如果外部记录器无法跟上日志流的速度和数量，也可能丢失日志数据。

语法

从下拉列表选择

日志格式

描述

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

语法

字符串。日志格式语法与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的相对路径。

提示

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

使用服务器索引文件

描述

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

语法

从下拉列表选择

索引文件

描述

指定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

后缀

描述

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

语法

以逗号分隔的列表，禁止使用句点"."字符。

提示

信息 服务器会自动为列表中的第一个后缀添加特殊MIME类型（"application/x-httpd-[suffix]"）。例如，会为后缀"php53"添加MIME类型"application/x-httpd-php53"。第一个之后的后缀需要在MIME设置设置中配置。
尽管此字段列出的是后缀，但脚本处理器使用MIME类型而不是后缀来决定要处理哪些脚本。因此，可以在.htaccess文件中使用Apache配置指令"AddType"和"ForceType"（用于控制文件MIME类型），来更改某些文件将使用的脚本处理器。例如，在位置正确的.htaccess文件中使用指令 AddType application/x-httpd-php53 .php，可以指定此目录中的PHP文件具有MIME类型"application/x-httpd-php53"，从而由使用MIME类型"application/x-httpd-php53"的脚本处理器（后缀"php53"）处理。这样，不仅可以根据不同文件后缀分配不同的脚本处理器，也可以根据文件位置进行分配。
性能安全 仅指定确实需要的后缀。

处理器类型

描述

指定处理这些脚本文件的外部应用程序类型。可用类型包括： LSAPI app、网络服务器、Fast CGI、SCGI、CGI、Load balancer、 Servlet引擎、uWSGI或模块处理器。除CGI和模块处理器 处理器类型外，处理器名称还必须设置为外部应用部分中已预先定义的外部应用程序。

语法

从列表中选择

处理器名称

描述

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

语法

从列表中选择

.htaccess

描述

目录级访问控制文件（.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"指令。

允许覆盖配置可在服务器、虚拟主机和上下文级别设置。如果某项配置在服务器级别未勾选，则无论较低级别如何设置，这些受控指令都会在整个服务器范围内禁用。较低级别可以禁用较高级别已启用的设置，但不能启用上级已禁用的设置。

默认值：
服务器级别："None"（忽略访问控制文件）
VH级别：继承服务器级别设置
上下文级别继承VH级别设置

语法

复选框

提示

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

访问控制文件名

描述

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

语法

以"."开头的文件名

另请参阅

允许覆盖

启用过期

描述

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

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

语法

布尔值

默认过期

描述

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

语法

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

按类型过期

描述

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

语法

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

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

Apache风格配置

描述

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

语法

与Apache配置文件相同。

URI

描述

指定将使用此WebSocket后端的URI。仅当发往此URI的流量包含WebSocket升级请求时，才会转发到WebSocket后端。

不包含此升级请求的流量会自动转发到此URI所属的Context。如果此URI没有对应的Context，LSWS会将该流量视为访问位置为$DOC_ROOT/URI的静态Context。

语法

普通URI（以“/”开头）。如果URI以“/”结尾，则此WebSocket后端会包含该URI下的所有子URI。

示例

将WebSocket代理与Context结合使用，可以在同一页面上以不同方式处理不同类型的流量，从而优化性能。您可以将WebSocket流量发送到WebSocket后端，同时设置静态Context让LSWS提供页面的静态内容，或设置LSAPI Context让LSWS提供PHP内容（这两种内容由LSWS处理都比由WebSocket后端处理更高效）。

地址

描述

WebSocket后端使用的唯一套接字地址。 支持IPv4套接字、IPv6套接字和Unix Domain Socket（UDS）。 IPv4和IPv6套接字可用于网络通信。 只有当WebSocket后端与服务器位于同一台机器上时，才能使用UDS。

语法

IPv4/IPv6地址:端口、UDS://路径或unix:路径

示例

127.0.0.1:5434
UDS://tmp/lshttpd/php.sock
unix:/tmp/lshttpd/php.sock

提示

安全 如果WebSocket后端在同一台机器上运行，建议优先使用UDS。如果必须使用IPv4或IPv6套接字， 请将IP地址设置为localhost或127.0.0.1，避免其他机器访问该WebSocket后端。
性能 Unix Domain Socket通常比IPv4或IPv6套接字提供更高性能。