Docker容器中www-data用户无法访问Node.js的问题求助

我在Dockerfile中通过nvm安装了Node.js和npm，镜像构建过程一切顺利。但进入容器终端后，使用www-data用户执行node、npm或nvm命令时，会提示找不到对应命令；而使用root等其他用户则可正常访问。

已尝试的无效方案 #

• 将文件权限修改为777、755或640
• 确认文件的用户及组归属均为www-data:www-data
• 为www-data用户添加sudo权限

当前环境信息 #

• 基础环境：nginx + debian + php8.2
• 目标Node版本：18
• 使用shell：bin/bash，已执行source /var/www/.bashrc和source /etc/bash.bashrc操作

相关Dockerfile代码段 #

RUN ls -la \
    && mkdir "/var/www/.nvm" \
    && export NVM_DIR="/var/www/.nvm" \
    && curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash \
    && [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" \
    && [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  \
    && nvm install 18 \
    && nvm use 18 && npm install -g yarn \
    && nvm use 18 \
    && nvm alias default 18

ENV NODE_PATH $NVM_DIR/v$NODE_VERSION/lib/node_modules
ENV PATH      $NVM_DIR/v$NODE_VERSION/bin:$PATH

解决方案 #

核心原因 #

1. ENV指令中使用的$NODE_VERSION变量未定义，导致PATH和NODE_PATH配置无效
2. www-data用户的shell启动脚本未加载nvm的初始化脚本，无法识别nvm/Node相关命令

具体修复步骤 #

1. 修正环境变量配置
   替换原有的ENV指令，直接使用具体的Node版本号（避免未定义变量问题）：

   ENV NODE_PATH /var/www/.nvm/v18/lib/node_modules
   ENV PATH /var/www/.nvm/v18/bin:$PATH
   

2. 让www-data自动加载nvm初始化脚本
   将nvm的初始化代码写入全局配置文件（所有用户生效）或www-data的个人bash配置：

   • 全局生效（推荐）：

     RUN echo 'export NVM_DIR="/var/www/.nvm"' > /etc/profile.d/nvm.sh \
         && echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> /etc/profile.d/nvm.sh \
         && echo '[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"' >> /etc/profile.d/nvm.sh
     

   • 仅www-data用户生效：

     RUN echo 'export NVM_DIR="/var/www/.nvm"' >> /var/www/.bashrc \
         && echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> /var/www/.bashrc \
         && echo '[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"' >> /var/www/.bashrc
     

3. 确保www-data对nvm目录的权限
   明确设置目录归属：

   RUN chown -R www-data:www-data /var/www/.nvm
   

4. 验证修复效果
   重新构建镜像后，进入容器切换到www-data用户：

   su - www-data
   node -v
   npm -v
   

   正常情况下会输出Node和npm的版本号。

优化后的完整Dockerfile片段 #

RUN mkdir "/var/www/.nvm" \
    && export NVM_DIR="/var/www/.nvm" \
    && curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash \
    && [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" \
    && [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  \
    && nvm install 18 \
    && nvm use 18 && npm install -g yarn \
    && nvm alias default 18 \
    # 设置目录权限
    && chown -R www-data:www-data /var/www/.nvm \
    # 写入全局nvm配置
    && echo 'export NVM_DIR="/var/www/.nvm"' > /etc/profile.d/nvm.sh \
    && echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> /etc/profile.d/nvm.sh \
    && echo '[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"' >> /etc/profile.d/nvm.sh

# 配置Node环境变量
ENV NODE_PATH /var/www/.nvm/v18/lib/node_modules
ENV PATH /var/www/.nvm/v18/bin:$PATH

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