Next.js网站与API如何配置Nginx?香港EPYC 4244P+32GB DDR5部署思路

发布人:A5数据发布时间:2026-10-10 13:10阅读量:379

香港机房部署 Next.js 网站与 API 服务时,可以让 Nginx 接收公网 HTTP/HTTPS 请求,再分别转发到本机的 Next.js 进程和 API 进程;进程由 systemd 守护,应用日志进入 journald,证书通过 ACME 客户端维护。EPYC 4244P 与 32GB DDR5 为这套架构提供了明确的硬件边界,但实际可承载的并发量仍取决于应用负载、数据库、缓存和网络条件,不能只凭内存容量推定。

以下以 Debian 12 或 Ubuntu 22.04/24.04、systemd、Nginx、独立 Node.js API 为例。应用监听地址仅绑定 127.0.0.1,公网入口由 Nginx 统一管理。部署前需要准备域名、指向服务器的 DNS 记录、SSH 管理权限、Next.js 项目和 API 项目;若 API 已由 Next.js 路由处理,可跳过独立 API 进程相关步骤。

Next.js与API服务的部署需要兼顾应用进程、数据存储与公网访问线路。A5数据提供香港物理服务器租用,涵盖AMD EPYC等平台,部分配置采用DDR5内存与NVMe存储,可为网站、业务后台、数据库和接口服务提供硬件资源基础。香港服务器还提供CN2与国际带宽等线路选择,适合承载面向不同访问区域的业务;美国、日本、新加坡等地区也有不同配置与线路的服务器方案,覆盖多地区部署需求。

一、准备条件与部署结构

建议先确认操作系统、处理器逻辑核心数、内存和磁盘余量,再确定构建与运行方式。以下命令适用于 Debian/Ubuntu:

cat /etc/os-release
lscpu
free -h
df -h

lscpu 用于核对当前系统识别到的核心和线程数,free -h 与 df -h 用于查看可用内存和磁盘。不要只根据处理器型号推算可用资源:虚拟化配置、系统预留和其他服务都会影响实际容量。

一、准备条件与部署结构配图

组件示例配置作用
Nginx监听 80、443TLS 终止、按路径转发、访问日志
Next.js127.0.0.1:3000页面渲染及 Next.js 自身路由
独立 API127.0.0.1:3101业务接口,与网站进程分开管理
systemd两个独立服务单元开机启动、异常退出后重启、查看运行日志
证书ACME 客户端签发与续期为站点提供 HTTPS

以 example.com 为站点域名,/srv/nextapp 与 /srv/api 为应用目录,nextapp 与 apiapp 为运行账户。部署时将这些示例值替换为实际域名、目录和项目设置。域名的 A 记录应指向服务器 IPv4 地址;使用 IPv6 时,还需确认 AAAA 记录指向可用地址。DNS 未生效或指向错误时,后续证书签发可能失败。

确认 Node.js 版本满足项目 package.json 中的 engines 要求,且依赖安装方式与项目锁文件一致:

node --version
npm --version

若命令不存在或版本不符合项目要求,应先通过所选发行版支持的 Node.js 安装方式准备运行环境,再继续部署。不要在生产服务器上直接使用来源不明的安装脚本。

二、创建运行账户并准备应用

应用不需要 root 权限运行。创建无交互登录账户,并准备项目目录:

sudo useradd --system --create-home --home-dir /srv/nextapp --shell /usr/sbin/nologin nextapp
sudo useradd --system --create-home --home-dir /srv/api --shell /usr/sbin/nologin apiapp
sudo install -d -o nextapp -g nextapp /srv/nextapp/app
sudo install -d -o apiapp -g apiapp /srv/api/app

不同系统的账户可能已存在。若 useradd 提示账户已存在,应使用 getent passwd nextapp 等命令核对账户及 home 目录,不要为了消除提示而删除账户或目录。目录应由对应账户拥有,避免通过 chmod -R 777 解决权限问题。

部署 Next.js

