자동 실행 검증 A · Ubuntu 26.04 · npm 12.2.2 · esbuild 0.25.0 · Node 22.23 · 2026-11-07게시 2026-11-07최종 확인 2026-11-07읽기 5분

npm 12 install scripts blocked 해결: allowScripts로 허용하기

npm 12부터 의존성 패키지의 postinstall 같은 install script가 기본으로 막힌다. 경고 메시지의 뜻과 npm install-scripts approve로 필요한 패키지만 허용하는 방법, CI 설정을 실행 결과로 정리했다.

30초 요약

  • npm 12부터 의존성 패키지의 install script(preinstall, install, postinstall)는 기본으로 실행되지 않는다. 설치는 끝나지만 스크립트만 건너뛴다.
  • 필요한 패키지만 npm install-scripts approve <패키지>로 허용하고 npm rebuild <패키지>로 스크립트를 돌린다. 허용 목록은 package.json의 allowScripts에 버전까지 고정돼 기록된다.
  • --dangerously-allow-all-scripts로 전부 푸는 방법은 npm 12로 옮겨 가는 동안만 쓴다.

증상/목표

npm을 12로 올린 뒤 npm install을 하면 설치는 성공하는데 마지막에 이런 경고가 붙는다.

npm warn install-scripts 1 package had install scripts blocked because they are not covered by allowScripts:
npm warn install-scripts esbuild@0.25.0 (postinstall: node install.js)
npm warn install-scripts
npm warn install-scripts Run `npm install-scripts ls` to review, or `npm install-scripts approve <pkg>` to allow.

경고만 보고 넘어가면 나중에 문제가 터진다. 설치 단계에서 네이티브 모듈을 빌드하거나 바이너리를 내려받는 패키지는, 스크립트가 돌지 않았으니 실행할 때 필요한 파일이 없다. 목표는 믿을 수 있는 패키지만 골라 스크립트를 허용하는 것이다.

원인

npm 12는 공급망 공격을 막으려고 의존성의 install script를 기본으로 막는다. 악성 패키지가 postinstall에 코드를 숨겨 두면 npm install 한 번으로 그 코드가 개발자 PC나 CI에서 실행되기 때문이다.

막히는 대상은 의존성 패키지의 preinstall, install, postinstall이고, 레지스트리가 아닌 곳(git, 파일)에서 받은 패키지는 prepare도 포함된다. package.json의 allowScripts에 들어 있는 패키지만 스크립트가 돈다.

npm 12는 Node.js ^22.22.2, ^24.15.0, >=26.0.0을 요구한다. 지금 쓰는 버전은 npm -v로 확인한다.

해결 방법

1. 막힌 패키지 목록을 본다

Terminal window
npm install-scripts ls

어떤 패키지가 어떤 스크립트를 실행하려 했는지 나온다. 이 목록을 보고 실제로 스크립트가 필요한지, 믿을 수 있는 패키지인지 판단한다.

2. 필요한 패키지만 허용한다

Terminal window
npm install-scripts approve esbuild

package.json에 다음이 추가된다.

"allowScripts": {
"esbuild@0.25.0": true
}

허용은 지금 설치된 버전에 고정된다. 패키지를 올리면 새 버전은 다시 막히므로, 그때 다시 검토하고 허용한다. 버전과 상관없이 허용하려면 --no-allow-scripts-pin을 붙인다. 반대로 스크립트가 필요 없는 패키지는 npm install-scripts deny <패키지>로 막아 두면 나중에 전체 허용을 해도 풀리지 않는다.

3. 건너뛴 스크립트를 다시 실행한다

허용만 해서는 이미 설치된 패키지의 스크립트가 돌지 않는다.

Terminal window
npm rebuild esbuild

allowScripts를 커밋해 두면 이후 npm ci나 다른 사람의 npm install에서는 경고 없이 바로 스크립트가 돈다.

4. CI에서는 경고 대신 실패로 받는다

경고는 CI 로그에 묻히기 쉽다. 허용 목록에 없는 패키지가 들어오면 설치가 실패하게 하려면 .npmrc에 다음을 둔다.

strict-allow-scripts=true

이렇게 하면 의존성이 바뀌어 새 install script가 생겼을 때 PR 단계에서 바로 드러난다.

5. 전역 설치와 npx

npm install -g와 npx에는 package.json이 없어서 approve를 쓸 수 없다. 이때는 설치할 때 직접 허용한다.

Terminal window
npm install -g --allow-scripts=sharp some-cli

막힌 install script를 다루는 법

  • 할 것: npm install-scripts ls로 막힌 목록부터 본다 · 필요한 패키지만 approve로 허용한다 · allowScripts를 커밋한다 · CI는 strict-allow-scripts=true
  • 하지 말 것: 경고를 보고도 그냥 넘긴다 · --dangerously-allow-all-scripts를 상시로 켠다 · --ignore-scripts로 문제를 덮는다

