正则仅匹配真实文件系统路径,不处理url;按配置顺序生效,不参与短路径优先排序;符号链接需匹配目标路径,不可用于url控制。

当 <directory></directory> 指令使用正则表达式(即带 ~ 后缀)时,Apache 的路径解析规则与普通 <directory></directory> 不同,核心在于匹配对象、生效顺序和文件系统路径约束。
正则 <directory></directory> 的匹配对象是文件系统路径,不是 URL 路径
Apache 只对实际磁盘上的物理路径(即 request_filename 对应的绝对路径)进行正则匹配。它不关心用户访问的 URL 是什么,只看这个请求最终要读取哪个本地文件或目录。
例如:
<directory>
Require all granted
</directory>
这条规则只会作用于真实存在于磁盘上、路径严格匹配该正则的目录(如 /var/www/site1/public),而不会匹配通过符号链接、别名(Alias)或重写后“逻辑上等价”的路径。
多个 <directory></directory> 段共存时,正则段不参与“短路径优先”排序
普通 <directory></directory> 和 <directory></directory> 会按路径长度由短到长排序,短路径指令优先继承;但含 ~ 的正则 <directory></directory> 段完全独立于该排序机制——它们在所有非正则段之后统一评估,且彼此之间按配置文件中出现的顺序依次匹配,第一个成功匹配的正则段即生效,后续不再检查。
Apache Superset 是一个广泛采用的开源 BI 平台,用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时,此技能非常有用。
必须与文件系统路径完全一致,符号链接会导致失效
如果目录 /var/www/app 是一个指向 /srv/app-data 的软链接,那么:
-
<directory></directory>不生效(因为 Apache 实际访问的是/srv/app-data) -
<directory></directory>或<directory></directory>才能命中
正则本身不能绕过这个限制——它匹配的是 Apache 内部解析出的真实路径,不是原始请求路径。
常见误用点
- ❌ 在
<directory></directory>中试图控制 URL 路径/api/——这是无效的,<directory></directory>不处理 URL - ✅ 正确做法:用
<locationmatch></locationmatch>或<location></location>控制 URL 路径行为 - ❌ 写
<directory></directory>期望匹配任意以 public 结尾的路径 ——缺少锚定(^和$),可能意外匹配子目录中的文件名
正则 <directory></directory> 是少数几个直接操作底层文件路径的容器之一,适合做细粒度的磁盘级权限隔离,但不适合做路由或 URL 层控制。










