安装

LiteHTTPD 安装

LiteHTTPD（完整版）是默认且推荐的版本。它包含打补丁的 OLS 二进制文件和 htaccess 模块。

前提条件

OpenLiteSpeed 1.7.0 或更高版本
Linux x86_64 或 ARM64

添加 LiteHTTPD RPM 仓库并安装：
Terminal window
```
curl -s https://rpms.litehttpd.com/setup.sh | bash
dnf install openlitespeed-litehttpd
```
一个 RPM 包含打补丁的 OLS 二进制文件、内置的 htaccess 模块和自动配置。软件包已 GPG 签名。
重启 OLS：
Terminal window
```
systemctl restart lsws
```

从 rpms.litehttpd.com 下载，或添加仓库源：

安装：

dnf install ./openlitespeed-litehttpd-*.rpm

重启 OLS：
Terminal window
```
systemctl restart lsws
```

发行版无关的二进制包（glibc 2.28+，与官方 OLS tarball 一样——解压后运行 install.sh）。从 rpms.litehttpd.com 或 GitHub Release 下载。

全新安装（尚未安装 OpenLiteSpeed）——安装完整的打补丁 OLS + 模块：

curl -LO https://rpms.litehttpd.com/openlitespeed-litehttpd-1.8.5-x86_64-linux.tgz
tar xzf openlitespeed-litehttpd-1.8.5-x86_64-linux.tgz
cd openlitespeed-litehttpd-1.8.5 && sudo ./install.sh

已安装官方 OpenLiteSpeed——选择一种叠加包：
- 完整功能（叠加打补丁的二进制——必须与已装 OLS 版本一致；会备份原二进制）：
  Terminal window
```
tar xzf litehttpd-ols-patch-1.8.5-x86_64-linux.tgz
cd litehttpd-ols-patch-1.8.5 && sudo ./install.sh
```
- 仅模块（适用于任意 OLS 版本；不替换二进制——RewriteRule/php_value 解析但不执行）：
  Terminal window
```
tar xzf litehttpd-module-0.2.2-x86_64-linux.tgz
cd litehttpd-module-0.2.2 && sudo ./install.sh
```
重启 OLS：
Terminal window
```
/usr/local/lsws/bin/lswsctrl restart
```

安装构建依赖：

# AlmaLinux / Rocky / RHEL
dnf install cmake gcc gcc-c++ libcrypt-devel

# Ubuntu / Debian
apt install cmake g++ libcrypt-dev

克隆 OLS，应用补丁并构建：

git clone --branch v1.8.5 https://github.com/litespeedtech/openlitespeed.git
cd openlitespeed
patch -p1 < /path/to/patches/0001-lsiapi-phpconfig.patch
patch -p1 < /path/to/patches/0002-lsiapi-rewrite.patch
# 应用补丁 0003、0004
bash build.sh

构建模块：

cd /path/to/litehttpd
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --target litehttpd_htaccess

安装：

cp build/litehttpd_htaccess.so /usr/local/lsws/modules/

LiteHTTPD-Thin（仅模块）

适用于未打补丁的原生 OLS。安装快捷但功能有限：

RewriteRule 指令会被解析但不会执行
php_value/php_flag 指令会被解析但不会传递给 lsphp

将模块复制到 OLS：

cp litehttpd_htaccess.so /usr/local/lsws/modules/

在 OLS 配置中启用模块：

cat >> /usr/local/lsws/conf/httpd_config.conf <<'CONF'

module litehttpd_htaccess {
    ls_enabled              1
}
CONF

重启 OLS：
Terminal window
```
/usr/local/lsws/bin/lswsctrl restart
```

对于依赖 .htaccess 重定向的生产环境 WordPress 站点，建议升级到完整版。