香港服务器部署Node.js 18应用,如何设置进程常驻与重启恢复?
要让 Node.js 18 应用在香港服务器重启后自动运行,并在进程异常退出时恢复,建议由 Ubuntu 自带的 systemd 管理应用,而不是用 nohup、后台 & 或终端会话保持进程。关键是配置明确的运行用户、启动命令和重启策略,并分别验证应用启动、异常退出恢复与服务器重启后的自动启动。
以下示例以使用 systemd 的 Ubuntu 22.04/24.04、amd64 架构为例,应用入口为 server.js,监听本机 3000 端口。Node.js 18 已于 2025 年 4 月 30 日结束上游支持;新部署应优先评估仍受支持的 Node.js 版本。若应用必须使用 18,应固定版本并安排升级计划。
A5数据提供中国香港物理服务器租用,覆盖入门建站、Xeon Gold及AMD EPYC等配置,并配备SSD或NVMe存储、不同内存规格及CN2和国际带宽方案,可为Node.js网站、业务后台、接口服务等长期运行应用提供相应的计算、存储与公网网络资源。
准备条件
开始前确认有服务器的 sudo 权限,应用代码和 package-lock.json 已准备好,并确认入口文件及健康检查路径。香港机房的地域不改变进程管理方式;需要从公网访问时,还要确认域名、入口服务和服务器侧及云平台侧的防火墙规则。
先核对系统、架构和 systemd:
cat /etc/os-release
dpkg --print-architecture
systemctl --version
下面的 Node.js 安装命令按 amd64 编写。若输出是 arm64,将后续变量中的 x64 改为 arm64。如果应用依赖数据库、上传目录等持久数据,部署前先确认备份可用;应用新版本不能自动替代数据库备份。
安装运行环境并准备应用
安装下载及解压工具:
sudo apt-get update
sudo apt-get install -y ca-certificates curl xz-utils
示例固定使用 Node.js 18.20.8。下载官方发行包和校验文件,再核验压缩包的 SHA-256:
NODE_VERSION=18.20.8
NODE_ARCH=x64
cd /tmp
curl -fsSLO "https://nodejs.org/dist/v${NODE_VERSION}/node-v${NODE_VERSION}-linux-${NODE_ARCH}.tar.xz"
curl -fsSLO "https://nodejs.org/dist/v${NODE_VERSION}/SHASUMS256.txt"
grep " node-v${NODE_VERSION}-linux-${NODE_ARCH}.tar.xz$" SHASUMS256.txt | sha256sum -c -
预期结果包含 OK。组织有更严格的软件供应链要求时,还应按其流程验证发行签名;不要把校验文件与安装包的下载成功本身当作来源验证。
将运行时放在版本化目录中,方便后续切换版本:
sudo install -d /opt/nodejs
sudo tar -xJf "/tmp/node-v${NODE_VERSION}-linux-${NODE_ARCH}.tar.xz" -C /opt/nodejs
sudo ln -sfn "/opt/nodejs/node-v${NODE_VERSION}-linux-${NODE_ARCH}" /opt/nodejs/node18
/opt/nodejs/node18/bin/node --version
/opt/nodejs/node18/bin/npm --version
第一条版本检查应显示 v18.20.8。升级运行时前先保留原版本目录,并在测试后再切换 /opt/nodejs/node18 指向的版本。
接下来为应用创建专用系统账号和目录。nodeapp 仅用于运行服务,不应加入 sudo 权限:
sudo useradd --system --home-dir /srv/nodeapp --shell /usr/sbin/nologin nodeapp
sudo install -d -o nodeapp -g nodeapp -m 0750 /srv/nodeapp/releases
sudo install -d -o nodeapp -g nodeapp -m 0750 /var/lib/nodeapp
把应用文件放入独立版本目录,再安装生产依赖。将示例中的 /path/to/release 换成服务器上的实际应用目录;目录中应包含 package.json 和 package-lock.json。

