mhart/alpine-node

mhart/alpine-node Docker镜像文档

支持的标签和Dockerfile链接

• https://github.com/mhart/alpine-node/blob/f3e7f5517280abf1d23111a5369fa26c18cb2438/build.dockerfile
• https://github.com/mhart/alpine-node/blob/1c1333be629f3fac3dabae8259efe699b012e254/build.dockerfile
• https://github.com/mhart/alpine-node/blob/12f9e02b4f3a927d169eb4bb0fef743d42cdbfc8/build.dockerfile
• https://github.com/mhart/alpine-node/blob/039bcc88e6294b0cb26bdc350df31b2b95889dac/build.dockerfile
• https://github.com/mhart/alpine-node/blob/274a39b65de0c3f76b975eaefe61be986e62a21b/build.dockerfile
• https://github.com/mhart/alpine-node/blob/9c49a321bc4a6b35754e58adf1276081868413ab/Dockerfile
• https://github.com/mhart/alpine-node/blob/e7ed7b28fbf6a46a35251ce8a6af2864612ea932/Dockerfile
• https://github.com/mhart/alpine-node/blob/0ec81104dd118e9faf431a77062d3c41ac9d8b4a/Dockerfile
• https://github.com/mhart/alpine-node/blob/0ce3c2b23f7df6b7574dc647e82ba458437b333e/Dockerfile
• https://github.com/mhart/alpine-node/blob/f3e7f5517280abf1d23111a5369fa26c18cb2438/slim.dockerfile
• https://github.com/mhart/alpine-node/blob/1c1333be629f3fac3dabae8259efe699b012e254/slim.dockerfile
• https://github.com/mhart/alpine-node/blob/12f9e02b4f3a927d169eb4bb0fef743d42cdbfc8/slim.dockerfile
• https://github.com/mhart/alpine-node/blob/039bcc88e6294b0cb26bdc350df31b2b95889dac/slim.dockerfile
• https://github.com/mhart/alpine-node/blob/274a39b65de0c3f76b975eaefe61be986e62a21b/slim.dockerfile
• https://github.com/mhart/alpine-node/blob/62259ade969c2c324305ae7f98bce6d8f640439b/slim.dockerfile

镜像概述和主要用途

mhart/alpine-node是基于Alpine Linux构建的最小化Node.js Docker镜像，支持多个Node.js版本（v16.4.2、v14.17.3、v12.22.3、v10.24.1、v8.17.0、v6.17.1、v4.9.1、v0.12.18和v0.10.48）。所有版本使用同一仓库，但通过不同标签区分，适用于构建轻量级Node.js应用，显著减少镜像体积。

核心功能和特性

镜像类型及大小

以下为Docker报告的未压缩镜像大小（压缩后约为1/3）：

• 完整安装版（含npm和yarn）：

  • latest, 16, 16.4, 16.4.2 – 108 MB（npm 7.19.1，yarn 1.22.10）
  • 14, 14.17, 14.17.3 – 109 MB（npm 6.14.13，yarn 1.22.10）
  • 12, 12.22, 12.22.3 – 80.4 MB（npm 6.14.13，yarn 1.22.10）
  • 10, 10.24, 10.24.1 – 73.1 MB（npm 6.14.12，yarn 1.22.10）
  • 8, 8.17, 8.17.0 – 67.8 MB（npm 6.14.11，yarn 1.22.10）

• 完整安装版（仅含npm）：

  • 6, 6.17, 6.17.1 – 49 MB（npm 3.10.10）
  • 4, 4.9, 4.9.1 – 35.2 MB（npm 2.15.12）
  • 0.12, 0.12.18 – 32.4 MB（npm 2.15.12）
  • 0.10, 0.10.48 – 27.8 MB（npm 2.15.12）

• 精简版（不含npm或yarn）：

  • slim, slim-16, slim-16.4, slim-16.4.2 – 78.1 MB
  • slim-14, slim-14.17, slim-14.17.3 – 73.9 MB
  • slim-12, slim-12.22, slim-12.22.3 – 46.9 MB
  • slim-10, slim-10.24, slim-10.24.1 – 41.3 MB
  • slim-8, slim-8.17, slim-8.17.0 – 37.2 MB
  • slim-6, slim-6.17, slim-6.17.1 – 32.5 MB

使用场景和适用范围

• 构建轻量级Node.js应用，需最小化镜像体积
• 开发环境快速验证Node.js版本兼容性
• 生产环境部署需高效资源利用的Node.js服务
• 多阶段构建中分离依赖安装和应用运行环境

使用方法和配置说明

基础使用示例

console
# 检查Node.js版本
$ docker run --rm mhart/alpine-node:14 node --version
v14.17.3

$ docker run --rm mhart/alpine-node:12 node --version
v12.22.3

# 检查npm版本
$ docker run --rm mhart/alpine-node:14 npm --version
6.14.13

# 检查yarn版本
$ docker run --rm mhart/alpine-node:14 yarn --version
1.22.10

# 使用精简版镜像
$ docker run --rm mhart/alpine-node:slim-14 node --version
v14.17.3

$ docker run --rm mhart/alpine-node:slim-12 node --version
v12.22.3

自定义Node.js项目的Dockerfile示例

多阶段构建（推荐，最小化最终镜像体积）

先使用完整安装镜像安装依赖，再使用精简镜像运行应用，可减少约35MB体积。

Dockerfile
# 阶段1：安装依赖
FROM mhart/alpine-node:12
WORKDIR /app
COPY package.json package-lock.json ./

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

RUN npm ci --prod

# 阶段2：构建应用镜像（使用精简版）
FROM mhart/alpine-node:slim-12

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

WORKDIR /app
COPY --from=0 /app .  # 复制阶段1安装的依赖
COPY . .  # 复制应用代码
CMD ["node", "index.js"]

单阶段构建

直接在完整安装镜像上构建和运行应用：

Dockerfile
FROM mhart/alpine-node:12

# 建议使用`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"]

注意事项

• musl兼容性：Alpine Linux使用musl libc，可能与依赖glibc的环境存在兼容性问题。若需使用glibc编译的二进制文件，建议重新编译为musl版本。

• libc依赖错误：若出现类似error loading shared library ld-linux-x86-64.so.2的错误，可能是依赖libc导致，可尝试以下解决方法：

  Dockerfile
  RUN apk add --no-cache libc6-compat
  # 或
  RUN ln -s /lib/libc.musl-x86_64.so.1 /lib/ld-linux-x86-64.so.2
  

• .dockerignore配置：构建时建议将node_modules添加到.dockerignore，避免不必要的文件传输到Docker守护进程。