在阿里云服务器上部署 Node.js 项目,npm 会参与依赖安装、脚本执行和项目构建。不过,命令能运行只是部署的一部分:Node.js 版本要符合项目要求,依赖安装要与锁文件一致,应用进程也要在退出 SSH 后继续运行。以下以 Ubuntu 阿里云 ECS 为例,说明从准备环境到上线检查的做法。
确认 ECS 和项目要求
先准备一台已开通公网访问的 ECS,并确认可以通过 SSH 登录。代码可以从 Git 仓库克隆,也可以用其他方式上传。部署前查看项目文档和 package.json,确认要求的 Node.js 版本,以及项目提供了哪些 scripts。不同项目的启动和构建命令并不相同,不能直接套用别的项目的命令。
登录服务器后,检查系统信息并更新软件包索引:
sudo apt update
cat /etc/os-release
安装系统软件或修改系统配置时使用 sudo;运行 npm 和管理项目文件时,尽量使用普通用户。长期用 root 启动应用,或随手用 sudo 执行 npm install,容易让项目文件归属变得混乱,之后普通用户可能无法更新或删除这些文件。
安装 Node.js 和 npm
Node.js 安装包通常会同时提供 npm。如果服务器上要部署多个项目,或项目要求的 Node.js 版本不同,可以使用 nvm 按用户管理版本。先按 nvm 项目说明完成安装,再用普通用户安装项目需要的 LTS 版本:
nvm install –lts
nvm use –lts
node -v
npm -v
如果 package.json 的 engines 字段或项目文档指定了版本,应按这个要求安装,不要只因为 LTS 更新就直接切换。安装后用 node -v 和 npm -v 确认当前终端实际调用的版本。若重新登录后出现 nvm、node 或 npm 找不到的提示,先检查当前用户的 shell 配置是否加载了 nvm;重复安装通常解决不了配置未生效的问题。
配置 npm 源并安装依赖
国内网络访问 npm 默认仓库时,依赖下载有时会比较慢。可以为当前用户配置维护正常的镜像源,并检查 npm 当前使用的地址:
npm config set registry https://registry.npmmirror.com
npm config get registry
镜像地址可能发生调整,使用前应确认可访问。若安装异常,也可以临时切回 npm 官方源进行排查:npm config set registry https://registry.npmjs.org。不要直接运行来源不明的安装脚本,也不要复制来历不清的配置链接。
进入项目目录后,先看仓库是否包含 package-lock.json。如果项目提交了这个文件,部署时通常用 npm ci:
npm ci
npm ci 会依据锁文件安装依赖,适合部署时保持依赖版本一致;它会清理已有的 node_modules,因此不要在项目目录里存放需要保留的文件。日常开发中新增或更新依赖,再使用 npm install,并按项目流程提交锁文件。依赖安装完成后,查看 package.json 的 scripts,再执行对应的构建命令,例如:
npm run build
如果构建失败,先看终端报错并核对 Node.js 版本、依赖和项目脚本。不要为了让安装通过就先删除 package-lock.json;这样可能会改变依赖版本,反而增加排查范围。
前端项目:构建后交给 Web 服务
例如,小周要在阿里云 ECS 上部署一个 Vue 项目,仓库里有 package-lock.json,package.json 中也定义了 build 脚本。他登录服务器后,先按项目要求安装 Node.js,再克隆代码到项目目录,依次运行 npm ci 和 npm run build。构建成功后,将生成的静态文件放到 Nginx 配置的站点目录,由 Nginx 对外提供网页访问。
这个流程里,npm 负责安装依赖和生成构建产物,不一定负责最终的网站服务。纯前端项目通常不适合长期通过 npm 的开发服务器直接对公网提供服务;生产环境可以由 Nginx 提供静态文件,并根据实际需要配置域名、HTTPS 和缓存。部署路径要与 Nginx 站点配置一致,否则构建成功了,访问时仍可能看到默认页面或 404。
后端项目:让进程稳定运行
如果项目包含 Node.js 后端,先在服务器本机按项目提供的启动脚本运行一次,确认应用能够启动、接口能正常响应,再配置进程管理工具,例如 PM2。这样 SSH 退出后,进程不会随终端关闭;服务器重启后的恢复方式也应按工具和项目的运行配置设置。生产环境使用正式启动脚本,并确认日志写到了可检查的位置,不要把调试模式当作长期运行方案。
应用监听地址和端口要与访问方式相符。服务只绑定 127.0.0.1 时,公网用户不能直接连到应用,但 Nginx 可以在本机通过反向代理访问它。若需要公网直接访问,则要同时核对应用监听地址、系统防火墙和阿里云安全组规则。安全组只开放实际需要的端口,网站一般优先开放 80、443;SSH 端口应尽量限制来源地址。排错时不要把所有端口都开放给公网。
上线前检查与常见问题
- 依赖下载超时:用 npm config get registry 检查当前源,再排查服务器网络和 DNS。切换镜像后仍失败时,查看具体依赖的报错,不要反复重跑安装命令。
- npm 权限报错:检查项目目录是否归当前用户所有。若之前用 sudo 安装过依赖,先处理目录权限,再用普通用户安装,避免继续扩大权限问题。
- Node.js 版本不兼容:对照项目文档、engines 字段和锁文件要求,切换到匹配版本后重新安装依赖并构建。
- 外网无法访问:先确认应用或 Nginx 进程正常,再检查监听地址、端口、防火墙、安全组和反向代理配置。按这个顺序排查,比直接开放更多端口更安全。
- 依赖和密钥安全:上线前查看依赖变更,更新依赖后先测试;数据库密码和其他密钥不要提交到公开仓库,也不要写进会下发给浏览器的前端代码。
阿里云服务器 npm 部署时,把项目要求的 Node.js 版本、依赖锁文件、进程管理和网络规则逐项核对,通常比反复重装更容易定位问题。前端项目要确认构建文件由谁提供访问;后端项目则要确认进程能持续运行、日志可查,并且公网只开放必要端口。