Как утекает
FROM node:24.22.1-alpine
WORKDIR /app
COPY package.json package-lock.json ./
ARG NPM_TOKEN
RUN echo "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" > .npmrc \
&& npm ci --omit=dev \
&& rm .npmrc
COPY . .
CMD ["node", "server.js"]
rm .npmrc в том же RUN — файла в слое нет. Но значение ARG Docker записывает в историю образа вместе
со строкой RUN, где оно используется: docker history --no-trunc показывает NPM_TOKEN=npm_… любому,
кто скачал образ1.
С ENV NPM_TOKEN=… ещё проще: его печатает docker inspect --format '{{.Config.Env}}'.
Многоступенчатая сборка («Многоступенчатая сборка») прикрывает лишь отчасти: история стадии сборки в итоговый
образ не попадает. Но стоит собрать эту стадию отдельно, --target build, — и токен снова в образе.
Как передаём
FROM node:24.22.1-alpine
WORKDIR /app
COPY package.json package-lock.json ./
RUN --mount=type=secret,id=npmrc,target=/root/.npmrc,required=true npm ci --omit=dev
COPY . .
CMD ["node", "server.js"]
docker build --secret id=npmrc,src=$HOME/.npmrc -t app:dev .
На время одного RUN файл ~/.npmrc с машины сборки появляется в контейнере по пути /root/.npmrc —
там npm ищет настройки пользователя root. После RUN файла нет ни в слое, ни в истории образа.
В GitHub Actions то же самое — входом secrets у docker/build-push-action, а содержимое .npmrc лежит
в секретах репозитория:
- uses: docker/build-push-action@v7
with:
secrets: npmrc=${{ secrets.NPMRC }}
Через ARG оставляем то, что и так публично: версию, адрес API, id сайта в счётчике посещений — он всё равно
стоит в коде каждой страницы.
Если не работает
npm ci в сборке падает на закрытом пакете: 404 Not Found или 401 Unauthorized
- Причина
- Секрет не дошёл до
RUN: вdocker buildнет--secret, илиidв нём не совпадает сidвRUN --mount. Безrequired=trueпропавший секрет молча пропускается. - Делаем
- Одинаковый
idв обоих местах иrequired=trueвRUN --mount: тогда сборка падает сразу и с понятной ошибкой.
Токен уже собирали через ARG, и образ лежит в реестре
- Причина
- Значение записано в историю образа.
- Делаем
- Пересобираем через
--secret, старые теги удаляем из реестра, токен отзываем и выпускаем новый («Секрет в коммите» — тот же порядок).
Как проверить
Токенов npm (они начинаются с npm_) в истории образа нет:
docker history --no-trunc app:dev | grep -c 'npm_'
# 0Ещё не проверено
- BuildKit в Docker 29 пишет значение ARG в историю образа у строки RUN, где ARG используется ↑