小规格云服务器部署 Node.js Web 服务实战:版本、进程守护与公网发布的几个坑
最近在一台入门级云主机(2 核 2 GiB、带宽 2 Mbit/s)上部署了一个 Node.js 的 Web 服务,过程里踩了几个不大不小的坑,记录下来供同样在小规格机器上折腾的朋友参考。
坑一:Node 版本不够新。很多新框架在 package.json 的 engines 里要求 Node 24 以上,机器上预装或默认源装的是 22 LTS,安装时只给一个 EBADENGINE 警告,真跑起来才出问题。解决办法是切换 NodeSource 的 24.x 源重新安装:curl -fsSL https://deb.nodesource.com/setup_24.x | sudo bash -,然后 sudo apt-get install -y nodejs,装完用 node -v 验证,并确认之前全局安装的命令行工具还能正常调用。
坑二:npm 报 ETARGET 装不上包。如果一个包目前只发布了预发布版本(比如 0.2.2-rc.1),不带版本号的 npm install 会按正式版范围解析、默认不收预发布版,于是报 No matching version found。这不是镜像源的问题,显式指定完整版本号即可装上,例如 npm install -g 包名@0.2.2-rc.1。
坑三:进程守护别裸跑。用 systemd 写一个 unit:ExecStart 写服务的启动命令,用专用的普通用户运行(User 字段)而不是 root,WorkingDirectory 指到该用户的家目录,再加 Restart=on-failure 和 RestartSec,最后 systemctl enable --now 启用。这样机器重启、进程崩溃都能自己回来,journalctl 就能看日志。
坑四:公网发布要三处对齐。第一,服务监听地址要绑到网卡的实际 IP,只听 127.0.0.1 外网进不来;第二,云控制台的安全组要放行对应端口;第三,如果框架本身有令牌鉴权或可信主机(trusted-host)设置,公网地址要正确登记。三处少任何一处,现象都是“服务器本机测一切正常,外网就是打不开”,排查时按这三层逐项对。
坑五:本机防火墙和云安全组是两道独立的门。云安全组放行了,系统里的 ufw 或宝塔防火墙没放行,端口一样不通;反过来也一样。本机 curl 测试只能证明服务活着,验证公网可达一定要用另一个网络(比如手机流量)实际打开一次。
小结:小规格机器跑 Web 服务完全够用,关键是把版本、守护、监听、安全组、防火墙这几件事一次对齐,剩下的就是耐心等小带宽慢慢传。
- 点赞
- 收藏
- 关注作者
评论(0)