URL 重写
重写规则在原版和打过补丁的 OpenLiteSpeed 上都能原生执行。补丁版 OLS(“Full” 版)走 LSI-API 快路径;原版 OLS 由模块内置引擎直接执行 Apache mod_rewrite 子集——无需补丁。
| 指令 | 语法 |
|---|---|
RewriteEngine | RewriteEngine On|Off |
RewriteBase | RewriteBase /path/ |
RewriteCond | RewriteCond TestString Pattern [flags] |
RewriteRule | RewriteRule Pattern Substitution [flags] |
RewriteOptions | RewriteOptions inherit|IgnoreInherit |
RewriteMap | RewriteMap name txt|rnd|int:/path |
Pattern 语法(内置引擎)
Section titled “Pattern 语法(内置引擎)”- PCRE2 正则(与模块各处使用的同一引擎,带
match_limit防病态回溯) .同样匹配换行(Apache 重写语义)- 前导
!表示否定——注意否定匹配不产生捕获组供$N使用
Substitution
Section titled “Substitution”| 形式 | 行为 |
|---|---|
- | URI 不变(配合 [F]/[G] 或纯条件规则) |
/path | 内部重写 |
/path?query | 带新查询串的内部重写 |
http(s)://… | 外部重定向 |
| 相对路径 | 拼接 RewriteBase 前缀 |
替换串内可展开:
$0…$9—— 规则 pattern 的捕获组%{VAR}—— 服务器变量(与 RewriteCond 同集,见下)
RewriteRule 标志
Section titled “RewriteRule 标志”| 标志 | 效果 |
|---|---|
[L]、[END] | 停止处理后续规则 |
[R] / [R=301..308] | 外部重定向(裸 [R] 默认 302) |
[NC] | 不区分大小写 |
[QSA] | 追加原始查询串 |
[F] | 403 禁止(substitution 用 -) |
[G] | 410 已删除 |
[NE]、[PT] | 接受但在此子集中为空操作 |
RewriteCond
Section titled “RewriteCond”测试串可引用 %{VAR} 服务器变量:
%{REQUEST_URI}, %{REQUEST_FILENAME}, %{QUERY_STRING},
%{HTTP_HOST}, %{HTTPS}, %{REMOTE_ADDR}, %{REQUEST_METHOD},
%{HTTP_USER_AGENT}, %{HTTP_REFERER}, %{HTTP:Header}, %{ENV:var}
CondPattern 形式:
| 形式 | 含义 |
|---|---|
| PCRE2 正则 | 匹配展开后的测试串 |
!pattern | 否定 |
-f / -d / -s | 文件存在 / 是目录 / 非空(相对路径按文档根解析) |
< > = | 与字面操作数的字典序比较 |
Cond 标志:[NC]、[OR](OR 组内任一满足即通过;默认 AND 组合)。
WordPress 固定链接
Section titled “WordPress 固定链接”RewriteEngine OnRewriteBase /RewriteRule ^index\.php$ - [L]RewriteCond %{REQUEST_FILENAME} !-fRewriteCond %{REQUEST_FILENAME} !-dRewriteRule . /index.php [L]强制 HTTPS
Section titled “强制 HTTPS”RewriteEngine OnRewriteCond %{HTTPS} offRewriteRule ^(.*)$ https://%{HTTP_HOST}/$1 [R=301,L]带捕获组的重定向
Section titled “带捕获组的重定向”RewriteEngine OnRewriteRule ^/old/(.*)$ /new/$1 [L]RewriteEngine OnRewriteRule ^/secret - [F]与 Apache 的文档化差异
Section titled “与 Apache 的文档化差异”- 规则按文件序单遍执行;内部重写后不从头重扫(Apache 的目录 上下文会重新扫描)。主流真实场景——单一 catch-all 前端控制器——行为 完全一致。
- RewriteCond 测试串中的
$N反向引用在首条规则匹配前近似为空。 - 替换串中的
%N条件组引用 v1 中预留未填充。
GeoIP 条件(零额外代码)
Section titled “GeoIP 条件(零额外代码)”OLS 原生支持 MaxMind MMDB 并把 GEOIP_* 变量注入请求环境;本引擎的
%{ENV:var} 直接读取。一次性服务器配置(httpd_config.conf,语法按
OLS 源码逐字核实):
geoipDB /usr/local/share/GeoLite2-Country.mmdb { geoipDBName COUNTRY_DB maxminddbenv GEOIP_COUNTRY_CODE COUNTRY_DB/country/iso_code}之后按国规则就是普通重写:
RewriteEngine OnRewriteCond %{ENV:GEOIP_COUNTRY_CODE} ^(US|DE)$ [NC]RewriteRule .* - [F]已实测:GB 地址请求 → 403,US → 200,无需任何模块改动。