需手动配置Nginx反向代理缓存:一、在站点配置文件location块中添加proxy_cache等指令;二、在Nginx主配置http块中声明cache_zone路径;三、透传缓存头并启用revalidate;四、重载配置后用curl验证X-Cache-Status;五、通过purge接口清理缓存。

如果您在宝塔面板中已设置反向代理,但希望进一步优化静态资源响应速度与后端负载,则需手动配置反向代理的缓存参数。以下是具体操作步骤:
一、修改反向代理配置文件
宝塔面板的反向代理规则最终生成于 Nginx 配置文件中,需直接编辑该配置以添加缓存指令。缓存行为由 proxy_cache 相关指令控制,依赖预定义的缓存区和路径。
1、进入宝塔面板,点击左侧【网站】,找到目标站点,点击右侧【设置】。
2、切换到【反向代理】选项卡,确认已存在一条有效的反向代理规则(如代理至 http://127.0.0.1:3000)。
3、点击【配置文件】按钮,定位到 location 块内 proxy_pass 行所在区域。
4、在 location 块内 proxy_pass 指令下方,插入以下缓存相关指令:
proxy_cache cache_one;
proxy_cache_valid 200 301 302 1h;
proxy_cache_valid 404 1m;
proxy_cache_use_stale updating error timeout http_500 http_502 http_503 http_504;
proxy_cache_lock on;
proxy_cache_lock_timeout 5s;
proxy_cache_min_uses 2;
proxy_cache_key $scheme$host$request_uri$is_args$args;
二、配置全局缓存区(cache_zone)
Nginx 要求 proxy_cache 指令引用的缓存区必须在 http 块中预先声明。宝塔默认未启用该功能,需手动追加至主配置。
1、在宝塔面板左侧菜单点击【软件商店】→ 找到已安装的 Nginx → 点击【设置】→ 【配置修改】。
2、在 http { ... } 块顶部(通常位于 include mime.types; 上方),添加以下代码段:
proxy_cache_path /www/server/nginx/proxy_cache levels=1:2 keys_zone=cache_one:10m inactive=30m max_size=1g;
3、确保 /www/server/nginx/proxy_cache 目录存在且 Nginx 进程具有读写权限:
mkdir -p /www/server/nginx/proxy_cache
chown www:www /www/server/nginx/proxy_cache
chmod 755 /www/server/nginx/proxy_cache
三、启用缓存头透传与校验控制
为确保后端应用可正确参与缓存决策(如通过 Cache-Control 或 ETag),需显式开启响应头透传及条件请求支持。
1、回到站点【配置文件】页面,在同一 location 块中 proxy_cache 指令附近添加:
proxy_ignore_headers Cache-Control Expires Set-Cookie;
2、若后端返回了 ETag 或 Last-Modified,且您希望 Nginx 在缓存有效时自动处理 If-None-Match / If-Modified-Since 请求,则补充:
proxy_cache_revalidate on;
3、为便于调试,可临时添加响应头标识缓存状态:
add_header X-Cache-Status $upstream_cache_status;
四、重启 Nginx 并验证缓存生效
配置修改后必须重载 Nginx 配置才能使缓存指令生效;仅重启服务不足以保证缓存区初始化完成。
1、保存所有配置文件修改后,返回【软件商店】→ Nginx → 【重载配置】。
2、使用 curl 命令访问站点资源并检查响应头:
curl -I https://your-domain.com/static/logo.png
3、观察返回头中是否包含 X-Cache-Status: HIT 或 X-Cache-Status: MISS 字段。
4、连续两次请求同一资源,首次应为 MISS,第二次若返回 HIT,则表明缓存机制已正常工作。
五、调整缓存清理策略
当需要主动清除特定 URL 缓存或批量失效时,宝塔未提供图形化入口,须通过 Nginx 的 proxy_cache_purge 模块实现,该模块需提前编译启用。
1、确认当前 Nginx 版本是否已编译 --with-http_proxy_cache_purge_module:在【软件商店】→ Nginx → 【配置修改】中执行 nginx -V 2>&1 | grep -o with-http_proxy_cache_purge_module。
2、若输出为空,需重新编译安装支持 purge 的 Nginx 版本。
3、在站点配置文件的 server 块中(非 location 内),添加 purge 接口配置:
location ~ /purge(/.*) {
proxy_cache_purge cache_one $scheme$host$1$is_args$args;
}
4、配置完成后,可通过访问 https://your-domain.com/purge/your-path 清除对应路径缓存。










