nginx部署node.js前后端分离项目的核心是分层处理：静态资源（dist目录）由nginx直接响应，动态api请求（如/api/）通过proxy_pass反向代理至node服务，同时配置超时、头信息、缓存及负载均衡以保障稳定高效。
用 Nginx 部署 Node.js 前后端分离项目，核心在于让 Nginx 承担“网关+静态服务+反向代理”三重角色，把 Node 从静态文件、SSL 终结、连接管理等非业务压力中解放出来，专注处理接口逻辑。高效稳定的关键不在堆配置，而在分层清晰、动静明确、转发可靠。
静态资源全由 Nginx 直接响应
前端打包后的 dist 目录（含 index.html、js、css、img 等）应完整上传至服务器指定路径，例如 /usr/share/nginx/html 或 /var/www/myapp。Nginx 不转发这些请求，而是直接读取并返回：
- 配置
root指向该目录，index index.html确保 SPA 路由兜底 - 加
try_files $uri $uri/ /index.html;支持 Vue/React 的 history 模式 - 启用
gzip on和合理缓存头（如expires 1y;for js/css），减少重复传输 - 避免让 Node.js 处理任何 .js/.css/.png 请求——它不擅长也不该干这事
动态接口严格走反向代理到 Node 服务
所有以 /api/、/v1/ 或其他约定前缀开头的请求，必须由 Nginx 转发给本地或内网运行的 Node 服务（如 http://127.0.0.1:3000）：
Zenlink - Node SDK for ZenHeart
下载
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
- 使用
location ^~ /api/ { proxy_pass http://127.0.0.1:3000/; }（末尾斜杠关键，避免路径拼接错误） - 必设
proxy_set_header Host $host;和X-Forwarded-For，确保 Node 能获取真实客户端 IP - 调大超时：如
proxy_connect_timeout 60s;、proxy_read_timeout 120s;，适配 Node 可能的长耗时操作 - 若 Node 启用了 CORS，生产环境建议关闭——Nginx 已解决跨域，CORS 头反而冗余且可能冲突
基础健壮性配置不可省略
稳定运行不是靠“能跑”，而是靠容错与可观测：
- 开启
sendfile on;和tcp_nopush on;提升静态文件传输效率 - 设置
worker_processes auto;和合理worker_connections（如 4096），匹配服务器 CPU 核数 - 启用访问日志和错误日志（
access_log /var/log/nginx/app-access.log;），但避免在高并发时写入过多 debug 级别日志 - 用
nginx -t校验配置，再nginx -s reload平滑更新，绝不直接 kill 进程
进阶：应对真实流量压力
当用户量上升，单台 Node 容易成为瓶颈，此时需扩展而非硬扛：
- Node 层可横向部署多个实例（如 pm2 cluster 模式），Nginx upstream 定义多台
server 127.0.0.1:3001; server 127.0.0.1:3002; - 前端 Nginx 自身也应集群化（如配合 Keepalived 或云 LB），避免单点故障
- 对高频只读接口（如商品列表），可在 Nginx 层加
proxy_cache缓存，减轻 Node 压力 - 限制单 IP 连接数（
limit_conn perip 10;）和请求频率，防恶意刷量
