You need to enable JavaScript to run this app. Vercel与Next.js场景下子域名动态重写为路径参数方案咨询
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.20 05:36:07