Jenkins自定义Docker镜像执行npm/node命令时权限被拒求助

核心问题 #

你的Docker镜像将Node.js通过nvm安装在root用户的/root/.nvm目录下，但Jenkins Docker插件默认以非root用户（通常是UID为1000的jenkins用户）执行容器内命令，非root用户无权访问root的家目录；同时Jenkinsfile中设置的HOME=.覆盖了容器内用户的默认HOME路径，导致nvm的初始化脚本无法找到配置目录，PATH中指向的/root/.nvm路径也对非root用户不可访问，最终触发权限拒绝错误。

方案一：直接全局安装Node.js（推荐） #

跳过nvm，直接从NodeSource仓库安装指定版本的Node.js，避免用户级环境带来的权限问题，所有用户均可全局访问node/npm：

FROM ubuntu:22.04

ENV SHELL /bin/bash

# 安装基础依赖并更新系统
RUN apt update && apt install -y nano git gnupg curl wget net-tools dpkg && \
    apt-get upgrade -y

# 安装指定版本的Node.js（18.18.2）
RUN curl -fsSL https://deb.nodesource.com/setup_18.x | bash - && \
    apt-get install -y nodejs=18.18.2-1nodesource1

# 验证安装结果
RUN node --version && npm --version

方案二：使用普通用户配置nvm（若必须保留nvm） #

创建与Jenkins默认运行用户匹配的普通用户，将nvm安装到该用户目录，确保权限兼容：

FROM ubuntu:22.04

ENV SHELL /bin/bash
ENV NODE_VERSION v18.18.2
ENV USER jenkins
ENV UID 1000

# 创建Jenkins匹配用户（UID与Jenkins默认运行用户一致）
RUN useradd -m -u $UID $USER

# 安装基础依赖并更新系统
RUN apt update && apt install -y nano git gnupg curl wget net-tools dpkg && \
    apt-get upgrade -y

# 切换到普通用户安装nvm
USER $USER
WORKDIR /home/$USER

RUN curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash && \
    . ~/.nvm/nvm.sh && \
    nvm install $NODE_VERSION && \
    nvm use $NODE_VERSION && \
    nvm alias default $NODE_VERSION

# 配置全局环境变量，确保所有用户可访问node/npm
ENV NODE_PATH /home/$USER/.nvm/versions/node/$NODE_VERSION/lib/node_modules
ENV PATH /home/$USER/.nvm/versions/node/$NODE_VERSION/bin:$PATH

调整Jenkinsfile #

移除破坏用户HOME路径的HOME=.设置，保留必要的npm缓存配置即可：

withEnv(['npm_config_cache=${env.WORKSPACE}/npm-cache']) {
    def wdi5Image = docker.build('wdi5-image', './')
    int statusCode = 99
    wdi5Image.inside {
        sh 'node --version'
        sh 'npm --version'
        statusCode = sh script:"npm run ${launchpadName}", returnStatus: true
    }
}

额外注意事项 #

• 若工作区存在权限问题，可在Dockerfile末尾添加RUN chown -R $USER:$USER /home/$USER，确保普通用户拥有完整目录权限；
• 避免随意修改容器内的HOME环境变量，这会破坏用户级工具（如nvm）的默认配置逻辑。

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