allowedDevOrigins
使用 allowedDevOrigins 配置可以向开发服务器发起请求的额外来源(origin)。
Next.js 在开发期间默认会阻止对仅用于开发的资源和端点的跨域请求,以防止未经授权的访问。
要配置 Next.js 应用以允许来自服务器初始化时所用主机名(默认为 localhost)之外的来源的请求,请使用 allowedDevOrigins 配置项。
allowedDevOrigins 让你可以设置在开发模式下可以向开发服务器发起请求的额外来源。例如,要使用 local-origin.dev 而不只是 localhost,请打开 next.config.js 并添加 allowedDevOrigins 配置:
module.exports = {
allowedDevOrigins: ['local-origin.dev', '*.local-origin.dev'],
}仅将请求 Origin 头中的 hostname 与你的条目进行匹配。对于来自 http://local-origin.dev:3000/dashboard?tab=1 的请求,即 local-origin.dev。协议、端口、路径和查询字符串都会被忽略。请以同样的方式编写条目,不要带 https://,也不要带端口。
no-cors 跨站请求(例如加载开发资源的 script 标签)不会发送 Origin 头。这类请求会改为根据 Referer 的主机名进行匹配。
条目还可以通过两个通配符进行扩展:* 代表主机名的一个标签,** 代表一个或多个标签。这就是为什么上例列出了两个条目,一个用于裸主机名,一个用于其子域名。
| 条目 | 匹配 | 不匹配 |
|---|---|---|
local-origin.dev | local-origin.dev | team.local-origin.dev |
*.local-origin.dev | team.local-origin.dev | local-origin.dev、team.eu.local-origin.dev |
**.local-origin.dev | team.local-origin.dev、team.eu.local-origin.dev | local-origin.dev |
不支持部分替换。请写 *.local-origin.dev,而不是 team-*.local-origin.dev。** 仅支持在模式开头使用。
开发服务器已经允许 localhost、其子域名以及启动时使用的主机名。任何其他主机名都需要一个条目,例如用于远程开发的隧道:
module.exports = {
allowedDevOrigins: ['*.tunnel.example.com'],
}