## OpenLiteSpeed Web Server Users' Manual

### Version 1.7 — Rev. 12

- License
- Introduction
- Installation
- Administration
  - Service Manager
- 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

# 管理控制台设置

Admin Server is a special virtual host dedicated to the WebAdmin console. It is very important to make sure Admin Server is securely protected either by only allowing access from the administrator's machines or by using an encrypted SSL connection.

## Table of Contents

### 启用Core Dump⇑

#### Description

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

#### Syntax

布尔值

#### Tips

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

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

#### Description

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

#### Syntax

无符号整数

#### Tips

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

### 使用服务器日志⇑

#### Description

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

#### Syntax

布尔值

### File Name⇑

#### Description

Specifies the path for the log file.

#### Syntax

Filename which can be an absolute path or a relative path to $SERVER_ROOT, $VH_ROOT.

#### Tips

Place the log file on a separate disk.

### 日志级别⇑

#### Description

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

#### Syntax

选项

#### Tips

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

#### See Also

调试级别

### 回滚大小⇑

#### Description

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

#### Syntax

无符号整数

#### Tips

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

### 日志管理⇑

#### Description

指定写入访问日志的地点。这里有三个选项： 1. 写入到服务器的访问日志； 2. 为虚拟主机创建一个访问日志； 3. 禁用访问日志记录。

#### Syntax

选项

### File Name⇑

#### Description

The access log filename.

#### Syntax

Filename which can be an absolute path or a relative path to $SERVER_ROOT, $VH_ROOT.

#### Tips

Put access log file on a separate disk.

### Piped Logger⇑

#### Description

Specifies the external application that will receive the access log data sent by LiteSpeed through a pipe on its STDIN stream (file handle is 0). When this field is specified, the access log will be sent only to the logger application and not the access log file specified in previous entry.
The logger application must be defined in External Apps section first. Server-level access logging can only use an external logger application defined at the server level. Virtual host-level access logging can only use a logger application defined at the virtual host level.
The logger process is spawned in the same way as other external (CGI/FastCGI/LSAPI) processes. This means it will execute as the user ID specified in the virtual host's 外部应用程序设置UID模式 settings and will never run on behalf of a privileged user.
LiteSpeed web server performs simple load balancing among multiple logger applications if more than one instance of a logger application is configured. LiteSpeed server always attempts to keep the number of logger applications as low as possible. Only when one logger application fails to process access log entries in time will the server attempt to spawn another instance of the logger application.
If a logger crashes, the web server will start another instance but the log data in the stream buffer will be lost. It is possible to lose log data if external loggers cannot keep up with the speed and volume of the log stream.

#### Syntax

Select from drop down list

### 日志格式⇑

#### Description

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

#### Syntax

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

#### Example

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

复选框

#### Tips

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

#### See Also

日志格式

### 保留天数⇑

#### Description

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

#### Syntax

无符号整数

### 字节记录⇑

#### Description

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

#### Syntax

文件2

#### Tips

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

### 压缩存档⇑

#### Description

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

#### Syntax

布尔值

#### Tips

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