在香港服务器部署Node.js 22 LTS应用,如何配置进程守护?

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

香港服务器上的 Node.js 22 LTS 应用,生产环境通常由 systemd 负责进程守护,由 Nginx 接收公网 HTTP/HTTPS 请求并转发到本机应用端口。应用异常退出时,systemd 可以按策略重启进程;机器重启后,服务也能自动启动。若已有 PM2 部署规范,也可以让 PM2 管理 Node.js 进程,再由 systemd 拉起 PM2,但不建议同时让 PM2 和 systemd 争抢同一个应用进程的重启责任。

导言配图

下面以 Debian 或 Ubuntu、systemd、Nginx 和单实例 Node.js 服务为例,说明从准备、部署、验证到回滚的实施顺序。命令需要按实际域名、目录、应用启动命令和 Node.js 安装路径调整;示例中的域名为 app.example.com,应用监听本机 127.0.0.1:3000。

A5数据提供香港物理服务器租用,覆盖Xeon Gold与AMD EPYC等平台,配备不同容量的内存及SSD或NVMe存储,为Node.js接口服务、企业网站和业务后台提供运行资源。计算、内存与存储资源可承载应用进程、Nginx入口及数据库等组件,支持多服务并行运行与发布文件留存;香港产品的CN2及国际带宽方案,则为面向不同访问地区的应用提供网络资源选择。

部署前准备

确认系统、Node.js 与权限

先确认服务器使用 systemd,并检查 Node.js 版本和可执行文件路径:

cat /etc/os-release
ps -p 1 -o comm=
node --version
npm --version
command -v node

预期 Node.js 版本以 v22 开头,PID 1 通常显示为 systemd。如果 node 命令不可用,或返回的不是 22.x,先按团队采用的安装方式配置 Node.js,再继续部署。不要在尚未确认路径的情况下直接把 /usr/bin/node 写进服务文件:通过版本管理工具安装时,Node.js 也可能位于其他目录。

systemd 的服务进程不会自动读取交互式登录 shell 中的 NVM 初始化配置。因此,如果 Node.js 通过 NVM 安装,不能假定服务能够直接使用登录终端里的 node 命令。建议在生产环境使用固定、可验证的 Node.js 安装路径,并把该路径写入服务配置;若必须使用 NVM,则需要明确配置服务的可执行文件路径及运行环境。

确认域名、端口与应用行为

部署前应准备好以下信息:

  • 已指向香港服务器公网地址的域名。若同时配置了 A 记录和 AAAA 记录,需确认 IPv4、IPv6 均能正确访问服务器,否则证书签发或部分用户访问可能失败。
  • 应用的启动命令、必需环境变量、监听端口和健康检查路径。
  • 应用是否依赖本地文件、数据库、队列等持久化资源。上传文件等需要保留的数据,不应只放在每次发布都会替换的代码目录内。
  • 服务器已允许 SSH 管理。修改防火墙前,先确认 SSH 端口仍会放行,并保留云平台控制台等带外管理方式。

确认 Node.js 程序只监听本机地址,而不是直接暴露给公网。以 Express 应用为例,服务应监听 127.0.0.1,并提供可用于验证的健康检查接口:

const express = require('express');

const app = express();
const host = '127.0.0.1';
const port = Number(process.env.PORT || 3000);

app.get('/health', (_req, res) => {
  res.status(200).json({ status: 'ok' });
});

const server = app.listen(port, host, () => {
  console.log(`listening on http://${host}:${port}`);
});

function shutdown(signal) {
  console.log(`${signal} received, closing server`);
  server.close((error) => {
    if (error) {
      console.error('server close failed', error);
      process.exit(1);
    }
    process.exit(0);
  });

  setTimeout(() => process.exit(1), 10000).unref();
}

process.on('SIGTERM', () => shutdown('SIGTERM'));
process.on('SIGINT', () => shutdown('SIGINT'));

优雅退出有助于服务升级或机器重启时停止接收新请求并完成正在处理的连接。具体超时时间应根据应用请求时长调整;若服务还要关闭数据库连接或消息消费者,应在退出逻辑中一并完成。

