精选优惠 · 官方会场

轻量应用服务器

新用户专享

2核2G · 200M峰值带宽 · 40G系统盘

限阿里云新用户
68元/年限阿里云新用户
立即选购

云服务器 ECS

新老同享

经济型e · 2核2G · 3M固定带宽 · 40G盘

同主体限1台 · 不可叠券
99元/年同主体限1台 · 不可叠券
立即选购

云数据库 RDS

数据库精选

托管数据库 · 弹性扩容 · 自动备份

按地域与配置选择
查看活动价按地域与配置选择
查看优惠
更多阿里云活动收起阿里云活动
11月1日—30日企业至高减 1728 元

双11满减礼包

个人至高减360元;需对应实名认证,满减门槛及适用产品以官方规则为准。

前往官方会场
AI 专场让 AI 应用轻松上云

AI 产品特惠

浏览 Token Plan、Qoder 与 AI 应用等官方活动,按实际使用需求选择。

前往官方会场
搭配更省心服务器 + 数据库

云产品组合购

查看 ECS、RDS 等组合活动,按业务规模和实际预算搭配。

前往官方会场
官方活动合集热门云产品,一站选

云小站更多特惠

继续查看服务器、数据库与存储等优惠,选择适合自己的配置。

前往官方会场

阿里云服务器npm项目部署:环境配置与上线步骤

在阿里云服务器上部署 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 版本、依赖锁文件、进程管理和网络规则逐项核对,通常比反复重装更容易定位问题。前端项目要确认构建文件由谁提供访问;后端项目则要确认进程能持续运行、日志可查,并且公网只开放必要端口。

赞 (0)
上一篇 2026年11月15日 上午7:29
下一篇 2026年11月15日 上午7:29

相关推荐

  • 云服务器应用实例怎么用?三个真实场景拆给你看

    第一次打开云服务器控制台,实例、镜像、弹性IP、安全组一起冒出来,很容易懵。拆开看,云服务器应用实例就是一台能随时开关、按需付费的虚拟计算机,被拿去跑某个具体业务。先别纠结概念,看它在真实场景里怎么干活,理解起来最快。 云服务器应用实例是什么 云服务器实例是云平台分配给你的一台虚拟主机,自带CPU、内存、硬盘和操作系统。应用实例指的是在这台主机上部署某个具体…

    2026年10月30日
  • 阿里云服务器免费申请条件和操作步骤有哪些?

    想搭建个人网站、测试程序或学习 Linux,很多人会先搜索“阿里云 服务器 免费”。试用资源能降低入门成本,但通常有资格要求、使用期限和配置范围,不等于永久免费、随时可用的云服务器。申请前先核对活动规则,也要想好试用结束后怎么处理,避免服务中断或产生预期之外的费用。 阿里云服务器免费通常指什么 大家说的“免费服务器”,一般是阿里云面向新用户或符合特定条件的用…

    云服务器 2026年11月15日
  • 阿里云服务器连接失败或性能异常,排查从哪里入手?

    遇到阿里云服务器问题,先重启实例往往是最顺手的做法,但重启只能说明服务可能暂时恢复,未必能解决故障原因。它还可能影响正在运行的业务,让进程状态、日志等现场信息难以保留。更稳妥的做法是先确认具体症状,再从网络、系统、应用和资源几个环节逐步检查。 先确认故障范围和发生时间 “打不开”“很慢”“连不上”对应的排查方向并不相同。先确认是所有用户都无法访问,还是只有某…

    云服务器 2026年11月15日
  • 阿里云服务器账务处理:费用入账与账目核对方法

    阿里云账单通常不只包含云服务器。ECS、云盘、带宽、数据库、对象存储和短信服务可能同时出现,计费方式和使用期间也不一样。做账时如果只看付款金额,容易把预付服务费一次性计入当期费用,或把云资源误当成企业购入的服务器设备。 处理阿里云服务器账务处理,先核对订单、账单明细和服务协议,弄清楚买了什么、服务覆盖哪段时间、费用由哪个部门或项目使用。之后再确定入账科目和分…

    云服务器 2026年11月15日
  • gpu云服务器网站按小时计费还是包月划算?训练和推理分开算

    不少做模型训练、视频渲染或科研计算的团队,本地显卡很快就不够用了。自己买服务器要占机房、配散热,还得有人维护。这时候找一个靠谱的gpu云服务器网站,按需租用显卡,就成了常见选择。一次性的硬件投入,变成了可以随时调整的运营成本。 训练和推理要分开算 很多人一上来就问按小时划不划算,但要先看任务是什么。训练通常是连续跑好几天的满载任务,显卡几乎一直在工作,关心的…

    2026年10月31日
返回顶部