构建参数
你可以向 open-next build
命令传递两个构建参数:
--config-path
- 指定要使用的配置文件路径。默认情况下会在当前工作目录查找open-next.config.ts
文件。该路径需要相对于当前工作目录。--node-externals
- 可以为open-next.config.ts
文件的 esbuild 编译配置外部依赖(例如--node-externals @aws-sdk/*,open-next/dist/queue/*
)
配置文件
如需自定义配置,你需要在 next.config.js
同级目录下创建 open-next.config.ts
文件,并导出一个符合 OpenNextConfig
接口的默认对象。如果没有 open-next.config.ts
文件,系统会自动应用默认配置。
该文件必须与 next.config.js
放在同一目录层级。
如果已有 open-next.config.ts
文件,请确保至少包含以下内容:
export default {
default: {},
};
如需查看简单配置示例,请参考简单示例。
对于更高级的使用场景,可以查看如何实现自定义覆盖。
如需查看完整示例,请参阅完整示例。
禁用默认的 poweredByHeader
默认情况下 Next.js 会添加 x-powered-by
(opens in a new tab) 响应头。OpenNext 也会添加 x-opennext
头。如需禁用此功能,请在 next.config.js
中关闭 poweredByHeader 配置项:
module.exports = {
poweredByHeader: false,
};