next.js笔记:代理

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
next.js笔记:代理 [2026/09/30 10:41] – 张叶安next.js笔记:代理 [2026/09/30 11:16] (当前版本) – 张叶安
行 1: 行 1:
 +next 16以上支持 !!!!
 +
 +
 原先是中间件,2025年改为代理 原先是中间件,2025年改为代理
  
行 8: 行 11:
  
 https://nextjs.org/docs/app/api-reference/file-conventions/proxy https://nextjs.org/docs/app/api-reference/file-conventions/proxy
 +
 +一、Proxy 是什么、主要职责
 +
 +它是位于路由匹配之前执行的单一函数,能对每个进来的请求做四件事:
 +
 +| 职责                   | 典型场景                                                    |
 +| **Redirect(重定向)**    | 未登录跳 `/login`、旧 URL 迁移、http→https                       |
 +| **Rewrite(改写)**      | A/B 测试分流、按 locale 改写路径、把 `/api/*` 转发到内部后端地址(对外隐藏真实接口路径) |
 +| **Header/Cookie 操作** | 注入安全头(CSP、X-Frame-Options)、读写 cookie(会话、实验分组)           |
 +| **直接返回响应**           | 健康检查、简单限流拦截,不进入后续路由                                     |
 +
 +典型代码:
 +```javascript
 +// proxy.ts(项目根目录,或 src/ 下,与 app/ 同级)
 +import { NextRequest, NextResponse } from "next/server";
 +
 +export function proxy(req: NextRequest) {
 +  const session = req.cookies.get("session");
 +  if (!session && req.nextUrl.pathname.startsWith("/admin")) {
 +    return NextResponse.redirect(new URL("/login", req.url));
 +  }
 +  return NextResponse.next();  // 放行
 +}
 +
 +export const config = {
 +  matcher: ["/admin/:path*"],   // 只对匹配的路径生效
 +};
 +```
 +
 +它还能访问完整的 Node.js API(文件、原生库等),因为新 proxy 只跑 Node.js 运行时,不再支持 Edge runtime,也不允许配置 runtime 选项——设了会直接报错。如果你强依赖 Edge,暂时只能留在旧的 middleware.ts。
 +
 +> 问题: 如果代理会被绕过,那么有必要设置代理吗,它的作用是什么呢
 +
 +它的真正价值:体验和成本,不是安全
 +
 +1. 未登录用户秒跳登录页,省掉一次完整渲染
 +
 +没有 proxy 时,未登录用户访问 /dashboard,服务端要花几十到几百毫秒渲染页面 → 返回 → 前端再判断跳转。有了 proxy,请求在网络边界就被 307 到 /login,用户几乎无感知,服务器也不用白渲染。这是纯体验收益,和安全无关——攻击者绕过它?他绕过的只是"被礼貌地请出去"这一步,真正的数据他照样拿不到(因为路由和数据库层还有锁)。
 +
 +2. 改写和分流,这是它独有的能力
 +
 +A/B 测试:按 cookie 把 10% 流量 rewrite 到实验版本
 +
 +i18n:识别 locale 后静默改写路径
 +
 +内部转发:把 /api/* 改写到内网真实后端,对外隐藏真实接口地址和端口——这本身就是安全收益,但它发生在"对外暴露面"这个层面
 +
 +3. 统一注入响应头
 +
 +CSP、X-Frame-Options、HSTS 这些安全头放在 proxy 一层搞定,不用每个路由单独写。这类"加固"本来就不指望它挡定向攻击,而是挡批量扫描、点击劫持这种广谱威胁——攻击者绕过 proxy 直连源站?那前提是源站已经暴露,属于另一层防护该管的事。
 +4. 减少下游系统的无效压力
 +
 +把 robots 请求、过期活动页、明显异常的请求在入口处快速处理掉,后端服务少接大量无意义流量。限流在 proxy 层做(比如 x-forwarded-for 计数),挡的是普通脚本小子的批量刷接口——专业攻击者会换 IP、绕 CDN,但这类对手本来就需要数据层和业务层的防御来对付。
 +
 +二、用个类比理解
 +
 +把系统想成一栋楼:
 +
 +proxy 是门口的前台:查一下有没有门禁卡,没卡的请去登记。它能拦住闲逛的路人、送错的外卖、走错楼的访客——处理掉 99% 的日常噪音。
 +
 +真正的锁在每个房间的门上(路由、数据层)。
 +
 +前台的象征意义大于安全意义,但你能因此撤掉前台吗?不能——因为前台的存在让楼里每个房间不用各自应付"这人是不是走错了"这种琐事。
 +
 +三、所以结论是三句话
 +
 +proxy 管"路由和体验",不管"授权和机密"——这两件事从来不靠它。
 +
 +它能被绕过,恰恰说明你的授权本来就不该只放在它里面——绕过者面对的应该是服务端和数据层,而不是长驱直入。
 +
 +省下的成本是真实的:少渲染、少跳转、少日志噪音、统一治理。就算一个攻击者都拦不住,这些收益也足以让它值得存在。
 +
 +真正危险的用法只有一种:把 proxy 当成唯一的鉴权点。只要服务端每个受保护操作都在重新校验身份,proxy 被绕过就只是"少了一次礼貌的拦截",而不是"门户大开"。
 +
 +> 问题: 常见的安全头有哪些
 +
 +常见的安全头
 +
 +^ 头                                  ^ 作用                                ^
 +| `Content-Security-Policy` (CSP)    | 白名单制:这个页面只允许加载哪些来源的脚本/样式/图片,防 XSS |
 +| `X-Frame-Options: DENY`            | 禁止页面被 `<iframe>` 嵌套,防点击劫持         |
 +| `Strict-Transport-Security` (HSTS) | 强制浏览器之后只走 HTTPS,防降级攻击             |
 +| `X-Content-Type-Options: nosniff`  | 禁止浏览器"猜测"文件类型(比如把上传的图片当脚本执行)      |
 +| `Referrer-Policy`                  | 控制跳转到外站时泄漏多少来源信息                  |
 +| `Permissions-Policy`               | 禁用页面用不到的敏感能力(摄像头、麦克风、定位)          |
 +
 +> 问题:代理被怎么被绕过,绕过之后怎么防御,绕过之后安全头还起作用吗
 +
 +代理的四种典型绕过方式
 +
 +| 绕过方式             | 原理                                                                                  |
 +| **伪造内部头**        | CVE-2025-29927 那类:发 `x-middleware-subrequest` 之类的头欺骗 Next.js 跳过 proxy(已修复,但说明结构性风险) |
 +| **直连源站**         | 绕过 CDN/网关,直接请求源站 IP:3000,proxy 根本不触发                                                |
 +| **不走 proxy 的通道** | Server Action、Server Component 内部流程、matcher 没覆盖的路径、命中缓存的响应                          |
 +| **让 proxy 自己失效** | matcher 静默失效、残留旧文件、proxy 抛异常后默认放行(fail-open)                                        |
 +
 +绕过之后靠什么防御:纵深防御
 +
 +第 1 层:网络层堵死直连(针对"直连源站")
 +
 +第 2 层:服务端重新鉴权(针对所有绕过)
 +
 +第 3 层:数据层带上下文过滤(最后防线)
 +
 +第 4 层:proxy 自身加固
 +
 +绕过之后,安全头还起作用吗?
 +
 +情况 A:攻击者自己绕过(直连源站)
 +
 +对其他用户的安全头毫无影响,对攻击者自己则从来就没用。
 +
 +情况 B:绕过导致正常用户响应里缺了头
 +
 +这才是真正要防的问题。如果你的安全头只在 proxy 里 set,而某条路径(缓存命中、proxy 异常放行)绕过了它,用户收到的响应就没有这些头,浏览器就失去了那层保护。
 +
 +对策:安全头要在多层冗余设置,不押注单点
 +
 +CDN 层(最外层):在 Cloudflare/Vercel 面板里配置响应头规则——流量经 CDN 时由 CDN 附加,即使源站 proxy 没执行也有
 +
 +反向代理层:Nginx 的 add_header
 +
 +应用层:Next.js 的 next.config.js 也能配,比 proxy 更稳(不依赖函数执行):
 +
 +

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • next.js笔记/代理.1790736084.txt.gz
  • 最后更改: 2026/09/30 10:41
  • 由 张叶安