RELEASE=release-001
sudo -u nodeapp mkdir -p "/srv/nodeapp/releases/$RELEASE"
sudo -u nodeapp cp -a /path/to/release/. "/srv/nodeapp/releases/$RELEASE/"
sudo -u nodeapp env PATH="/opt/nodejs/node18/bin:/usr/bin:/bin" \
sh -c "cd '/srv/nodeapp/releases/$RELEASE' && npm ci --omit=dev"
sudo ln -sfn "/srv/nodeapp/releases/$RELEASE" /srv/nodeapp/current.new
sudo mv -Tf /srv/nodeapp/current.new /srv/nodeapp/current
npm ci 根据锁文件安装依赖,适合可重复部署;如果项目没有锁文件,应先在开发或构建流程中生成并检查锁文件。部分依赖需要编译工具,若安装报编译错误,再按依赖要求安装构建工具,不必预先开放额外服务端口。
配置环境变量与 systemd 服务
将环境变量与代码分开保存。示例只设置运行环境和端口;真实密钥不要提交到代码仓库,也不要写进服务单元文件。
sudo install -d -o root -g root -m 0755 /etc/nodeapp
sudo tee /etc/nodeapp/nodeapp.env >/dev/null <<'EOF'
NODE_ENV=production
PORT=3000
DATA_DIR=/var/lib/nodeapp
EOF
sudo chown root:nodeapp /etc/nodeapp/nodeapp.env
sudo chmod 0640 /etc/nodeapp/nodeapp.env
/var/lib/nodeapp 可用于应用确实需要写入的持久数据。不要把上传文件或运行中生成的数据放在会随版本替换的发布目录中。
创建 /etc/systemd/system/nodeapp.service:

[Unit]
Description=Node.js 18 application
Wants=network-online.target
After=network-online.target
[Service]
Type=simple
User=nodeapp
Group=nodeapp
WorkingDirectory=/srv/nodeapp/current
EnvironmentFile=/etc/nodeapp/nodeapp.env
ExecStart=/opt/nodejs/node18/bin/node /srv/nodeapp/current/server.js
Restart=on-failure
RestartSec=3
TimeoutStopSec=20
KillSignal=SIGTERM
UMask=027
NoNewPrivileges=true
[Install]
WantedBy=multi-user.target
这里的 ExecStart 直接启动 Node.js 和应用入口,避免把开发服务器或不必要的命令包装层作为生产进程。若项目实际入口是构建后的文件,例如 dist/server.js,应相应修改路径。应用应能读取 PORT,并监听 127.0.0.1;若由本机 Nginx 转发流量,不要让应用端口直接暴露到公网。
Restart=on-failure 会在进程异常退出或被信号终止时尝试重启,但不会因管理员执行 systemctl stop 而重新启动。它也不会在应用正常退出码为 0 时重启;若业务要求任何非手动退出都拉起进程,可评估 Restart=always,同时先检查应用为何会正常退出。RestartSec=3 用于避免失败后立即连续拉起。
检查服务文件并启动:
sudo systemd-analyze verify /etc/systemd/system/nodeapp.service
sudo systemctl daemon-reload
sudo systemctl enable --now nodeapp.service
sudo systemctl status --no-pager nodeapp.service
预期状态为 active (running)。如果 systemd-analyze verify 报错,先修正路径或配置,再执行 daemon-reload 和启动操作。
验证应用与公网入口
先从服务器本机检查应用。以下命令假设应用实现了 /health 健康检查接口:
curl --fail --show-error http://127.0.0.1:3000/health
sudo ss -lntp | grep ':3000'
应收到应用预期的健康检查响应,并看到服务监听 127.0.0.1:3000。如果项目没有 /health,改用实际存在且能反映服务状态的路径。若看到 0.0.0.0:3000,检查应用绑定地址;除非有明确的网络设计需要,不要将应用端口直接开放给公网。
如需通过域名提供访问,可以由已部署的 Nginx 接收 HTTP/HTTPS 流量,再转发到 http://127.0.0.1:3000。证书和 HTTPS 应在入口层按现有证书管理流程配置。对外通常只开放实际需要的 SSH、HTTP 和 HTTPS 端口;不要为了测试随意改动防火墙规则。必须调整时,先确认 SSH 管理通道仍可用,并记录原规则以便恢复。
服务的标准输出和错误输出默认可通过 systemd 日志查询:
sudo journalctl -u nodeapp.service --since "10 minutes ago" --no-pager
sudo journalctl -u nodeapp.service -f
应用日志写到标准输出和标准错误,通常比自行在发布目录里追加日志文件更便于集中查看。磁盘空间受限时,还应检查系统日志的保留策略。
异常处理
排错时先查看服务状态和启动日志,再判断是 Node.js 路径、应用依赖、端口还是外部入口问题:
sudo systemctl status --no-pager nodeapp.service
sudo journalctl -u nodeapp.service -b --no-pager -n 100
常见结果及处理方向如下:

