把 Node.js 项目部署到阿里云,代码能启动只是第一步。上线后还要保证进程不会因 SSH 断开而退出,公网请求能正确转发,敏感配置不会泄露,后续更新也有可执行的步骤。下面以 Ubuntu 上的 Express Web 服务为例,说明从准备 ECS 到验证域名访问的常见流程。其他 Linux 发行版的安装命令和服务管理方式可能不同。
一、部署前先准备好三件事
1. 一台阿里云 ECS
创建 ECS 时,按项目需要选择地域、操作系统和配置。测试环境或访问量较小的服务,可以先从较低配置开始,再根据 CPU、内存等实际使用情况调整。实例创建后记下公网 IP,并确认运行状态正常。若项目还依赖数据库、对象存储等服务,也要提前准备相应的连接信息。
2. 配置安全组规则
安全组控制哪些网络流量可以进入 ECS。登录阿里云控制台,找到实例对应的安全组,按实际用途开放端口。SSH 通常使用 22 端口;如果由 Nginx 对外提供网站服务,一般需要开放 80 和 443 端口。
不要为了排错方便直接放开所有端口。Node 服务如果只接收本机 Nginx 转发的请求,可以监听 127.0.0.1,应用端口不必暴露给公网。SSH 也尽量限制来源地址,避免任何网络位置都能尝试连接。
3. 检查项目的运行要求
部署前先看一遍 package.json:确认项目需要的 Node.js 版本、启动命令、构建脚本和依赖管理工具。还要弄清楚服务监听哪个端口、需要哪些环境变量,以及是否依赖数据库或本地文件。数据库密码、访问密钥等敏感信息不要提交到代码仓库,正式环境应通过环境变量或安全的配置管理方式提供。
二、连接服务器并安装运行环境
在本地终端通过 SSH 登录 ECS,把示例中的地址替换为实例公网 IP:
ssh 用户名@服务器公网IP
首次连接时,终端会提示确认服务器指纹。确认连接目标无误后再继续。登录服务器后更新系统软件包,并安装 Git、Node.js 等项目所需工具。Node.js 可以通过系统软件源、NodeSource 或适合服务器环境的版本管理工具安装;具体选哪种方式,应以项目的版本要求和服务器维护习惯为准。
安装完成后检查版本:
node -vnpm -v
生产环境尽量使用项目明确支持的 Node.js 长期支持版本,并让开发、测试和生产环境的版本保持一致。项目有原生依赖或构建步骤时,还要确认系统中具备所需的编译工具;否则依赖安装可能在服务器上报错。
三、上传代码并启动 Node 项目
常见做法是通过 Git 拉取代码。先进入准备存放项目的目录,再执行:
git clone 仓库地址
进入项目目录后,根据仓库中的锁定文件安装依赖。如果使用 npm 且项目提供 package-lock.json,生产部署通常可以运行:
npm ci
它会按锁定文件安装依赖,适合需要保持安装版本一致的场景。没有相应锁定文件时,再按项目约定使用 npm install。如果项目需要打包或编译,执行对应的构建脚本,并确认生成的文件确实位于启动命令会读取的位置。
接着设置生产环境变量和服务端口,再按项目配置启动命令。例如,package.json 中可能定义了 npm start。使用 Nginx 反向代理时,应用通常监听本机的 127.0.0.1:3000,由 Nginx 接收公网请求后转发过来。启动后检查输出信息,确认没有端口占用、数据库连接失败或配置缺失等问题。
如果要临时排查,可以先在服务器本机请求应用端口,确认服务是否正常响应。此时先别急着开放应用端口到公网;把应用本身、反向代理和外网访问分开验证,出错时更容易定位。
四、用 PM2 管理服务进程
在 SSH 窗口里直接运行 Node 程序,断开连接后进程可能停止。生产环境可以使用 PM2 管理进程,让服务在后台运行,并查看状态和日志。安装命令为:
npm install -g pm2
如果项目通过 npm start 启动,可以这样运行:
pm2 start npm --name my-node-app -- start
查看运行状态和应用日志:
pm2 statuspm2 logs my-node-app
确认服务正常后,再按 PM2 的提示配置开机自启并保存当前进程列表。PM2 会根据系统环境给出相应命令;执行时使用有权限的账户,并检查重启服务器后服务是否仍能正常启动。不要只凭命令执行成功就认定配置完成。
五、通过 Nginx 和域名对外提供服务
需要通过域名访问时,可以让 Nginx 接收公网请求,再把请求转发给本机 Node 服务。反向代理配置要对应实际的站点域名、监听端口和上游地址,例如转发到 127.0.0.1:3000。若应用监听端口与配置不一致,Nginx 可能无法连接到后端。
改完配置后先检查语法,再重新加载 Nginx,避免配置错误影响现有服务。随后在阿里云 DNS 控制台把域名解析到 ECS 公网 IP,并确认安全组开放了实际使用的 80、443 端口。启用 HTTPS 时,需要配置有效的 TLS 证书;如果希望访问统一使用 HTTPS,还要检查 HTTP 到 HTTPS 的跳转是否符合预期。
六、案例:部署一个 Express 服务
假设项目名为 order-api,Express 应用监听本机 3000 端口,域名是 api.example.com。部署时先在 ECS 安装项目支持的 Node.js 版本,再拉取代码、安装依赖并完成构建。生产环境和数据库连接信息通过环境变量提供,然后用 PM2 启动项目的 npm start 命令。最后配置 Nginx,将 api.example.com 的请求转发到 127.0.0.1:3000。
上线验证按层进行:先在服务器本机访问应用端口,再从外网访问域名。如果本机请求成功、域名访问失败,重点检查 Nginx 配置、DNS 解析和安全组;如果应用本身没有启动,查看 PM2 状态和日志,并核对环境变量。分清故障发生在哪一层,比反复重启服务更容易找到原因。
七、上线后的检查与维护
- 查看日志:出现接口报错或服务异常时,结合 PM2 和 Nginx 日志检查应用输出与请求情况。
- 收紧网络访问:限制 SSH 来源范围,不要把数据库端口、调试端口或仅供本机使用的 Node 端口暴露到公网。
- 单独备份数据:代码可以重新拉取,数据库内容和用户上传文件则需要独立的备份安排。
- 按步骤更新:拉取新代码后,按项目需要安装依赖、执行构建并完成测试,再重启服务;更新前确认环境变量和数据兼容性。
- 留意资源使用:观察 CPU、内存、磁盘和网络情况。日志或上传文件持续增长时,也要检查磁盘空间。
Node 部署阿里云涉及代码运行、进程管理、网络代理和安全配置。小型项目可以按这套流程逐项验证:先确认应用能在服务器本机正常响应,再接入 Nginx 和域名,最后检查 HTTPS、日志与重启后的运行状态。把每一层分开检查,后续更新和排错都会更有依据。