日本服务器部署Next.js网站,静态资源与服务端渲染如何分配?
日本服务器部署 Next.js 时,不应把静态资源和服务端渲染请求交给同一个处理路径。更合理的分配方式是:由 Nginx 或 CDN 负责带有构建哈希的 JavaScript、CSS 等静态文件,由 Node.js 运行时处理 SSR、RSC、API、Server Actions 和需要读取实时数据的页面,日本服务器作为动态请求的源站。
如果访问者主要位于日本或东亚地区,可以先采用“日本服务器 + Nginx + Next.js Node 进程”的结构;如果静态文件较大、海外访问者较多,或者图片、字体、前端包占用了大量带宽,再把 /_next/static/ 和版本化资源交给 CDN。页面 HTML 是否缓存,则要根据是否包含登录状态、Cookie、地域和实时数据单独判断,不能因为静态资源可缓存就把 SSR 页面一并缓存。
围绕日本服务器上的 Next.js 部署,A5数据提供日本热销系列与 CTG 系列物理服务器,覆盖 Xeon Gold、AMD EPYC、NVMe 存储及不同网络线路配置,可为 Node.js 服务端渲染、Nginx 静态资源分发、数据库与缓存运行提供独立硬件基础。面向跨境访问场景,相关方案还提供 CN2、CIA、GIA、SoftBank 及国际带宽选项,并可结合多地区服务器资源扩展静态资源与源站架构。
当前问题与业务链路
Next.js 请求可以分成三类
部署前需要先区分资源的生成时机,而不是仅按文件后缀判断。
| 请求或资源 | 典型路径 | 生成时机 | 主要处理组件 | 常见缓存方式 |
|---|---|---|---|---|
| 构建产物 | /_next/static/... | next build 时生成 | Nginx 或 CDN | 长期缓存、immutable |
| 公共资源 | /assets/logo.svg、/fonts/app.woff2 | 发布时存在于 public | Nginx、CDN 或 Node | 根据文件是否版本化决定 |
| SSR 页面 | /products/123 | 每次请求或按应用策略生成 | Next.js Node 进程 | 默认不做公共缓存 |
| ISR 页面 | /news/1 | 首次访问生成,按规则重新生成 | Next.js Node 进程及其缓存 | 依赖 ISR 和代理缓存策略 |
| API、Server Actions、RSC | /api/orders、页面导航请求 | 请求发生时生成 | Next.js Node 进程 | 通常不缓存,或按接口单独设置 |
/_next/static/ 下的文件通常带有构建版本标识。新版本发布后,文件名会发生变化,因此可以设置较长的缓存时间。浏览器即使保留旧文件,也不会影响新 HTML 对新文件的引用。
public 目录中的文件则不同。public/logo.png 通常会映射到 /logo.png,文件名不一定带版本号。如果直接给这类文件设置一年缓存,替换图片后,浏览器或 CDN 可能继续使用旧内容。需要长期缓存时,应使用类似以下方式:
- 使用
logo.20250301.svg这样的版本化文件名; - 在文件名中加入构建版本;
- 对不带版本号的文件使用较短的缓存时间;
- 发布时配合 CDN 刷新或缓存失效。
一次页面访问的实际路径
以访问一个需要读取商品数据的 SSR 页面为例,请求链路通常是:

浏览器
└─ HTTPS
└─ Nginx 或 CDN
└─ 日本服务器上的 Next.js Node 进程
├─ 读取数据库
├─ 查询缓存
└─ 生成 HTML、RSC 数据或 API 响应
浏览器收到 HTML 后,还会继续请求 JavaScript、CSS、字体和图片:
浏览器
├─ /_next/static/chunks/*.js
├─ /_next/static/css/*.css
├─ /assets/*.woff2
└─ 图片资源
└─ Nginx 或 CDN 直接返回
因此,SSR 页面消耗的主要是 Node.js 的 CPU、内存和数据源连接数;静态资源消耗的主要是网络带宽、连接数和磁盘读取能力。两者使用同一台日本服务器并不意味着必须使用同一个进程处理。

如果数据库不在日本,而是位于其他地区,SSR 页面还需要承担应用服务器到数据库的网络往返时间。静态文件不需要查询数据库,通常不会受到这段延迟影响。对于需要频繁读取数据的页面,应用服务器和数据库的区域距离,往往比静态文件是否由 Node.js 返回更值得优先核对。
相关组件职责
Nginx:入口、证书和静态资源
Nginx 适合承担四项工作:
- 接收公网 HTTP/HTTPS 请求;
- 在入口处完成 TLS 证书处理;
- 直接返回构建后的静态资源;
- 把动态请求转发到本机 Node.js 端口。
Nginx 不负责执行 React Server Components、服务端组件逻辑或数据库查询。它的价值在于减少 Node.js 需要处理的连接和文件传输,并统一管理域名、证书、请求头和访问日志。
Next.js Node 进程:页面和应用逻辑
生产环境中的 Next.js 通常由 Node.js 进程运行。它负责:
- SSR 页面生成;
- RSC 请求和客户端导航;
- API Route 或 Route Handler;
- Server Actions;
next/image图片优化请求;- ISR 页面重新生成;
- Cookie、登录状态、请求头和业务数据处理。
这些请求不能简单地按“GET 就可以缓存”处理。一个 GET 页面可能依赖登录 Cookie、授权头、地域或实时库存。只有明确确认响应与用户身份无关,并且缓存键包含必要维度时,才适合做公共缓存。
数据库与缓存:只服务于动态链路
数据库不是 Next.js 部署的必选组件,但只要 SSR 页面需要读取商品、订单、用户或内容数据,就会进入请求链路。
缓存组件也不是为了展示架构而必须添加。它适用于以下情况:
- 多个页面重复读取变化不频繁的数据;
- 数据库查询成本明显高于缓存读取;
- 页面访问高峰会造成数据库连接或查询压力;
- 需要把短时间内相同的查询结果复用。
需要注意的是,Node.js 每增加一个进程,通常都会增加数据库连接池和应用内存占用。如果一台 4 GB 内存的日本服务器同时运行数据库、缓存和多个 Node worker,不能只按照 CPU 核数增加进程数。
CDN:静态资源的可选出口
CDN 可以把静态资源缓存到距离访问者较近的边缘节点,源站仍然是日本服务器。典型分配方式是:
www.example.jp -> 日本服务器,处理 HTML、API、SSR
static.example.jp -> CDN,回源日本服务器,处理 JS、CSS、字体和版本化图片
如果只使用 assetPrefix 指向 CDN,需要注意它主要影响 Next.js 构建生成的静态资源,public 目录中的文件不会自动全部迁移到 CDN 地址。公共资源还需要单独上传、配置回源路径,或继续由主域名提供。
组件交互与资源分配
推荐的单机生产结构
访问量中等、用户主要在日本或亚洲、暂时不需要多台应用服务器时,可以使用以下结构:
公网
└─ Nginx: 80/443、证书、静态文件
├─ /_next/static/* -> 直接读取构建目录
├─ /assets/* -> 直接读取版本化公共资源
└─ 其他请求 -> 127.0.0.1:3000
└─ Next.js standalone server
Next.js 可以使用 standalone 输出减少运行时文件范围:
/** @type {import('next').NextConfig} */
const nextConfig = {
output: 'standalone',
};
module.exports = nextConfig;
构建完成后,standalone 目录通常还需要补充 public 和 .next/static。下面是一个发布到新目录的示例,目录名称仅作示意:
npm ci
npm run build
mkdir -p /srv/nextapp/releases/release-20250301/.next
cp -a .next/standalone/. \
/srv/nextapp/releases/release-20250301/
if [ -d public ]; then
cp -a public \
/srv/nextapp/releases/release-20250301/
fi
cp -a .next/static \
/srv/nextapp/releases/release-20250301/.next/
建议在独立的构建环境完成 npm run build,再把产物发布到日本服务器。这样可以减少生产机在构建时与在线 SSR 请求争用 CPU 和内存。构建环境和运行环境应使用一致的 Node.js 主版本、操作系统架构和依赖锁文件。
用 systemd 管理 Node.js
单机部署时,可以让 systemd 负责进程启动、异常重启和日志收集。示例服务文件如下:
[Unit]
Description=Next.js production application
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=nextapp
Group=nextapp
WorkingDirectory=/srv/nextapp/current
EnvironmentFile=/etc/nextapp.env
ExecStart=/usr/bin/node server.js
Restart=on-failure
RestartSec=5
KillSignal=SIGTERM
TimeoutStopSec=30
NoNewPrivileges=true
PrivateTmp=true
[Install]
WantedBy=multi-user.target
对应的环境变量文件可以是:
NODE_ENV=production
PORT=3000
HOSTNAME=127.0.0.1
# 根据服务器内存和其他服务占用情况决定是否设置
# NODE_OPTIONS=--max-old-space-size=1536
/usr/bin/node 必须与实际安装位置一致,可先使用以下命令核对:
command -v node
node --version
如果服务器总内存为 4 GB,Node.js 堆上限设置为 1536 MB 只能作为一种参考,仍要为操作系统、Nginx、构建任务、数据库和文件缓存预留空间。不要因为服务器有多个 CPU 核心,就直接启动同样数量的 Node 进程。每个进程都可能复制应用内存,并建立独立的数据库连接池。
Nginx 如何区分静态和动态请求
下面的配置展示了一个简化的入口结构。证书路径、域名和应用目录需要替换为实际值:
upstream next_app {
server 127.0.0.1:3000;
keepalive 32;
}
server {
listen 80;
server_name www.example.jp example.jp;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
server_name www.example.jp example.jp;
ssl_certificate /etc/letsencrypt/live/example.jp/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.jp/privkey.pem;
location ^~ /_next/static/ {
alias /srv/nextapp/current/.next/static/;
add_header Cache-Control "public, max-age=31536000, immutable" always;
access_log off;
}
location ^~ /assets/ {
alias /srv/nextapp/current/public/assets/;
add_header Cache-Control "public, max-age=86400" always;
access_log off;
}
location / {
proxy_http_version 1.1;
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_set_header X-Request-ID $request_id;
proxy_pass http://next_app;
}
}
这里的关键点有三个:
/_next/static/直接由 Nginx 返回,Node.js 不再读取这些文件;/assets/只映射到明确的公共资源目录,避免把所有根路径文件都错误地设置成长缓存;- 其他请求仍然交给 Next.js,包括 SSR、RSC、API 和
/_next/image。
如果使用 next/image,图片优化请求通常仍会进入 Node.js。图片尺寸变化较多、原图较大时,这部分可能消耗额外 CPU 和内存。可以根据图片规模决定是保留 Next.js 图片优化,还是使用已经处理好的版本化图片,并由 Nginx 或 CDN 直接返回。
Nginx 配置修改后,应先检查语法,再平滑加载。修改前保留上一份配置,加载失败时恢复旧文件并重新检查:
nginx -t
systemctl reload nginx
如果 SSR 使用流式输出,Nginx 的缓冲策略可能影响浏览器收到首段内容的时间。不要一开始就全局关闭 proxy_buffering,应先确认具体页面确实存在流式传输需求,再按路由或接口调整。
部署取舍
方案一:静态和动态全部经过 Node.js
这种方式的路径最简单:
Nginx -> Next.js Node.js -> 返回所有请求
它适合:
- 服务器规模较小;
- 静态文件数量和带宽压力有限;
- 希望减少 Nginx 路径映射;
- 应用仍处于频繁调整阶段。
缺点是 Node.js 需要参与静态文件传输,连接数、响应流和磁盘读取都会占用应用进程资源。它不一定马上造成问题,但在前端包较大或并发静态请求较多时,动态页面可能与静态资源争用资源。
方案二:Nginx 返回静态文件,Node.js 处理动态内容
这是单台日本服务器上较平衡的部署方式。静态文件由 Nginx 直接读取,Node.js 只处理需要执行应用逻辑的请求。
适合:
- 前端构建文件较多;
- 页面包含 SSR 或 API;
- 希望减少 Node.js 的文件传输压力;
- 静态资源存放在本机磁盘且发布流程可控。
需要特别注意发布目录的一致性。不要在正在运行的目录内逐个覆盖文件,否则可能出现以下情况:
- 新 HTML 已经引用了新版本的 chunk;
- Nginx 目录中部分文件仍是旧版本;
- 用户收到 JavaScript 404 或版本不匹配错误。
更稳妥的方式是每次发布到新的 release 目录,再切换 current 符号链接。切换后重启或平滑重启 Node.js,并在确认新版本正常后再清理旧目录。旧版本的静态文件不能立即删除,至少要考虑浏览器缓存、CDN 缓存以及正在使用旧 HTML 的访问者。

