assetPrefix
了解如何使用 assetPrefix 配置选项来配置你的 CDN。
注意: 部署到 Vercel 会自动为你的 Next.js 项目配置全球 CDN。 你无需手动设置 Asset Prefix。
注意: 部署到 Vercel 会自动为你的 Next.js 项目配置全球 CDN。 你无需手动设置 Asset Prefix。
小知识: Next.js 9.5+ 增加了对可自定义基础路径的支持,它更适合在诸如
/docs这样的子路径下托管你的应用程序。 我们不建议你在这种用例下使用自定义的 Asset Prefix。
设置 CDN#
要设置 CDN,你可以设置一个 asset prefix,并将 CDN 的源站配置为解析到 Next.js 所在的域名。
打开 next.config.mjs,根据阶段添加 assetPrefix 配置:
next.config.mjs
// @ts-check
import { PHASE_DEVELOPMENT_SERVER } from 'next/constants'
export default (phase) => {
const isDev = phase === PHASE_DEVELOPMENT_SERVER
/**
* @type {import('next').NextConfig}
*/
const nextConfig = {
assetPrefix: isDev ? undefined : 'https://cdn.mydomain.com',
}
return nextConfig
}Next.js 会自动对从 /_next/ 路径(.next/static/ 文件夹)加载的 JavaScript 和 CSS 文件使用你的 asset prefix。例如,使用上述配置时,对 JS chunk 的以下请求:
text
/_next/static/chunks/4b9b41aaa062cbbfeff4add70f256968c51ece5d.4d708494b3aed70c04f0.js将变为:
text
https://cdn.mydomain.com/_next/static/chunks/4b9b41aaa062cbbfeff4add70f256968c51ece5d.4d708494b3aed70c04f0.js将文件上传到指定 CDN 的具体配置取决于你选择的 CDN。你需要在 CDN 上托管的唯一文件夹是 .next/static/ 的内容,如上方的 URL 请求所示,它应作为 _next/static/ 上传。不要上传 .next/ 文件夹的其余部分,因为你不应将服务端代码和其他配置暴露给公众。
虽然 assetPrefix 涵盖了对 _next/static 的请求,但它不影响以下路径:
- public 文件夹中的文件;如果你想通过 CDN 提供这些资源,必须自行添加前缀
- public 文件夹中的文件;如果你想通过 CDN 提供这些资源,必须自行添加前缀
getServerSideProps页面的/_next/data/请求。这些请求始终针对主域名发出,因为它们不是静态的。getStaticProps页面的/_next/data/请求。这些请求始终针对主域名发出,以支持增量静态生成(ISR),即使你没有使用它(为了保持一致性)。