创建运行目录与发布结构

使用专用系统用户运行应用,不要让 Web 应用长期以 root 身份启动。以下操作适用于具备 sudo 权限的 Debian/Ubuntu 管理员账号:

sudo adduser --system --group --home /srv/nodeapp nodeapp
sudo install -d -o root -g nodeapp -m 0750 /srv/nodeapp
sudo install -d -o root -g nodeapp -m 0750 /srv/nodeapp/releases
sudo install -d -o nodeapp -g nodeapp -m 0750 /var/lib/nodeapp
sudo install -d -o root -g nodeapp -m 0750 /etc/nodeapp

目录用途如下:

  • /srv/nodeapp/releases:按版本或发布时间保存应用代码及依赖。
  • /srv/nodeapp/current:指向当前启用版本的符号链接。
  • /var/lib/nodeapp:存放需要跨版本保留的本地数据。若应用无本地持久化数据,可以不使用该目录。
  • /etc/nodeapp:存放服务环境变量文件。

这样组织后,发布和回滚只需切换 current 链接,不需要在运行中的目录直接覆盖文件。应用进程对发布目录通常只需读取权限;只有确实需要写入的运行数据目录才授予 nodeapp 写权限。

将已构建的应用发布到新版本目录。下面以构建产物已经准备好为例,20250308-1 只是示例版本名:

RELEASE=/srv/nodeapp/releases/20250308-1

sudo install -d -o root -g nodeapp -m 0750 "$RELEASE"
sudo cp -a /path/to/build/. "$RELEASE/"
sudo chown -R root:nodeapp "$RELEASE"
sudo find "$RELEASE" -type d -exec chmod 0750 {} \;
sudo find "$RELEASE" -type f -exec chmod 0640 {} \;

如果应用需要在运行时读取文件,可按实际情况调整读权限;不要为了快速解决权限问题而对整个应用目录执行 chmod -R 777。如果依赖是在服务器上安装,还要确认安装步骤与锁文件、Node.js 版本及构建方式一致。生产部署通常优先使用已验证的构建产物,并在发布记录中保存版本号及依赖锁文件。

配置 systemd 进程守护

配置环境变量文件

创建服务所需的环境变量文件。敏感信息不要放进公开代码仓库,也不要直接写在会被普通用户读取的文件中:

sudoedit /etc/nodeapp/nodeapp.env

示例内容如下,实际密钥应替换为应用使用的值:

NODE_ENV=production
PORT=3000
APP_SECRET=replace-with-a-long-random-value

限制文件的读取权限:

sudo chown root:nodeapp /etc/nodeapp/nodeapp.env
sudo chmod 0640 /etc/nodeapp/nodeapp.env

systemd 的 EnvironmentFile 使用 KEY=value 格式,不是完整的 shell 脚本,不要依赖其中执行命令、变量展开或 shell 转义。若密钥包含空格、引号等特殊字符,应先按 systemd 对环境文件的规则确认写法,并在服务启动后检查应用实际读取到的结果,但不要把秘密值输出到日志。

创建服务单元

先用 command -v node 确认 Node.js 路径。以下单元文件以 /usr/bin/node 为例;若核验结果不同,将 ExecStart 改成真实路径。假设应用入口文件是 dist/server.js:

sudoedit /etc/systemd/system/nodeapp.service

写入:

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

[Service]
Type=simple
User=nodeapp
Group=nodeapp
WorkingDirectory=/srv/nodeapp/current
EnvironmentFile=/etc/nodeapp/nodeapp.env
ExecStart=/usr/bin/node /srv/nodeapp/current/dist/server.js
Restart=on-failure
RestartSec=5
TimeoutStopSec=15
KillSignal=SIGTERM
UMask=0027
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=full
ProtectHome=true
ReadWritePaths=/var/lib/nodeapp

[Install]
WantedBy=multi-user.target

