如何配置Debian Apache缓存

Debian 上配置 Apache 缓存的完整指南

一 方案总览

• 在 Debian 上，Apache 的缓存通常分为三层：
  • 磁盘缓存：使用 mod_cache_disk 将可缓存的响应落到磁盘，适合代理或动态内容加速。
  • 浏览器缓存：使用 mod_expires 设置 Cache-Control/Expires，让客户端长期复用资源。
  • 文件句柄/静态文件缓存：使用 mod_file_cache 将静态文件常驻内存，减少磁盘 I/O。

二 启用模块

• 安装所需模块（若尚未安装）：
  • sudo apt-get update
  • sudo apt-get install libapache2-mod-cache libapache2-mod-cache-disk
• 启用模块：
  • sudo a2enmod cache
  • sudo a2enmod cache_disk
  • sudo a2enmod expires
  • sudo a2enmod file_cache
• 使配置生效：
  • sudo systemctl restart apache2
• 说明：在部分系统上，相关模块可能已预装，上述命令为幂等操作，未安装时会自动安装，已安装则提示已启用。

三 配置磁盘缓存 CacheEnable disk

• 准备缓存目录并设置权限：
  • sudo mkdir -p /var/cache/apache2/mod_cache_disk
  • sudo chown -R www-data:www-data /var/cache/apache2/mod_cache_disk
  • sudo chmod -R 755 /var/cache/apache2/mod_cache_disk
• 全局或虚拟主机启用磁盘缓存（示例为全局配置，也可放入 或 /）：
  • CacheEnable disk / CacheRoot "/var/cache/apache2/mod_cache_disk" CacheDirLevels 2 CacheDirLength 1 CacheIgnoreHeaders Set-Cookie CacheIgnoreNoLastMod On CacheDefaultExpire 3600 CacheMaxExpire 86400 CacheMinExpire 600 CacheLockOnPost On CacheLockPath /tmp/mod_cache_lock CacheLockMaxAge 5 CacheStorePrivateFiles On CacheableMimeType text/html text/css application/javascript
• 仅对特定路径启用（示例）：
  • < Location “/static”> CacheEnable disk CacheDefaultExpire 3600
• 关键参数说明：
  • CacheEnable disk [/path]：对指定路径启用磁盘缓存；/ 表示全局。
  • CacheRoot：缓存根目录，需可写且归属 www-data。
  • CacheDirLevels/CacheDirLength：缓存目录层级与长度，利于海量小文件存储。
  • CacheIgnoreHeaders Set-Cookie：遇到 Set-Cookie 时不缓存（避免私有会话泄露）。
  • CacheIgnoreNoLastMod On：无 Last-Modified 也允许缓存（配合默认过期）。
  • CacheDefaultExpire/CacheMaxExpire/CacheMinExpire：默认/最大/最小过期时间（秒）。
  • CacheLockOnPost/CacheLockPath/CacheLockMaxAge：并发写保护，避免重复生成。
  • CacheStorePrivateFiles On：允许缓存带 Cache-Control: private 的响应（按需开启）。
  • CacheableMimeType：仅缓存指定 MIME 类型，提升命中率与安全性。

四 配置浏览器缓存 mod_expires

• 在 或 中启用：
  • ExpiresActive On ExpiresDefault "access plus 1 week" ExpiresByType text/html "access plus 1 hour" ExpiresByType text/css "access plus 1 month" ExpiresByType application/javascript "access plus 1 month" ExpiresByType image/jpeg "access plus 1 year" ExpiresByType image/png "access plus 1 year" ExpiresByType image/gif "access plus 1 year"
• 说明：为不同类型设置差异化 max-age，静态资源（如图片、字体、视频）可设置更长周期；text/html 通常较短或配合协商缓存（ETag/Last-Modified）。

五 验证与注意事项

• 验证配置与生效：
  • 语法检查：sudo apache2ctl configtest
  • 重启服务：sudo systemctl restart apache2
  • 查看响应头：curl -I https://your-domain/static/app.js
    • 期望看到：Cache-Control: public, max-age=… 或 Expires: …；命中磁盘缓存时，部分环境会带 X-Cache: HIT（取决于是否启用相关模块/代理）。
• 常见问题与建议：
  • 动态、带 Set-Cookie、带 Authorization 或用户私有内容不应被缓存；必要时使用 Vary 与更严格的 Cache-Control。
  • 静态资源建议配合 强缓存（长 max-age）+ 文件名哈希 或 ETag，实现“长期缓存 + 变更即失效”。
  • 目录权限与磁盘空间：确保 /var/cache/apache2/mod_cache_disk 可写且磁盘充足；定期清理陈旧缓存。
  • 高并发写入场景建议开启 CacheLockOnPost 并合理设置 CacheLockMaxAge，避免“缓存击穿”。
  • 若需对少量热点静态文件做极致加速，可结合 mod_file_cache 的 CacheFile 指令（适合体积较小且极少变更的文件）。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！