Next.js 可通过 output: 'standalone' 生成精简的运行目录。项目根目录的 next.config.js 可配置为:

/** @type {import('next').NextConfig} */
const nextConfig = {
  output: 'standalone',
};

module.exports = nextConfig;

若项目使用 next.config.mjs,应按其现有模块格式修改配置,不要同时维护两份配置文件。提交代码前先在开发或构建环境验证配置能够通过项目构建。

将已审查的代码发布到 /srv/nextapp/app 后,以应用账户安装依赖并构建:

sudo -u nextapp -H bash -lc '
  cd /srv/nextapp/app
  npm ci
  npm run build
'

npm ci 按锁文件安装依赖,适用于锁文件与 package.json 一致的项目;锁文件缺失或依赖未同步时命令会失败,应在开发环境修正并提交锁文件,不建议在生产环境临时改用不受控的依赖版本。

Standalone 模式通常需要将静态资源复制到构建输出目录。项目存在 public 目录时执行:

sudo -u nextapp -H bash -lc '
  cd /srv/nextapp/app
  mkdir -p .next/standalone/.next
  cp -a .next/static .next/standalone/.next/static
  if [ -d public ]; then
    cp -a public .next/standalone/public
  fi
'

核对入口文件及静态资源是否生成:

sudo -u nextapp test -f /srv/nextapp/app/.next/standalone/server.js \
  && echo "standalone 入口存在"
sudo -u nextapp test -d /srv/nextapp/app/.next/standalone/.next/static \
  && echo "静态资源目录存在"

如果项目采用自定义构建流程、Monorepo 或特殊静态资源路径,Standalone 输出位置可能不同,应以项目的实际构建产物为准。验证失败时不要启动服务;先检查 Next.js 构建日志和项目目录结构。

二、创建运行账户并准备应用 / 部署 Next.js配图

配置运行环境变量

将生产环境变量放入独立文件,而不是写入代码仓库或直接放进 shell 历史。示例:

sudo install -o root -g nextapp -m 0640 /dev/null /etc/nextapp.env
sudoedit /etc/nextapp.env

文件内容可按项目实际需要填写:

NODE_ENV=production
PORT=3000
HOSTNAME=127.0.0.1

数据库密码、第三方密钥等敏感值应使用真实项目配置,并限制读取权限。完成后核对权限:

sudo stat -c '%U %G %a %n' /etc/nextapp.env

预期所有者为 root、所属组为 nextapp,权限为 640。若把环境变量写进服务文件,常会因转义、权限或日志暴露造成问题;独立文件更便于控制访问。变更环境文件后需要重启对应服务才会生效。

三、配置 Next.js 与 API 的 systemd 服务

先建立 Next.js 服务单元:

sudoedit /etc/systemd/system/nextapp.service

配置示例:

[Unit]
Description=Next.js application
After=network.target

[Service]
Type=simple
User=nextapp
Group=nextapp
WorkingDirectory=/srv/nextapp/app
EnvironmentFile=/etc/nextapp.env
ExecStart=/usr/bin/node /srv/nextapp/app/.next/standalone/server.js
Restart=on-failure
RestartSec=5
TimeoutStopSec=30
KillSignal=SIGTERM

[Install]
WantedBy=multi-user.target

这里假设 Node.js 位于 /usr/bin/node。若安装路径不同,用 command -v node 核验后修改 ExecStart。不要猜测路径,也不要把 npm run dev 用作生产服务入口。

若 API 是独立 Node.js 服务,可使用单独的环境文件和服务单元。API 入口路径应替换为项目实际入口,例如 dist/server.js:

sudo install -o root -g apiapp -m 0640 /dev/null /etc/apiapp.env
sudoedit /etc/apiapp.env

环境文件示例:

NODE_ENV=production
PORT=3101
HOST=127.0.0.1

创建 API 服务:

sudoedit /etc/systemd/system/apiapp.service
[Unit]
Description=Node.js API application
After=network.target

