Node.js 20 지원 종료 · 아직 쓰고 있다면 옮기는 순서

지원 종료가 뜻하는 것

Node.js 20은 2026년 4월 30일에 지원이 끝났습니다.

지원이 끝났다는 것은 새 보안 문제가 발견돼도 Node.js 프로젝트가 공식 수리 버전을 내놓지 않는다는 뜻입니다.

2026년 10월 보안 공지에서도 지원이 끝난 버전대는 지원 중인 버전대로 옮기라고 안내했습니다.

어느 버전으로 옮길까

실제 서비스에는 LTS 버전을 쓰라는 것이 Node.js 공식 사이트의 권고입니다.

Node.js 24의 지원 종료는 2028년 4월 30일, Node.js 26은 2029년 4월 30일로 잡혀 있습니다.

다음 이전까지 여유를 두고 싶다면 지원 기간이 긴 버전대를, 쓰는 라이브러리가 아직 최신 버전을 지원하지 않는다면 그보다 한 단계 앞의 LTS를 고르는 식으로 정하면 됩니다.

옮기는 순서

먼저 node -v로 서버, 개발 컴퓨터, 자동 빌드 환경, 도커 이미지마다 실제로 어떤 버전을 쓰는지 목록을 만듭니다.

다음으로 개발 환경에서 새 버전으로 바꾸고 패키지를 다시 설치한 뒤 테스트를 돌립니다.

문제가 없으면 시험 서버, 실제 서버 순서로 바꾸고, 각 단계마다 주요 기능을 확인합니다.

마지막으로 배포 설정 파일과 도커 파일에 적힌 버전 숫자도 바꿔야 다음 배포 때 옛 버전으로 돌아가지 않습니다.

자주 막히는 곳

오래된 패키지가 새 Node.js에서 설치되지 않거나 경고를 내는 경우가 있습니다. 패키지를 최신으로 올리거나 대체 패키지를 찾습니다.

버전 관리 도구를 쓰고 있다면 프로젝트 폴더의 버전 지정 파일도 함께 바꿉니다.

주의할 점

한 번에 여러 메이저 버전을 건너뛰면 바뀌는 부분이 많습니다. 시험 환경에서 충분히 확인합니다.

호스팅이나 관리형 서비스를 쓴다면 업체가 제공하는 Node.js 버전 선택 메뉴와 지원 일정을 확인합니다.

지원 종료 버전을 당장 못 옮긴다면 그 서버가 인터넷에 얼마나 노출돼 있는지라도 줄여 두는 것이 좋습니다.

자주 묻는 질문

Q. 18은 어떤가요?

18도 이미 지원이 끝난 버전대입니다. 20과 같은 방식으로 옮기면 됩니다.

Q. 유료 장기 지원을 쓰면 되지 않나요?

그런 선택지도 있지만, 결국 언젠가는 지원 버전으로 옮겨야 합니다. 옮길 계획을 함께 세우는 것이 좋습니다.

Q. 옮긴 뒤 성능이 달라지나요?

서비스마다 다릅니다. 옮기기 전후로 주요 화면의 응답 속도를 재 보면 차이를 확인할 수 있습니다.