확인

검증 범위: GitHub Actions 러너에서 npm 12.2.2로 실행했다. install script가 있는 패키지를 설치했을 때 스크립트가 건너뛰어지고 경고가 나는 것, npm install-scripts approve 뒤 allowScripts에 버전이 고정돼 기록되는 것, npm rebuild로 스크립트가 실행되는 것, 허용 목록이 있으면 npm ci에서 경고가 나지 않는 것을 확인했다. strict-allow-scripts와 --allow-scripts, --dangerously-allow-all-scripts의 동작은 npm 12 문서로 대조했다.

CI 실행 결과 · 17/17 단계 성공
검증 환경 5항목
OSUbuntu 26.04.1
npm12.2.2
esbuild0.25.0
Node22.23.4
실행 날짜2026-11-07
[PASS] 임시 경로의 npm이 12.2.2다
[PASS] 임시 경로에 npm 12.2.2 패키지가 있다
[PASS] npm 12.2.2의 Node 요구 범위(engines.node)를 읽었다
[진단] 러너 Node v22.23.4, npm 12.2.2 요구 범위 ^22.22.2 || ^24.15.0 || >=26.0.0: 충족
npm warn install-scripts 1 package had install scripts blocked because they are not covered by allowScripts:
npm warn install-scripts   esbuild@0.25.0 (postinstall: node install.js)
npm warn install-scripts
npm warn install-scripts Run `npm install-scripts ls` to review, or `npm install-scripts approve <pkg>` to allow.
[PASS] esbuild@0.25.0 설치는 성공한다 (종료 코드 0)
[PASS] 설치 출력에 「install scripts blocked」 경고가 있다
[PASS] 경고에 esbuild@0.25.0의 postinstall이 나온다
[PASS] postinstall이 건너뛰어졌다 (bin/esbuild가 아직 JS 실행 파일이다)
1 package has install scripts blocked because they are not covered by allowScripts:
  esbuild@0.25.0 (postinstall: node install.js)

Run `npm install-scripts approve <pkg>` to allow, or `npm install-scripts deny <pkg>` to deny.
[PASS] npm install-scripts ls에 esbuild@0.25.0이 나온다
Approved esbuild:
  added esbuild@0.25.0
[PASS] package.json의 allowScripts에 "esbuild@0.25.0": true가 기록됐다
{
  "allowScripts": {
    "esbuild@0.25.0": true
  }
}
rebuilt dependencies successfully
[PASS] npm rebuild esbuild 성공
[PASS] rebuild 뒤 postinstall이 돌았다 (bin/esbuild가 ELF 바이너리로 바뀌었다)

added 2 packages in 316ms
[PASS] node_modules를 지우고 npm ci 성공
[PASS] npm ci 출력에 install scripts blocked 경고가 없다
[PASS] npm ci에서 postinstall이 돌았다 (bin/esbuild가 ELF 바이너리다)
[PASS] allowScripts 없는 프로젝트에서 npm install 성공
[PASS] 프로젝트 자신의 postinstall이 실행됐다 (own-postinstall.txt가 생겼다)
[PASS] 프로젝트 자신의 postinstall에는 install scripts blocked 경고가 없다
이 결과는 글의 명령어를 GitHub Actions의 깨끗한 환경에서 그대로 실행해 자동으로 붙인 것입니다.

주의

  • --dangerously-allow-all-scripts는 허용 목록을 통째로 무시하고 모든 스크립트를 돌린다. npm 12로 옮겨 가는 동안 쓰라고 둔 옵션이고, npm도 쓰지 말라고 강하게 권한다. 켜 둔 채로 두면 npm 12로 올린 의미가 없다.
  • --ignore-scripts는 모든 스크립트를 끈다. 경고는 사라지지만 필요한 빌드도 같이 건너뛰니 해결책이 아니다.
  • --allow-scripts 플래그는 프로젝트 안의 npm install, ci, update, rebuild에서 쓰면 오류가 난다. 프로젝트에서는 allowScripts를 쓴다.

자주 묻는 질문

내 프로젝트의 postinstall도 막히나?

아니다. 막히는 것은 의존성 패키지의 install script다. 프로젝트 자신의 스크립트는 그대로 돈다.

npm approve-scripts와 npm install-scripts approve는 뭐가 다른가?

둘 다 allowScripts를 고친다. npm install-scripts는 approve, deny, ls, prune을 한 명령 아래에 모은 것이다.

허용했던 패키지를 지웠는데 allowScripts에 남아 있다면?

npm install-scripts prune이 더 이상 설치돼 있지 않거나 스크립트가 없는 항목을 정리한다. --dry-run으로 먼저 볼 수 있다.

참고 자료