[Service]
Type=simple
User=apiapp
Group=apiapp
WorkingDirectory=/srv/api/app
EnvironmentFile=/etc/apiapp.env
ExecStart=/usr/bin/node /srv/api/app/dist/server.js
Restart=on-failure
RestartSec=5
TimeoutStopSec=30
KillSignal=SIGTERM

[Install]
WantedBy=multi-user.target

API 必须确实监听 127.0.0.1:3101。如果项目默认监听 0.0.0.0,应通过项目配置改为 loopback 地址;否则端口可能直接暴露在公网。若 API 使用其他运行时或启动命令,需按其服务模型配置,不能照搬 Node.js 示例。

加载服务单元并启动:

sudo systemctl daemon-reload
sudo systemctl enable --now nextapp
sudo systemctl enable --now apiapp

只部署 Next.js 路由的场景,不执行 API 服务相关命令。检查服务状态和本机端口:

systemctl is-active nextapp
systemctl is-active apiapp
sudo ss -lntp | grep -E ':(3000|3101)\b'

预期服务状态为 active,端口监听地址为 127.0.0.1。ss 没有输出通常说明程序未启动、端口配置不同或启动后立即退出;出现 0.0.0.0:3000 则应先收紧应用监听地址。也可进行本机 HTTP 探测:

curl -i http://127.0.0.1:3000/
curl -i http://127.0.0.1:3101/health

/health 仅为示例,应替换成 API 已实现的健康检查路径。若得到应用定义的正常响应,说明进程能处理本机请求;404 只能证明服务返回了 HTTP 响应,不代表业务接口验证通过。

查看启动失败原因:

sudo journalctl -u nextapp -n 100 --no-pager
sudo journalctl -u apiapp -n 100 --no-pager

重点检查入口路径、账户权限、环境变量、依赖和端口冲突。修正服务文件后执行 systemctl daemon-reload,再重启服务。不要通过把应用改为 root 运行来绕过权限错误。

四、配置 Nginx 反向代理

安装 Nginx 后先确认服务状态:

sudo apt update
sudo apt install nginx
sudo systemctl enable --now nginx
sudo nginx -t

apt install 会安装系统软件包,升级已有生产系统前应先确认维护窗口和包管理策略。nginx -t 应显示语法检查成功;未通过时不要 reload,应根据报错修复配置。

先创建仅处理 HTTP 的站点配置,供站点验证和证书签发使用:

sudoedit /etc/nginx/sites-available/example.com
server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;

    location /api/ {
        proxy_pass http://127.0.0.1:3101;
        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_connect_timeout 5s;
        proxy_read_timeout 60s;
    }

    location / {
        proxy_pass http://127.0.0.1:3000;
        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_read_timeout 60s;
    }
}

示例中 /api/ 转发到独立 API,且 proxy_pass 没有附加 URI,因此路径会保留。例如 /api/orders 会以 /api/orders 形式到达 API。若 API 实际路由不带 /api 前缀,需要明确决定由 Nginx 改写路径,或由 API 自身配置路由,不要在没有验证的情况下直接改写。

四、配置 Nginx 反向代理配图

如果 API 由 Next.js 自身处理,应删除 /api/ 这个独立上游块,让请求按站点路由交给 Next.js。若使用 WebSocket,需按应用需求增加 Upgrade 与 Connection 头;普通 HTTP 请求不需要为此添加配置。

启用站点并检查配置:

sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/example.com
sudo nginx -t
sudo systemctl reload nginx

如果链接已存在,先检查其目标,不要强行覆盖。reload 在配置检查通过后使 Nginx 重新载入配置,通常不会像 stop/start 那样中断现有连接。检查公网请求:

curl -i -H 'Host: example.com' http://127.0.0.1/
curl -i -H 'Host: example.com' http://127.0.0.1/api/health

