通过Nginx实现Next.js多机房高可用部署，需以standalone模式构建应用，Nginx作为反向代理分发静态资源、SSR及API请求，配置upstream健康检查与机房内负载均衡，并配合GSLB实现跨机房故障转移。
通过 Nginx 实现 Next.js 项目的多机房高可用负载部署，核心在于将静态资源、服务端渲染（SSR）和 API 路由的流量合理分发到跨地域的多个 Next.js 实例，并保障故障自动切换、会话一致性（如需）与健康探测能力。Next.js 应用本身需以 standalone 模式构建并运行在 Node.js 服务上（如 next start），Nginx 不直接处理 Next.js 构建逻辑，而是作为反向代理和全局流量入口。
1. Next.js 服务准备：启用 standalone 并暴露标准端口
确保每个机房的 Next.js 实例都使用 next build --standalone 构建，生成独立可运行的服务包。启动时统一监听固定端口（如 3000），不依赖开发服务器或自定义路由中间件干扰代理逻辑。
- 构建命令：
next build --standalone，输出目录含完整 Node.js 运行时和.next/standalone服务入口 - 启动脚本示例：
NODE_ENV=production PORT=3000 node .next/standalone/server.js - 每个机房至少部署 2 台实例，绑定内网 IP（如
10.1.10.10:3000、10.1.10.11:3000），避免单点
2. Nginx 全局负载层：基于 DNS + GeoIP 的机房级调度
单靠一台 Nginx 无法实现跨机房高可用，需前置全局负载层（如云厂商 GSLB 或自建 Anycast + GeoDNS）。Nginx 本身作为各机房内的本地负载均衡器，负责将入站请求分发给本机房内的多个 Next.js 实例。
- 在每个机房部署一套 Nginx 集群（主备或 active-active），VIP 绑定机房公网出口 IP
- 配置 upstream 使用
ip_hash（如需 SSR 会话粘性）或默认轮询；搭配max_fails=2 fail_timeout=30s实现快速摘除故障节点 - 示例 upstream：
upstream nextjs_cluster {
server 10.1.10.10:3000 max_fails=2 fail_timeout=30s;
server 10.1.10.11:3000 max_fails=2 fail_timeout=30s;
keepalive 32;
}
3. 关键代理配置：适配 Next.js 的静态文件、API 和 SSR 路由
Next.js 的 public/ 静态资源、pages/api/ 接口、以及动态 SSR 页面（如 /blog/[id]）均需被正确转发。Nginx 需区分路径，优先本地服务静态资源，其余透传至 Next.js 后端。
- 静态资源（
/_next/、/favicon.ico、/robots.txt等）建议由 Nginx 直接alias提供，减少后端压力 - 所有非静态路径（包括
/api/和页面路由）统一 proxy_pass 到 upstream - 必须设置
proxy_http_version 1.1、proxy_set_header Connection ''以支持 HTTP/1.1 keepalive - 关键 header 透传：
X-Forwarded-For、X-Forwarded-Proto、Host，确保 Next.jsgetServerSideProps中能获取真实客户端信息
4. 健康检查与自动故障转移
Next.js 自身不提供内置健康接口，需在应用层暴露 /health（返回 200）或复用 /api/health，再由 Nginx 主动探测。
- 在 upstream 中启用
health_check（需 Nginx Plus）或使用开源版配合nginx_upstream_check_module - 更通用做法：用 systemd 或 supervisor 监控 Node.js 进程，配合
curl -f http://localhost:3000/health定时检测，失败时触发 reload 或通知运维 - 跨机房故障转移依赖上层 DNS TTL 缩短（如 60s）+ GSLB 主动探测，Nginx 本机房内不跨机房转发
不复杂但容易忽略：Next.js 的 assetPrefix 必须设为 '' 或匹配 Nginx 所在域名，否则 /_next/ 资源路径错乱；trailingSlash: true 等路由配置也需与 Nginx location 规则对齐。整体架构中，Nginx 是可靠、可控的流量枢纽，但高可用的根基仍在于应用无状态、实例可水平伸缩、以及各层探测闭环。
