属于大家的
VPS知识分享站

Next.js 自托管:美国/日本节点缓存与图片

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,镜像会小很多。

构建产物流向 Node 与 CDN
standalone 能减小运行包。

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。

图片优化

next/image 在服务端优化图片,需要 sharp;容器里没装会报错。图片多时,优化很吃 CPU,建议配 CDN。

npm install sharp

远程图片要配 images.remotePatterns;不配会 400,别以为是网络问题。

环境变量

构建时和运行时变量要分清:NEXT_PUBLIC_ 会打进前端,密钥不能加这个前缀。运行时变量放 systemd/容器环境,别写进代码。

美日节点与部署流水线
SSR 节点跟用户走。

美国还是日本

  • 美国:北美用户近,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。

相关推荐

赞(0)
未经允许不得转载:VPS知识分享站 » Next.js 自托管:美国/日本节点缓存与图片