预期站点返回应用响应,API 路径返回 API 的健康检查响应。若得到 502 Bad Gateway,通常是上游进程未运行、地址端口错误或连接被拒绝;若是 404,应检查请求路径是否与 Next.js 或 API 路由匹配。

申请并配置 HTTPS 证书

证书签发前,确认域名 DNS 指向正确,并且服务器和上游网络允许公网访问 TCP 80、443。若使用系统防火墙或云平台防火墙,只开放所需端口;修改规则前应确认当前 SSH 管理端口已放行,避免锁死远程连接。

安装 Certbot 的 Nginx 插件并签发证书:

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d example.com -d www.example.com

只有实际配置了对应 DNS 记录的域名才应加入参数。交互过程中按需选择 HTTP 跳转 HTTPS;Certbot 会调整 Nginx 配置,执行前应备份现有站点文件。完成后检查:

sudo nginx -t
sudo systemctl reload nginx
sudo certbot certificates

通过 HTTPS 验证站点与 API:

curl -I https://example.com/
curl -i https://example.com/api/health

再检查续期流程:

sudo certbot renew --dry-run

模拟续期成功表示续期流程具备可用条件,不等于证书永不过期。应确认系统定时器存在并启用:

systemctl list-timers | grep -i certbot

若证书签发失败,先检查 DNS 解析、80 端口连通性、Nginx server_name 和域名拼写;不要反复删除证书目录或手工覆盖私钥。

五、日志、资源边界与备份

日志查看与保留

systemd 服务的标准输出和错误输出可通过 journald 查看:

sudo journalctl -u nextapp --since today --no-pager
sudo journalctl -u apiapp --since today --no-pager

Nginx 通常将访问日志和错误日志写入 /var/log/nginx/:

sudo tail -n 100 /var/log/nginx/access.log
sudo tail -n 100 /var/log/nginx/error.log

访问日志中的状态码可帮助区分请求是否到达 Nginx;错误日志中的 connect() failed 常指向上游无法连接。检查日志前注意其中可能包含 URL、客户端地址或业务字段,转交和长期留存时应按数据保护要求处理。

journald 与 Nginx 日志都应设置合理的容量和保留期。可以检查 journald 的当前占用:

journalctl --disk-usage

磁盘紧张时不要直接删除正在使用的日志文件。先确认轮转与保留策略,再使用受支持的日志管理方式清理归档数据。

资源分配与容量观察

32GB 内存并不意味着全部可分配给 Node.js。系统、Nginx、构建任务、数据库或监控进程都需要空间。若数据库也运行在同一台服务器,应进一步保留数据库缓存和连接峰值所需的内存;如果数据库在外部,仍需为操作系统和应用留出余量。

可从保守的资源观察开始,而不是一次性把进程限制到很低:

  • 部署初期观察 free -h、top 或 htop,记录空闲内存、交换空间和 CPU 峰值。
  • Node.js 堆内存受运行时与项目工作集影响,不要仅凭物理内存大小把堆上限设到接近整机内存。
  • 持续出现交换、OOM 或进程被内核终止时,先定位内存增长来源,再调整并发、缓存、堆上限或服务拆分。
  • CPU 长时间饱和时,检查 SSR 计算、图片处理、构建任务和 API 热点;生产构建尽量在独立 CI 环境完成,避免和高峰请求争抢资源。

如果需要通过 systemd 限制资源,应先在低峰期测量正常峰值,再设置边界并观察。示例中的值不是通用建议:

[Service]
MemoryMax=2G
CPUQuota=200%

CPUQuota=200% 表示最多使用相当于两个逻辑 CPU 的配额;MemoryMax 则会在达到限制后带来内存压力甚至进程终止风险。加入限制前备份服务单元,修改后执行 daemon-reload 并观察 systemctl status、journal 与系统内存事件。发生 OOM 或服务频繁重启时,应先回退限制,再根据实际峰值重新评估。

备份对象与恢复验证

