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