详解nodejs之创建最小docker镜像

作者:栖木

时间:2026-10-22

浏览:566

本文详解如何基于Alpine Linux构建极简Node.js Docker镜像。通过替换基础镜像、编译安装Node源码及清理构建依赖,将镜像体积从默认的666M压缩至43.5M。内容涵盖Node.js、Yarn安装及C++插件支持,旨在降低资源消耗并提升部署效率。

文章目录

Docker运行Node.js服务的优势

利用Docker运行服务,能够获得一致的运行环境,精确控制CPU和内存等资源分配,便捷地配置端口与网络,并通过镜像仓库进行代码的管理与分发。目前,越来越多的开发者倾向于将服务部署在Docker环境中。

构建极简Node.js镜像的必要性

许多Node.js用户在Docker中直接使用了默认的node镜像,但其体积往往过大。例如node:6.10.1镜像的体积已达到666M,而实现相同功能仅需43.5M。较小的镜像体积意味着更低的资源消耗、更快的下载速度以及更小的传输带宽占用。下文将介绍如何构建极简的Node.js镜像。

基础镜像切换:从Debian到Alpine

FROM指令用于指定alpine作为基础镜像。

目前Docker中最轻量的操作系统是Alpine,其体积不足5M。Node默认镜像基于debian构建,其中debian:jessie版本体积已达123M。因此,减小镜像尺寸的首要步骤是将基础镜像从debian切换为alpine。

FROM alpine:3.5

配置Node用户与编译环境

RUN指令用于配置node用户。


adduser -D -u 1000 node

添加node用户是可选步骤。若添加该用户,可在运行容器时指定以node用户的身份来运行服务。

RUN指令用于安装Node.js的编译工具。


apk add --no-cache \
  libstdc++ \
&& apk add --no-cache --virtual .build-deps \
  binutils-gold \
  curl \
  g++ \
  gcc \
  gnupg \
  libgcc \
  linux-headers \
  make \
  python 
  1. 使用apk add --no-cache参数可以不使用本地缓存的安装包数据库,直接从远程获取安装包信息并进行安装。这样便无需通过apk update来获取安装包数据库。
  2. 使用apk add --virtual .build-deps参数可将本次安装的所有包封装为一个名为.build-deps的虚拟包。这样做的好处是可以通过apk del .build-deps一键清除这些包。

源码下载、校验与编译安装

RUN指令用于导入Node.js源码包的公钥。


for key in \
  9554F04D7259F04124DE6B476D5A82AC7E37093B \
  94AE36675C464D64BAFA68DD7434390BDBE9B9C5 \
  FD3A5288F042B6850C66B31F09FE44734EB7990E \
  71DCFD284A79C3B38668286BC97EC7A07EDE3FC1 \
  DD8F2338BAE7501E3DD5AC78C273792F7D83545D \
  B9AE9905FFD7803F25714661B63B535A4C206CA9 \
  C4F0DFFF4E8C1A8236409D08E73BC641CC11F4C8 \
  56730D5401028683275BD23C23EFEFE93C4CFFFE \
; do \
gpg --keyserver ha.pool.sks-keyservers.net --recv-keys "$key"; \
done

这些公钥将用于校验通过curl下载的Node.js源码文件。

RUN指令用于下载并校验Node.js源码文件。


curl -SLO "https://nodejs.org/dist/v$NODE_VERSION/node-v$NODE_VERSION.tar.xz" \
&& curl -SLO "https://nodejs.org/dist/v$NODE_VERSION/SHASUMS256.txt.asc" \
&& gpg --batch --decrypt --output SHASUMS256.txt SHASUMS256.txt.asc \
&& grep " node-v$NODE_VERSION.tar.xz\$" SHASUMS256.txt | sha256sum -c -

其中$NODE_VERSION: 代表Node版本,例如6.10.1。

RUN指令用于编译并安装Node.js。


tar -xf "node-v$NODE_VERSION.tar.xz" \
&& cd "node-v$NODE_VERSION" \
&& ./configure \
&& make -j$(getconf _NPROCESSORS_ONLN) \
&& make install 
  1. 如果不需要npm,可以将第三行替换为&& ./configure --without-npm。
  2. 其中$NODE_VERSION代表Node版本,例如6.10.1。

清理构建依赖与设置入口

RUN指令用于清理构建过程中产生的临时文件。


apk del .build-deps \
&& cd .. \
&& rm -Rf "node-v$NODE_VERSION" \
&& rm "node-v$NODE_VERSION.tar.xz" SHASUMS256.txt.asc SHASUMS256.txt

其中$NODE_VERSION: 代表Node版本,例如6.10.1。

CMD指令用于将镜像入口设置为node。


CMD [ "node" ]

可选步骤:Yarn安装与C++插件支持

上述步骤为创建Node.js镜像的必需操作,后续步骤可根据实际需求添加。

安装Yarn包管理器。

安装项目依赖。


apk add --no-cache --virtual .build-deps-yarn curl gnupg

导入Yarn的公钥。


for key in \
6A010C5166006599AA17F08146C2130DFD2497F5 \
; do \
 gpg --keyserver ha.pool.sks-keyservers.net --recv-keys "$key"; \
done

下载并校验Yarn文件。


 curl -fSL -o yarn.js "https://yarnpkg.com/downloads/$YARN_VERSION/yarn-legacy-$YARN_VERSION.js" \
 && curl -fSL -o yarn.js.asc "https://yarnpkg.com/downloads/$YARN_VERSION/yarn-legacy-$YARN_VERSION.js.asc" \
 && gpg --batch --verify yarn.js.asc yarn.js \
 && rm yarn.js.asc

其中$YARN_VERSION:代表Yarn版本,例如0.22。

执行安装操作。


mv yarn.js /usr/local/bin/yarn \
&& chmod +x /usr/local/bin/yarn \

清理Yarn相关的构建依赖。


apk del .build-deps-yarn

关于C++插件的支持。

若需支持C++插件,还需安装python、make和g++。


apk add --no-cache python make g++

关于headers文件。

部分C++模块在运行过程中需要下载node-headers文件。由于国内下载node-headers文件可能不稳定,建议将其集成到镜像中,否则可能会遇到包编译长时间无响应的情况。

可参考Node.js源码下载校验的步骤对headers文件进行下载和校验。

具体代码如下:

curl -SLO "https://nodejs.org/dist/v$NODE_VERSION/node-v${NODE_VERSION}-headers.tar.xz"

安装headers文件。


mkdir /root/.node-gyp
tar --strip-component 1 -xzf node-v${NODE_VERSION}-heraders.tar.xz /root/.node-gyp/$NODE_VERSION
rm -rf node-v${NODE_VERSION}-headers.tar.xz

其中$NODE_VERSION: 代表Node版本,例如6.10.1。

结论。

构建最小的Docker镜像既简单又具有重要意义。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持本站。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章