Node.js 项目在本地能运行,部署到服务器后却打不开,常见原因包括依赖没有正确安装、应用进程退出,或端口和代理配置不匹配。使用阿里云服务器部署时,把运行环境、进程管理和网络入口逐项确认,比单纯把代码上传上去更可靠。下面以一个简单的网站为例,梳理从准备服务器到上线检查的流程。
先确定服务器配置与系统
服务器规格要结合项目规模、访问量和预算来定。个人项目、测试环境或轻量接口服务,可以先从较低配置起步;如果应用需要处理更多请求,或还要运行数据库、缓存等组件,就要给 CPU、内存和磁盘留出余量。上线后观察监控数据,再决定是否调整配置,通常比一开始直接购买高规格实例更合适。
系统可以选择 Ubuntu、Alibaba Cloud Linux 等常见 Linux 发行版。优先使用团队熟悉、仍在维护的版本,并在安装前核对项目依赖支持的 Node.js 版本。Node.js 可以通过官方安装包、系统仓库或版本管理工具安装。如果多个项目需要不同版本,版本管理工具更方便;团队协作时,还应约定统一的运行版本,避免开发环境和线上环境不一致。
部署前做好基础准备
- 整理项目:确认依赖锁定文件已经提交,npm 或 pnpm 安装流程可用,并核实
package.json中的生产启动命令。 - 准备配置:数据库地址、密钥等敏感信息放在环境变量或独立配置文件中,不要写进代码后提交到仓库。
- 连接服务器:通过 SSH 登录,优先使用密钥认证;如果需要密码登录,应确认相关访问限制设置妥当。
- 检查安全组:只开放实际需要的端口。SSH 用于服务器管理,网站通常通过 80 和 443 端口对外提供服务。
可以先让 Node.js 应用监听本机的内部端口,例如 3000,再由 Nginx 接收外部请求并转发。这样访问者只需要连接网站入口,应用端口不必直接暴露在公网,也方便后续接入域名和 HTTPS。
以简单网站为例完成部署
假设项目已经上传到服务器的 /srv/myapp 目录。进入项目目录后,按锁定文件安装生产依赖,再执行项目定义的启动命令:
安装依赖:npm ci --omit=dev
启动项目:npm start
这两条命令不能脱离项目配置照搬。使用 npm 的项目要确认存在对应的锁定文件,启动脚本也要以 package.json 为准。如果项目使用 pnpm,安装命令应按项目现有流程执行。应用启动后,可在服务器本机用 curl 请求对应端口,先确认页面或接口有响应,再排查 Nginx 和域名问题。
应用通常只需监听本机地址和约定端口,例如 127.0.0.1:3000。如果监听地址、端口与代理配置对不上,Nginx 就无法把请求转发到应用。部署前也要检查应用实际读取的环境变量,避免数据库连接信息缺失时服务虽然启动,却无法正常处理请求。
项目如果需要构建前端资源,应先运行对应的构建命令,并确认生成目录也包含在部署流程里。不要直接把本地的 node_modules 整体复制到服务器:本地与服务器的操作系统或运行环境不同,可能导致依赖无法使用。通常在服务器上根据锁定文件重新安装更稳妥。
用进程管理工具保持服务运行
在 SSH 窗口中直接运行应用,退出会话或关闭终端后,进程可能停止。生产环境可以用 PM2 等进程管理工具让应用在后台运行,并查看进程状态和日志。部署时要按项目配置启动命令与运行环境,确认服务正常后,再设置服务器重启时自动恢复。
例如,一个小型预约系统把 Node.js 接口部署到阿里云服务器后,最初直接在终端启动服务。维护时 SSH 会话关闭,接口也停止响应。改由 PM2 管理进程并设置开机启动后,退出终端不会直接结束服务;应用启动失败时,也可以通过状态和日志查找原因。
PM2 管理的是进程,不能代替应用错误处理、备份或监控。查看日志时留意是否意外记录了密钥、用户信息等内容;同时定期检查内存、磁盘和错误日志,避免服务运行一段时间后才发现空间不足或持续报错。
配置 Nginx、域名与 HTTPS
Nginx 可以接收发往网站域名的请求,再转发到 Node.js 应用的本机端口。例如,外部访问 80 或 443 端口,Nginx 将请求代理到 3000 端口。修改配置后,先检查 Nginx 配置语法,通过后再重新加载服务;之后分别测试域名页面和应用接口,确认代理目标与应用监听端口一致。
域名解析要指向服务器的公网地址。启用 HTTPS 时,还需要为域名配置有效证书,并留意证书续期。域名解析、证书和阿里云安全组是不同的配置环节:域名解析正确,并不代表 443 端口已放行;安全组放行了端口,也不代表证书已经正确配置。排查时按环节逐项确认,能更快缩小范围。
上线后的检查与维护
- 核对安全组规则,只开放必要端口;数据库等内部服务没有对外访问需求时,不要直接暴露到公网。
- 查看应用、Nginx 和系统日志,确认没有持续报错、代理失败或进程频繁重启。
- 备份数据库和重要配置,并定期检查备份文件是否完整、是否能够恢复。
- 观察 CPU、内存和磁盘使用情况,再根据实际负载判断要不要扩容或优化应用。
- 升级 Node.js 或项目依赖前,先在测试环境验证,避免未经检查就直接改动线上运行环境。
常见问题与排查思路
域名无法访问:先确认域名解析指向正确的公网地址,再检查安全组、防火墙规则和 Nginx 状态。如果直接访问服务器地址正常、通过域名不正常,优先核对解析与 Nginx 站点配置。
应用启动失败:查看 PM2 或其他进程管理工具的日志,检查 Node.js 版本、依赖安装结果、启动脚本和环境变量。不要只看终端里最后一行报错,前面的日志往往能说明问题发生在哪个环节。
本机能访问,外网不通:确认应用是否监听了预期地址和端口,再检查 Nginx 是否指向该端口,以及安全组是否放行 80 或 443。应用端口只供本机代理使用时,外网访问不到这个端口属于正常情况。
部署阿里云服务器 Node.js 项目,可以先采用一台服务器、一个应用进程和 Nginx 反向代理的简单方案。把依赖安装、启动检查、域名接入和日志查看做成固定流程;遇到无法访问时,按应用本机访问、Nginx 代理、域名解析和安全组的顺序排查。项目规模增长后,再根据实际负载调整服务器配置和部署方式。