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

# 管理控制台设置

A中控服务器是专门用于WebAdmin控制台的虚拟主机。确保中控服务器只允许管理员终端登入或者采用加密的SSL连接是十分必要的。

## Table of Contents

### 启用Core Dump⇑

#### Description

指定当服务由root用户启动时是否启用core dump。 对大多数现代的Unix系统，会更改用户ID或组ID的进程出于安全考虑不被允许产生core文件。但是core dump文件对于排查故障非常有用。 这个选项只能在Linux Kernel 2.4或更高版本中可用。 Solaris用户应当使用coreadm命令来控制这个功能。

#### Syntax

从单选框选择

#### 提示

[安全建议] 仅在当你在服务器日志中看到没有创建core文件时启用。当产生core文件后立即关闭。Core文件产生后请提交bug报告。

### 会话超时时长（秒）⇑

#### Description

自定义WebAdmin控制台会话超时时间。 如果未设置任何值，则默认值60秒生效。

#### Syntax

整数

#### 提示

[安全建议] 在生产环境中一般设置一个不超过300秒的合适值。

### 使用服务器日志⇑

#### Description

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

#### Syntax

从单选框选择

### 文件路径⇑

#### Description

指定日志文件的路径。

#### Syntax

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

#### 提示

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

### 日志级别⇑

#### Description

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

#### Syntax

从列表中选择

#### 提示

[性能建议] 除非调试级别设置为NONE以外的日志级别, 否则DEBUG级别不会对性能产生任何影响，推荐采用。

#### See Also

调试级别

### 回滚大小 (bytes)⇑

#### Description

指定何时日志文件需要回滚，也称为日志循环。 当文件大小超过回滚限制后，在使用的日志文件将在同一目录中被重命名 为log_name.mm_dd_yyyy(.sequence)，一个新的日志文件将被创建。 回滚的日志文件的实际大小有时会比限制值稍微大一些。 将值设置为0将禁用日志循环。

#### Syntax

整数

#### 提示

请用“K”，“M”，“G”代表千字节，兆字节和千兆字节。

### 保留天数⇑

#### Description

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

#### Syntax

整数

### 压缩存档⇑

#### Description

指定是否压缩回滚日志以节省磁盘空间。

#### Syntax

从单选框选择

#### 提示

日志文件是高度可压缩的，建议采取压缩以减少旧日志的磁盘占用量。

### 日志管理⇑

#### Description

指定写入访问日志的地点。这里有三个选项：

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

#### Syntax

从列表中选择

### 文件名⇑

#### Description

访问日志的文件名

#### Syntax

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

#### 提示

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

### 管道日志记录⇑

#### Description

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

#### Syntax

从列表中选择

### 日志格式⇑

#### Description

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

#### Syntax

字符串。日志格式的语法与Apache 2.0自定义 log format.

#### 例子

一般日志格式（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"

#### See Also

记录头部

### 记录头部⇑

#### Description

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

#### Syntax

从复选框中选择

#### 提示

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

#### See Also

日志格式

### 字节记录⇑

#### Description

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

#### Syntax

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

#### 提示

[性能建议] 将日志文件放置在一个单独的磁盘上。