在 nginx 中配置代理静态资源服务,核心是利用 location 块结合 proxy_pass 指令将请求转发给后端服务器。具体做法是在 server 块中定义匹配路径(如 /static/),并在其中设置 proxy_pass http://backend_ip:port;,同时建议添加 proxy_set_header 以传递正确的客户端信息。这样配置后,nginx 会作为反向代理,把对静态资源的请求转交给指定的后端服务处理。

如何配置 location 和 proxy_pass 实现基本代理
要实现基本的静态资源代理,需要在 Nginx 配置文件中创建一个 location 块,指定 URL 前缀,并使用 proxy_pass 指向目标服务器的地址。例如,如果希望所有以 /assets/ 开头的请求都被代理到运行在本地 8080 端口的 Node.js 服务,配置如下:

server {
listen 80;
server_name example.com;
# 匹配 /assets/ 开头的请求
location /assets/ {
# 代理到后端服务
proxy_pass http://127.0.0.1:8080/;
# 传递原始 Host 头
proxy_set_header Host $host;
# 传递真实客户端 IP
proxy_set_header X-Real-IP $remote_addr;
# 传递真实客户端 IP (X-Forwarded-For)
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}上述配置中,proxy_pass 后面的 URL 末尾带有斜杠 /,这意味着当请求路径为 /assets/image.png 时,Nginx 会将路径中的 /assets/ 部分去除,并将剩余部分 image.png 追加到后端 URL 上,即实际向后端发送的请求是 http://127.0.0.1:8080/image.png。如果不加斜杠,则会将完整路径 /assets/image.png 传递给后端。通常对于静态资源,我们希望去掉前缀,因此建议保留斜杠。此外,proxy_set_header 确保了后端能获取到真实的客户端信息,这对于日志记录和权限验证很重要。
如何处理代理过程中的缓存和超时问题
在代理静态资源时,为了提高性能并减轻后端压力,通常需要配置缓存策略和超时时间。可以通过 proxy_cache_path 定义缓存目录,并在 location 中启用缓存。同时,使用 proxy_connect_timeout 和 proxy_read_timeout 来防止因后端响应慢导致的连接挂起。

http {
# 定义缓存路径和参数
proxy_cache_path /var/cache/nginx/static levels=1:2 keys_zone=static_cache:10m max_size=1g inactive=60m;
server {
listen 80;
server_name example.com;
location /assets/ {
proxy_pass http://127.0.0.1:8080/;
# 启用缓存
proxy_cache static_cache;
# 设置缓存键,这里使用请求 URI
proxy_cache_key $scheme$request_method$host$request_uri;
# 设置状态码为 200 和 304 的响应可缓存
proxy_cache_valid 200 304 12h;
# 添加缓存命中状态头,便于调试
add_header X-Cache-Status $upstream_cache_status;
# 设置超时时间
proxy_connect_timeout 5s;
proxy_read_timeout 30s;
proxy_send_timeout 10s;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
}在上述配置中,proxy_cache 指令启用了之前定义的 static_cache 区域。当请求到达时,Nginx 会检查缓存中是否存在对应的键(由 proxy_cache_key 决定)。如果存在且未过期,直接返回缓存内容,并设置响应头 X-Cache-Status 为 HIT;如果不存在或已过期,则向后端发起请求,获取响应并存入缓存,此时 X-Cache-Status 为 MISS。超时时间的设置可以避免因网络波动或后端故障导致的长时间等待,提升用户体验。proxy_cache_valid 指定了哪些 HTTP 状态码的响应可以被缓存以及缓存的有效时间,这里设置为 12 小时,适用于变化不频繁的静态资源。
当后端返回 404 时 Nginx 的行为是什么
当后端服务器返回 404 Not Found 状态码时,Nginx 默认会将该错误页面原样返回给客户端。如果需要自定义 404 错误页或进行其他处理,可以使用 error_page 指令。例如,可以配置 Nginx 在收到后端的 404 响应时,返回一个自定义的 HTML 页面或重定向到其他 URL。
server {
listen 80;
server_name example.com;
location /assets/ {
proxy_pass http://127.0.0.1:8080/;
# 当后端返回 404 时,执行内部重定向到 /custom_404.html
error_page 404 /custom_404.html;
# 提供自定义 404 页面的位置
location = /custom_404.html {
root /usr/share/nginx/html;
internal; # 只允许内部重定向访问,禁止外部直接访问
}
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}在这个例子中,如果后端返回 404,Nginx 会触发 error_page 404 指令,内部重定向到 /custom_404.html。这个内部重定向不会改变客户端的 URL,但会返回自定义页面的内容。internal 指令确保只有 Nginx 内部的重定向才能访问这个文件,防止用户通过直接输入 /custom_404.html 来访问它。这种机制可以用于提供更友好的错误提示,或者在静态资源缺失时返回默认的占位图。需要注意的是,error_page 指令也可以用于处理其他 HTTP 错误状态码,如 500、502 等,以实现统一的错误处理策略。


