其中,Restart=on-failure 会在进程以非零状态退出或被异常信号终止时尝试重启;RestartSec=5 可避免失败后立即反复拉起。正常停止时 systemd 先发送 SIGTERM,等待最多 15 秒,再按 systemd 的停止策略处理未退出进程。应用的优雅退出时间应短于这个窗口。

配置 systemd 进程守护 / 创建服务单元配图

ProtectSystem=full 会限制对系统目录的写入;ReadWritePaths 只为应用确实需要写入的位置开放权限。如果应用需要写临时文件、缓存或上传文件,应明确规划目录并加入相应写路径,避免简单移除所有保护项。也不要把代码目录设为运行时可写,除非应用确有该需求。

加载配置、启用服务并启动:

sudo systemctl daemon-reload
sudo systemctl enable --now nodeapp

验证服务是否正常

先看服务状态与启动日志:

sudo systemctl status nodeapp --no-pager
sudo journalctl -u nodeapp -n 50 --no-pager

成功时,服务状态应为 active (running),日志中能看到应用启动信息。下面是用于判断格式的示例输出,不代表某台服务器的实际执行记录:

Active: active (running)
Main PID: 12345 (node)
/srv/nodeapp/current/dist/server.js
listening on http://127.0.0.1:3000

再从服务器本机检查健康接口:

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

预期响应为 HTTP 200,正文类似:

{"status":"ok"}

如果服务不是 active (running),先不要配置或开放公网入口,直接查看 journalctl 的完整错误,以免把应用启动错误误判为 Nginx 或网络问题。也可以检查监听地址:

sudo ss -lntp | grep ':3000'

预期监听地址为 127.0.0.1:3000。若看到 0.0.0.0:3000 或公网地址,需检查应用绑定配置并重启服务;除非确有架构需求,不应将应用端口直接暴露到公网。

配置 Nginx 反向代理与 HTTPS

配置 HTTP 反向代理

安装 Nginx 后创建站点配置。不同发行版的软件包安装方式可能略有差异;Debian/Ubuntu 可先用 nginx -v 检查是否已安装。

sudo apt update
sudo apt install nginx

创建站点配置:

sudoedit /etc/nginx/sites-available/nodeapp

配置示例:

server {
    listen 80;
    listen [::]:80;
    server_name app.example.com;

    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_connect_timeout 5s;
        proxy_read_timeout 60s;
    }
}

启用配置前,先确认 Nginx 是否已经有同名站点或默认站点配置,避免覆盖现有业务。Debian/Ubuntu 常见的启用方式如下:

sudo ln -s /etc/nginx/sites-available/nodeapp /etc/nginx/sites-enabled/nodeapp
sudo nginx -t

只有 nginx -t 显示配置语法检查通过后,再重载 Nginx:

sudo systemctl reload nginx

检查域名解析和 HTTP 响应:

curl -I http://app.example.com/health

预期状态码为 200。如果本机 curl http://127.0.0.1:3000/health 成功,但域名访问返回 502 Bad Gateway,通常表示 Nginx 无法连接上游应用,或上游连接被拒绝,应核对服务状态、监听地址和 proxy_pass 端口。如果返回 404,则需进一步检查应用路由、Nginx 命中的站点配置和请求路径。

配置证书与 HTTPS

签发证书前,确认域名 A/AAAA 记录已指向目标服务器,并且公网可访问 80 端口。若使用 Let’s Encrypt 和 Certbot,应按系统版本安装对应软件包,并核实命令可用;在 Debian/Ubuntu 上可检查:

certbot --version

安装完成后,为域名申请证书:

sudo certbot --nginx -d app.example.com

按照提示完成邮箱、服务条款及 HTTP 跳转选项。签发成功后,检查 HTTPS 响应:

curl -I https://app.example.com/health

如果选择将 HTTP 重定向到 HTTPS,还应验证:

curl -I http://app.example.com/health

预期 HTTP 请求返回重定向状态,Location 指向 HTTPS 地址。确认续期机制已启用后,可进行续期演练:

sudo certbot renew --dry-run

