Node18-Alpine容器中安装Git仓库依赖时权限错误排查

核心问题 #

你遇到的权限拒绝问题，根源不是/root/.npm/_cacache/tmp的权限，而是node用户无法访问/root目录本身。默认情况下，Alpine容器中/root目录的权限是drwx------（仅root用户可读可写可进入），即使你给子目录/root/.npm设置了node用户的权限，node用户也无法进入/root目录，自然无法在其中创建克隆目录。

解决方案 #

1. 切换到node用户执行npm（推荐） #

Alpine镜像默认创建了node用户，直接切换到该用户运行npm，npm会自动将缓存目录放在/home/node/.npm（node用户的home目录，权限默认正确）：

# 容器内临时执行
su - node -c "npm install"

如果是在Dockerfile中配置，建议添加：

USER node
WORKDIR /home/node/app
# 后续的npm install等命令都会以node用户执行

2. 指定npm缓存目录到node有权限的路径 #

如果必须以root用户运行npm，可以手动指定缓存目录到node用户有权限的路径：

# 先创建并设置缓存目录权限
mkdir -p /home/node/.npm && chown -R node:node /home/node/.npm
# 指定缓存目录执行npm install
npm install --cache /home/node/.npm

也可以通过环境变量永久设置：

export npm_config_cache=/home/node/.npm
npm install

3. 临时开放/root目录权限（不推荐） #

如果只是临时测试，可以给/root目录添加其他用户的执行权限（允许node用户进入）：

chmod o+x /root

但这种做法会降低容器安全性，不建议在生产环境使用。

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