跳转到内容

URL 重写

重写规则在原版和打过补丁的 OpenLiteSpeed 上都能原生执行。补丁版 OLS(“Full” 版)走 LSI-API 快路径;原版 OLS 由模块内置引擎直接执行 Apache mod_rewrite 子集——无需补丁。

指令语法
RewriteEngineRewriteEngine On|Off
RewriteBaseRewriteBase /path/
RewriteCondRewriteCond TestString Pattern [flags]
RewriteRuleRewriteRule Pattern Substitution [flags]
RewriteOptionsRewriteOptions inherit|IgnoreInherit
RewriteMapRewriteMap name txt|rnd|int:/path
  • PCRE2 正则(与模块各处使用的同一引擎,带 match_limit 防病态回溯)
  • . 同样匹配换行(Apache 重写语义)
  • 前导 ! 表示否定——注意否定匹配不产生捕获组供 $N 使用
形式行为
-URI 不变(配合 [F]/[G] 或纯条件规则)
/path内部重写
/path?query带新查询串的内部重写
http(s)://…外部重定向
相对路径拼接 RewriteBase 前缀

替换串内可展开:

  • $0 … $9 —— 规则 pattern 的捕获组
  • %{VAR} —— 服务器变量(与 RewriteCond 同集,见下)
标志效果
[L]、[END]停止处理后续规则
[R] / [R=301..308]外部重定向(裸 [R] 默认 302)
[NC]不区分大小写
[QSA]追加原始查询串
[F]403 禁止(substitution 用 -)
[G]410 已删除
[NE]、[PT]接受但在此子集中为空操作

测试串可引用 %{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 组合)。

RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}/$1 [R=301,L]
RewriteEngine On
RewriteRule ^/old/(.*)$ /new/$1 [L]
RewriteEngine On
RewriteRule ^/secret - [F]
  • 规则按文件序单遍执行;内部重写后不从头重扫(Apache 的目录 上下文会重新扫描)。主流真实场景——单一 catch-all 前端控制器——行为 完全一致。
  • RewriteCond 测试串中的 $N 反向引用在首条规则匹配前近似为空。
  • 替换串中的 %N 条件组引用 v1 中预留未填充。

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 On
RewriteCond %{ENV:GEOIP_COUNTRY_CODE} ^(US|DE)$ [NC]
RewriteRule .* - [F]

已实测:GB 地址请求 → 403,US → 200,无需任何模块改动。