Nginx缓存配置提升海外访问：Nginx缓存配置指南

知识分享

2026-06-24 01:00

31 阅读

当你把网站服务器放在国内，海外用户访问时常常遇到加载慢、图片打不开的情况。
一个简单有效的解决办法就是启用Nginx缓存——把静态资源或整个页面缓存到服务器本地，后续请求直接用缓存响应，大幅缩短跨国传输时间。

本文适合没有接触过Nginx缓存的站长，所有操作只要按步骤来，前后不超过20分钟。

开始配置前需要确认的内容

首先确保你的服务器满足以下条件：

已安装Nginx：不知道是否安装？在终端输入 nginx -v，如果显示版本号说明已安装。
Nginx编译了proxy_cache模块：默认情况下标准Nginx都包含此模块。输入 nginx -V 2>&1 | grep -o proxy_cache，有输出就代表支持。
服务器有空闲磁盘空间：缓存需要占用硬盘，建议至少预留2GB空间给缓存目录。

如果你用的是宝塔面板，可以在“软件商店”里确认Nginx版本，并通过面板文件管理器创建缓存目录。

一步步配置Nginx缓存加速海外访问

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

mkdir -p /var/cache/nginx
chown -R www-data:www-data /var/cache/nginx
chmod 755 /var/cache/nginx

如果你用的是其他用户运行Nginx（比如nginx或www），请对应修改。宝塔用户通常用www。

2. 在Nginx配置中定义缓存路径

编辑Nginx主配置文件（通常位于/etc/nginx/nginx.conf），在http {}块内添加如下内容：

proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=cache_one:100m inactive=7d max_size=10g use_temp_path=off;

参数说明：

levels=1:2：缓存目录层级结构，分散文件防止单目录文件过多。
keys_zone=cache_one:100m：缓存key共享内存区，100MB足够缓存大量元数据。
inactive=7d：如果7天内没有被访问，自动删除。
max_size=10g：缓存最大10GB，超过后会自动淘汰最旧数据。
use_temp_path=off：直接写入缓存目录，避免零时文件额外I/O。

3. 在需要缓存的站点配置中应用缓存

示例：为静态资源（css, js, 图片等）开启缓存。

server {
    listen 80;
    server_name example.com;
    
    location / {
        proxy_pass http://后端服务器地址;  # 比如你的应用服务器
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        
        # 启用缓存
        proxy_cache cache_one;
        proxy_cache_key $scheme$proxy_host$uri$is_args$args;
        proxy_cache_valid 200 302 12h;
        proxy_cache_valid 404 1m;
        proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;
        proxy_cache_revalidate on;
        proxy_cache_lock on;
        add_header X-Cache $upstream_cache_status;
        add_header Cache-Control public;
    }

    # 也可以单独对静态文件目录开启更长时间缓存
    location ~*\.(jpg|jpeg|png|gif|ico|css|js)$ {
        proxy_cache cache_one;
        proxy_cache_key $scheme$proxy_host$uri;
        proxy_cache_valid 200 30d;
        proxy_cache_valid any 1d;
        add_header X-Cache $upstream_cache_status;
        proxy_pass http://后端服务器地址;
    }
}

检查配置并重启：

nginx -t
systemctl reload nginx   # 或者 service nginx reload

避坑与优化：常见问题注意

缓存不生效：检查proxy_cache是否拼写正确，确认缓存目录权限可写。用tail -f /var/log/nginx/error.log查看错误。
海外用户看不到X-Cache头：确保add_header X-Cache写在location内，并且没有被其他add_header覆盖。
磁盘写满：监控缓存目录大小，可以设置inactive时间更短，或提高max_size。
动态内容也被缓存：对于需要实时更新的页面，可以在location内用proxy_cache_bypass或proxy_no_cache条件排除，比如根据Cookie判断登录状态。
缓存雪崩：当大量缓存同时过期，请求直冲后端。建议设置inactive不同过期时间，或加入proxy_cache_use_stale用过期缓存应对临时故障。

验证效果：确保缓存生效

用curl命令测试：

curl -I https://你的网站/某个静态资源.jpg

返回的响应头中如果出现 X-Cache: MISS 表示第一次访问（未命中），再访问一次出现 X-Cache: HIT 说明缓存生效。
你也可以用海外节点（如阿里云海外服务器或在线测速工具）来确认访问速度是否明显提升。

高频问题解答（FAQ）

Q：配置后重启报错“proxy_cache_path” directive is duplicate？
A：检查是否在http块中重复添加了proxy_cache_path，每个缓存区域只能定义一次。

Q：宝塔面板怎么配置？
A：在宝塔网站设置的“配置文件”中，找到对应server块，在location里手动添加上述缓存配置，并记得在http块（宝塔面板的Nginx配置文件顶部）添加proxy_cache_path。

Q：海外用户仍然慢，怎么办？
A：除了缓存，还可以考虑使用CDN（如Cloudflare免费版）或购买海外服务器做反向代理，Nginx缓存可以极大缓解后端压力，但物理距离无法完全消除。

Q：缓存如何手动清除？
A：找到对应的缓存文件路径，删除即可。也可以通过安装ngx_cache_purge模块实现proxy_cache_purge指令（需重新编译Nginx）。

如果你正在处理Nginx缓存配置提升海外访问速度的问题，建议先按本文步骤完整执行，再根据自己的环境做微调；
遇到异常时优先回看避坑和高频问题部分。

Nginx反向代理多跨境站点配置详解

Nginx日志切割自动清理磁盘