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

# 安装/卸载

## 最低系统要求

- 操作系统:
  - Linux(i386): kernel 2.4或更高, glibc-2.2 或更高
  - CentOS: 5 或更高
  - Ubuntu: 8.04 或更高
  - Debian: 4 或更高
  - FreeBSD(i386): 4.5 and up
  - MacOSX: 10.3 and up
- CPU:
  - Intel: 80486 或更高
  - PowerPC: PowerPC G4
- 内存: 32MB 或更高
- 硬盘:
  - 安装时: 200MB
  - 运行时: 300MB或更高, 交换空间取决于使用情况。

## 安装

安装必须在命令行终端中执行。 出于测试目的， 非特权用户可以将LiteSpeed Web Server安装到主目录中。 对于生产用途，应将其安装到系统目录中。

在Mac OS X中，默认情况下禁用root用户。 可以使用Apple网站上的详述操作来启用它. 您也可以使用sudo命令在不启用root用户的情况下将LSWS安装到系统目录中， 但是系统文件夹仍然只能由root用户操作。 这意味着每次您要从命令行终端控制LSWS时（例如，启动或停止LSWS时）， 都必须使用sudo命令。

### 安装步骤:

访问 OpenLiteSpeed知识库 查看有关安装方法的列表。

## 开始

1. 有关控制服务器进程的详细信息，请参阅《管理指南》。

   要启动LSWS，只需运行 [您的安装文件夹]/bin/lswsctrl. (停止请运行 [您的安装文件夹]/bin/lswsctrl.)

2. 示例站点应在服务器上运行.

   如果想访问您的网站,请访问 http://[address]:8088/, [address] 是您的Web服务器的IP地址或域名。 如果服务器在您使用的计算机上,使用"localhost" "8088"是默认的端口. 如果在安装过程中为LiteSpeed选择了另一个端口，请使用您指定的端口。

   当访问上述地址时，应为祝贺的测试页面。 如果不是，请尝试访问WebAdmin控制台界面。

3. WebAdmin控制台的默认端口是 7080.

   访问http://[address]:7080/来进入WebAdmin. (如果在安装过程中更改了WebAdmin的端口，请改用该端口。)

   记住对于[address],如果服务器在您使用的计算机上你可以使用 "localhost"

   TWebAdmin欢迎页面应该加载。 点击 "Log on" 链接, 并使用安装期间指定的管理员用户名和密码登录。

   有关配置的详细信息，请参阅我们的配置指南，或单击顶部的“帮助”。

4. 如果您的服务器使用防火墙，请确保本地主机受信任。

   例如，带有IPTables的Linux应该包括LO的ALLOW INPUT规则。

5. 如果您的网站和WebAdmin Console无法访问，请查看错误日志 [your_install_dir]/logs/error.log.

   如果与其他服务器应用程序存在TCP端口冲突，则应使用可用端口重新安装Web服务器。 可以使用以下命令查找可用端口: netstat -an | grep XXXX XXXX是端口号。 如果端口可用，该命令将不产生任何输出。

   如果交换目录不可写，则可以将交换目录的写权限授予运行Web服务器的用户，也可以手动更改交换目录的配置。 交换目录在服务器的XML配置文件中配置: [your_install_dir]/conf/httpd_config.xml. 在XML文件中搜索swappingDir。 交换目录的默认位置是/tmp/lshttpd/swap。

   如果您仍然有安装问题，请查看我们的Wiki或将您的问题发布在我们的支持论坛上。

## Notes

- OpenLiteSpeed支持本机LiteSpeed XML配置文件和纯文本配置文件（用于编辑Apache的httpd.conf的文件） 运行 [your_install_dir]/conf/switch_config.sh l来在这些格式之间切换。
- 在FreeBSD，Mac OS X，Ubuntu和Debian上，附带的PHP（对于CentOS）将无法运行。 您将需要为OpenLiteSpeed构建新的PHP，以便使用OpenLiteSpeed运行PHP应用程序。

## 卸载步骤

1. 如果OpenLiteSpeed正在运行，则停止它: [your_install_dir]/bin/lswsctrl stop
2. 删除安装文件夹: rm -rf [your_install_dir]