Nginx与Node.js应分容器各司其职：Nginx专注反向代理或静态服务，Node.js仅运行API；通过多阶段构建（如node:18-alpine构建+nginx:alpine托管dist）、精简镜像、生产依赖安装、非root用户及.dockerignore优化，实现轻量高效部署。

在容器化场景中，用 Nginx 部署 Node.js 服务，核心不是把两者塞进同一个镜像，而是各司其职：Node.js 做后端 API 服务，Nginx 做反向代理或静态资源服务。轻量级的关键在于分层构建、精简依赖、避免冗余。

用多阶段构建分离职责

前端类 Node.js 应用（如 Vue/React）通常需构建为静态文件，再由 Nginx 托管。这时推荐多阶段 Dockerfile：

• 第一阶段用 node:18-alpine 安装依赖并执行 npm run build
• 第二阶段用 nginx:alpine，只复制 dist/ 目录和定制的 nginx.conf
• 最终镜像体积可压到 20–50 MB，不含 Node.js 运行时和开发工具

后端 API 服务保持最小运行时

纯 Node.js 后端（如 Express/Koa API）无需 Nginx 构建，但要确保自身轻量：

Zenlink - Node SDK for ZenHeart

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

下载

• 基础镜像选 node:18-alpine 或更小的 node:18-slim，避开完整 Debian 发行版
• RUN npm install --production 只装生产依赖，跳过 devDependencies
• 禁用 root 用户：在 Dockerfile 中加 USER node（需提前创建非 root 用户）
• 通过 .dockerignore 排除 node_modules、test/、docs/ 等非必要文件

Nginx 容器只做代理，不混装业务逻辑

当 Node.js 是后端服务时，Nginx 容器应专注反向代理，配置简洁明确：

• 自定义 nginx.conf，仅保留 upstream 指向 Node.js 容器（如 backend:3000）和 location /api/ 转发规则
• 用 docker-compose 统一编排，让 Nginx 和 Node.js 容器共属同一自定义网络，避免暴露端口到宿主机
• 不修改 Nginx 默认 HTML 或日志路径；若需定制，用 COPY 替换配置文件，而非重装软件包

ARM 设备等资源受限环境特别注意

比如树莓派部署，优先使用已预编译的 ARM 专用镜像：

• 选用 gh_mirrors/do/docker-arm 中的 nginx-arm 或 node4.x-arm 镜像，省去交叉编译开销
• 避免在容器内运行 apt-get install 或 npm install —— 这些操作应在构建阶段完成，不在运行时发生
• 对 Node.js 应用启用 --max-old-space-size=256 等内存限制参数，防止 OOM