宝塔面板反向代理缓存配置指南

一、准备工作

1. 确保已安装宝塔面板（建议最新版本）
2. 已添加网站并配置好基本环境（Nginx/Apache）
3. 确保服务器有足够内存用于缓存

二、Nginx反向代理缓存配置步骤

1. 通过宝塔面板配置反向代理

1. 登录宝塔面板
2. 进入"网站" → 选择要配置的网站 → "设置"
3. 选择"反向代理"标签页
4. 点击"添加反向代理"
   • 代理名称：自定义（如cache_proxy）
   • 目标URL：填写要代理的后端服务器地址（如http://127.0.0.1:8080）
   • 发送域名：通常填写$host
   • 其他选项保持默认
5. 点击"提交"

2. 配置缓存参数

1. 返回网站设置 → "配置文件"
2. 在Nginx配置文件中添加缓存配置（通常在server块内）：

# 代理缓存路径配置
proxy_cache_path /www/server/nginx/proxy_cache_dir levels=1:2 keys_zone=my_cache:10m inactive=60m use_temp_path=off max_size=1g;

server {
    # ... 其他原有配置 ...

    location / {
        proxy_pass http://127.0.0.1:8080; # 与之前设置的目标URL一致

        # 缓存配置
        proxy_cache my_cache;
        proxy_cache_key $scheme$proxy_host$request_uri;
        proxy_cache_valid 200 304 10m;
        proxy_cache_valid 301 302 1h;
        proxy_cache_valid any 1m;

        # 其他代理设置
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # 可选：添加缓存状态头信息
        add_header X-Proxy-Cache $upstream_cache_status;
    }
}

3. 创建缓存目录并设置权限

1. SSH登录服务器执行：

mkdir -p /www/server/nginx/proxy_cache_dir
chown -R www:www /www/server/nginx/proxy_cache_dir
chmod -R 755 /www/server/nginx/proxy_cache_dir

4. 重载Nginx配置

1. 在宝塔面板中：
   • 进入"软件商店" → 找到Nginx → "设置"
   • 点击"重载配置"
2. 或通过SSH执行：

nginx -t && nginx -s reload

三、高级配置选项

1. 缓存排除设置

在location块中添加不需要缓存的规则：

# 不缓存后台管理页面
location /admin {
    proxy_pass http://127.0.0.1:8080;
    proxy_no_cache 1;
    proxy_cache_bypass 1;
}

# 或根据Cookie排除
if ($http_cookie ~* "nocache") {
    set $no_cache 1;
}
proxy_no_cache $no_cache;
proxy_cache_bypass $no_cache;

2. 缓存清理配置

添加缓存清理接口（注意保护此接口）：

location ~ /purge(/.*) {
    allow 127.0.0.1;
    allow 192.168.1.0/24;
    deny all;
    proxy_cache_purge my_cache $scheme$proxy_host$1;
}

3. 缓存性能优化

proxy_buffering on;
proxy_buffer_size 4k;
proxy_buffers 8 1m;
proxy_busy_buffers_size 2m;
proxy_temp_file_write_size 2m;
proxy_max_temp_file_size 128m;

四、验证缓存是否生效

1. 访问网站页面
2. 查看响应头，应包含X-Proxy-Cache字段，其值可能为：
   • MISS：未命中缓存，从后端获取
   • HIT：命中缓存
   • BYPASS：绕过缓存
3. 检查缓存目录是否有文件生成

五、常见问题解决

1. 缓存不生效：

   • 检查Nginx错误日志：cat /www/wwwlogs/nginx_error.log
   • 确认缓存目录权限正确
   • 检查proxy_cache_valid设置的时间是否合理

2. 缓存占用空间过大：

   • 调整max_size参数限制最大缓存大小
   • 设置较短的inactive时间使不活跃缓存自动清理
   • 定期清理缓存目录

3. 动态内容被缓存：

   • 为动态请求添加缓存排除规则
   • 使用Cookie或URL参数区分动态请求

通过以上步骤，您可以在宝塔面板中成功配置Nginx反向代理缓存，显著提升网站性能。