把 Node.js 项目放到阿里云服务器上,代码能启动只是第一步。服务器配置是否合适、端口有没有正确开放、进程断开 SSH 后能不能继续运行,都会影响上线后的稳定性。下面以 Ubuntu 和常见的 Express 应用为例,说明从准备服务器到验证服务的基本做法。
先确定服务器配置和访问方式
学习、测试或承载轻量 API,可以从配置适中的云服务器开始,再根据实际负载调整。选购时看清地域、CPU、内存、系统盘和公网带宽:地域尽量靠近主要用户,内存要留出运行应用及依赖进程的空间,带宽则关系到公网访问体验。具体规格要结合项目实际情况,刚开始不必为了“以后可能用得上”直接选很高的配置。
Ubuntu、Alibaba Cloud Linux 等 Linux 系统都能运行 Node.js,本文使用 Ubuntu 举例。测试时可以通过公网 IP 和端口检查应用;正式服务通常会绑定域名、启用 HTTPS,再由 Nginx 把请求转发给 Node.js。确定访问方式后,安全组规则也更容易按需设置。
准备阿里云服务器网络与登录
创建实例后,在阿里云控制台查看公网 IP,并检查安全组入方向规则。SSH 管理端口只应允许可信来源访问;测试时如果需要直接访问应用端口,再临时放行对应 TCP 端口。正式部署通常只开放 SSH、HTTP 和 HTTPS 等必要入口,Node.js 本身由 Nginx 转发访问,不必把应用端口公开到公网。
通过 SSH 登录后,先更新系统软件包:
sudo apt update && sudo apt upgrade -y
生产环境尽量用普通用户运行应用,并妥善管理 SSH 密钥及文件权限。不要为了省事长期开放所有端口,也别把数据库密码、访问密钥等敏感信息提交到公开代码仓库。若项目需要环境变量,部署前就要确认这些值从哪里读取、由谁维护。
安装 Node.js 并上传项目
Node.js 版本要和项目依赖、运行环境匹配。先检查 package.json、锁文件以及团队使用的版本约定,再选择受支持的长期维护版本。可以通过 Node.js 官方渠道或版本管理工具安装,完成后检查版本:
node -v
npm -v
假设项目名为 demo-api,可以通过 Git 拉取代码并安装依赖:
git clone <项目仓库地址>
cd demo-api
npm ci
有锁文件时,npm ci适合按锁定版本安装依赖;项目没有锁文件,则按项目说明使用 npm install。如果上线前需要编译,例如 TypeScript 项目,还要执行对应的构建命令,如 npm run build。别忘了确认服务实际启动的是构建后的入口文件,而不是开发环境使用的文件。
环境变量可以放在服务器端配置文件或通过环境变量注入,并限制配置文件的读取权限。不要把本地开发用的配置直接复制到生产环境,尤其要核对数据库地址、密钥和运行模式。
案例:验证 Express API 是否正常
假设 Express 服务由 server.js 启动,监听本地 3000 端口。启动前确认端口配置正确,并准备一个健康检查接口;上线后遇到问题时,可以先访问这个接口,判断服务进程是否仍在响应。
先在服务器上手动启动应用:
node server.js
再从服务器本机检查响应:
curl http://127.0.0.1:3000
如果服务只通过 Nginx 对外提供访问,建议让 Node.js 监听本地回环地址,避免 3000 端口直接暴露。确认本机请求成功后,再检查域名或公网访问。若外部连不上,不要只反复改应用代码:依次看进程是否运行、监听地址和端口是否正确、Nginx 是否转发到对应端口,以及阿里云安全组是否放行了必要入口。
用 PM2 管理 Node.js 进程
在 SSH 会话里直接运行 Node.js,退出会话后进程可能停止,不适合长期运行。可以用 PM2 管理应用:
sudo npm install -g pm2
pm2 start server.js --name demo-api
pm2 status
pm2 logs demo-api
PM2 可以在进程异常退出后重新拉起应用,也方便查看状态和日志,但它不能替代错误监控、备份或安全管理。配置开机启动时,按 PM2 给出的提示执行相应命令,并保存当前进程列表。部署更新后,按项目流程安装依赖、重新构建,再重启应用;重启完成要实际请求接口,确认新版本可用,而不只看 PM2 显示在线。
通过 Nginx 配置域名和 HTTPS
正式对外提供服务时,先完成域名解析,再在 Nginx 中配置域名和反向代理,把请求转给 Node.js 的本地端口。安全组只开放需要的 Web 端口。HTTPS 证书可通过合适的证书服务申请和部署;配置完成后,记得检查证书有效期和自动续期安排,避免证书过期后访问报错。
Nginx 能统一处理 HTTPS、访问日志和静态资源,也能避免应用端口直接暴露。配置不能只看示例是否能启动:应用如果使用 WebSocket、允许较大的文件上传,或需要较长请求时间,就要核对代理配置中的相应设置。配置完成后,可分别测试 HTTP、HTTPS 和应用接口,确认请求确实转发到了正确服务。
上线前检查与常见问题
- 端口无法访问:先在服务器本机请求应用端口,再检查进程、监听地址、服务器防火墙和阿里云安全组。若本机能访问、外部不能访问,重点排查安全组和 Nginx 转发。
- 启动后很快退出:查看 PM2 日志,核对环境变量、依赖安装、Node.js 版本和启动脚本。构建项目还要确认构建命令已执行,入口文件路径没有写错。
- 更新后运行异常:核对部署的代码版本、构建产物和依赖是否一致。线上更新前保留上一个可用版本,出现问题时可以按现有部署流程回退。
- 资源占用升高:关注 CPU、内存、磁盘和请求量。如果负载持续增加,再根据瓶颈评估扩容、缓存或拆分服务,不要只凭一次短时波动调整配置。
一套可维护的阿里云服务器 Node.js 部署,至少要完成环境安装、项目验证、进程管理和网络访问配置。上线后还要持续看日志与资源使用情况,并确认备份和回滚方式可用。这样排查问题时有明确顺序,后续更新也不必每次从头摸索。