Apache DocumentRoot 配合代理缓存怎么配-Apache-PHP中文网

documentroot与代理缓存（mod_cache）作用对象不同，不可直接配合：前者服务本地静态文件，后者缓存反向代理的动态响应；需通过路径分离（如/static/走documentroot、/api/走proxypass+cacheenable）、缓存目录独立设置及环境变量精细控制缓存条件来协同工作。

apache documentroot 配合代理缓存怎么配

DocumentRoot 和代理缓存（mod_cache）是两个不同层级的功能，不能直接“配合”使用，因为它们作用对象完全不同：

DocumentRoot 定义的是 Apache 作为静态文件服务器时的根目录，响应的是本地磁盘上的 .html、.js、.css 等静态资源；
代理缓存（mod_cache_disk + mod_proxy）针对的是反向代理转发后的动态响应（如 /api/xxx），缓存的是从后端（PHP、Java、Node.js 等）返回的内容，和 DocumentRoot 下的文件无关。

但如果你的目标是：让 Apache 同时服务静态资源（走 DocumentRoot）+ 缓存动态 API（走 ProxyPass + CacheEnable），那就需要明确分工、避免冲突。以下是关键配置逻辑和实操要点：

✅ 明确职责边界：静态 vs 动态路径分离

Apache 必须区分哪些请求该走本地文件系统（DocumentRoot），哪些该走反向代理并缓存。典型做法是用路径前缀做路由判断：

/ 或 /static/ → 指向 DocumentRoot，可配 mod_expires 做浏览器缓存
/api/ 或 /v1/ → 用 ProxyPass 转发，并在 <locationmatch></locationmatch> 中启用 CacheEnable disk

示例配置片段：

DocumentRoot "/var/www/html"

# 静态资源：直接读取磁盘，不走代理
<directory>
    Require all granted
</directory>

# 动态 API：转发并缓存
ProxyPass "/api/" "http://backend-server:8080/api/"
ProxyPassReverse "/api/" "http://backend-server:8080/api/"

<locationmatch>
    CacheEnable disk
    CacheIgnoreHeaders Set-Cookie Vary
    CacheStorePrivate Off
    CacheStoreNoStore Off
</locationmatch>

⚠️ 注意：DocumentRoot 的路径不能覆盖代理路径（比如 DocumentRoot "/var/www/html" 和 ProxyPass "/api/" 是安全的；但如果设成 DocumentRoot "/var/www/html/api"，Apache 会优先尝试找本地文件，导致代理失效）。

✅ 缓存目录独立于 DocumentRoot

mod_cache_disk 的缓存文件必须放在单独目录，且不能是 DocumentRoot 子目录（否则可能被意外暴露或权限冲突）：

Apache Superset Dashboard and SQL Exploration Skill

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

<ifmodule mod_cache_disk.c>
    CacheRoot "/var/cache/apache2/proxy_cache"
    CacheDirLevels 2
    CacheDirLength 1
</ifmodule>

执行：

sudo mkdir -p /var/cache/apache2/proxy_cache
sudo chown www-data:www-data /var/cache/apache2/proxy_cache

✅ 避免缓存污染：用环境变量精细控制

不是所有 /api/ 请求都该缓存。需过滤出安全、幂等、无用户上下文的 GET 请求：

SetEnvIfNoCase Request_Method "GET" is_cacheable=1
SetEnvIfNoCase Cookie "(^|;\s*)auth_token=|session=" no_cache=1
SetEnvIfNoCase Authorization "^Bearer " no_cache=1

<locationmatch>
    CacheEnable disk env=is_cacheable:!no_cache
</locationmatch>

这样即使请求路径匹配 /api/，只要带 Token 或 Cookie，就不会进缓存。