方案三:CDN 返回静态资源,日本服务器保留源站
当访问者分布在日本以外,或静态文件、字体、图片带宽占比较高时,可以采用:
浏览器
├─ 静态资源 -> CDN 边缘节点
└─ HTML/API/SSR -> 日本服务器 Nginx -> Next.js
这种方式可以减少源站出口带宽和静态连接数,但会增加发布管理要求:
- 确认 CDN 回源地址使用 HTTPS;
- 为静态域名设置正确的缓存规则;
- 构建版本变化后确认新文件可以回源;
- 字体等跨域资源需要配置合适的 CORS;
- 不要把带有用户身份的 HTML、订单接口或个性化 API 配置成公共缓存;
- 发生回源异常时,能够区分 CDN 缓存问题和日本源站问题。
如果访问者几乎都在日本,CDN 对首字节延迟的改善可能有限,但仍然可以承担静态带宽和连接压力。是否启用 CDN,应根据静态资源体积、访问地区和源站出口成本判断,而不是把所有请求默认迁移到 CDN。
什么时候不应保留 SSR
如果页面完全由构建时数据生成,没有登录状态、实时库存、个性化内容和运行时 API,可以评估静态导出,再把结果交给 Nginx、对象存储或 CDN。这样不需要长期运行 Node.js。
但只要页面依赖以下内容,静态导出就不能直接替代 SSR:
- 请求时读取 Cookie;
- 根据登录用户返回不同内容;
- 服务端读取数据库;
- 需要 Server Actions 或服务端 API;
- 需要 ISR 或运行时生成页面;
- 依赖请求头、地域或权限判断。
这时更适合保留 Node.js,并只把确定的静态部分从动态链路中分离出来。
运行要点
关注应用进程,而不是只看服务器在线
日本服务器可以正常响应 TCP 连接,但 Next.js 进程仍可能因内存不足、数据库连接耗尽或事件循环阻塞而无法生成页面。因此监控至少应区分:
- Nginx 的 4xx、5xx 和上游响应时间;
- Node.js 进程重启次数;
- CPU、内存、磁盘和文件描述符;
- SSR 页面首字节时间;
- 数据库连接池使用量;
/_next/static/和图片资源的 404 比例;- API 和页面的超时数量。
systemd 管理的应用日志可以通过以下方式查看:
journalctl -u nextapp -n 100 --no-pager
journalctl -u nextapp -f
Nginx 的访问日志和错误日志则需要结合请求 ID、时间和状态码分析。日志中不要直接记录 Cookie、Authorization 头和用户隐私数据。静态资源可以减少访问日志,但动态请求最好保留足够信息,以便定位是入口、Node.js 还是数据库变慢。
SSR 页面不要套用静态资源缓存规则
可以采用以下较保守的策略:
/_next/static/:长缓存并使用immutable;- 版本化字体、图片:长缓存;
- 不带版本号的公共文件:短缓存或发布时刷新;
- 登录后页面:默认
private或不做公共缓存; - API 的 POST、Server Actions:不做缓存;
- API 的 GET:确认数据公开、缓存键完整后再单独配置;
- ISR 页面:同时核对 Next.js 的重新生成机制和 CDN/Nginx 的缓存时间;
- RSC 请求:不要仅根据 URL 是 GET 就设置公共长缓存。
尤其要避免把所有 HTML 响应统一设置为一年缓存。这样可能导致用户看到旧页面、旧权限状态或旧业务数据。
ISR 和多进程需要额外核对
单个 Node.js 进程时,ISR 缓存和本地文件行为相对容易观察。使用多个进程或多台日本服务器后,需要确认:
- 不同进程是否共享 ISR 缓存;
- 发布后的页面是否在所有实例同时更新;
- CDN 是否继续返回旧 HTML;
- 重新生成失败时是否有旧版本可回退;
- 数据库和缓存连接数是否随进程数增长。
如果多实例之间没有共享缓存策略,同一个页面可能在不同实例上出现不同的重新生成时间。多进程不能只看作“把 CPU 用满”,它还会改变缓存、连接池和发布一致性。
证书和应用重启应分开验证
证书续期后,通常需要让 Nginx重新加载证书;应用代码发布则由 systemd 管理 Node.js 进程。两者最好分开检查:
nginx -t
systemctl reload nginx
systemctl restart nextapp
systemctl status nextapp --no-pager
重启前应确认新版本已经完整写入 release 目录,且 server.js、public、.next/static 和环境变量都存在。应用重启后先访问健康检查地址,再访问一条真实 SSR 页面,不要只确认进程显示为 active。
用响应头和日志验证分配是否生效
可以从外部检查静态资源:
curl -I https://www.example.jp/_next/static/chunks/example.js
需要重点观察:
- 返回状态是否为
200; Cache-Control是否包含预期的max-age和immutable;- 静态请求是否未进入 Node.js 业务日志;
- CDN 场景下是否出现命中或回源标识。
再检查动态页面:
curl -sS -o /dev/null \
-w 'status=%{http_code} ttfb=%{time_starttransfer}\n' \
https://www.example.jp/products/123
动态页面验证时,还应分别测试未登录和已登录状态,确认没有把带用户身份的响应错误缓存给其他访问者。若静态文件返回 404,优先检查发布目录中是否复制了 .next/static;若 HTML 能打开但浏览器报 chunk 加载失败,则重点检查 release 切换、旧缓存和 CDN 缓存;若静态文件正常而 SSR 超时,则应转向 Node.js 日志、数据库延迟和应用内计算。

回到“日本服务器如何分配静态资源与服务端渲染”这个问题,下一步可以先用一条真实 SSR 页面和一个带哈希的 /_next/static/ 文件分别验证:前者是否稳定进入 Node.js,后者是否由 Nginx 或 CDN 直接返回。确认这两条链路的状态码、缓存头、日志归属和发布后版本一致性,再决定是否需要增加 CDN、缓存组件或第二个应用实例。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/4379.html



