Node.js 在 Windows Server 上的離線(xiàn)部署方案

離線(xiàn)部署的核心是提前準(zhǔn)備所有依賴(lài)資源（避免在線(xiàn)下載），并通過(guò)本地配置完成服務(wù)搭建，整體分為「依賴(lài)準(zhǔn)備」「環(huán)境配置」「項(xiàng)目部署」「服務(wù)注冊(cè)」4個(gè)階段。

一、提前準(zhǔn)備離線(xiàn)資源（關(guān)鍵：在有網(wǎng)機(jī)器操作）

需準(zhǔn)備 3 類(lèi)核心資源，確保無(wú)網(wǎng)環(huán)境下可完整安裝：

二、Windows Server 環(huán)境配置（無(wú)網(wǎng)機(jī)器操作）

1. 安裝 Node.js 環(huán)境

1. 將下載的 Node.js msi 包拷貝到 Windows Server，雙擊運(yùn)行安裝；
2. 安裝向?qū)е?，勾選「Add to PATH」（自動(dòng)配置環(huán)境變量，無(wú)需手動(dòng)改），其余默認(rèn)下一步；
3. 驗(yàn)證安裝：打開(kāi)「命令提示符（CMD）」，執(zhí)行以下命令，顯示版本即成功：

   node -v  # 如 v20.11.0
   npm -v   # 如 10.2.4
   

   • 若用 zip 包：解壓到指定目錄（如 D:\Node.js），手動(dòng)添加 D:\Node.js 和 D:\Node.js\node_global 到「系統(tǒng)環(huán)境變量-PATH」，再驗(yàn)證版本。

2. 配置項(xiàng)目目錄

1. 在 Windows Server 上創(chuàng)建項(xiàng)目目錄（如 D:\NodeProjects\your-app）；
2. 拷貝以下文件到該目錄：
   • 項(xiàng)目源碼（app.js/server.js 入口文件、package.json、配置文件等）；
   • 提前壓縮的 node_modules 文件夾，解壓到項(xiàng)目根目錄（與 package.json 同級(jí)）。

三、項(xiàng)目部署與測(cè)試

1. 本地啟動(dòng)測(cè)試（驗(yàn)證項(xiàng)目可運(yùn)行）

1. 打開(kāi) CMD，進(jìn)入項(xiàng)目目錄：

   cd D:\NodeProjects\your-app

2. 執(zhí)行啟動(dòng)命令（根據(jù)項(xiàng)目入口文件調(diào)整，如 app.js）：

   node app.js

3. 驗(yàn)證服務(wù)：
   • 本地驗(yàn)證：在 Server 上打開(kāi)瀏覽器，訪(fǎng)問(wèn) http://localhost:端口號(hào)（如 http://localhost:3000），若返回正常頁(yè)面/API 結(jié)果，說(shuō)明項(xiàng)目可運(yùn)行；
   • 局域網(wǎng)驗(yàn)證：在同一局域網(wǎng)機(jī)器上，訪(fǎng)問(wèn) http://Windows Server IP:端口號(hào)（如 http://192.168.1.100:3000），確保端口未被防火墻攔截（需開(kāi)放端口，見(jiàn)下文「故障排查」）。

2. 解決端口占用問(wèn)題（可選）

若啟動(dòng)時(shí)報(bào)「端口被占用」，執(zhí)行以下命令排查并釋放：

1. 查看端口占用情況（以端口 3000 為例）：

   netstat -ano | findstr ":3000"

2. 找到 PID（最后一列數(shù)字），結(jié)束對(duì)應(yīng)進(jìn)程：

   taskkill /F /PID 1234  # 1234 替換為實(shí)際 PID

四、注冊(cè) Windows 服務(wù)（實(shí)現(xiàn)后臺(tái)運(yùn)行+開(kāi)機(jī)自啟）

直接用 node app.js 啟動(dòng)后，關(guān)閉 CMD 服務(wù)會(huì)停止，需將 Node 項(xiàng)目注冊(cè)為 Windows 系統(tǒng)服務(wù)，推薦用 pm2（輕量且支持 Windows 服務(wù)）。

1. 離線(xiàn)安裝 pm2（提前在有網(wǎng)機(jī)器準(zhǔn)備）

1. 在有網(wǎng)機(jī)器上，執(zhí)行 npm install pm2 -g（全局安裝 pm2）；
2. 找到 pm2 安裝目錄（默認(rèn)路徑：C:\Users\用戶(hù)名\AppData\Roaming\npm\node_modules\pm2）；
3. 將 pm2 文件夾壓縮，拷貝到 Windows Server 的 Node 全局模塊目錄（默認(rèn)：C:\Users\用戶(hù)名\AppData\Roaming\npm\node_modules\），解壓覆蓋。

2. 用 pm2 管理 Node 服務(wù)

1. 進(jìn)入項(xiàng)目目錄，執(zhí)行啟動(dòng)命令（指定入口文件，如 app.js）：

   pm2 start app.js --name "your-app-name"  # --name 自定義服務(wù)名，方便管理

2. 驗(yàn)證 pm2 服務(wù)狀態(tài)：

   pm2 list  # 查看服務(wù)列表，狀態(tài)為 "online" 即正常

3. 注冊(cè)為 Windows 系統(tǒng)服務(wù)（開(kāi)機(jī)自啟）

1. 執(zhí)行 pm2 服務(wù)安裝命令：

   pm2-service-install  # 彈出提示，直接按 Enter 確認(rèn)（默認(rèn)服務(wù)名 PM2）

2. 驗(yàn)證系統(tǒng)服務(wù)：
   • 打開(kāi)「控制面板 → 管理工具 → 服務(wù)」；
   • 找到「PM2」服務(wù)，確認(rèn)「啟動(dòng)類(lèi)型」為「自動(dòng)」，「狀態(tài)」為「正在運(yùn)行」。

五、部署驗(yàn)證與故障排查

1. 最終驗(yàn)證

• 重啟 Windows Server，檢查「PM2」服務(wù)是否自動(dòng)啟動(dòng)；
• 訪(fǎng)問(wèn) http://Server IP:端口號(hào)，確認(rèn)項(xiàng)目正常響應(yīng)。

2. 常見(jiàn)問(wèn)題解決

總結(jié)

離線(xiàn)部署的關(guān)鍵是提前規(guī)避“在線(xiàn)依賴(lài)”：所有 Node 環(huán)境、項(xiàng)目依賴(lài)、工具（如 pm2）都需在有網(wǎng)環(huán)境打包，再拷貝到 Windows Server；通過(guò) pm2 注冊(cè)系統(tǒng)服務(wù)，確保服務(wù)穩(wěn)定運(yùn)行且開(kāi)機(jī)自啟，最后驗(yàn)證端口和依賴(lài)兼容性即可完成部署。

到此這篇關(guān)于Node.js 在 Windows Server 上的離線(xiàn)部署方案詳解的文章就介紹到這了,更多相關(guān)Node.js 離線(xiàn)部署內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論