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

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

- 주소: https://copyandrun.com/blog/nodejs-npm-project-audit-first-steps/
- 분야: DevSecOps
- 발행일: 2026-11-15
- 태그: Node.js, npm, npm audit, lodash, 의존성 점검

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 버전 확인

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

```bash
node --version
npm --version
```

```text
v24.15.0
11.12.1
```

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

## 2. 프로젝트 만들기

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

```bash
npm init -y
```

```text
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`의 오래된 버전을 설치합니다.

```bash
npm install lodash@4.17.15
```

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

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

Run `npm audit` for details.
```

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

## 4. npm audit 결과 읽기

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

```bash
npm audit
```

```text
# 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`로 취약한 버전을 올립니다. 이 명령은 같은 주 버전 안에서 바꿀 수 있는 것만 바꿉니다.

```bash
npm audit fix
```

```text
changed 1 package, and audited 2 packages in 3s

found 0 vulnerabilities
```

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

```bash
npm ls lodash
```

```text
lab@1.0.0
`-- lodash@4.18.1
```

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

```bash
npm audit
```

```text
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`은 알려진 권고만 찾습니다. 직접 작성한 코드의 취약점은 찾지 못하므로, 정적 분석 도구와 함께 쓰는 것이 좋습니다.
