日本服务器部署Next.js网站,静态资源与服务端渲染如何分配?

发布人:A5数据发布时间:2026-10-18 11:07阅读量:106

日本服务器部署 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发布时存在于 publicNginx、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 适合承担四项工作:

  1. 接收公网 HTTP/HTTPS 请求;
  2. 在入口处完成 TLS 证书处理;
  3. 直接返回构建后的静态资源;
  4. 把动态请求转发到本机 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 的文件传输压力;
  • 静态资源存放在本机磁盘且发布流程可控。

需要特别注意发布目录的一致性。不要在正在运行的目录内逐个覆盖文件,否则可能出现以下情况:

  1. 新 HTML 已经引用了新版本的 chunk;
  2. Nginx 目录中部分文件仍是旧版本;
  3. 用户收到 JavaScript 404 或版本不匹配错误。

更稳妥的方式是每次发布到新的 release 目录,再切换 current 符号链接。切换后重启或平滑重启 Node.js,并在确认新版本正常后再清理旧目录。旧版本的静态文件不能立即删除,至少要考虑浏览器缓存、CDN 缓存以及正在使用旧 HTML 的访问者。

方案二:Nginx 返回静态文件,Node.js 处理动态内容配图

方案三: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

相关推荐