若证书申请失败,先检查 DNS 解析、80 端口可达性、Nginx 配置和域名拼写,再查看 Certbot 报错;不要用关闭证书校验的方式绕过问题。若服务器启用了防火墙,需确保放行 SSH、HTTP 和 HTTPS,并先核对当前管理端口。执行防火墙变更前,保存现有规则并确认有带外控制台,避免误封 SSH 导致无法管理。

日志、资源边界与备份

查看和保留日志

按上述配置,Node.js 的标准输出和标准错误由 systemd 收集,可以使用以下命令查看:

sudo journalctl -u nodeapp -f
sudo journalctl -u nodeapp --since "1 hour ago"

服务重启或部署后,日志中应能看到新进程启动信息。不要在应用日志中输出密码、访问令牌或完整的敏感请求体。systemd 日志会受到系统 journald 配置和磁盘空间策略影响;如果有明确的保留周期或审计要求,应检查 /etc/systemd/journald.conf 和服务器磁盘使用情况,并制定统一日志归档策略。Nginx 访问日志、错误日志通常位于发行版配置指定的位置,可通过 Nginx 配置和 journalctl -u nginx 辅助检查。

设定合理的资源边界

进程守护只能负责启动、监测和重启进程,并不能替代容量规划。服务占用内存会随请求量、缓存、依赖组件和应用代码变化。先在预发布环境或低流量阶段观察稳定运行时的内存,再评估是否设置 systemd 的 MemoryMax。例如,若应用长期内存占用约为 600 MiB,不能把限制设为 600 MiB 就认定足够;应为峰值、垃圾回收和系统其他服务预留空间,并监控是否发生内存压力或进程被终止。

systemd 新版本通常支持 MemoryMax 等资源控制项,但可用性与内核、systemd 版本及 cgroup 配置有关。先检查:

systemd --version
systemctl show nodeapp -p ControlGroup

确认环境支持后,再根据实际容量在 [Service] 中设置,例如:

MemoryMax=1G

这是示例值,不是所有 Node.js 服务都适用的默认配置。设置过低可能导致服务被 OOM 终止并进入重启循环;设置过高则可能挤占同机数据库、Nginx 或系统服务的空间。修改后执行 systemctl daemon-reload 并重启服务,再检查状态和日志。是否设置 CPU 限额也应结合业务延迟目标和服务器上其他工作负载决定,不宜未经观察就给应用设置过低的 CPU 配额。

备份配置与数据

至少应保存以下内容,并确保备份不与服务器上的唯一副本放在同一磁盘:

  • 当前版本及前一个可回滚版本的代码、构建产物和依赖锁文件。
  • /etc/nodeapp/nodeapp.env 等服务配置。备份中含有秘密信息时,应限制访问并采用适当的加密与保管方式。
  • /etc/systemd/system/nodeapp.service 和 Nginx 站点配置。
  • 应用写入 /var/lib/nodeapp 的持久化数据,以及应用依赖的数据库备份。

代码发布备份不能替代数据库备份。数据库的备份方式、时间点恢复能力和一致性要求应按所用数据库单独设计,并定期执行恢复演练。更新前至少记录当前链接指向和当前运行版本,以便判断回滚目标:

readlink -f /srv/nodeapp/current
sudo systemctl status nodeapp --no-pager

更新发布与回滚

发布新版本

每次发布新建独立目录,先完成文件校验,再切换 current。以下命令适用于前述目录结构;切换符号链接会改变生产服务下一次启动或重启使用的代码,执行前必须确认新目录完整、旧版本仍保留。

NEW_RELEASE=/srv/nodeapp/releases/20250308-2

sudo install -d -o root -g nodeapp -m 0750 "$NEW_RELEASE"
sudo cp -a /path/to/new-build/. "$NEW_RELEASE/"
sudo chown -R root:nodeapp "$NEW_RELEASE"
sudo find "$NEW_RELEASE" -type d -exec chmod 0750 {} \;
sudo find "$NEW_RELEASE" -type f -exec chmod 0640 {} \;

