讲师中心 微信公众号
AI工具推荐 视频效率加速

宝塔面板下如何为网站配置独立的反向代理缓存逻辑?

云宇姑娘_3308

云宇姑娘_3308

发布时间:2026-03-17 18:32:03

|

498人浏览过

|

来源于php中文网

原创

需在宝塔面板中通过站点级Nginx配置实现独立反向代理缓存:一、自定义proxy_cache_path与proxy_cache指令;二、用map动态生成cache_key;三、用if+proxy_no_cache跳过特定请求;四、为静态资源设专用cache_zone与缓存策略。

宝塔面板下如何为网站配置独立的反向代理缓存逻辑?

如果您在宝塔面板中托管多个网站,并希望为其中某个特定站点配置独立的反向代理缓存逻辑(如仅对该站启用缓存、设置专属缓存键、跳过特定路径缓存等),则需绕过全局反向代理缓存配置,采用站点级 Nginx 配置片段实现精细化控制。以下是具体操作步骤:

一、通过站点配置文件插入自定义 proxy_cache 指令

宝塔面板允许在站点配置中添加自定义 Nginx 配置,从而为该站点独立声明 cache_zone、cache_key、cache_valid 等指令,不与其他站点共享缓存区域或策略。

1、登录宝塔面板,进入【网站】列表,点击目标站点右侧的【设置】按钮。

2、切换到【配置文件】选项卡,在 location / { 块上方空白处(或在 server 块内合适位置)插入以下缓存区定义:
proxy_cache_path /www/server/nginx/proxy_cache/example_com levels=1:2 keys_zone=example_com:10m max_size=1g inactive=1h use_temp_path=off;

3、在该站点的反向代理 location 块中(例如 location ^~ /api/ { 或 location / {),添加缓存控制指令:
proxy_cache example_com;
proxy_cache_valid 200 302 10m;
proxy_cache_valid 404 1m;
proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;
proxy_cache_lock on;
proxy_cache_lock_timeout 5s;

4、保存配置后,点击【重载配置】使 Nginx 重新加载生效。

二、使用 map 指令动态生成独立 cache_key

通过 Nginx 的 map 模块可基于 Host、请求路径或 Cookie 动态构造 cache_key,确保不同子域名或用户会话的响应不被错误复用,实现逻辑隔离。

1、在宝塔面板【软件商店】中确认已安装并启用 Nginx(建议版本 ≥1.11.6),且未禁用 map 模块。

2、进入【网站】→【设置】→【配置文件】,在 http { 块顶部(即 server 块外)添加 map 定义:
map $host$request_uri $custom_cache_key {
  default "$host$request_uri";
  ~^www\.example\.com$ "$host$request_uri$args";
  ~^blog\.example\.com$ "$host$request_uri";
}

3、在对应站点的 location 块中,将原 proxy_cache_key 替换为:
proxy_cache_key $custom_cache_key;

4、保存配置并重载 Nginx。

三、通过 if 指令按条件跳过缓存

利用 if 判断请求头、Cookie 或 URI 路径,对特定流量(如含 auth_token 的请求、后台接口、调试路径)主动 bypass 缓存,保障数据实时性与安全性。

1、在站点配置文件的 location 块内(位于 proxy_pass 上方),插入缓存绕过逻辑:
if ($http_cookie ~* "auth_token|debug_mode") {
  set $skip_cache "1";
}
if ($request_uri ~* "^/(admin|api/v2|__debug__)") {
  set $skip_cache "1";
}

2、在同 location 块中添加缓存开关指令:
proxy_no_cache $skip_cache;
proxy_cache_bypass $skip_cache;

3、确保该 location 已启用 proxy_cache(参考第一部分),否则 skip 指令无效。

4、保存配置并重载 Nginx。

四、为静态资源启用独立缓存策略

针对 CSS、JS、图片等静态资源,可通过匹配后缀的 location 块单独配置更长缓存周期与专用 cache_zone,避免与动态内容共用同一缓存区导致驱逐干扰。

1、在站点配置文件的 server 块内,新增独立 location 块:
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff2|ttf|eot)$ {
  proxy_pass http://127.0.0.1:8080;
  proxy_cache static_assets;
  proxy_cache_valid 200 302 1d;
  proxy_cache_valid 404 1m;
  proxy_cache_use_stale error timeout updating http_500;
  expires 1d;
  add_header X-Cache-Status $upstream_cache_status;
}

2、在 http 块顶部(server 外)预先定义该 cache_zone:
proxy_cache_path /www/server/nginx/proxy_cache/static levels=1:2 keys_zone=static_assets:50m max_size=5g inactive=3d use_temp_path=off;

3、保存配置并重载 Nginx。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

100

2026.10.22

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

60

2026.10.22

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。

60

2026.10.22

Gradle怎么构建Java项目
Gradle怎么构建Java项目

本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。

20

2026.10.22

PHP时间戳漏洞修复教程
PHP时间戳漏洞修复教程

本专题汇总PHP常见时间戳漏洞,包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等,并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案,帮助开发者快速排查和加固时间相关代码。

60

2026.10.22

Golangci-lint配置文件与规则设置
Golangci-lint配置文件与规则设置

本专题聚焦Golangci-lint YAML配置文件,讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置,便于团队统一检查标准。

20

2026.10.22

Golangci-lint安装与入门教程
Golangci-lint安装与入门教程

本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查,覆盖本地环境、Docker及多平台用法,帮助Go开发者快速上手。

40

2026.10.22

PHP2Shell高危漏洞修复教程
PHP2Shell高危漏洞修复教程

PHP2Shell漏洞是什么,哪些PHP版本和运行环境会受到影响,服务器应该如何检测与修复?本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤,以及修复验证、临时缓解和应急响应方案。

280

2026.10.22

剧云人物设定与关系管理教程
剧云人物设定与关系管理教程

本专题介绍剧云人物设定与关系管理,讲解角色小传、性格职业、人物目标、背景资料和关系网络的创建及维护方法。

40

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn