Nginx实现动态内容缓存的示例代码_缓存

在 nginx 中实现动态内容的缓存可以显著提高性能，减少后端服务器的负载。以下是如何在 nginx 中配置动态内容缓存的详细步骤和示例配置。

1. 安装 nginx

确保你已经安装了 nginx。如果没有安装，可以使用以下命令进行安装：

sudo apt-get update
sudo apt-get install nginx

2. 配置缓存目录

首先，定义一个缓存目录，用于存储缓存的数据。

示例配置：

http {
    # 定义缓存区
    proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m use_temp_path=off;

    server {
        listen 80;
        server_name example.com;

        # 配置缓存
        location / {
            proxy_pass http://backend;
            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;

            # 启用缓存
            proxy_cache my_cache;
            proxy_cache_key "$scheme$request_method$host$request_uri";
            proxy_cache_valid 200 301 302 10m;
            proxy_cache_valid 404 1m;

            # 添加缓存控制头
            add_header x-proxy-cache $upstream_cache_status;
        }
    }
}

3. 参数解释

proxy_cache_path：定义缓存目录的路径、层级结构、缓存区名称、最大大小和活动时间。
- /var/cache/nginx：缓存目录路径。
- levels=1:2：缓存文件的层级结构，例如 1:2 表示两级目录。
- keys_zone=my_cache:10m：缓存区名称和大小，10mb。
- max_size=1g：缓存的最大大小，1gb。
- inactive=60m：缓存项在不活跃多久后会被删除，60分钟。
- use_temp_path=off：禁用临时文件路径，直接写入缓存目录。
proxy_cache：启用缓存，指定缓存区名称。
proxy_cache_key：定义缓存键，用于唯一标识缓存项。
- "$scheme$request_method$host$request_uri"：缓存键包含协议、请求方法、主机名和请求uri。
proxy_cache_valid：设置不同 http 状态码的缓存时间。
- 200 301 302 10m：200、301 和 302 状态码的缓存时间为 10 分钟。
- 404 1m：404 状态码的缓存时间为 1 分钟。
add_header x-proxy-cache $upstream_cache_status：添加一个响应头，显示缓存状态（hit、miss、bypass 等）。

4. 配置缓存忽略查询字符串

如果需要忽略查询字符串，可以在缓存键中排除查询字符串。

示例配置：

http {
    # 定义缓存区
    proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m use_temp_path=off;

    server {
        listen 80;
        server_name example.com;

        # 配置缓存
        location / {
            proxy_pass http://backend;
            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;

            # 启用缓存
            proxy_cache my_cache;
            proxy_cache_key "$scheme$request_method$host$request_uri";
            proxy_cache_valid 200 301 302 10m;
            proxy_cache_valid 404 1m;

            # 忽略查询字符串
            proxy_ignore_headers cache-control;
            proxy_cache_bypass $http_pragma $http_authorization;
            proxy_no_cache $http_pragma $http_authorization;

            # 添加缓存控制头
            add_header x-proxy-cache $upstream_cache_status;
        }
    }
}

5. 测试配置

在重新加载 nginx 之前，先测试配置文件是否有语法错误。

sudo nginx -t

6. 重新加载 nginx

如果配置文件没有问题，重新加载 nginx 使配置生效。

sudo systemctl reload nginx

7. 验证缓存

可以通过查看响应头中的 x-proxy-cache 字段来验证缓存是否生效。

示例请求：

curl -i http://example.com/some-dynamic-content

示例响应：

http/1.1 200 ok
server: nginx/1.21.3
date: tue, 12 oct 2021 12:34:56 gmt
content-type: text/html
content-length: 1234
connection: keep-alive
x-proxy-cache: hit