在 Windows 服务器上部署 Node.js 项目（小白实战教程）

先说说我为什么要搞这件事

大家好，我是码农刚子。最近我"Vibe Coding"了一个小网站，技术栈如下：

• 前端：Next.js 16 (App Router) + Tailwind CSS v4 + shadcn/ui
• 后端：NestJS (Node.js)
• 数据库：Supabase PostgreSQL

一开始我想着：全部扔到 Vercel 上不就完事了？毕竟 Vercel 对 Next.js 太友好了，一键部署，自动给 HTTPS，爽得很。

结果很快就被打脸了：Vercel 其实不适合部署 Node.js 后端 。

它虽然有 Serverless Functions，但限制一大堆（响应时间、包大小、WebSocket 支持......），我这个 NestJS 项目体积不小，还用了不少传统的 Node 库，硬塞进去就是自找麻烦。

所以只能把后端单独部署出来。正好手里有一台阿里云的 Windows Server（上面已经跑着一些 .NET 站点），而且我本人从来没在生产环境部署过 Node 项目------这是纯纯的第一次实操，踩了无数坑。

于是我把整个折腾过程记了下来，整理成这篇小白照着做就能成功 的教程。

如果你也跟我一样，想把一个真实的 Node 后端扔到自己的 Windows 云服务器上，那这篇文章就是为你写的。

---

🧰 你需要提前准备好这些东西

• 一台 Windows Server（2016 / 2019 / 2022 都行），要有管理员权限
• 你的后端项目代码（我用的是 NestJS，但 Express 之类的也一样）
• 一个域名（后面要配 HTTPS 用）
• 阿里云 / 腾讯云 / 其他云厂商的免费 SSL 证书（或者你知道怎么用 Let's Encrypt 也行）

---

一、装好基础环境

1. 装 Node.js

1. 打开官网：https://nodejs.org/

1. 下载 LTS 版本 （比如 22.x）的 .msi 安装包

2. 双击安装，一路点"下一步"，不要乱改安装路径 （默认装在 C:\Program Files\nodejs）

3. 装完之后，以管理员身份打开 PowerShell，敲下面两行检查一下：

   node -v # 应该显示 v22.x.x
   npm -v # 应该显示 10.x.x 或更高

2. 装 PM2（进程守护工具）

PM2 的作用就是让你的 Node 程序在后台跑着，挂了能自动重启，服务器重启了也能自己起来。

npm install -g pm2
npm install -g pm2-windows-startup
pm2-startup install

这三条命令分别是：装 PM2 → 装 Windows 开机自启插件 → 把 PM2 注册成系统服务。搞定之后，重启服务器也不用怕了。

---

二、把项目代码弄到服务器上

1. 创建目录

mkdir C:\wwwroot\my-node-project
cd C:\wwwroot\my-node-project

2. 上传或克隆代码

• 方法一（推荐）：用 Git 直接拉下来

  git clone https://github.com/你的用户名/你的仓库.git .

• 方法二：用远程桌面或者 FTP 把文件夹整个复制进去

3. 重要安全提醒：检查 .gitignore

确保你的项目根目录或 backend 目录下有一个 .gitignore 文件，里面至少包含：

node_modules/
dist/
.env
*.log

如果你的 .env 文件已经被提交到 Git 了，赶紧把它从版本控制里移除（但本地文件要保留）：

git rm --cached .env
git commit -m "remove env from git"

⚠️ .env 里存着数据库密码、JWT 密钥这些敏感信息，死活不能上传到 Git，记住了嗷。

---

三、装依赖 + 构建项目

1. 进入后端目录（如果你的前后端是分开的）

cd C:\wwwroot\my-node-project\backend   # 根据你的实际路径来

2. 装依赖

npm install

这个过程可能会花几分钟，耐心等一等。

3. 配置生产环境变量

在 backend 目录下创建 .env 文件（如果没有的话）：

New-Item -Path .env -ItemType File

然后用记事本或 VS Code 打开 .env，写上类似下面的内容（按你自己的项目来）：

PORT=3000
JWT_SECRET=一定改成一个超长的随机字符串
DATABASE_URL=你的数据库连接地址

🔐 想生成一个随机 JWT_SECRET？在 PowerShell 里直接跑这条命令：

-join ((48..57)+(65..90)+(97..122) | Get-Random -Count 64 | ForEach-Object {[char]$_})

4. 构建项目（这一步容易踩坑 ⚠️）

大部分 Node 项目（尤其是 NestJS）需要把 TypeScript 编译成 JavaScript。

通常的命令是：

npm run build

但是 ：如果你的项目用了 module: "nodenext" 这种配置，直接跑 nest build 可能会失败，导致 dist 目录是空的。

解决办法（以 NestJS 为例）：

打开 package.json，找到 "build" 脚本，把：

"build": "nest build"

改成：

"build": "tsc -p tsconfig.build.json"

如果你不是 NestJS，而是普通的 TypeScript + Node，那构建命令一般就是 tsc 或者 tsc --project tsconfig.json。

改完之后，重新跑一遍构建：