怎么配置 Apache 代理为后端接口添加统一缓存标识

冰川箭仙

冰川箭仙

2026-06-15

785人浏览

原创

apache反向代理中通过header指令注入x-cached-by等自定义响应头实现统一缓存标识,需启用mod_headers等模块,在virtualhost中配置header always set,并可结合mod_cache_disk用环境变量区分hit/miss。

怎么配置 apache 代理为后端接口添加统一缓存标识

直接在 Apache 的反向代理配置中添加统一缓存标识,核心是通过 Header 指令注入自定义响应头(如 X-Cache-StatusX-Cached-By),让所有经由该代理返回的后端接口响应都带上可识别的缓存标记。这个标识不参与缓存逻辑本身,但对监控、调试和灰度判断非常实用。

启用必要模块并确认支持

确保以下模块已启用:

  • mod_headers:用于设置/修改 HTTP 响应头(必需)
  • mod_proxymod_proxy_http:支撑反向代理功能
  • mod_cachemod_cache_disk(如需实际缓存):非标识必需,但常配套使用

Ubuntu/Debian 系统执行:

sudo a2enmod headers proxy proxy_http cache cache_disk
syntax systemctl restart apache2

在 Proxy 配置块中注入统一缓存标识

在你的 <virtualhost></virtualhost><location></location> 代理段内,添加 Header always set 指令:


ServerName api.example.com
ProxyPass / http://backend-service:8080/
ProxyPassReverse / http://backend-service:8080/

# 统一注入缓存标识(所有响应都会带此头)
Header always set X-Cached-By "Apache-Proxy"
Header always set X-Cache-Mode "disk-cache-enabled"

# 可选:仅对 GET/HEAD 缓存型请求添加更细粒度标识

Header always set X-Cache-Scope "read-only"

这样,无论后端返回 200、404 还是 500,只要走这个代理路径,响应里都会包含 X-Cached-By: Apache-Proxy,便于前端或日志系统快速识别流量来源。

Apache 2.4.62
Apache 2.4.62

PHP中文网提供Apache 2.4.62 官方 tar.gz 源码包下载,通过源码编译安装,开发者能够灵活定制模块、优化性能并精准控制安装路径,满足多样化的业务需求。

下载

配合真实缓存时增强语义(推荐)

如果你同时启用了 mod_cache_disk,可进一步用条件头区分缓存命中与未命中:

# 启用磁盘缓存
CacheEnable disk /
CacheRoot /var/cache/apache2/mod_cache_disk
CacheIgnoreHeaders Set-Cookie
CacheDefaultExpire 600

# 缓存命中时加 HIT 标识
Header edit Cache-Control "^(.*)$" "$1, must-revalidate"
Header always set X-Cache "%{cache-status}e" env=cache-status
Header always set X-Cache-Hit "1" env=cache-hit
Header always set X-Cache-Miss "1" env=cache-miss

其中 %{cache-status}e 是 Apache 内置环境变量,值为 HITMISScache-hit/cache-miss 环境变量由 mod_cache 自动设置。这比静态标识更能反映真实缓存行为。

验证是否生效

用 curl 测试:

curl -I http://api.example.com/users/123

观察响应头中是否出现:

X-Cached-By: Apache-Proxy
X-Cache: HIT # 或 MISS
X-Cache-Hit: 1 # 若命中

注意:浏览器开发者工具的 Network 面板也能看到这些头,但需禁用“Disable cache”选项才能观察到真实缓存行为。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

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

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1111

5

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

2154

13

后端的主要工作内容介绍
后端的主要工作内容介绍

后端是应用程序的服务端部分,负责核心任务,如数据库交互、业务逻辑处理和响应客户端请求。想了解更多后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

2678

10

nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.27

339

5

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

1729

6

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

2023.08.04

2149

6

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

416

5

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.07.09

1245

5

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

2024.08.07

3811

3

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程