若应用需要数据库结构变更,应先确认迁移是否向后兼容,并在迁移前完成数据库备份。破坏性数据库迁移不能仅靠切回旧代码回滚,需另行制定数据恢复方案。

记录旧版本路径,再创建临时链接并原子替换当前链接:

OLD_RELEASE=$(readlink -f /srv/nodeapp/current)
NEW_RELEASE=/srv/nodeapp/releases/20250308-2

sudo ln -s "$NEW_RELEASE" /srv/nodeapp/current.new
sudo mv -Tf /srv/nodeapp/current.new /srv/nodeapp/current
sudo systemctl restart nodeapp

切换后进行基本检查:

sudo systemctl is-active nodeapp
curl -fsS http://127.0.0.1:3000/health
curl -fsSI https://app.example.com/health
sudo journalctl -u nodeapp -n 30 --no-pager

服务应处于 active,健康接口应返回成功,HTTPS 请求应得到预期状态码,日志中不应出现持续的启动错误。健康检查通过不等于所有业务功能都正常;发布验收还应覆盖登录、关键读写流程及实际依赖的数据库或外部服务。

异常处理与回滚

如果重启后服务无法启动,先查看状态、日志和 Node.js 路径,不要立刻删除新版本目录:

sudo systemctl status nodeapp --no-pager
sudo journalctl -u nodeapp -n 100 --no-pager
command -v node
sudo systemctl show nodeapp -p ExecStart -p EnvironmentFiles

常见原因及处理方向:

表现优先核对项
203/EXEC 或提示无法执行ExecStart 中 Node.js 路径是否存在、是否有执行权限
Cannot find module入口文件路径、构建产物和依赖是否完整
服务因环境变量报错退出环境文件权限、变量名称和值的格式
EADDRINUSE端口是否已有其他进程监听,应用是否重复启动
Nginx 返回 502Node.js 服务状态、上游监听地址和端口
启动后很快被终止应用启动错误、内存压力、systemd 资源限制和日志

如果新版本验收失败,切回已记录的旧版本,并重启服务。以下操作会切换生产代码,执行前确认 OLD_RELEASE 非空且目录存在:

test -n "$OLD_RELEASE" && test -d "$OLD_RELEASE" || {
  echo "旧版本路径无效,停止回滚"
  exit 1
}

sudo ln -s "$OLD_RELEASE" /srv/nodeapp/current.rollback
sudo mv -Tf /srv/nodeapp/current.rollback /srv/nodeapp/current
sudo systemctl restart nodeapp

随后重新检查服务状态、本机健康接口、HTTPS 访问和日志。若数据库已执行不兼容迁移,代码回滚可能无法恢复业务,应按数据库备份与迁移方案处理,不要直接删除或覆盖数据库文件。确认回滚稳定后,再保留新版本现场用于分析;只有在确认无需排查且备份完备时,才考虑清理旧发布目录。

更新发布与回滚 / 异常处理与回滚配图

上线验收清单

发布完成后,按服务层、入口层和恢复能力分别验收:

  • 进程守护:systemctl is-enabled nodeapp 显示已启用,systemctl is-active nodeapp 显示运行中;重启服务后能自动恢复。
  • 监听范围:Node.js 仅监听 127.0.0.1 的应用端口,公网请求经 Nginx 进入。
  • 应用健康:本机健康接口、域名 HTTPS 健康接口均返回预期结果;关键业务流程已实际检查。
  • 反向代理与证书:nginx -t 通过,HTTP 跳转策略符合预期,证书有效且续期演练通过。
  • 日志与资源:systemd 和 Nginx 日志可读取,磁盘空间、内存及重启次数有监控;资源限制与服务实际负载相匹配。
  • 备份与回滚:代码、服务配置、敏感环境变量和持久化数据均有可恢复副本;记录了上一版本路径,并确认回滚命令可用。
  • 管理安全:防火墙规则仍允许必要的 SSH 管理流量,只开放需要的公网服务端口;不需要公网访问的应用端口未对外开放。

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

相关推荐