Vercel与Next.js场景下子域名动态重写为路径参数方案咨询
Next.js子域名动态重写实现方案
1. 核心配置(next.config.js)
在项目根目录的next.config.js文件中添加重写规则,通过匹配host头提取子域名参数,重写到对应路径:
/** @type {import('next').NextConfig} */ const nextConfig = { async rewrites() { return [ { // 匹配子域名下的所有路径 source: '/:path*', has: [ { type: 'host', // 替换为你的实际主域名,提取子域名到client变量 value: '(?<client>[^.]+).domain.com', }, ], // 排除根域名和www子域名,避免误匹配 missing: [ { type: 'host', value: 'domain.com', }, { type: 'host', value: 'www.domain.com', } ], // 重写到对应client标识的路径,保留原路径参数 destination: '/:client/:path*', }, ] }, } module.exports = nextConfig
2. 本地测试配置
如需在本地开发环境验证效果,修改系统hosts文件添加测试映射:
127.0.0.1 google.localhost 127.0.0.1 netflix.localhost
临时将配置中的host规则替换为(?<client>[^.]+).localhost即可本地测试访问。
3. 生产环境配置
- 在域名解析服务商添加泛域名解析记录:主机记录填
*.domain.com,指向你的Next.js应用部署地址 - 在部署平台(如Vercel、自建Node服务)配置泛域名绑定,允许所有子域名访问该应用
注意事项
- 该规则为重写而非重定向,用户地址栏会保留
{client}.domain.com的展示形式 - 自动保留原路径的查询参数和后缀路径,例如
netflix.domain.com/pricing?from=ad会被重写为domain.com/netflix/pricing?from=ad - 配置兼容Pages Router和App Router两种路由模式
内容的提问来源于stack exchange,提问作者Diego Ulloa
相关产品推荐
相关产品推荐

