用户手册
Version 1.9 — Rev. 3

# 安装/卸载

## 最低系统要求

### 支持的操作系统

OpenLiteSpeed支持以下当前仍受支持、且未到生命周期终止（non-EOL）的Linux发行版：

- CentOS* 8、9、10
- Debian 11、12、13
- Ubuntu 20（将于2025年5月31日EOL）、22、24

* 包括RedHat Enterprise Linux及其衍生版，如AlmaLinux、CloudLinux、Oracle Linux、RockyLinux、VzLinux等。

### CPU

- Intel：x86-64
- ARM：aarch64（仅限Linux）

### 内存

512MB及以上

### 磁盘

- 安装：200MB
- 运行：300MB及以上，交换空间取决于使用情况。

## 安装

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

### 安装步骤

请访问 OpenLiteSpeed文档 查看安装方法列表。

## 开始使用

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

   要启动服务器，只需运行[your_install_dir]/bin/lswsctrl start。 （若要停止，请运行[your_install_dir]/bin/lswsctrl stop。）

2. 服务器上应有一个示例站点正在运行。

   要访问您的网站，请将浏览器指向 http://[address]:8088/， 其中[address]是您的Web服务器所在机器的IP地址或域名。 如果服务器就在您当前使用的机器上，请使用"localhost"。 "8088"是默认端口。如果您在安装OpenLiteSpeed时选择了其他端口，请使用您指定的端口。

   当访问上述地址时，浏览器应加载一个带有其他测试页面链接的祝贺页面。如果没有，请尝试访问WebAdmin控制台。

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

   请在浏览器中输入https://[address]:7080/ 进入WebAdmin控制台。（如果您在安装过程中更改了WebAdmin端口，请改用该端口。）

   请记住，如果服务器就在您当前使用的机器上，[address]可以使用"localhost"。

   此时应加载WebAdmin控制台欢迎页面。点击"Log on"链接， 然后使用安装过程中指定的管理员用户名和密码登录。

   有关配置的详细信息，请参阅我们的配置指南， 或点击任意页面顶部的"Help"链接。

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

   例如，在使用IPTables的Linux上，应包含一条 ALLOW INPUT from LO规则。

5. 如果您的网站和WebAdmin控制台无法访问，请查看错误日志 [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。

   如果您仍然遇到安装问题，请参阅 相关文档 或在我们的 支持论坛 上发帖。

## 注意事项

- OpenLiteSpeed同时支持原生LiteSpeed XML配置文件和纯文本配置文件 （适合习惯编辑Apache的httpd.conf的用户）。运行 [your_install_dir]/conf/switch_config.sh 可以在这两种格式之间切换。

## 卸载步骤

1. 如果OpenLiteSpeed正在运行，请先停止它： [your_install_dir]/bin/lswsctrl stop
2. 删除安装目录： rm -rf [your_install_dir]