把 Node.js 项目放到云端,创建一台服务器只是开头。运行环境是否匹配、服务能否在断开 SSH 后继续运行、外部端口是否开放得过多,都会影响上线后的稳定性和安全性。本文以阿里云轻量应用服务器或云服务器 ECS 为例,按创建实例、部署代码到上线检查的顺序,说明常见做法。
以下步骤适用于一般的 Node.js 网站或接口服务。阿里云控制台的页面和镜像选项可能调整,具体操作以实际页面为准。文中以一个 Express 服务为例,入口文件为 app.js,应用监听 3000 端口。
一、按项目需求选择服务器配置
个人项目、开发测试环境或低流量展示站,可以先评估轻量应用服务器;如果需要更灵活地管理网络、云资源或后续扩展,则可以考虑云服务器 ECS。选购时对照项目需求查看 CPU、内存、系统盘、带宽和地域,不必一开始就购买高规格配置。
还要确认费用包含哪些资源,例如公网流量、云盘或其他附加服务。若项目依赖较多,或计划在同一台机器上运行数据库等服务,资源需求会和单独运行一个小型接口有所不同。不要只看 CPU 和内存,也要留意磁盘空间及公网带宽是否符合用途。
系统可选择 Ubuntu、Alibaba Cloud Linux 等常见 Linux 发行版。如果项目依赖特定系统库,或团队已经有固定的运维规范,优先沿用熟悉且验证过的系统环境。地域则可结合用户分布选择;目标用户主要在国内时,通常先考虑距离较近的地域,并确认域名备案及相关合规要求。
二、部署前整理 Node.js 项目
先在本地确认项目的启动命令、Node.js 版本、生产环境配置和依赖安装方式。团队使用 npm、pnpm 还是 yarn,应和项目中的锁定文件保持一致。生产服务器不建议直接安装未经验证的最新版本,版本变化可能带来依赖兼容问题。
以 Express 服务为例,应用应从环境变量读取监听端口,并提供一个简单的健康检查接口,例如 /health。部署后访问这个接口,可以确认服务是否正常响应;如果只检查首页,遇到首页缓存或静态页面正常、接口进程异常时,容易误判应用状态。
检查配置文件时,尤其要留意数据库地址、密钥和其他敏感信息。不要把这些内容提交到公开代码仓库,也不要为了省事直接写入应用代码。可以在运行环境中通过环境变量提供配置,并确认部署流程使用的是生产环境配置。
三、创建实例并做好登录设置
在阿里云控制台创建实例时,按计划选择地域、系统镜像、规格和公网带宽。实例创建完成后,优先使用 SSH 密钥对登录。若当前只能使用密码,应设置强度足够、未在其他服务重复使用的密码,并妥善保存。
登录后先更新系统软件包,再创建普通部署用户。日常发布和查看日志尽量使用普通账户,不要长期用 root 直接操作。可以顺手检查系统时间、磁盘空间和网络状态;项目需要 Git、编译工具或图像处理库等系统依赖的,也应根据项目文档提前安装。
例如,项目含有需要编译的原生模块时,部署阶段可能依赖系统编译工具。若等到应用启动报错才补装,排查时就要同时确认 Node.js 版本、模块依赖和系统库,问题往往更难定位。
四、安装 Node.js 并发布代码
Node.js 的安装方式应和项目团队的版本管理习惯一致,也可以使用系统发行版或官方渠道提供的方案。安装后运行 node -v 和 npm -v,确认实际版本符合项目要求。代码可以通过 Git 拉取、CI/CD 发布,或受控的文件传输方式放到服务器指定目录。
安装依赖时依据项目锁定文件执行生产环境所需的安装,不要把本地的 node_modules 整个复制到服务器。不同操作系统或 Node.js 版本可能导致原生模块无法运行。部署完成后,按项目已有流程执行测试,再启动服务。
如果项目使用数据库或第三方服务,先核对环境变量是否正确,尤其是生产环境地址和凭据。密钥不要写在公开仓库里;如需更新配置,也要确认变更已经进入实际运行的进程,而不是只改了服务器上的文件。
五、用进程管理工具托管服务
在终端直接运行 node app.js,SSH 会话结束后服务可能停止。生产环境应使用 PM2 或 systemd 等进程管理方式托管应用,并设置异常退出后的重启和开机启动。这样服务器重启或应用意外退出时,不必依靠人工重新登录启动。
以 PM2 为例,可以通过它管理启动命令、运行状态和日志。代码更新后,按固定发布流程重启应用,并确认进程处于正常状态。不要只看到终端没有报错就认为部署成功,应用也可能因配置缺失而启动后立即退出。
例如,发布一个预约查询接口的新版本后,先查看 PM2 进程状态和应用日志,再请求 /health。如果进程反复重启,优先检查启动命令、环境变量、依赖是否安装完整,以及端口是否被占用。盲目增加 CPU 或内存,通常解决不了这类配置问题。
六、配置安全组、域名与 HTTPS
阿里云安全组控制实例允许哪些网络请求进入。只开放业务实际需要的端口:SSH 通常使用 22,网站一般通过 80 和 443 提供访问。Node.js 的 3000 端口不宜直接向所有公网来源开放;数据库端口更不应为了临时测试而长期暴露。SSH 的来源地址也尽量限制为可信 IP。
常见部署方式是由 Nginx 接收用户的 HTTP 或 HTTPS 请求,再将请求反向代理到本机运行的 Node.js 服务。应用可以只监听本机地址,避免直接暴露 3000 端口;Nginx 则负责处理域名、证书和静态资源。配置时要检查代理目标端口与应用实际监听端口是否一致。
绑定域名后,检查 DNS 解析是否指向正确的服务器,再配置 HTTPS 证书和 HTTP 到 HTTPS 的跳转。解析生效可能需要一定时间。上线前还应确认浏览器访问时证书有效、域名匹配,且跳转没有造成循环。
七、上线检查与后续维护
发布完成后,从服务器以外的网络进行一次访问测试,避免只在本机验证成功,却遗漏安全组或 DNS 配置问题。至少检查以下几项:
- 通过域名打开网站,确认 HTTPS 证书正常,页面或接口返回符合预期。
- 请求 /health,检查应用是否能稳定响应,而不只是进程显示为运行中。
- 查看应用和 Nginx 日志,留意启动报错、请求异常以及进程反复重启。
- 从外部网络测试访问,并确认安全组没有开放不需要的端口。
上线后定期更新系统与项目依赖,关注 CPU、内存、磁盘和带宽使用情况。应用日志应设置轮转,避免文件持续增长、占满磁盘;重要数据则应按项目需要安排备份。若访问变慢,先结合监控和日志判断瓶颈,再考虑调整服务器规格、优化数据库或配置负载均衡,不要仅凭一次变慢就直接升级配置。
上线后的发布流程也要留记录
把 Node.js 项目部署到阿里云服务器后,建议记录 Node.js 版本、依赖安装方式、启动命令、环境变量名称、端口和回滚方法。记录不需要很复杂,但应让下一次更新时能按同一流程操作。出现故障时,也能更快判断问题来自代码、配置、网络规则还是系统环境。
对小型项目来说,先用合适的配置跑通一次可重复的部署,再根据实际运行情况调整资源,通常比一开始购买高规格服务器更稳妥。阿里云 Node.js 服务器能否稳定上线,取决于运行环境、进程托管、访问控制和日常检查是否都落实到位。