宝塔反向代理缓存设置详解

本文详细讲解了如何在宝塔面板中手动配置Nginx反向代理缓存，以显著提升静态资源访问速度、减轻后端服务器压力；从修改站点location块添加缓存指令、全局声明cache_zone路径与权限设置，到透传缓存头、启用revalidate校验机制和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 清除对应路径缓存。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~