Nginx 部署 Next.js 指南：配置 upstream 保持后端 Server 会话-Nginx-PHP中文网

Next.js 默认不依赖传统Session因其是无状态框架，推荐状态存客户端或外部存储；但实际集成Auth.js等需服务端session时，必须通过Nginx ip_hash实现会话保持，确保同一用户请求路由至同一后端实例。

nginx 部署 next.js 指南：配置 upstream 保持后端 server 会话

Next.js 应用在生产环境中通常以 Server-Side Rendering（SSR） 或 Incremental Static Regeneration（ISR） 模式运行，需依赖 Node.js 服务（如 next start 启动的内置服务器）。当使用 Nginx 作为反向代理时，若部署多个 Next.js 实例（例如多进程、多机器），默认轮询策略会导致用户请求被分发到不同后端，破坏服务端会话（如基于内存的 session、未共享的 cookie 状态、临时上传文件等）。

为什么 Next.js 默认不依赖传统 Session？

Next.js 本身是无状态框架 —— 官方推荐将状态存在客户端（localStorage、cookies）或外部存储（Redis、数据库）。但实际项目中，你可能：

使用 getServerSideProps 中调用带 session 的中间件（如 express-session）
集成第三方认证服务（如 Auth.js / NextAuth.js），其底层依赖服务端 session 存储
自定义了基于内存缓存的请求上下文（如临时 token 映射、上传进度跟踪）

这些场景下，**同一用户的连续请求必须落到同一台后端实例**，否则会话丢失、登录态中断、数据错乱。

用 upstream + ip_hash 实现会话保持

Nginx 的 upstream 块支持多种负载均衡策略。对会话保持最简单可靠的方式是 ip_hash：根据客户端 IP 的哈希值固定分配后端，确保同 IP 请求始终打到同一台服务器。

配置示例（/etc/nginx/conf.d/nextjs.conf）：

upstream nextjs_backend {
    ip_hash;  # 启用基于客户端 IP 的会话保持
    server 127.0.0.1:3001;
    server 127.0.0.1:3002;
    # 可添加更多本地或远程实例
}
<p>server {
listen 80;
server_name example.com;</p><pre class="brush:php;toolbar:false;">location / {
    proxy_pass http://nextjs_backend;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_cache_bypass $http_upgrade;
}

}

chartjs-reporter

此技能用于在用户需要将结构化数据（查询结果、CSV 摘要、JSON 记录或 Python 字典/列表）转换为独立的 HTML 页面时使用。

下载

⚠️ 注意：ip_hash 在用户使用 NAT（如公司出口、移动基站）时可能导致多个真实用户被映射为同一 IP，造成后端负载不均。如需更精准控制，可改用 hash $cookie_jsessionid consistent;（需后端写入指定 cookie）或结合 sticky 模块（需编译安装）。