status=203/EXEC:通常是ExecStart指向的文件不存在或不可执行。核对/opt/nodejs/node18/bin/node和应用入口路径。MODULE_NOT_FOUND:检查current是否指向正确发布版本,以及该版本的npm ci --omit=dev是否成功。EADDRINUSE:端口已被其他进程占用。用sudo ss -lntp 'sport = :3000'确认占用者,避免在未识别进程前直接结束它。- 本机健康检查成功、域名访问失败:应用进程基本可用,继续检查 Nginx 配置、DNS、证书,以及服务器和云平台的防火墙规则。
Start request repeated too quickly:服务连续启动失败,systemd 已按启动频率限制停止重试。先从日志修复根因,再清除失败状态并启动:
sudo systemctl reset-failed nodeapp.service
sudo systemctl start nodeapp.service
反复重启不等于故障已恢复;若应用因内存不足、配置错误或外部依赖不可用而退出,应先处理根因。依赖数据库等远端服务的应用也应具备连接失败后的重试能力,After=network-online.target 不代表远端服务一定可用。
检查重启恢复
系统启动时自动运行由 systemctl enable 控制;进程异常退出后的恢复则由 Restart 策略控制,两者需要分别验证:
sudo systemctl is-enabled nodeapp.service
sudo systemctl show -p ActiveState -p SubState -p NRestarts nodeapp.service
is-enabled 应返回 enabled,服务应为 active。要验证异常退出恢复,可先在测试环境进行;若在生产环境验证,应安排维护窗口,因为测试会中断当前进程:

sudo systemctl kill --signal=SIGKILL nodeapp.service
sleep 5
sudo systemctl show -p ActiveState -p NRestarts nodeapp.service
curl --fail --show-error http://127.0.0.1:3000/health
预期服务重新进入 active,NRestarts 增加,健康检查恢复。正式环境还可在维护窗口安排一次受控重启;服务器恢复后检查 systemctl is-enabled、服务状态、启动日志及入口访问。单独验证进程重启,不能代替对服务器开机自动启动的检查。
上线验收与回滚核对
上线前确认以下项目:
- 服务单元语法通过,运行用户不是
root,应用入口及环境文件路径正确。 nodeapp.service已启用且处于运行状态,本机健康检查通过,监听地址和端口符合预期。- 异常退出恢复已在测试环境或维护窗口验证;服务器重启后的自动启动也已确认。
- 日志可通过
journalctl查询;公网入口、证书和防火墙规则按实际访问方式配置。 - 旧发布版本、服务文件和环境变量变更记录仍可用于恢复;数据库等持久数据有独立的备份与恢复方案。
采用版本目录的好处是回滚时可以保留新版本,不必直接覆盖代码。若新版本启动失败,将示例中的 release-000 替换为上一个已验证版本,再切回链接并重启:
sudo ln -sfn /srv/nodeapp/releases/release-000 /srv/nodeapp/current.rollback
sudo mv -Tf /srv/nodeapp/current.rollback /srv/nodeapp/current
sudo systemctl restart nodeapp.service
sudo systemctl status --no-pager nodeapp.service
回滚后再执行本机健康检查,并查看启动日志。如果同时修改过服务单元或运行时版本,应恢复对应备份并重新执行 systemctl daemon-reload。不要仅因应用回滚就回退数据库结构,也不要在未确认数据备份和影响范围前删除旧发布目录或数据目录。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5488.html