备份应覆盖可恢复业务所需的内容,而不只是项目代码。至少盘点:

  • 源码、锁文件和可重新生成的构建产物;若构建可复现,通常优先备份代码、构建配置与发布版本。
  • 环境变量文件、Nginx 站点配置、systemd 服务单元和证书续期配置。
  • 上传文件、数据库及其他无法由代码重新生成的数据。
  • 恢复所需的 Node.js 版本、依赖源、部署步骤和访问凭据保管方式。

敏感配置与数据库备份应限制访问权限,并存放在服务器以外的受控位置。数据库采用何种备份命令取决于实际数据库类型和一致性要求,不能用复制运行中的数据目录代替经过验证的数据库备份。

至少定期执行一次恢复演练:在隔离环境还原数据,检查应用能否启动、关键接口能否访问、配置和证书是否可用。只有备份文件存在而没有可恢复验证,无法证明业务可以恢复。

六、常见失败处理

按从入口到应用的顺序排查,能减少在错误层级反复修改配置。

现象优先检查判断方向
域名无法访问DNS、服务器公网地址、80/443 规则DNS 未指向目标或端口未放行,请求尚未到达 Nginx
Nginx 返回 502systemctl status、ss -lntp、错误日志上游进程未启动、监听地址或端口不一致
HTTPS 证书申请失败DNS 记录、80 端口、域名拼写ACME 验证无法访问对应 HTTP 站点
页面可打开但静态资源 404.next/static、public 复制结果Standalone 部署目录不完整或资源路径配置不一致
API 路径返回 404Nginx location、proxy_pass 路径、API 路由前缀是否保留与 API 路由设计不匹配
服务启动后反复重启journalctl、环境文件、入口路径、依赖进程启动异常或缺少生产环境变量
内存耗尽或进程退出free -h、系统日志、应用指标堆增长、缓存、并发或同机其他服务挤占资源

查看内核是否记录 OOM 事件:

sudo journalctl -k --since today --no-pager | grep -i -E 'oom|out of memory|killed process'

如果看到进程被内核终止,应结合当时内存占用判断;单纯增加重启次数只能暂时恢复服务,不能解决资源持续超限。

七、发布结果检查与回滚

首次上线或每次发布后,按同一清单核对,避免只凭首页能打开就判定部署完成:

  1. systemctl is-active nextapp(以及部署了独立 API 时的 apiapp)返回 active。
  2. ss -lntp 显示应用只监听 loopback;公网服务端口由 Nginx 对外提供。
  3. nginx -t 通过,HTTP/HTTPS 域名访问正常,证书覆盖实际使用的主机名。
  4. 首页、静态资源、关键业务路由和 API 健康检查分别返回预期结果。
  5. journalctl 与 Nginx 错误日志没有持续出现启动失败、上游连接失败或明显的异常增长。
  6. certbot renew --dry-run 通过,续期定时器存在;备份文件可访问,并已验证至少一条恢复流程。

发布建议保留前一版可运行产物。更新前记录当前版本、配置文件和服务状态,并确保数据库变更有独立备份与回退方案。若使用版本目录,可通过受控的部署脚本切换当前版本;不要在服务运行时直接覆盖关键文件后再判断是否需要回滚。

发生故障时,先恢复上一版应用代码和已知可用配置,再按需重启服务:

sudo systemctl restart nextapp
sudo systemctl restart apiapp
sudo nginx -t
sudo systemctl reload nginx

只对实际部署的服务执行重启。若故障来自 Nginx 配置,应先恢复备份配置并运行 nginx -t,通过后再 reload;语法检查失败时不要 reload。若故障与数据库结构变更有关,恢复代码并不一定能让旧版本兼容新结构,应按数据库迁移方案单独回滚或恢复备份。

验收与回滚时最终确认:域名与证书可用、站点和 API 路由符合预期、应用端口未直接暴露、服务账户权限正确、日志可查询、资源无持续异常、备份可恢复;如需回滚,则确认代码版本、环境变量、Nginx 配置和数据库状态彼此兼容后再切换。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3092.html

相关推荐