nvitaterna/nodejs-distroless Docker 镜像 - 轩辕镜像

nodejs-distroless

**使用Canonical *构建的Distroless Node.js Docker镜像

概述

nodejs-distroless提供超精简的生产就绪型Docker镜像，用于运行Node.js应用。这些镜像基于Canonical的构建，并受Google的distroless理念启发，容器中仅包含Node.js及其必要的运行时库——无shell、无包管理器，也无不必要的操作系统文件。这显著减小了镜像大小和面，使部署更快、更安全。

核心功能与特性

• 仅支持以非root用户运行，提升安全性。
• 最小化镜像大小，实现快速部署并减少***面。
• 仅包含Node.js运行时和必需库——无shell或包管理器。
• 使用Canonical的***构建。
• 适用于生产环境中运行Node.js应用。

使用场景与适用范围

本镜像用于运行预构建的Node.js应用，推荐通过多阶段Docker构建流程使用：

• 在标准Node.js镜像中构建并打包应用（及依赖）。
• 将构建后的应用和node_modules复制到distroless镜像中运行。

使用方法

示例Dockerfile

Dockerfile
# 构建阶段
FROM node:22 AS build
WORKDIR /app
COPY . .
RUN npm ci --omit=dev

# 生产阶段
FROM nvitaterna/nodejs-distroless:22
WORKDIR /home/node/app
COPY --from=build /app /home/node/app
CMD ["index.js"]

将index.js替换为你的应用入口文件。

注意事项

• 仅存在node用户，不以root运行。无需在Dockerfile中切换用户。

为什么选择Distroless？

• 安全性：更少的软件包和非root用户意味着更少的漏洞。
• 性能：更小的镜像体积加快拉取和启动速度。
• 最佳实践：强制分离构建和运行时环境，符合现代容器化推荐标准。

限制

• 镜像内无shell或包管理器，无法在运行时调试或安装额外软件包。
• 无npm或npx，所有依赖必须在构建时安装并复制到镜像中。
• 不能以root用户或执行特权操作。
• 仅支持维护版、LTS版和当前版Node.js版本。旧版本可能可用，但不会接收基础镜像的更新。

参考资料

• 受GoogleContainerTools/distroless启发
• 使用Canonical ***构建

联系方式：
如有问题或需要支持，请在GitHub仓库提交issue。