목적별 가이드
| 하려는 일 | 가이드 |
|---|---|
| Node가 없는 환경에 처음 설치하기 | Node.js 설치·npm 확인 |
| 실행 버전과 보안 공지 비교하기 | 이 글의 경로·수정 버전 확인 |
| 업데이트 뒤 CLI 다시 확인하기 | 제미나이 CLI |
| Qwen 도구의 실행 조건 확인하기 | Qwen Code |
먼저 실제 Node 경로 찾기
문제가 있는 프로젝트를 실행하는 터미널에서 확인합니다.
node -v
node -p "process.execPath"
Get-Command node -All | Select-Object Source
서로 다른 터미널·버전 관리자·서비스가 서로 다른 Node를 사용할 수 있습니다. 버전만 기록하지 말고 경로와 어떤 작업에 쓰는지도 적어 두세요.
| 확인 대상 | 구분할 이유 |
|---|---|
| 현재 터미널의 Node | 명령 검색 경로에서 선택된 실행 파일 |
| 버전 관리자가 선택한 Node | 프로젝트·셸에 따라 다른 버전일 수 있음 |
| 이미 실행 중인 서버 | 파일을 갱신해도 기존 프로세스는 재시작이 필요할 수 있음 |
| 다른 앱에 내장된 Node | 해당 앱의 업데이트 경로로 확인해야 함 |
터미널의 node -v만으로 Electron 등 다른 앱 내부의 런타임까지 확인했다고 보지 마세요.
공식 공지의 영향·수정 버전 읽기
Node.js 공식 보안 공지는 2026년 10월 21일 보안 릴리스를 안내합니다.
| 릴리스 라인 | 해당 공지의 수정 릴리스 |
|---|---|
| 26.x | 26.12.1 |
| 24.x | 24.22.1 |
| 22.x | 22.23.4 |
이 표는 그 날짜의 공지에 대응하는 버전입니다. 앞으로 발견될 취약점까지 모두 해결했다는 보장이나, 각 라인의 최신 버전 표가 아닙니다.
공지는 여러 문제를 함께 다룹니다. 예를 들어 DNS 처리 문제인 CVE-2026-105482는 26·24·22 라인을, 전각 숫자 호스트명의 TLS 검사 문제인 CVE-2026-105483은 26·24 라인을 대상으로 설명합니다. 주 버전이 언급됐다는 이유만으로 모든 CVE의 영향 조건이 같다고 처리하지 않습니다.
확인 순서는 공지 날짜 → CVE·영향 조건 → 내 릴리스 라인 → 수정 릴리스 → 현재 최신 수정판입니다.
LTS와 지원 종료도 따로 확인
보안 수정 최소 버전, 최신 패치, LTS 여부는 서로 다른 정보입니다.
2026년 11월 1일 기준 Node 26은 10월 28일 LTS로 전환했고, 24·22도 각각의 지원 일정을 갖습니다. Node 20은 공식 일정상 지원이 종료된 상태입니다.
프로그램의 최소 요구 조건을 충족한다고 해서 해당 런타임의 보안 지원이 계속된다는 뜻은 아닙니다. 공식 지원 일정을 확인하고 프로젝트가 검증한 지원 버전을 선택하세요.
설치 방식에 맞게 업데이트
| 현재 관리 방식 | 업데이트 전에 확인할 것 |
|---|---|
| 공식 Windows 설치 프로그램 | 기존 설치 위치·CPU·선택한 지원 라인의 최신 파일 |
| 버전 관리자 | 프로젝트 지정 버전과 현재 셸에서 선택한 버전 |
| 운영체제 패키지 관리자 | 저장소가 제공하는 버전·배포판의 보안 수정 정책 |
| 앱·컨테이너에 포함된 Node | 앱·이미지 소유자의 지원·업데이트 절차 |
처음부터 최신 주 버전으로 뛰기보다 현재 프로젝트가 지원하는 라인의 수정판과 호환성을 검토합니다. 주 버전을 바꾸면 패키지·네이티브 모듈·실행 방식의 확인이 추가로 필요할 수 있습니다.
공식 설치 파일은 Node.js 다운로드에서 확인합니다. 다른 설치 방식을 쓰던 환경에 설치 프로그램을 더 얹기 전에는 중복 경로부터 점검하세요.
공식 설치 프로그램으로 관리하던 Windows PC라면 다음 순서로 진행합니다.
- 프로젝트의 요구 버전과 유지할 지원 라인을 정합니다.
- 해당 라인·CPU에 맞는 현재 공식 설치 파일을 고릅니다.
- 설치 프로그램의 갱신 안내를 따릅니다.
- 터미널과 필요한 프로세스를 다시 시작합니다.
- 아래 명령과 기존 프로젝트 검사로 바뀐 환경을 확인합니다.
버전 관리자를 쓰는 PC라면 이 설치 프로그램 절차 대신 그 관리자의 설치·선택 기능을 사용합니다. 운영 서버·앱 내장 런타임의 갱신은 해당 환경의 관리 절차로 진행해야 합니다.
재시작 후 같은 경로에서 다시 확인
업데이트 후에는 새 터미널이나 다시 시작한 프로세스에서 확인합니다.
node -v
node -p "process.execPath"
npm -v
그다음 프로젝트에 이미 있는 검사·빌드·대표 동작을 확인합니다. 업데이트 전후 버전은 바뀌었는데 실행 경로가 예상과 다르다면, 처음 확인했던 프로세스를 아직 갱신하지 못했을 수 있습니다.
가상 점검 사례
다음은 특정 PC의 검사 결과가 아닌 설명용 사례입니다.
| 상황 | 다음 확인 |
|---|---|
| 터미널은 수정판인데 서버 로그는 이전 버전 | 서버 실행 파일 경로·프로세스 재시작 여부 |
| 같은 24.x인데 보안 공지보다 이른 패치 | 공지의 영향 조건과 현재 24.x 수정판 |
| 앱에 내장된 Node가 오래됨 | 해당 앱의 업데이트·지원 안내 |
| 설치 파일만 새로 내려받음 | 실제 설치·버전 선택·재시작 후 실행 결과 |
npm 업데이트·audit와 다른 점
npm install -g npm은 npm 자체를 바꾸는 명령입니다. Node 실행 파일의 보안 수정판을 설치하는 절차와 같지 않습니다.
npm audit는 프로젝트 패키지의 알려진 취약점 정보를 확인하는 도구입니다. 이것만으로 운영체제·Node 바이너리·다른 앱의 내장 런타임까지 안전하다고 판정할 수는 없습니다.
오류를 해결하려고 패키지를 지우거나 주 버전을 일괄 변경하기 전에 어떤 구성 요소를 갱신해야 하는지부터 나누세요.
참고자료
공식 자료 확인일은 2026년 11월 1일입니다. 명령과 가상 점검 사례를 확인했으며 실제 PC·서버의 취약점 스캔, 런타임 교체, 서비스 재시작은 실행하지 않았습니다.