Nginx Node 部署怎么使用 Docker 容器化打包并部署 Node.js 服务-Nginx-PHP中文网

核心是分层构建、网络互通与配置解耦：node.js用多阶段dockerfile构建轻量镜像（

nginx node 部署怎么使用 docker 容器化打包并部署 node.js 服务

用 Docker 容器化打包并部署 Node.js 服务，配合 Nginx 做反向代理，核心是“分层构建 + 网络互通 + 配置解耦”。不依赖宿主机环境，一次构建、随处运行。

重点不是直接运行 node app.js，而是构建轻量、可复用的镜像：

推荐使用多阶段构建：第一阶段用 node:18-alpine 安装依赖并构建，第二阶段仅复制 node_modules 和源码，基础镜像仍为 alpine，最终镜像体积通常控制在 120MB 以内
Dockerfile 中必须指定监听地址为 0.0.0.0:3000（不能写 127.0.0.1），否则容器内无法被其他容器访问
避免在容器里用 npm start 启动后端时依赖本地 .env 文件未挂载——建议把关键配置（如端口、数据库地址）通过 environment 字段或 docker-compose.yml 的 env_file 注入

Nginx 不托管前端就浪费了它的能力；它真正价值在于统一入口、路由分发和跨域屏蔽：

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

下载

静态资源（如 Vue/React 构建产物、Unity WebGL）直接放在 /usr/share/nginx/html，由 Nginx 原生服务，不走 Node
所有 /api/ 开头的请求，用 proxy_pass http://node-app:3000; 转发——注意这里写的是服务名 node-app，不是 localhost 或 IP
确保 Nginx 容器与 Node 容器在同一个自定义网络（如 fullstack-net），才能通过服务名通信；bridge 默认网络不支持服务发现

不用手动 docker run 启一堆参数，靠 YAML 文件声明依赖关系和网络策略：

在 docker-compose.yml 中定义两个 service：nginx 和 node-app，都加入同一 networks，例如 - fullstack-net
Node 服务无需暴露宿主机端口给外部（如不写 ports），只要保证 Nginx 能访问它内部端口（如 3000）即可，更安全
Nginx 服务则必须映射宿主机端口（如 "80:80" 或 "8080:80"），这是用户实际访问的入口
可加 depends_on 确保 Node 启动后再拉起 Nginx，但注意它只控制启动顺序，不等待 Node 服务就绪；需配合健康检查或启动脚本做真正就绪判断

502 Bad Gateway、404、跨域报错，90% 出在这里：

502：Nginx 找不到后端——检查 upstream 或 proxy_pass 地址是否拼错；确认 Node 容器日志里真有 Server running at http://0.0.0.0:3000，而不是卡在连接数据库等阻塞步骤
404：静态文件路径不对——Nginx 的 root 必须指向容器内路径（如 /usr/share/nginx/html），且挂载卷时宿主机路径要对应（如 ./dist:/usr/share/nginx/html）
CORS 报错：前端请求被浏览器拦截——这不是 Nginx 能解决的，得在 Node 层加 cors 中间件，或让 Nginx 在响应头中补 Access-Control-Allow-Origin: *（仅限调试，生产建议精确控制）