astefanutti/scratch-node

无发行版Node.js Docker镜像

多架构无发行版Node.js Docker镜像，旨在提供轻量级、安全的Node.js运行环境，适用于生产环境部署。

镜像概述与主要用途

该镜像为无发行版（distroless）设计，不包含传统Linux发行版中的冗余组件，从而显著减小镜像体积并降低***面。适用于需要最小化容器大小和提高安全性的Node.js应用场景，支持多种硬件架构，可广泛用于各类云环境和边缘设备。

核心功能与内容

• Node.js二进制文件：使用musl静态链接，支持可选的国际化（i18n）数据
• musl动态链接器：提供对原生模块的支持
• 用户配置：包含node用户的/etc/passwd条目，遵循最小权限原则

镜像标签与架构

支持多架构（amd64、arm32v6、arm32v7、arm64v8），以下为可用标签及其大小（压缩/未压缩）：

• latest, 17, 17.0, 17.0.1 – 17.7 MB / 46.2 MB
• 16, 16.9, 16.9.0 – 17.1 MB / 43.5 MB
• 15, 15.14, 15.14.0 – 16.7 MB / 42.7 MB
• 14, 14.17, 14.17.0 – 15.9 MB / 41.7 MB
• 13, 13.14, 13.14.0 – 14.8 MB / 39.0 MB
• 12, 12.22, 12.22.1 – 15.2 MB / 39.8 MB
• 10, 10.22, 10.22.0 – 13.3 MB / 34.1 MB
• 8, 8.17, 8.17.0 – 11.2 MB / 30.1 MB

镜像发布于以下仓库：

• https://hub.docker.com/r/astefanutti/scratch-node
• https://github.com/users/astefanutti/packages/container/package/scratch-node
• quay.io/astefanutti/scratch-node

使用方法

基础用法

通过多阶段构建将应用代码和依赖复制到无发行版镜像中：

dockerfile
FROM node as builder

WORKDIR /app

COPY package.json package-lock.json index.js ./

RUN npm install --prod

FROM astefanutti/scratch-node

COPY --from=builder /app /

ENTRYPOINT ["node", "index.js"]

原生模块支持

原生模块需使用musl静态编译才能加载。可通过以下示例实现：

dockerfile
FROM node:alpine as builder

RUN apk update && apk add make g++ python

WORKDIR /app

COPY package.json package-lock.json index.js ./

RUN LDFLAGS='-static-libgcc -static-libstdc++' npm install --build-from-source=<native_module>

FROM astefanutti/scratch-node

COPY --from=builder /app /

ENTRYPOINT ["node", "index.js"]

国际化支持

Node二进制文件静态链接ICU库，默认仅包含英文 locale 数据以减小体积。如需支持其他语言，可通过提供额外ICU数据实现：

dockerfile
FROM alpine as builder

RUN apk update && apk add curl

# 注意：ICU版本需与Node版本兼容！
RUN curl -Lsq -o icu4c-69_1-src.zip https://github.com/unicode-org/icu/releases/download/release-69-1/icu4c-69_1-src.zip \
    && unzip -q icu4c-69_1-src.zip

FROM astefanutti/scratch-node:17.0.1

COPY --from=builder /icu/source/data/in/icudt69l.dat /icu/

ENV NODE_ICU_DATA=/icu

更多信息请参考Node.js文档中的运行时提供ICU数据。

构建镜像

可通过以下命令构建镜像：

console
$ git clone https://github.com/astefanutti/scratch-node
$ cd scratch-node
$ docker build --build-arg version=<nodejs_version> --build-arg arch=<target_architecture> .