NNext.js 中文网 GitHub

allowedDevOrigins

使用 allowedDevOrigins 配置可以向开发服务器发起请求的额外来源(origin)。

Next.js 在开发期间默认会阻止对仅用于开发的资源和端点的跨域请求,以防止未经授权的访问。

要配置 Next.js 应用以允许来自服务器初始化时所用主机名(默认为 localhost)之外的来源的请求,请使用 allowedDevOrigins 配置项。

allowedDevOrigins 让你可以设置在开发模式下可以向开发服务器发起请求的额外来源。例如,要使用 local-origin.dev 而不只是 localhost,请打开 next.config.js 并添加 allowedDevOrigins 配置:

next.config.js
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.devlocal-origin.devteam.local-origin.dev
*.local-origin.devteam.local-origin.devlocal-origin.dev、team.eu.local-origin.dev
**.local-origin.devteam.local-origin.dev、team.eu.local-origin.devlocal-origin.dev

不支持部分替换。请写 *.local-origin.dev,而不是 team-*.local-origin.dev。** 仅支持在模式开头使用。

开发服务器已经允许 localhost、其子域名以及启动时使用的主机名。任何其他主机名都需要一个条目,例如用于远程开发的隧道:

next.config.js
module.exports = {
  allowedDevOrigins: ['*.tunnel.example.com'],
}