在香港服务器部署Node.js应用,如何配置进程守护与反向代理?
在香港服务器部署 Node.js 应用,可以采用“Node.js 只监听本机端口,systemd 负责进程守护,Nginx 对外提供 HTTPS 并转发请求”的结构。这样能将应用运行、异常重启、开机启动、证书管理和访问日志分开处理,避免直接把 Node.js 端口暴露到公网。

下面以 Ubuntu 24.04 LTS、单台服务器、单个 Node.js 应用为例,按部署、验证、排障和回滚的顺序操作。进程守护选择系统自带的 systemd,不与 PM2 叠加使用;Nginx 负责正常的网站反向代理。示例适合 API 服务和常规网站,不包含数据库安装,也不把单机进程重启等同于高可用。
A5数据提供香港物理服务器租用,为Node.js网站、API接口和业务后台提供部署所需的计算、存储与网络资源。香港产品涵盖入门建站、Xeon Gold及AMD EPYC等平台,配有SSD或NVMe存储,不同档位的内存与处理器资源可承载应用进程、Nginx入口及多任务运行;CN2与国际带宽方案则为面向不同访问地区的业务提供网络资源基础。
一、准备环境,确定端口与目录边界
部署前需要满足哪些条件
开始前确认:
- 有可使用
sudo的 SSH 账号,并保留另一条 SSH 会话或服务器控制台作为应急入口。 - 已安装应用支持的、仍在维护期内的 Node.js LTS 版本。
- 域名已经解析到服务器公网地址;如存在 AAAA 记录,IPv6 也必须能正确到达该服务器。
- 云平台安全组和系统防火墙允许网站需要的 TCP 80、443,以及实际使用的 SSH 端口。
- 应用提供健康检查路径,例如
/healthz。 - 已准备应用发布包、环境变量及数据库连接信息,不在服务器上临时猜测生产配置。
香港服务器的位置不会改变 systemd 或 Nginx 的配置方式,但会影响用户访问路径。部署成功只能证明服务链路可用;面向不同地区用户的延迟、丢包和带宽表现,应在上线后从目标访问地区单独验证。
本文使用以下示例,执行前统一替换域名:
| 项目 | 示例值 | 边界说明 |
|---|---|---|
| 域名 | app.example.com | 替换为自己的域名 |
| 应用用户 | a5app | 无登录权限,不用于 SSH |
| 发布目录 | /srv/a5app/releases/v1 | 保存代码及运行依赖 |
| 当前版本 | /srv/a5app/current | 指向发布目录的符号链接 |
| 应用端口 | 127.0.0.1:3000 | 不向公网开放 |
| 环境变量 | /etc/a5app/app.env | 仅管理员可读 |
| 可写数据目录 | /var/lib/a5app | 与代码目录分离 |
核验系统和 Node.js 路径
cat /etc/os-release
node --version
command -v node
readlink -f "$(command -v node)"
后文服务文件使用 /usr/bin/node。只有确认该路径对应所需版本后才能照用:
/usr/bin/node --version
如果 Node.js 安装在其他位置,应修改服务文件中的 ExecStart。不要直接引用某个管理员账号下的版本管理器路径,否则系统服务可能因目录权限、登录环境或版本切换而无法启动。
安装 Nginx 和证书工具:
sudo apt update
sudo apt install -y nginx certbot curl
这是针对 Ubuntu 24.04 软件包布局的命令。若服务器已有网站,先备份相关 Nginx 配置,不要删除默认站点或覆盖其他业务配置。
检查当前监听情况:
sudo ss -lntp
sudo nginx -t
若 3000 已被占用,应先识别进程,而不是直接终止;若 80、443 被其他 Web 服务占用,需要先决定由哪个服务承担公网入口。
防火墙只开放必要端口
先查看 UFW 状态:
sudo ufw status numbered
如果 UFW 已启用,可按现有规则补充网站端口:
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
不要开放 3000。云平台安全组也只需放行公网入口端口。
本文不直接执行 ufw enable:远程启用防火墙前,必须确认实际 SSH 端口已放行,并有控制台兜底。回滚时只删除本次新增且不再需要的规则,不要清空防火墙,也不要删除其他网站共用的 80、443 规则。
二、部署应用并交给 systemd 守护
建立专用用户和目录
以下命令用于新建应用;如果同名用户或目录已存在,应先确认用途,不要覆盖已有业务。
getent passwd a5app
没有输出时,再创建用户:
sudo useradd --system --user-group \
--home-dir /srv/a5app \
--shell /usr/sbin/nologin a5app
sudo install -d -o root -g a5app -m 0750 \
/srv/a5app \
/srv/a5app/releases \
/srv/a5app/releases/v1
sudo install -d -o root -g root -m 0700 /etc/a5app
sudo install -d -o a5app -g a5app -m 0750 /var/lib/a5app
代码目录由管理员管理,应用用户只有读取权限;上传文件、缓存等写入 /var/lib/a5app。不要为了消除权限报错,把整个项目目录设成全员可写。
放入可验证的应用
已有项目应部署完成构建的发布包,包含运行入口和必要的生产依赖。带原生模块的依赖还必须匹配服务器的系统、CPU 架构及 Node.js 版本。
下面的最小应用用于验证部署链路。只在新建的演示目录执行,不要覆盖实际项目的 server.js。
sudo tee /srv/a5app/releases/v1/server.js >/dev/null <<'EOF'
'use strict';
const http = require('node:http');
const host = process.env.HOST || '127.0.0.1';
const port = Number(process.env.PORT || 3000);
const server = http.createServer((req, res) => {
if (req.url === '/healthz') {
res.writeHead(200, { 'Content-Type': 'application/json' });
res.end(JSON.stringify({ status: 'ok' }));
return;
}
res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
res.end('Node.js application is running\n');
});
server.listen(port, host, () => {
console.log(`listening on ${host}:${port}`);
});
function shutdown(signal) {
console.log(`received ${signal}, shutting down`);
server.close(() => process.exit(0));
setTimeout(() => process.exit(1), 10000).unref();
}
process.on('SIGTERM', () => shutdown('SIGTERM'));
process.on('SIGINT', () => shutdown('SIGINT'));
EOF
sudo chmod 0644 /srv/a5app/releases/v1/server.js
sudo ln -s /srv/a5app/releases/v1 /srv/a5app/current
sudo /usr/bin/node --check /srv/a5app/current/server.js
node --check 无输出且退出码为 0,表示语法检查通过;它不证明数据库、外部接口或运行依赖可用。
建立环境变量文件:
sudo tee /etc/a5app/app.env >/dev/null <<'EOF'
NODE_ENV=production
HOST=127.0.0.1
PORT=3000
EOF
sudo chmod 0600 /etc/a5app/app.env
该文件由 systemd 读取后传入进程,不需要应用用户直接读取。实际密钥也可放在这里,但不要提交到代码仓库;修改后需要重启应用才能生效。
配置 systemd 服务
下面的内存参数是小型应用的起始示例,应结合服务器总内存和其他服务调整。如果文件已存在,先备份,再修改。
sudo tee /etc/systemd/system/a5app.service >/dev/null <<'EOF'
[Unit]
Description=A5 Node.js Application
Wants=network-online.target
After=network-online.target
StartLimitIntervalSec=60
StartLimitBurst=5
[Service]
Type=simple
User=a5app
Group=a5app
WorkingDirectory=/srv/a5app/current
EnvironmentFile=/etc/a5app/app.env
ExecStart=/usr/bin/node --max-old-space-size=512 /srv/a5app/current/server.js
Restart=on-failure
RestartSec=3
KillSignal=SIGTERM
TimeoutStopSec=15
NoNewPrivileges=true
PrivateTmp=true
ProtectHome=true
ProtectSystem=strict
ReadWritePaths=/var/lib/a5app
MemoryMax=768M
CPUQuota=100%
LimitNOFILE=65536
UMask=0027
StandardOutput=journal
StandardError=journal
[Install]
WantedBy=multi-user.target
EOF
sudo systemd-analyze verify /etc/systemd/system/a5app.service
sudo systemctl daemon-reload
sudo systemctl enable --now a5app.service
这里几个配置需要分开理解:
Restart=on-failure:异常退出时重启,管理员执行正常停止时不会重新拉起。StartLimitBurst:阻止错误配置造成无限快速重启。--max-old-space-size=512:限制 V8 老生代堆,单位为 MiB,不是整个进程的内存上限。MemoryMax=768M:限制服务控制组内存,需覆盖堆、Buffer、原生模块和线程等开销。CPUQuota=100%:服务最多使用相当于一个逻辑 CPU 的处理时间,不表示独占一个 CPU。ProtectSystem=strict:大部分文件系统对服务只读;需要写入的目录必须显式放行。
实际应用若还要写其他目录,应逐项添加 ReadWritePaths,而不是直接取消全部保护。
验证监听、健康检查和异常重启
sudo systemctl status a5app.service --no-pager
sudo ss -lntp | grep ':3000'
curl --fail --show-error http://127.0.0.1:3000/healthz
预期服务为 active (running),监听地址为 127.0.0.1:3000,健康检查返回:
{"status":"ok"}
若出现 0.0.0.0:3000,说明应用没有正确使用监听地址,应先修正再继续。
以下测试会强制终止主进程,可能中断请求,仅在上线前或维护窗口执行:
sudo systemctl kill --kill-whom=main --signal=SIGKILL a5app.service
sleep 5
sudo systemctl show a5app.service -p ActiveState -p MainPID -p NRestarts
curl --fail --show-error http://127.0.0.1:3000/healthz
恢复为活动状态且健康检查成功,才说明异常重启链路有效。真实应用还应测试收到 SIGTERM 后能否停止接收新请求、释放数据库连接并在超时前退出。
三、配置 Nginx 反向代理和 HTTPS
先建立 HTTP 入口
创建证书验证目录:
sudo install -d -o root -g root -m 0755 /var/www/acme
新建 /etc/nginx/sites-available/a5app.conf:
server {
listen 80;
server_name app.example.com;
access_log /var/log/nginx/a5app.access.log;
error_log /var/log/nginx/a5app.error.log warn;
location ^~ /.well-known/acme-challenge/ {
root /var/www/acme;
default_type text/plain;
try_files $uri =404;
}
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Connection "";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_connect_timeout 5s;
proxy_read_timeout 60s;
proxy_send_timeout 60s;
client_max_body_size 10m;
}
}
本例中 Nginx 是直接接收公网请求的唯一入口,因此用 $remote_addr 重写 X-Forwarded-For,不继承客户端自行提交的同名头。
如果前面还有 CDN 或负载均衡器,应另外配置可信来源地址及真实 IP 处理,不能直接照搬信任规则。应用框架也应只信任本机 Nginx,不应无条件信任所有代理头。
启用站点并检查:
sudo ln -s /etc/nginx/sites-available/a5app.conf \
/etc/nginx/sites-enabled/a5app.conf
sudo nginx -t
sudo systemctl reload nginx
curl --fail --show-error \
-H 'Host: app.example.com' \
http://127.0.0.1/healthz
只有 nginx -t 成功才执行 reload。若同名启用链接已存在,先核对目标,不要重复创建或强制覆盖。
签发证书,再切换 HTTPS
先从服务器外部确认域名能到达本站。证书签发时,公网 80 端口需要可访问,域名解析及可能存在的 CAA 记录也必须允许所选证书机构签发。
sudo certbot certonly \
--webroot \
-w /var/www/acme \
-d app.example.com
sudo certbot certificates
以命令实际列出的证书路径为准。如果存在旧证书或重复证书名称,路径可能不是下面的默认示例。
证书成功后,备份现有站点文件:
sudo install -d -m 0700 /var/backups/a5app
sudo cp -a /etc/nginx/sites-available/a5app.conf \
/var/backups/a5app/nginx.before-tls.conf
将站点配置替换为:
server {
listen 80;
server_name app.example.com;
location ^~ /.well-known/acme-challenge/ {
root /var/www/acme;
default_type text/plain;
try_files $uri =404;
}
location / {
return 301 https://app.example.com$request_uri;
}
}
server {
listen 443 ssl;
server_name app.example.com;
ssl_certificate /etc/letsencrypt/live/app.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/app.example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
access_log /var/log/nginx/a5app.access.log;
error_log /var/log/nginx/a5app.error.log warn;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Connection "";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_connect_timeout 5s;
proxy_read_timeout 60s;
proxy_send_timeout 60s;
client_max_body_size 10m;
}
}
再验证:
sudo nginx -t
sudo systemctl reload nginx
curl -I http://app.example.com/
curl --fail --show-error https://app.example.com/healthz
预期 HTTP 返回 301,HTTPS 健康检查返回 200。正式验收不要使用 curl -k 跳过证书验证。
proxy_pass 此处没有附加 URI,会保留原请求路径。涉及 /api/ 前缀改写时,应单独验证路径,不能随意增加或删除尾部斜杠。
本配置没有启用 WebSocket 升级;应用如使用 WebSocket,需要额外配置 Upgrade 和对应的 Connection 映射。长连接、流式响应也应按业务需求调整超时,不要统一拉长所有请求的超时时间。
验证自动续期和证书重载
为 webroot 续期增加部署钩子,使证书更新后 Nginx 重新读取证书:
sudo install -d -m 0755 /etc/letsencrypt/renewal-hooks/deploy
sudo tee /etc/letsencrypt/renewal-hooks/deploy/reload-nginx >/dev/null <<'EOF'
#!/bin/sh
set -eu
/usr/sbin/nginx -t
/usr/bin/systemctl reload nginx
EOF
sudo chmod 0755 /etc/letsencrypt/renewal-hooks/deploy/reload-nginx
sudo certbot renew --dry-run
sudo /etc/letsencrypt/renewal-hooks/deploy/reload-nginx
systemctl list-timers --all | grep certbot
续期模拟用于验证申请链路,单独执行钩子用于验证配置检查和重载。若没有定时任务,应核对当前 Certbot 的安装方式,再建立一种明确的调度方式,不要同时堆叠多个续期任务。
四、补齐日志、备份和资源监控
区分三类日志
# 应用启动、异常和标准输出
sudo journalctl -u a5app.service -n 100 --no-pager
# 持续观察应用日志,按 Ctrl+C 退出
sudo journalctl -u a5app.service -f
# Nginx 访问及上游错误
sudo tail -n 100 /var/log/nginx/a5app.access.log
sudo tail -n 100 /var/log/nginx/a5app.error.log
# 日志占用与磁盘余量
sudo journalctl --disk-usage
df -h
df -i
应用日志不要记录密码、访问令牌或完整敏感请求体。Nginx 默认访问日志可能包含查询字符串,因此敏感信息也不应放进 URL。
Ubuntu 软件包通常提供 Nginx 日志轮转配置,可以检查:
sudo logrotate -d /etc/logrotate.d/nginx
-d 是调试检查,不实际轮转。应用日志由 journald 管理,不要对其内部文件使用普通文件轮转。若要修改 journald 的持久化和容量上限,需要注意配置通常影响整台服务器,应在维护窗口备份并验证。
备份配置和发布版本
下面归档只包含应用代码、配置和证书,不保证业务数据一致性:
sudo install -d -m 0700 /var/backups/a5app
sudo tar -czf \
"/var/backups/a5app/config-release-$(date +%Y%m%d-%H%M%S).tar.gz" \
-C / \
srv/a5app \
etc/a5app \
etc/systemd/system/a5app.service \
etc/nginx/sites-available/a5app.conf \
etc/letsencrypt
归档内可能包含密钥和环境变量,必须限制访问并加密传输到异机存储。只保存在同一块服务器磁盘上的副本,无法应对磁盘故障或整机丢失。
数据库应使用对应数据库的备份机制;上传文件和 /var/lib/a5app 则需要配合暂停写入、应用一致性方案或合适的快照机制。不要把运行中的数据库目录直接打包后当作可靠备份。
至少进行一次隔离恢复演练:检查归档能否解开、符号链接是否保留、密钥权限是否正确、应用版本是否匹配数据库结构。
用监控决定资源边界
sudo systemctl show a5app.service \
-p MemoryCurrent -p MemoryPeak -p CPUUsageNSec -p NRestarts
sudo journalctl -k --since "1 hour ago" --no-pager
上线后重点观察内存峰值、重启次数、磁盘增长、请求延迟和 5xx 错误。示例中的 512 MiB 堆和 768 MiB 服务上限不是容量承诺;即使服务器有 2 GiB 内存,也必须为系统、Nginx及其他服务留出空间。
systemd 能重启退出的进程,却不能自动识别所有“进程仍在,但接口已经失效”的情况。健康检查应接入外部监控;读取数据库的就绪检查与单纯判断进程存活的检查,可以分别设置。
五、出现故障时,按从外到内的顺序排查
域名无法访问或证书申请失败
先检查域名解析、云平台安全组、系统防火墙,再检查 Nginx 是否监听:
getent ahosts app.example.com
sudo ss -lntp | grep -E ':80|:443'
sudo nginx -t
- 解析地址不正确:修改 DNS,并等待缓存更新。
- 存在不可达的 AAAA 记录:修复 IPv6 链路,或删除不适用的记录。
- 本机访问正常、外部超时:优先检查公网入站规则和网络路径。
- 证书验证路径返回 404:检查 webroot、站点匹配以及其他重写规则。
- 证书签发被拒绝:查看 Certbot 提示,区分 DNS、CAA、验证失败和申请频率限制。
不要通过关闭全部防火墙解决问题。
Nginx 返回 502 或 504
先看错误日志,再访问上游:
sudo tail -n 100 /var/log/nginx/a5app.error.log
curl --max-time 5 --show-error http://127.0.0.1:3000/healthz
sudo systemctl status a5app.service --no-pager
connection refused 通常表示上游未监听、端口配置错误或服务已退出;upstream timed out 则需要检查慢请求、事件循环阻塞、数据库连接和外部依赖。
504 不一定是服务器带宽不足。未经分析就增加 proxy_read_timeout,可能只是让更多请求长期占用连接。

