如何通过Docker中的Node环境在本地安装npm包及指定对应镜像

解决方法 #

你之前执行的命令缺少必填的Node镜像参数，docker run语法要求镜像名称必须放在待执行的命令之前，以下是可直接使用的操作方案：

最简可用命令 #

docker run --rm -v $(pwd):/app -w /app node:lts npm install

各参数说明：

• -v $(pwd):/app：将本地当前工作目录挂载到容器内的/app路径
• -w /app：指定容器内的默认工作目录为/app，npm install会直接读取挂载目录中的package.json文件，生成的node_modules目录也会同步写入本地目录
• node:lts：就是你需要指定的Node镜像，lts指代官方长期支持版本，你也可以替换为项目需要的对应版本，比如node:18、node:20-alpine（alpine为轻量化镜像版本，体积更小）
• 末尾的npm install为容器内要执行的实际命令

优化版命令（解决权限问题） #

如果执行基础命令后，本地生成的node_modules目录为root权限，普通用户无法修改，可以添加用户参数指定执行身份：

docker run --rm -v $(pwd):/app -w /app --user $(id -u):$(id -g) node:lts npm install

$(id -u):$(id -g)会自动读取当前本地用户的ID和用户组ID，容器内用该身份执行命令，生成的文件权限和本地用户完全匹配，不会出现权限不足的问题。

自定义调整说明 #

• 需要使用yarn或pnpm安装依赖时，直接替换末尾的命令即可，官方Node镜像已预装这两款包管理器
• 需要指定npm源时，可以直接在install后加参数，比如npm install --registry=https://registry.npmmirror.com

内容的提问来源于stack exchange，提问作者Axel