Docker构建过程中GitHub私有npm包无法安装且npm ci报E401错误

第一步：确认构建参数是否正确传递 #

Dockerfile中声明的ARG LIB_GITHUB_TOKEN需要在执行docker build时显式传参，否则变量值为空会直接导致认证失败。docker-compose运行正常是因为你大概率在docker-compose.yml中配置了build.args或者自动读取了本地环境变量，单独构建时需要添加参数：

docker build --build-arg LIB_GITHUB_TOKEN=你的GitHub访问令牌 .

注意：GitHub访问令牌需要提前开启read:packages权限，权限不足也会触发401报错

第二步：修正Dockerfile配置逻辑 #

你当前提前把NODE_ENV设为了production，和后续执行的npm install --only=development逻辑冲突，同时npm ci会严格校验package-lock.json与package.json的一致性，配置不合理也会触发认证问题。建议拆分构建与运行阶段，避免密钥残留在最终镜像中：

# 构建阶段
FROM node:14-alpine as builder
ARG LIB_GITHUB_TOKEN
WORKDIR /home/node/app
RUN chown -R node:node /home/node/app
COPY --chown=node:node package.json package-lock*.json tsconfig.json .npmrc ./
# 可选调试步骤：验证令牌是否正常传递，输出0则说明参数未传入
RUN echo $LIB_GITHUB_TOKEN | wc -c
RUN npm ci
RUN npm run build

# 运行阶段
FROM node:14-alpine as runtime
ENV NODE_ENV=production
WORKDIR /home/node/app
RUN chown -R node:node /home/node/app
COPY --from=builder --chown=node:node /home/node/app/dist ./dist
COPY --from=builder --chown=node:node /home/node/app/package.json ./
# 运行阶段仅安装生产依赖，不需要.npmrc和访问令牌
RUN npm ci --only=production
USER node
EXPOSE 8080
CMD ["node", "dist/index.js"]

第三步：修复.npmrc环境变量替换问题 #

node:14-alpine自带的npm 6.x版本对.npmrc中的环境变量替换存在兼容性缺陷，你可以在复制完配置文件后手动替换变量值，避免读取失败：

# 复制完.npmrc后添加该行
RUN sed -i "s/\${LIB_GITHUB_TOKEN}/$LIB_GITHUB_TOKEN/g" .npmrc

该操作仅在临时的构建阶段生效，不会造成密钥泄漏。

第四步：校验作用域配置 #

确认package.json中的私有包名完全匹配@github_user/包名格式，和.npmrc里配置的@github_user:registry作用域大小写完全一致，GitHub Package Registry对作用域大小写敏感。

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