应用持续重启、权限失败或被内存限制终止
sudo journalctl -u a5app.service -n 200 --no-pager
sudo -u a5app /usr/bin/node --check /srv/a5app/current/server.js
按日志区分处理:
EADDRINUSE:确认端口占用者,停用重复启动方式。EACCES:检查目录权限及ReadWritePaths,不要放宽整个文件系统。- 找不到模块:检查发布包是否遗漏生产依赖,或原生模块与运行环境不匹配。
- V8 堆耗尽:结合业务检查内存泄漏和堆配置。
- 服务被 OOM 终止:结合内核日志判断是服务上限还是整机内存压力。
修正后,如果已经触发启动频率限制:
sudo systemctl reset-failed a5app.service
sudo systemctl restart a5app.service
curl --fail --show-error http://127.0.0.1:3000/healthz
不要反复 reset-failed 来掩盖启动错误。
六、执行上线验收,并保留可操作的回滚路径
上线验收检查项
a5app.service已启用开机启动,运行用户不是 root。- Node.js 只监听
127.0.0.1:3000,公网没有开放应用端口。 - 本机健康检查和外部 HTTPS 健康检查均成功。
- HTTP 正确跳转 HTTPS,证书域名和有效期正确。
- Certbot 续期模拟及 Nginx 重载钩子通过。
- 已验证异常退出重启;维护窗口内完成整机重启后验收。
- 日志可查询,有容量控制或告警,磁盘余量可监测。
- 环境变量、证书和备份均限制访问。
- 已保留上一发布版本,并明确数据库迁移是否支持回退。
应用版本回滚
更新时先将新版本完整放入独立目录,不要在正在运行的目录中覆盖文件。下面以已经准备并检查完成的 v2 为例;切换会重启单个实例,存在短暂中断,应在维护窗口执行。
# 记录当前版本,便于回滚
readlink -f /srv/a5app/current | \
sudo tee /var/backups/a5app/previous-release.txt >/dev/null
# 确认新版本入口存在并通过语法检查
sudo test -f /srv/a5app/releases/v2/server.js
sudo /usr/bin/node --check /srv/a5app/releases/v2/server.js
# 原子替换符号链接,再重启服务
sudo ln -s /srv/a5app/releases/v2 /srv/a5app/.current-next
sudo mv -Tf /srv/a5app/.current-next /srv/a5app/current
sudo systemctl restart a5app.service
curl --fail --show-error http://127.0.0.1:3000/healthz
curl --fail --show-error https://app.example.com/healthz
以上命令应逐条检查结果:任何一步失败都应停止,不要继续切换。临时链接 .current-next 必须事先不存在。语法检查之外,还需执行项目自己的测试和依赖检查。
验证失败时,在确认旧目录仍完整、数据库结构仍兼容后回滚:
PREVIOUS="$(sudo cat /var/backups/a5app/previous-release.txt)"
sudo test -f "$PREVIOUS/server.js"
sudo ln -s "$PREVIOUS" /srv/a5app/.current-rollback
sudo mv -Tf /srv/a5app/.current-rollback /srv/a5app/current
sudo systemctl restart a5app.service
curl --fail --show-error http://127.0.0.1:3000/healthz
curl --fail --show-error https://app.example.com/healthz
回滚代码不会自动回滚环境变量、数据库结构或业务数据。涉及不兼容迁移时,应采用经过验证的迁移回退方案,不能只切换符号链接。

配置回滚检查项
每次后续修改 Nginx 前,先单独保存当时的配置:
sudo cp -a /etc/nginx/sites-available/a5app.conf \
/var/backups/a5app/nginx.before-change.conf
需要回退时:
sudo cp -a /var/backups/a5app/nginx.before-change.conf \
/etc/nginx/sites-available/a5app.conf
sudo nginx -t
sudo systemctl reload nginx
同样只有配置检查成功才能 reload。首次部署保存的 nginx.before-tls.conf 仅适用于 HTTPS 配置阶段的临时回退,不应在正式上线后恢复它并继续承载敏感业务。
最终确认:
- 回滚后检查的是本机上游和公网 HTTPS 两条链路。
- systemd 服务文件如有恢复,已执行
daemon-reload再重启。 - 环境变量恢复后,应用已重启并验证。
- 未删除旧版本、共用证书、其他站点配置或共用防火墙规则。
- 业务数据没有被代码回滚误覆盖。
- 验收完成前保留 SSH 应急会话和服务器控制台入口。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3234.html



