利用Nginx实现资源代理和接口代理的实现方法

前言

在 web 开发与部署中，我们常常需要借助 nginx 实现接口代理和静态资源代理，以解决跨域、统一入口、权限控制或性能优化等问题。本指南将全面介绍 nginx 资源代理与接口代理的实现方法，并深入解析 proxy_set_header host 配置的差异与最佳实践。

在现代前后端分离的架构中，前端页面往往需要访问多个不同域名的后端服务，或引用外部的静态资源。若直接请求，会产生跨域问题，或不便于统一管理。这时，使用 nginx 实现代理是一种优雅的解决方案。

一、资源代理与接口代理的区别

二、应用场景举例

1. 资源代理场景：

   前端项目需要引入第三方编辑器插件，例如来自static.example.com的 js/css 文件。但出于同源策略或备案原因，希望通过 nginx 中转。

2. 接口代理场景：

   前端调用/api/user/info实际请求应转发到api-backend.example.com/user/info，避免跨域问题或隐藏后端真实地址。

三、资源代理配置

• 示例目标

  将请求：

https://test.example.com/proxy/res/plugin/editor/editor.js

• 代理到：

https://static.example.com/res/plugin/editor/editor.js

• nginx 配置示例

server {
    listen 443 ssl;
    server_name test.example.com;

    ssl_certificate     /etc/nginx/ssl/test.example.com.crt;
    ssl_certificate_key /etc/nginx/ssl/test.example.com.key;

    location /proxy/res/plugin/editor/ {
        proxy_pass https://static.example.com/res/plugin/editor/;
        proxy_set_header host static.example.com;  # 保持与目标一致，避免部分资源校验失败
        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_pass 末尾保留 /，确保路径拼接正确。

四、接口代理配置

• 示例目标

  将请求：

https://test.example.com/api/user/info

• 代理到：

http://api-backend.example.com/user/info

• nginx 配置示例

	location /api/ {
    proxy_pass http://api-backend.example.com/;
    proxy_set_header host $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_pass 后带 /，则会将匹配到的路径直接截去 /api/，从而 /api/user/info → /user/info。

五、关于 proxy_set_header host 的设置差异说明

六、常见问题排查

1. 资源无法加载，返回 403/404？

   • 是否 proxy_pass 写法错误？结尾是否缺少 /？

   • 目标资源服务器是否校验 host？试试 proxy_set_header host xxx。

   • url 拼接是否正确？可通过 curl -v 本地排查。

2. 跨域问题（cors）？

   • nginx 不是万能解决方案，需要目标服务支持 cors；

   • 若目标后端不可控，可由 nginx 添加响应头：

location /api/ {
    add_header access-control-allow-origin *;
    add_header access-control-allow-methods get,post,options;
    add_header access-control-allow-headers *;
    proxy_pass http://api-backend.example.com/;
}

• 注意：生产环境中建议使用白名单，避免任意源访问。

七、安全建议与优化

• 限定访问来源

allow 10.0.0.0/8;
deny all;

• 开启缓存提升性能（资源代理）

proxy_cache_path /tmp/nginx_cache levels=1:2 keys_zone=res_cache:10m inactive=1h max_size=1g;

location /proxy/res/ {
    proxy_cache res_cache;
    proxy_pass https://static.example.com/res/;
}

• 统一接口前缀管理使用/api/路由前缀划分接口，避免前后端路径冲突。

八、总结

以上就是利用nginx实现资源代理和接口代理的实现方法的详细内容，更多关于nginx资源代理和接口代理的资料请关注代码网其它相关文章！