Apache重写规则匹配已存在文件不生效问题求助（HestiaCP环境）

问题场景 #

我通过PHP脚本将JPG/PNG格式的图片转为WebP格式提供服务，配置了如下.htaccess规则：

RewriteEngine On
RewriteRule ^((lib|uploads)/.+)\.(jpe?g|png)$ incs/webp.php?file=$1.$3 [L]

但在HestiaCP部署的服务器上出现异常：

• 访问已存在的图片文件（如https://example.com/lib/image_exists.png）时，直接返回原静态图片，Rewrite规则完全不生效；
• 访问不存在的图片时，能正常触发PHP脚本并输出WebP格式图片。
  该规则在本地环境和其他非HestiaCP服务器上运行正常。

问题原因 #

HestiaCP默认采用NGINX+Apache的架构，NGINX作为前端代理会优先处理静态文件请求。当请求的图片文件实际存在时，NGINX直接读取并返回文件内容，不会将请求转发给Apache执行.htaccess中的Rewrite规则。

解决方案 #

需要修改NGINX配置，让lib和uploads目录下的图片请求强制转发给Apache处理，具体步骤如下：

1. 修改NGINX配置模板（推荐）

   • 登录HestiaCP后台，进入对应网站的Web管理页面；
   • 找到NGINX Template选项，选择自定义模板（若无自定义模板，可先创建基础模板副本）；
   • 在模板中添加针对目标目录的转发规则：

     # 针对lib和uploads目录下的图片请求，转发给Apache处理
     location ~* ^/(lib|uploads)/.+\.(jpg|jpeg|png)$ {
         proxy_pass http://127.0.0.1:8080; # 端口需与Apache实际监听端口一致，默认多为8080
         proxy_set_header Host $host;
         proxy_set_header X-Real-IP $remote_addr;
         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
         proxy_set_header X-Forwarded-Proto $scheme;
     }
     

   • 保存模板后，重启NGINX服务（可在HestiaCP后台Server->Services中操作）。

2. 直接修改站点NGINX配置文件
   若不想修改模板，可直接编辑站点的NGINX配置文件（路径通常为/home/[用户名]/web/[域名]/conf/nginx.conf），添加上述location规则后，执行systemctl restart nginx重启服务。

补充说明 #

如果原有NGINX配置中存在全局的静态图片处理规则（如缓存设置），也可以通过条件判断排除lib和uploads目录，示例：

location ~* \.(jpg|jpeg|png)$ {
    # 当请求路径属于lib或uploads目录时，转发给Apache
    if ($request_uri ~* ^/(lib|uploads)/) {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        break;
    }
    # 其他静态图片的缓存配置
    expires 30d;
    add_header Cache-Control "public, no-transform";
}

内容的提问来源于stack exchange，提问作者Muhammed