宝塔nginx静态缓存需手动配置location规则并确保前端资源路径指向cdn域名,七牛云插件开关无效;须放行cdn回源ip、禁用cdn端冲突功能,并统一静态资源引用地址。

宝塔里配Nginx静态资源缓存,别碰「七牛云插件」那个开关
那个开关根本没生效——源码里搜不到 qiniu,日志里也看不到调用记录,panel.log 里压根不写七牛相关动作。它不是“没配好”,是压根没接入。真要走七牛,得靠反向代理或前端构建时替换域名,而不是指望面板里那个形同虚设的按钮。
在网站配置文件里加 location 块匹配静态后缀
直接进「网站 → 设置 → 配置文件」,在 server 块里插入以下规则(放在所有 location ~* \.(js|css|...) 前面更稳妥):
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff2|ttf|eot|pdf|xml|txt)$ {
expires 1y;
add_header Cache-Control "public, immutable";
add_header X-Content-Type-Options nosniff;
try_files $uri =404;
}
-
expires 1y是浏览器端缓存,但 CDN 是否尊重它取决于你回源策略; -
Cache-Control: public, immutable比max-age=31536000更明确,告诉中间节点“这资源不会变”,避免误刷新; -
try_files $uri =404必须加,否则 Nginx 可能把请求透传给 PHP,导致动态响应被缓存; - 如果静态资源放在
/static/或/uploads/子目录,建议改用前缀匹配(如location ^~ /static/),比后缀匹配更精准、优先级更高。
CDN 回源时 Nginx 要允许真实 IP 访问
很多 CDN(比如阿里云、腾讯云)回源用的是固定 IP 段,但宝塔防火墙默认会拦截非公网直连请求。结果就是:用户能访问 CDN,CDN 却拿不到源站响应,出现 502 或超时。
- 进「安全 → 防火墙」插件,找到对应站点,勾选「启用 CDN 模式」;
- 如果用了自定义 Nginx 规则(比如限制
allow/deny),得手动放行 CDN 官方公布的回源 IP 段; - 检查 Nginx 日志:
tail -f /www/wwwlogs/your-site.error.log,看到Connection refused或no live upstreams就基本是回源不通; - 不要在 CDN 控制台开启「强制 HTTPS 回源」以外的压缩、HTML 缓存等功能,容易和 Nginx 的
gzip或expires冲突。
前端资源路径不改,Nginx 配再好也没用
你配了 expires 1y,但 HTML 里还是写 /css/app.css,浏览器就永远去源站拉,CDN 根本没机会缓存。这不是 Nginx 的问题,是资源引用没切过去。
- Webpack/Vite 项目:改
publicPath或base为https://static.example.com/; - PHP 模板(如 ThinkPHP、Laravel Blade):定义常量
STATIC_HOST,统一拼接路径; - 实在没法改代码?可用 Nginx
sub_filter替换响应体中的路径(但只适用于 HTML,且有性能开销); - 千万别用
rewrite ... permanent跳转,每次请求多一次 302,首屏加载反而更慢。
实际部署中最容易被跳过的,是前端资源 URL 和 CDN 域名的对齐。Nginx 缓存头再标准,只要 <link href="/css/main.css"> 这种写法还留在 HTML 里,所有加速配置就只是纸上谈兵。











