Copy & Run

Node.js 시작하기: 프로젝트 만들기와 npm audit 점검

Node.js 버전을 확인하고 npm 프로젝트를 만든 뒤, 취약한 lodash 4.17.15를 설치해 npm audit가 무엇을 보고하는지 확인합니다. npm audit fix로 고친 뒤 다시 점검하는 순서까지 실제 출력으로 정리합니다.

실습 노트 · 2026-11-15 발행 · 5분 · 2026-11 확인

Node.js 프로젝트는 npm으로 패키지를 설치합니다. 설치한 패키지에는 알려진 취약점이 있을 수 있고, npm audit은 설치한 패키지 목록을 레지스트리의 보안 권고와 대조해 보여 줍니다. 이 글에서는 프로젝트를 만들고, 일부러 오래된 lodash를 설치한 뒤, 감사 결과를 읽고 고치는 순서를 실제 출력으로 따라갑니다.

준비물

항목 내용
Node.js v24.15.0
npm 11.12.1
실습 패키지 lodash@4.17.15 (취약 버전, 실습용)
실습 위치 빈 폴더 하나 (실제 프로젝트와 분리)
예상 소요 시간 약 10분

npm audit은 네트워크로 레지스트리에 접속해야 합니다. 결과는 실행한 날짜의 권고 목록을 기준으로 하므로, 날짜가 다르면 개수가 달라질 수 있습니다.

1. Node.js와 npm 버전 확인

설치된 버전을 먼저 확인합니다.

node --version
npm --version
v24.15.0
11.12.1

Node.js 22 이상에서는 npm이 함께 설치되므로 별도 도구를 더 설치하지 않아도 됩니다.

2. 프로젝트 만들기

빈 폴더에서 npm init -y로 package.json을 만듭니다.

npm init -y
Wrote to .../node-lab/package.json:

{
  "name": "lab",
  "version": "1.0.0",
  "main": "index.js",
  "license": "ISC",
  "type": "commonjs"
}

package.json은 의존성 목록이고, 설치 결과의 정확한 버전은 package-lock.json에 기록됩니다. 두 파일을 함께 저장소에 올리는 것이 점검의 출발점입니다.

3. 취약한 패키지 설치

lodash의 오래된 버전을 설치합니다.

npm install lodash@4.17.15

설치는 끝나지만 마지막에 취약점 경고가 나옵니다.

To address all issues, run:
  npm audit fix --force

Run `npm audit` for details.

설치가 성공했다고 해서 안전하다는 뜻은 아닙니다. 경고는 설치 뒤에 따로 확인해야 합니다.

4. npm audit 결과 읽기

감사 명령으로 취약점 목록을 봅니다.

npm audit
# npm audit report

lodash  <=4.17.23
Severity: high
Command Injection in lodash - https://github.com/advisories/GHSA-35jh-r3h4-6jhm
Prototype Pollution in lodash - https://github.com/advisories/GHSA-p6mc-m468-83gw
Regular Expression Denial of Service (ReDoS) in lodash - https://github.com/advisories/GHSA-29mw-wpgm-hmr9
lodash vulnerable to Code Injection via `_.template` imports key names - https://github.com/advisories/GHSA-r5fr-rjxr-66jc
Lodash has Prototype Pollution Vulnerability in `_.unset`, `_.omit`, and `_.pullAt` functions - https://github.com/advisories/GHSA-xxjr-mmjv-4gpg
fix available via `npm audit fix`
node_modules/lodash

1 high severity vulnerability

출력에서 읽을 항목은 네 가지입니다.

  • 영향 범위: lodash <=4.17.23은 이 버전 이하가 모두 해당한다는 뜻입니다.
  • 심각도: high는 이 프로젝트에서 우선 고칠 대상입니다.
  • 권고 번호: GHSA-로 시작하는 주소를 열면 취약한 호출 조건과 수정 버전을 확인할 수 있습니다.
  • 수정 방법: npm audit fix로 고칠 수 있다고 알려 줍니다.

5. 수정하고 다시 점검하기

npm audit fix로 취약한 버전을 올립니다. 이 명령은 같은 주 버전 안에서 바꿀 수 있는 것만 바꿉니다.

npm audit fix
changed 1 package, and audited 2 packages in 3s

found 0 vulnerabilities

설치된 버전이 실제로 바뀌었는지 npm ls로 확인합니다.

npm ls lodash
lab@1.0.0
`-- lodash@4.18.1

마지막으로 감사 명령을 한 번 더 실행합니다.

npm audit
found 0 vulnerabilities

6. 점검 항목 정리

새 Node.js 프로젝트를 점검할 때는 다음 순서로 확인합니다.

  1. package-lock.json이 저장소에 있는지 확인합니다. 없으면 설치할 때마다 버전이 달라질 수 있습니다.
  2. npm audit을 실행하고 심각도가 high와 critical인 항목부터 봅니다.
  3. npm audit fix로 해결되는지 확인하고, 해결되지 않으면 해당 패키지의 주 버전 업그레이드를 검토합니다.
  4. --force는 주 버전이 바뀔 수 있으므로 테스트를 돌린 뒤에만 씁니다.
  5. 배포 전에 npm audit --omit=dev로 실행 환경에 들어가는 패키지만 따로 확인합니다.

npm audit은 알려진 권고만 찾습니다. 직접 작성한 코드의 취약점은 찾지 못하므로, 정적 분석 도구와 함께 쓰는 것이 좋습니다.

이 글의 다음 단계

  • npm audit --audit-level 사용법: 종료 코드로 배포 막기npm audit --audit-level은 지정한 심각도 이상의 취약점이 있을 때만 종료 코드 1을 돌려줍니다. low부터 critical까지 단계별 종료 코드와 --omit=dev를 붙였을 때의 차이를 실제 실행 결과로 확인합니다. npm script와 CI 단계에 넣는 방법도 정리합니다.
  • package.json과 package-lock.json 차이: npm ci로 확인하기package.json에는 허용하는 버전 범위가, package-lock.json에는 실제로 설치된 버전과 integrity 해시가 적힙니다. 같은 프로젝트에서 npm install과 npm ci를 번갈아 실행해 두 파일의 역할과 두 명령의 차이를 실제 출력으로 확인합니다.

이 내용을 팀 교육으로 진행하고 싶으신가요?

인원, 수준, 일정에 맞춰 실습 환경까지 준비해 진행합니다. 대상과 기간을 알려 주시면 구성을 제안해 드립니다.

교육 문의하기

교육 진행 순서와 자주 묻는 질문 보기

팀이나 교육 담당자에게 이 글 제안하기

메일로 보내실 수도 있습니다: fankh111@gmail.com

같은 카테고리의 글