node.js项目配合nginx一键部署需按构建、传输、服务控制、配置生效四步实现：先本地打包并校验输出目录，再ssh上传至服务器，接着远程安装依赖、重启pm2进程并重载nginx，最后确保配置隔离、权限安全与回滚机制。

Node.js 项目配合 Nginx 实现一键打包与发布，核心在于分离职责：Node.js 负责后端服务（如 API），Nginx 负责反向代理、静态资源托管或负载均衡。自动化脚本要覆盖本地构建、远程传输、服务控制和配置生效四个环节，而非把所有逻辑堆在一台机器上。

明确部署模式再写脚本

先确认你的 Node.js 应用是纯后端服务，还是前后端同构（如 Nuxt/Next SSR）：

• 纯后端 API 服务：Nginx 只做反向代理，不托管静态文件。脚本重点是上传代码、安装依赖、启动/重启 Node 进程（推荐 pm2）
• 前端 + 后端混合（如 Vue/React 静态页 + Node API）：Nginx 同时托管 dist 目录（前端）并 proxy_pass 到 Node 端口（后端）。脚本需同步更新静态文件目录，并确保 Nginx 配置中 root 和 proxy_pass 指向正确路径
• SSR 应用（如 Nuxt 4、Next.js）：Node 进程直接渲染 HTML，Nginx 仅作反向代理。此时打包产物是 Node 可执行入口（如 .output/server/index.mjs），脚本需上传整个 .output 目录并重启服务

本地打包阶段：统一构建输出

确保 package.json 中有明确的构建命令，且输出路径固定（如 dist 或 .output）：

• 普通 Express/Koa 项目："build": "npm run clean && tsc" 或 "build": "cross-env NODE_ENV=production node scripts/build.js"
• Vite/React/Vue 项目："build": "vite build"，默认输出到 dist/
• Nuxt 4："build": "nuxt build"，输出到 .output/

构建完成后，脚本应校验目标目录是否存在，避免空传。例如 Bash 中可加：if [ ! -d "dist" ]; then echo "构建失败：dist 目录不存在"; exit 1; fi

Zenlink - Node SDK for ZenHeart

ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。

下载

远程部署阶段：SSH + SCP/RSYNC + 命令链

不依赖 Jenkins 或 Docker 时，Python 或 Node.js 脚本均可实现。关键动作顺序不能错：

• 通过 SSH 连接服务器，进入项目目录（如 /var/www/myapp）
• 用 SCP 或 rsync 上传本地 dist/.output 目录（建议用 rsync -avz --delete 更安全）
• 执行远程命令：安装依赖（npm ci --only=production）、重启进程（pm2 restart myapp）、重载 Nginx（sudo nginx -s reload）
• 若涉及权限变更（如 www-data 用户运行），需提前配置 sudo 免密（visudo 添加 %deploy ALL=(ALL) NOPASSWD: /usr/sbin/nginx）

注意：Nginx 重载失败不会中断已有服务，但配置语法错误会报错。建议加校验：sudo nginx -t && sudo nginx -s reload || echo "Nginx 配置异常，请检查 /etc/nginx/conf.d/myapp.conf"

安全与稳定性要点

生产环境脚本必须考虑容错和回滚能力：

• 每次部署前备份上一版 dist 或 .output（如 mv dist dist_$(date +%Y%m%d_%H%M)）
• Node 进程用 pm2 管理，设置 ecosystem.config.cjs 定义重启策略、日志路径、环境变量
• Nginx 配置单独拆出 conf.d/myapp.conf，避免直接改 nginx.conf；启用 include 机制便于隔离维护
• 敏感信息（数据库密码、API key）绝不硬编码在脚本里，改用环境变量或服务器上的 .env 文件（由脚本上传前注入）