Docker安装Node.js遇EBADENGINE错误，求合规安装替代方案

构建基于Ubuntu 18.04的Docker镜像时，安装Node.js 16和npm遇到两个问题：

1. npm版本兼容错误：执行npm i npm@latest -g失败，npm 10要求Node.js版本≥18.17.0或≥20.5.0，但当前安装的Node.js 16.20.2不满足要求，错误日志如下：

#8 67.82 npm ERR! code EBADENGINE
#8 67.82 npm ERR! engine Unsupported engine
#8 67.82 npm ERR! engine Not compatible with your version of node/npm: npm@10.0.0
#8 67.82 npm ERR! notsup Not compatible with your version of node/npm: npm@10.0.0
#8 67.82 npm ERR! notsup Required: {"node":"^18.17.0 || >=20.5.0"}
#8 67.82 npm ERR! notsup Actual:   {"npm":"8.19.4","node":"v16.20.2"}

2. 安装脚本弃用警告：原使用的https://deb.nodesource.com/setup_16.x脚本已被弃用，官方提示需更换安装方式。

原Dockerfile中Node.js安装段：

# Install Node
RUN curl -sL https://deb.nodesource.com/setup_16.x | bash - \
    && apt-get install -y \
        nodejs \
    && npm i npm@latest -g

方法1：使用官方Node.js镜像作为基础镜像 #

这是Docker中运行Node.js项目的首选方案，官方镜像已预装好对应版本的Node.js和npm，版本匹配可靠，无需手动配置环境。
修改后的Dockerfile示例：

# 选择兼容Ubuntu 18.04的Node.js 16官方镜像（基于Debian Buster，兼容性良好）
FROM node:16-buster

ENV TMPDIR=/tmp
ENV CHROMIUM_BIN=/usr/bin/chromium-browser

# 安装项目所需的系统依赖
RUN apt-get update -y \
    && apt-get upgrade -y \
    && DEBIAN_FRONTEND=noninteractive TZ=Etc/UTC apt-get install -y \
        curl \
        software-properties-common \
        bzip2 \
        git \
        firefox \
        chromium-browser

RUN rm -rf /app/*

COPY ./code/ /app/
WORKDIR /app

RUN rm -rf node_modules \
    && rm -rf ./static/vendor

RUN npm ci --legacy-peer-deps

说明：官方镜像提供多种变体：node:<version>（完整包）、node:<version>-slim（精简版）、node:<version>-alpine（极小体积），可按需选择。若必须基于Ubuntu 18.04基础镜像，可采用以下方法。

方法2：采用Nodesource官方推荐的APT源安装方式 #

替代弃用的setup脚本，直接通过添加官方APT源安装Node.js：
修改Dockerfile中的Node安装段：

# 安装Node.js 16
RUN apt-get update && apt-get install -y gnupg
RUN mkdir -p /etc/apt/keyrings
RUN curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
RUN echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_16.x nodistro main" | tee /etc/apt/sources.list.d/nodesource.list

RUN apt-get update && apt-get install -y nodejs
# Node.js 16最高兼容npm 9，指定版本安装避免兼容问题
RUN npm i npm@9 -g

说明：Node.js 16已于2023年9月终止官方支持，若项目允许，建议升级至Node.js 18（长期支持版），此时可安装npm 10，只需将源地址改为node_18.x。

方法3：使用nvm管理Node.js版本 #

若需在同一镜像中切换多个Node.js版本，可使用nvm（Node Version Manager）：

# 安装nvm
RUN curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 配置nvm环境变量，确保容器启动时可识别
RUN echo "export NVM_DIR=\"$HOME/.nvm\"" >> ~/.bashrc \
    && echo "[ -s \"$NVM_DIR/nvm.sh\" ] && \. \"$NVM_DIR/nvm.sh\"" >> ~/.bashrc \
    && echo "[ -s \"$NVM_DIR/bash_completion\" ] && \. \"$NVM_DIR/bash_completion\"" >> ~/.bashrc

# 安装Node.js 16并设为默认版本
RUN bash -c "source ~/.bashrc && nvm install 16 && nvm alias default 16"
# 配置全局环境变量，让Docker命令可直接调用node和npm
ENV PATH="/root/.nvm/versions/node/v16.20.2/bin:$PATH"
# 安装兼容的npm版本
RUN npm i npm@9 -g

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