jellydn/alpine-nodejs

jellydn/alpine-nodejs Docker镜像文档

镜像概述

⚠️ 本镜像为https://github.com/mhart/alpine-node%E7%9A%84%E5%88%86%E6%94%AF%EF%BC%8C%E5%8E%9F%E9%A1%B9%E7%9B%AE%E5%B7%B2%E5%81%9C%E6%AD%A2%E5%BC%80%E5%8F%91%E3%80%82

jellydn/alpine-nodejs是基于https://alpinelinux.org/%E6%9E%84%E5%BB%BA%E7%9A%84%E6%9C%80%E5%B0%8F%E5%8C%96Node.js Docker镜像，支持多个稳定的Node.js版本，提供完整安装版（包含npm和yarn）和精简版（无npm和yarn）两种类型，旨在为Node.js应用提供轻量级的容器环境。

支持版本与镜像标签

所有版本均使用同一仓库jellydn/alpine-nodejs，通过不同标签区分。以下为可用标签及对应解压后体积（压缩后体积约为解压大小的1/3）：

完整安装版（含npm和yarn）

• 20, 20.1, 20.1.0：63.51 MB（npm 9，yarn 1.22.10）
• latest, 18, 18.16, 18.16.0：62.02 MB（npm 8，yarn 1.22.10）
• 16, 16.20, 16.20.0：55.89 MB（npm 7，yarn 1.22.10）
• 14, 14.21, 14.21.3：59.32 MB（npm 6，yarn 1.22.10）

精简版（无npm和yarn）

• slim-20, slim-20.1, slim-20.1.0：70.62 MB
• slim, slim-18, slim-18.16, slim-18.16.0：65.49 MB
• slim-16, slim-16.20, slim-16.20.0：63.04 MB
• slim-14, slim-14.21, slim-14.21.3：58.21 MB

核心功能与特性

• 轻量级：基于Alpine Linux，镜像体积远小于官方Node.js镜像
• 多版本支持：覆盖Node.js v14至v20的稳定版本
• 灵活选择：提供完整版（含包管理工具）和精简版（仅Node.js运行时）
• 多阶段构建友好：支持通过多阶段构建进一步减小应用镜像体积

使用场景

• Node.js应用的容器化部署
• 构建轻量级微服务
• CI/CD流程中的Node.js环境
• 对镜像体积有严格要求的生产环境

使用方法

基本使用示例

console
# 运行Node.js 20版本
$ docker run --rm jellydn/alpine-nodejs:20 node --version
v20.1.0

# 运行默认版本（Node.js 18）
$ docker run --rm jellydn/alpine-nodejs node --version
v18.16.0

# 运行Node.js 14版本
$ docker run --rm jellydn/alpine-nodejs:14 node --version
v14.21.3

# 运行精简版Node.js 16
$ docker run --rm jellydn/alpine-nodejs:slim-16 node --version
v16.20.0

Node.js项目Dockerfile示例

多阶段构建（推荐）

通过多阶段构建，使用完整版镜像安装依赖，再使用精简版镜像运行应用，可显著减小最终镜像体积：

Dockerfile
# 阶段1：安装依赖
FROM docker.xuanyuan.run/jellydn/alpine-nodejs:14
WORKDIR /app
COPY package.json package-lock.json ./

# 如有原生依赖，需安装额外工具
# RUN apk add --no-cache make gcc g++ python3

RUN npm ci --prod

# 阶段2：构建应用镜像
FROM docker.xuanyuan.run/jellydn/alpine-nodejs:slim-14

# 建议使用`docker run --init`运行容器，或安装tini
# RUN apk add --no-cache tini
# ENTRYPOINT ["/sbin/tini", "--"]

WORKDIR /app
COPY --from=0 /app .
COPY . .
CMD ["node", "index.js"]

单阶段构建

若不使用多阶段构建，可直接使用完整版镜像：

Dockerfile
FROM docker.xuanyuan.run/jellydn/alpine-nodejs:14

# 建议使用`docker run --init`运行容器，或安装tini
# RUN apk add --no-cache tini
# ENTRYPOINT ["/sbin/tini", "--"]

WORKDIR /app
COPY . .

# 如有原生依赖，需安装额外工具
# RUN apk add --no-cache make gcc g++ python3

RUN npm ci --prod

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

构建与发布镜像到Docker Hub

sh
# 进入对应Node.js版本目录（node14/node16/node18/node20）
cd node14
# 构建完整版镜像
sh build.sh
# 构建精简版镜像
sh build-slim.sh
# 发布镜像
sh publish.sh
# 构建工具镜像
sh build-tools.sh
# 再次发布
sh publish.sh

注意事项

Alpine Linux使用musl libc而非glibc，可能导致部分依赖glibc的二进制文件无法运行。常见问题及解决方法：

• 若出现类似error loading shared library ld-linux-x86-64.so.2的错误，说明依赖需要libc，可尝试：

  Dockerfile
  # 方法1：安装libc6-compat
  RUN apk add --no-cache libc6-compat
  
  # 方法2：创建符号链接
  RUN ln -s /lib/libc.musl-x86_64.so.1 /lib/ld-linux-x86-64.so.2
  

参考来源

• https://github.com/alpinelinux/aports/blob/454db196/main/nodejs/APKBUILD
• https://github.com/alpinelinux/aports/blob/454db196/main/libuv/APKBUILD
• https://hub.docker.com/r/ficusio/nodejs-base/~/dockerfile/