当前位置： 首页 > news >正文

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

news 2026/6/15 7:10:47

这篇教程适合谁？—— 你大概懂一点命令行，但从没在生产环境部署过 Node 项目
最终目标：把你的 NestJS / Express 后端安全跑在 Windows 服务器上，并且用 HTTPS 对外提供服务

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

大家好，我是码农刚子。最近我“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。

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

npm run build

检查一下编译产物：

Test-Path dist/main.js # 或者 dist/src/main.js（看你的配置）

如果返回True，说明编译成功了。

💡 实在不行，你也可以在本地编译好了，把整个dist文件夹直接上传到服务器，跳过服务器上编译这一步。

四、用 PM2 启动后端

1. 写 PM2 配置文件

在项目的根目录（比如C:\wwwroot\my-node-project）下新建一个文件，叫ecosystem.config.js，内容如下：

module.exports = { apps: [ { name: 'my-node-backend', // 给你的应用起个好认的名字 cwd: './backend', // 入口文件在哪个目录（按你实际的改） script: 'dist/main.js', // 编译后的入口文件 instances: 1, autorestart: true, watch: false, max_memory_restart: '500M', env: { NODE_ENV: 'production', PORT: 3000, }, error_file: './logs/backend-error.log', out_file: './logs/backend-out.log', log_date_format: 'YYYY-MM-DD HH:mm:ss', }, ], };

📁 别忘了先创建logs文件夹：mkdir C:\wwwroot\my-node-project\backend\logs

2. 启动应用

cd C:\wwwroot\my-node-project pm2 start ecosystem.config.js pm2 save

3. 看看到底跑起来没有

pm2 status

你应该会看到类似这样的输出：

只要status是online，就说明成了。

4. 本地测试一下接口

curl http://localhost:3000/api/health # 换成你项目里真实存在的接口

如果返回了数据（哪怕是 401 未授权也没关系，起码说明服务在跑），就恭喜你，Node 程序已经在后台欢快地工作了。

五、配置 HTTPS 反向代理（用 Caddy）

为啥要搞这个？

因为你的前端（比如部署在 Vercel）强制用了 HTTPS，而浏览器有个安全策略：HTTPS 页面不能去请求 HTTP 接口，否则会报 Mixed Content 错误。
所以你的后端也必须通过 HTTPS 对外暴露。

但是：你服务器上可能已经有 IIS 或者其他服务占用了 80 和 443 端口。
所以我们换个思路：用 Caddy 监听一个高位端口（比如 8443），手动挂上 SSL 证书，这样就不会跟 IIS 打架了。

1. 下载 Caddy

在 PowerShell 里执行：

Invoke-WebRequest -Uri "https://github.com/caddyserver/caddy/releases/download/v2.9.1/caddy_2.9.1_windows_amd64.zip" -OutFile "$env:TEMP\caddy.zip" New-Item -Path "C:\caddy" -ItemType Directory -Force Expand-Archive "$env:TEMP\caddy.zip" -DestinationPath "C:\caddy" -Force

2. 搞一张免费 SSL 证书（以阿里云为例）

  1. 登录阿里云控制台，搜索“SSL 证书”
  2. 点“免费证书” → “立即购买”（0 元）
  3. 选“DV 单域名证书”，证书绑定的域名写你的 API 域名，比如api.yourdomain.com
  4. 验证方式选 DNS（如果你的域名也在阿里云，它会自动帮你添加 TXT 记录）
  5. 签发成功后下载证书，格式选Nginx
  6. 你会得到两个文件：.pem（证书）和.key（私钥）

把这两个文件放到C:\caddy\目录下，像这样：

C:\caddy\api.yourdomain.com.pem C:\caddy\api.yourdomain.com.key

3. 配置 DNS 解析

去你的域名管理后台，加一条A 记录：

主机记录记录类型记录值
apiA你服务器的公网 IP

等几分钟让解析生效，可以用这条命令验证：

Resolve-DnsName api.yourdomain.com

应该会返回你的公网 IP。

4. 写 Caddyfile

在C:\caddy\目录下新建一个文件，就叫Caddyfile（没有扩展名），内容如下：

{ auto_https off } api.yourdomain.com:8443 { tls C:\caddy\api.yourdomain.com.pem C:\caddy\api.yourdomain.com.key reverse_proxy localhost:3000 }

⚠️ 这一行的auto_https off千万不能少，不然 Caddy 会试图去占 80 端口做自动重定向，然后就报错了。

5. 测试一下 Caddy 能不能跑

cd C:\caddy .\caddy.exe run --config Caddyfile --resume=false

如果你看到了server running并且没有报错，那就成功了。按Ctrl+C先停掉。

6. 让 Caddy 开机自启（用任务计划）

关掉刚才的 Caddy 窗口，然后以管理员身份打开 PowerShell，执行下面这一大坨命令：

$action = New-ScheduledTaskAction ` -Execute "C:\caddy\caddy.exe" ` -Argument "run --config C:\caddy\Caddyfile" ` -WorkingDirectory "C:\caddy" $trigger = New-ScheduledTaskTrigger -AtStartup $settings = New-ScheduledTaskSettingsSet ` -AllowStartIfOnBatteries ` -DontStopIfGoingOnBatteries ` -StartWhenAvailable ` -RestartCount 5 ` -RestartInterval (New-TimeSpan -Minutes 1) Register-ScheduledTask ` -TaskName "Caddy-API-Proxy" ` -Action $action ` -Trigger $trigger ` -Settings $settings ` -RunLevel Highest ` -Force Start-ScheduledTask -TaskName "Caddy-API-Proxy"

检查一下 8443 端口是不是已经在监听了：

netstat -ano | findstr :8443

应该会显示LISTENING。

7. 开放防火墙端口

netsh advfirewall firewall add rule name="Allow HTTPS 8443" dir=in action=allow protocol=TCP localport=8443

另外，如果你的云服务器还有安全组（阿里云叫安全组规则），也要去控制台添加入方向规则：允许 TCP 8443。

8. 测试 HTTPS 接口

打开浏览器，或者直接敲命令：

curl https://api.yourdomain.com:8443/api/health

如果能返回数据（哪怕是 401），就说明 HTTPS 反向代理大功告成了。

六、日常更新代码的流程

以后每次改了代码，在服务器上走这几步：

cd C:\wwwroot\my-node-project git pull cd backend npm install # 如果有新依赖就装一下 npm run build # 重新编译 pm2 restart my-node-backend pm2 logs my-node-backend # 看一眼启动日志，确认没报错

七、常见翻车现场 & 解决办法

现象可能原因怎么办
PM2 状态是errored入口文件路径不对，或者依赖没装全检查ecosystem.config.js里的script路径；手动node dist/main.js看看报什么错
curl localhost:3000没反应Node 没启动，或者端口被占netstat -ano \| findstr :3000看端口；pm2 logs看日志
Caddy 启动报 80 端口错误忘了加auto_https off检查 Caddyfile 第一行
浏览器提示“连接不安全”证书域名不匹配，或者证书过期重新申请证书，确认 Caddyfile 里的域名跟证书域名完全一样
前端调用接口报 CORS 错误后端的.env没配允许的前端域名加上CORS_ORIGIN=https://你的前端域名，然后pm2 restart
改了.env但没生效PM2 没重启，环境变量没重新读pm2 restart my-node-backend就好了

八、你成功完成了这些事

  • ✅ 装了 Node.js 和 PM2
  • ✅ 把代码弄到服务器上，装了依赖
  • ✅ 解决了 TypeScript 编译的小坑
  • ✅ 用 PM2 把 Node 进程守护起来，还能开机自启
  • ✅ 用 Caddy + 免费 SSL 证书 搞定了 HTTPS 反向代理
  • ✅ 开了防火墙端口，配置了开机启动任务

现在你的 Node.js 后端已经安安稳稳地跑在生产环境，可以通过https://api.yourdomain.com:8443对外提供服务了。

📌 最后再啰嗦几句：

  • 定期（比如每个月）登录阿里云控制台，瞅一眼 SSL 证书过期了没，快到期的重新申请替换一下
  • 每天有空就pm2 logs --lines 50看看有没有报错
  • 永远、永远不要把.env文件发给任何人，也不要传到 Git 上去

我是刚子，一个还在写 .NET 代码的程序员。祝你部署顺顺利利，永不宕机！如果觉得文章对你有用，记得点赞、收藏、转发给更多的小伙伴。

阅读原文：从零开始：在 Windows 服务器上部署 Node.js 项目（小白实战教程） - 码农刚子的开发笔记

http://www.jsqmd.com/news/1016821/

相关文章：

  • TVA 视觉智能体二次开发实战（十二）：双通信模式 Demo｜C# 与 Python 互联互通 调用 TVA 视觉智能体自定义算子完整案例
  • 虚实同频，营区运维智控全域；全域孪生，营区态势一览无余
  • DagsHub：数据科学家的GitHub，实现代码-数据-模型全链路版本控制
  • Linux generic_file_buffered_write缓冲写与pagecache
  • 2026年成都监控品牌怎么选？行业视角下的弱电工程服务商实力解析 - 优质品牌商家
  • claude code 部署方法
  • 告别玄学调参：手把手教你用ENVI Deep Learning 1.2优化遥感影像分类效果（附样本ROI绘制技巧）
  • 多维聚合实战：从SQL到Doris的OLAP数据操作心法
  • 红米Note11刷Magisk后无限重启？可能是AVB2.0和Magisk版本没搞对（附救砖思路）
  • 别再被网站识别成机器人了！用Chromedp + Go 实现‘隐身’爬虫的完整配置清单
  • 通话清晰蓝牙耳机技术选型与实测：从ENC降噪原理到旗舰方案对比（2026版）
  • Win10下Cadence OrCAD卡死？别急着重装，先试试关掉这个隐藏设置
  • 别再只记错误码了！用Python+OPC UA Client库，自动解析并处理这些状态码（附完整脚本）
  • 嵌入式通信实战：MPC8272 SPI/I2C协议与BD机制深度解析
  • TLE5012B寄存器配置避坑指南：从CRC校验失败到自动校准，我的调试笔记
  • 国民技术N32G030K8L7内部FLASH读写避坑指南：从解锁到校验的完整流程
  • 从生成式AI到智能代理：AI正在进入“第二阶段”
  • LabVIEW NIPM安装报错别慌！手把手教你定位C盘隐藏日志文件（附MSI/cURL日志开启命令）
  • 从‘矩阵求逆失败’到排查指南：盘点NumPy、PyTorch中判断矩阵可逆性的实战技巧与常见坑
  • SIT2515与MCP2515引脚兼容吗？国产替代实战中的那些‘坑’与解决方案
  • 测试用例自动生成助手-Dify API 部署到飞书
  • OpenCode可视化使用方式
  • NDB分数：量化GAN模式坍缩的无预训练评估方法
  • Rancher v2.7.5集群导入翻车实录：cattle-system卡在Terminating，我是如何一步步救回来的
  • 2026主流AI编程工具榜单：开发者实测第一梯队选型参考
  • 避坑指南：Oracle 19c DataGuard配置中那些容易踩的“雷”（归档、网络、密码文件）
  • Claude Code 完全使用指南：从入门到精通
  • SVM实操手记：小样本高维噪声数据下的鲁棒分类器
  • ENVI Deep Learning 1.2实战踩坑记：从TensorBoard白屏到模型分类效果差，我的避坑全记录
  • 别慌！MCU死机后，用Ozone和Keil这招非侵入式调试，5分钟定位HardFault