把Node.js项目部署到阿里云,通常要完成几件事:准备ECS服务器、安装匹配的Node.js版本、上传代码并启动服务,再配置Nginx、域名和HTTPS。本文以Ubuntu系统和Node.js后端应用为例。项目的启动方式、端口和构建命令可能不同,动手前先核对项目文档及package.json里的配置。
一、准备阿里云ECS服务器
创建ECS实例时,可以选择Ubuntu等常见Linux系统。测试项目可从较低配置开始;正式环境则要结合访问量、应用内存占用和数据库需求选择规格,避免只按代码大小估算服务器配置。实例创建后,记下公网IP,并确认已有可用的登录账号。
还要检查安全组入方向规则。SSH默认使用22端口,网站通常需要开放80端口和443端口。若Node.js服务由Nginx接收公网请求并转发到本机,应用端口一般不必直接向公网开放。只开放当前确实需要的端口,后续排查也更容易判断访问路径。
二、登录服务器并安装Node.js
在本地终端通过SSH登录服务器,把命令中的用户名和公网IP替换为实际信息:
ssh 用户名@服务器公网IP
可以用nvm管理Node.js版本,切换项目环境时会方便一些。先安装常用工具,再按照nvm官方文档提供的方式安装nvm:
sudo apt updatesudo apt install -y curl git
安装完成后,按提示重新打开终端或加载配置,再安装LTS版本并检查命令是否可用:
nvm install --ltsnvm use --ltsnode -vnpm -v
如果项目明确要求某个Node.js主版本,就安装对应版本,不要为了使用“最新版本”而忽略兼容性。特别是老项目,依赖可能无法在新版本下正常安装。上线前先在本地或测试环境运行构建和测试,能提前发现版本差异带来的问题。
三、上传代码并安装依赖
代码可以通过Git拉取,也可以用SCP等方式上传压缩包。使用Git时,进入服务器后执行:
git clone 你的项目仓库地址cd 项目目录
项目有锁文件时,正式部署优先使用npm ci,依赖版本会按锁文件安装;没有锁文件或项目另有说明时,再按项目要求使用npm install。如果项目使用TypeScript,或需要打包前端资源,还要执行相应构建命令,例如npm run build。
数据库密码、API密钥等敏感信息不要提交到公开代码仓库。可以通过环境变量或权限受限的配置文件提供给应用,同时检查这些文件不会被Nginx作为网页内容直接访问。
四、启动Node.js服务并保持运行
先查看项目的package.json,确认scripts中定义的启动命令。比如项目包含"start": "node app.js",就可以运行npm start进行测试。假设服务监听3000端口,可在服务器本机请求接口,确认应用确实有响应:
curl http://127.0.0.1:3000
测试时直接在SSH窗口运行程序即可,但生产环境不适合一直依赖这个窗口:断开连接后,服务可能停止。可用PM2托管进程:
sudo npm install -g pm2pm2 start npm --name my-node-app -- startpm2 statuspm2 logs my-node-app
PM2可查看进程状态和日志,也能在进程异常退出后尝试重启。需要开机自动启动时,执行pm2 startup,根据终端输出完成系统配置,再运行pm2 save保存当前进程列表。完成后可以重启服务器,确认服务能否自动恢复。
五、配置Nginx并绑定域名
常见做法是让Node.js监听本机端口,再由Nginx接收公网请求并转发。安装Nginx:
sudo apt install -y nginx
创建或编辑站点配置,将example.com替换成自己的域名,并把3000改成应用实际监听的端口:
server { listen 80; server_name example.com; location / { proxy_pass http://127.0.0.1:3000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; }}
先检查配置语法,通过后再重新加载Nginx,避免错误配置影响现有站点:
sudo nginx -tsudo systemctl reload nginx
然后在域名解析服务中添加A记录,指向ECS公网IP。解析生效后,用浏览器访问域名验证。如果应用使用WebSocket,还要在Nginx配置中补充相应的升级请求头;普通HTTP代理配置不能直接替代这一步。
六、配置HTTPS并检查上线状态
网站对外提供服务时建议启用HTTPS。可以申请阿里云SSL证书,并按证书说明部署到Nginx,也可以使用可信的自动化证书工具。配置完成后,检查HTTP请求是否按预期跳转到HTTPS,并确认安全组放行443端口。证书有有效期,到期前需要续期或更新,否则访问者可能看到安全警告。
上线前逐项确认域名解析是否指向正确IP、安全组是否只开放必要端口、Node.js进程是否正常、Nginx配置是否通过检查,以及关键接口和静态资源能否访问。还要确认应用日志可查,服务器重启后服务能够恢复。遇到访问异常时,可以先看pm2 logs和Nginx错误日志,再检查应用配置、监听端口及安全组规则。
订单查询接口部署示例
假设要上线一个监听3000端口的Node.js订单查询服务。先在ECS安装项目需要的Node.js版本,拉取代码并安装依赖;本机请求127.0.0.1:3000能正常返回结果后,再用PM2托管进程。接着让Nginx把api.example.com的请求转发到本机3000端口,并将域名解析到服务器公网IP。
确认外部请求可以通过域名访问后,再配置证书并从外部网络测试HTTPS接口。这个配置下,公网请求先到Nginx,再由Nginx转给Node.js,应用端口不必直接暴露给公网。更新代码时,也要按项目流程安装依赖或重新构建,并重启对应的PM2进程。
阿里云如何部署Node.js,涉及的不只是启动应用,还包括进程管理、反向代理、域名解析、HTTPS和端口控制。正式上线前先在测试环境走通这些步骤;上线后定期检查日志、更新依赖并做好数据备份,能减少故障时的排查和恢复压力。