Next.js 部署到 Vercel 很顺,迁到自己的服务器就一堆问题:构建产物跑不起来、图片 404、缓存不生效、环境变量没注入。自托管不是把 .next 传上去,而是把 Node、缓存和图片链路配对。
三种自托管方式
- Node server:next build + next start,支持 SSR/ISR/API
- standalone:构建出最小运行包,适合容器
- static export:纯静态,不能 SSR/ISR
要 ISR 和 API 路由,就用 Node server 或 standalone;纯展示站再考虑静态导出。
构建和启动
npm ci
npm run build
NODE_ENV=production npm run start -- -p 3000
standalone 模式在 next.config.js 里开 output: 'standalone',构建后复制 .next/standalone 和 static,镜像会小很多。

Nginx 反代
location / {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
location /_next/static/ {
alias /var/www/app/.next/static/;
expires 365d;
add_header Cache-Control "public, immutable";
}
静态资源交给 Nginx,别让 Node 处理;带 hash 的文件可以长缓存。
缓存和 ISR
ISR 依赖服务端缓存,多实例要共享缓存或粘性会话;否则每个实例各缓各的,内容不一致。
- 单实例:本地缓存够用
- 多实例:Redis/外部缓存,或接受短时间不一致
- 动态页:按用户分流,别缓存登录态

图片优化
next/image 在服务端优化图片,需要 sharp;容器里没装会报错。图片多时,优化很吃 CPU,建议配 CDN。
npm install sharp
远程图片要配 images.remotePatterns;不配会 400,别以为是网络问题。
环境变量
构建时和运行时变量要分清:NEXT_PUBLIC_ 会打进前端,密钥不能加这个前缀。运行时变量放 systemd/容器环境,别写进代码。

美国还是日本
- 美国:北美用户近,Vercel/API 生态顺
- 日本:东亚用户近,延迟低
- 香港:大陆访问快,适合中文站
SSR 站点节点跟用户走;静态资源走 CDN,源站位置影响小一些。
守护进程
[Service]
WorkingDirectory=/var/www/app
ExecStart=/usr/bin/node server.js
Restart=always
Environment=NODE_ENV=production
Environment=PORT=3000
用 systemd 或 PM2 守护;崩溃自动拉起,日志交给 journald 或文件。
安全
- HTTPS、HSTS、安全响应头
- 不在前端暴露密钥
- API 路由加限流和鉴权
- 依赖定期更新
- 构建产物和源码权限分离
部署模式
单实例用 systemd,多实例用容器加反代;standalone 适合容器,别把源码和构建产物混在一起。
缓存头
带 hash 的静态资源长缓存,HTML 短缓存或不缓存;ISR 页面按 revalidate 设,别让用户看到旧价格。
多实例
多实例要共享 ISR 缓存或接受不一致;会话和登录态别放本地内存。
监控
看 Node 内存、事件循环延迟、5xx 和图片优化耗时;图片服务挂了,页面会大面积 500。
图片缓存
优化后的图片走 CDN 缓存,源站别重复处理;远程图片域名变更要同步 remotePatterns。
环境
开发、预发、生产分开构建;NEXT_PUBLIC 变量构建时固化,改完要重新构建。
日志
Node 日志结构化,记录请求 ID 和耗时;5xx 先看服务端日志,再看 Nginx。
部署清单
构建、环境变量、静态路径、图片域名、缓存头、HTTPS 六项逐项确认。
回滚
保留上一版构建产物,回滚先切流量再换版本;数据库变更要单独评估。
图片尺寸
按展示尺寸给 sizes,别让移动端下桌面大图;图片域名和尺寸白名单要配。
安全头
CSP、HSTS、X-Frame-Options 在 Nginx 或 next.config 配;CSP 太严会挡第三方脚本。
性能
SSR 页面缓存、图片 CDN、Node 内存监控;瓶颈通常在图片和数据库,不在框架。
先把 Node、缓存和图片跑通,再谈多实例啊。
先把 SSR 和图片跑顺,再谈多实例。
先跑通 SSR 和图片,再谈多实例。
先把 SSR 和图片跑通。
先把 SSR 和图片跑通,再谈多实例。
常见问题 FAQ
Q1:Next.js 一定要 Vercel 吗?
不一定。Node server、standalone、容器都能自托管,ISR 和图片优化要自己配。
Q2:图片 404 怎么办?
看 remotePatterns、sharp 和 Nginx 静态路径;本地图片和远程图片规则不同。
Q3:美国还是日本节点?
SSR 跟用户走;北美选美国,东亚选日本,大陆选香港。
Q4:多实例缓存不一致?
用共享缓存或粘性会话;否则接受短时间不一致。
Q5:构建很慢?
开缓存、减少页面、用 standalone;CI 构建比服务器构建更稳。
总结
Next.js 自托管的核心是 Node 运行、Nginx 静态、ISR 缓存和图片优化:standalone 减小体积,sharp 处理图片,多实例共享缓存。节点跟用户走,密钥别进前端。
需要一台 Next.js 机器,可以按小时开一台萤光云美国硅谷云服务器,先把 SSR 和图片跑通。
图片优化先看缓存头,再看 sharp。







