在 linux 中开启 nginx 缓存并指定存储路径,需要在 http 块中使用 proxy_cache_path 指令定义路径和参数,并在 location 块中通过 proxy_cache 启用该缓存区域。配置完成后,nginx 会将代理响应的内容存储在指定的磁盘目录中,后续相同请求将直接读取本地文件,从而减少后端负载。

如何配置 proxy_cache_path 以指定存储路径和基本参数
要指定缓存的存储路径,必须在 nginx.conf 的全局 http 上下文中使用 proxy_cache_path 指令。该指令定义了缓存数据的存放位置、共享内存区域名称以及缓存管理的策略。例如,设置路径为 /var/cache/nginx/proxy,并分配 10m 的内存区域用于存储索引,同时限制最大磁盘占用为 1g。配置时需注意确保 Nginx 运行用户(通常是 www-data 或 nginx)对该目录具有读写权限。

proxy_cache_path /var/cache/nginx/proxy levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m use_temp_path=off;
上述配置中,levels=1:2 表示缓存目录层级结构,keys_zone 定义了共享内存区域及其大小,max_size 限制磁盘使用量,inactive 指定非活跃缓存项的保留时间。若目录不存在,需手动创建并赋予正确权限:mkdir -p /var/cache/nginx/proxy && chown www-data:www-data /var/cache/nginx/proxy。
如何在 location 块中启用缓存并关联缓存区域
在定义好缓存路径后,需在具体的 location 块中启用缓存功能。通过 proxy_cache my_cache 引用之前定义的共享内存区域名称,并结合 proxy_cache_valid 设置不同响应码的缓存时长。例如,对 200 和 301 响应缓存 10m,对其他响应缓存 1m。同时,必须配置 proxy_pass 指向后端服务器,否则缓存无法生效。

server { listen 80; server_name example.com; location / { proxy_pass http://backend_server; proxy_cache my_cache; proxy_cache_valid 200 301 10m; proxy_cache_valid 404 1m; add_header X-Cache-Status $upstream_cache_status; }} 此配置中,$upstream_cache_status 变量可用于调试,显示当前请求是命中缓存(HIT)、未命中(MISS)还是其他状态。重启 Nginx 服务使配置生效:systemctl restart nginx。验证缓存是否工作可通过多次访问同一 URL,观察响应头中 X-Cache-Status 的值变化。
当缓存目录权限不足时会发生什么错误及如何解决
如果 Nginx 运行用户对指定的缓存路径没有写权限,Nginx 将无法写入缓存文件,导致所有请求均返回 500 Internal Server Error 或日志中出现 permission denied 错误。此时需检查目录所有者和权限设置。例如,若 Nginx 以 www-data 用户运行,执行 chown -R www-data:www-data /var/cache/nginx/proxy 并设置权限 chmod 755 /var/cache/nginx/proxy。此外,SELinux 或 AppArmor 等安全模块也可能阻止写入,需相应调整策略或临时禁用测试。


















