Neo4j를 운영하다 보면 “우리가 쓰는 이 버전, 언제까지 괜찮은 걸까?” 하는 궁금증이 생기기 마련이죠. 특히 갑자기 보안 패치가 필요한데 지원이 끝난 버전이라면 정말 난감할 거예요. 오늘은 Neo4j의 버전별 지원주기를 자세히 알아보면서, 어떤 버전을 선택하면 좋을지 함께 살펴보겠습니다.
1. Neo4j가 뭐길래? – 그래프 데이터베이스의 강자
Neo4j는 2010년부터 사용되어온 그래프 데이터베이스예요. 일반적인 관계형 데이터베이스(RDBMS)와는 완전히 다른 방식으로 데이터를 다루는데요, 특히 복잡한 관계를 가진 데이터를 다룰 때 진가를 발휘합니다.
데이터를 어떻게 저장할까요? Neo4j는 노드(Nodes), 관계(Relationships), 그리고 속성(Properties)이라는 세 가지 요소로 데이터를 표현해요. 예를 들어 소셜 네트워크를 생각해보면, 사람은 ‘노드’, 친구 관계는 ‘관계’, 나이나 이름 같은 정보는 ‘속성’이 되는 거죠. 이런 구조 덕분에 “친구의 친구가 좋아하는 음악”처럼 복잡한 관계도 쉽게 찾을 수 있어요.
Cypher 쿼리 언어 Neo4j는 Cypher라는 자체 쿼리 언어를 사용합니다. SQL을 써보신 분이라면 비슷한 느낌이라고 생각하시면 돼요. 패턴 매칭 방식이라 관계를 시각적으로 표현하듯 쿼리를 작성할 수 있어서 직관적이에요.
엔터프라이즈급 안정성 ACID(Atomicity, Consistency, Isolation, Durability) 트랜잭션을 완벽하게 지원해서 금융권이나 의료 분야처럼 데이터 무결성이 중요한 곳에서도 안심하고 쓸 수 있습니다.
에디션별 차이점 Neo4j는 Community Edition(무료)과 Enterprise Edition(유료)으로 나뉘어요. 다만 한 가지 주의할 점은, 이 글에서 다루는 지원 일정은 모두 Enterprise Edition 기준이에요. Community Edition은 공식 지원이나 보안 패치가 보장되지 않기 때문에, 실제 서비스 운영 환경에서는 Enterprise Edition을 쓰는 걸 추천드려요.
Neo4j는 추천 시스템, 사기 탐지, 지식 그래프, 소셜 네트워크 분석 등 다양한 분야에서 활용되고 있어요. 최근에는 AI와 결합한 GraphRAG 같은 분야에서도 주목받고 있습니다.
2. 버전 번호가 갑자기 바뀌었다고? – CalVer 전환 이야기
2025년 1월, Neo4j는 큰 변화를 맞이했어요. 버전 번호 체계를 완전히 바꾼 거죠. 이전까지는 5.26.1 같은 방식(Semantic Versioning)을 썼는데, 이제는 2025.01.0 처럼 연도와 월을 기준으로 한 Calendar Versioning(CalVer)을 사용합니다.
왜 바꿨을까요? Neo4j가 이제 매달 새로운 기능을 담은 버전을 출시하기로 했거든요. 그러다 보니 “이게 몇 월에 나온 버전이지?”를 한눈에 알 수 있는 게 더 편한 거예요. 2025.03이면 2025년 3월 버전, 딱 보면 알 수 있죠.
버전 번호 읽는 법
- 2025.01.0: 2025년 1월 첫 번째 릴리스
- 2025.01.1: 2025년 1월 두 번째 릴리스 (보통 버그 수정)
- 5.26 LTS: 5번째 메이저 버전, 26번째 마이너 버전, LTS(장기 지원) 버전
LTS는 Long-Term Support의 약자예요. 쉽게 말해 “이 버전은 오래오래 지원할게요”라는 뜻이죠.
3. 지원 기간이 다르다고? – 18개월 vs 36개월의 비밀
Neo4j 버전마다 지원받을 수 있는 기간이 다른데요, 크게 두 가지 유형으로 나뉩니다.
일반 버전은 18개월 대부분의 Neo4j 버전은 정식 출시일로부터 18개월 동안 지원을 받아요. 예를 들어 5.23 버전이 2024년 8월에 나왔다면, 2026년 2월까지 보안 패치나 버그 수정을 받을 수 있는 거죠. 물론 그 전에 다음 버전으로 업그레이드하는 걸 권장하긴 하지만요.
LTS 버전은 36개월(3년) 각 메이저 버전의 마지막 릴리스는 LTS로 지정되는데, 이건 36개월이나 지원받을 수 있어요. Neo4j 5.26 LTS가 대표적인 예인데, 2024년 12월에 나와서 2028년 6월까지 지원됩니다. 실제로는 42개월이나 되네요!
2025.x 시리즈는 좀 특별해요 2025년부터 시작된 새 버전들은 다음 버전이 나올 때까지만 지원돼요. 그러니까 2025.01은 2025.02가 나오면 지원이 끝나는 거죠. “왜 이렇게 짧아?”라고 생각할 수 있는데, 매달 새 버전이 나오니까 항상 최신 버전을 쓰라는 의미예요.
지원 기간 동안 뭘 해주나요? 지원 기간 동안에는 보안 취약점 패치, 중요한 버그 수정, 핫픽스 같은 걸 받을 수 있어요. 다만 LTS 버전은 새로운 기능 추가는 없고, 안정성 유지에만 집중합니다.
4. 지금 쓸 수 있는 버전들 – 2025년 11월 기준
현재 Neo4j에서 공식적으로 지원하는 버전들을 살펴볼게요.
가장 최신 버전 (2025.x 시리즈)
| 버전 | 언제 나왔나요? | 지금 쓸 수 있나요? | 최신 패치 | 참고사항 |
|---|---|---|---|---|
| 2025.10 | 2025-10-30 | ✅ 네, 쓸 수 있어요 | 2025.10.1 | 지금 가장 최신 버전 |
| 2025.09 | 2025-09-29 | ❌ 지원 종료 (10월 30일) | 2025.09.0 | 다음 버전이 나와서 끝 |
| 2025.08 | 2025-08-27 | ❌ 지원 종료 (9월 29일) | 2025.08.0 | 다음 버전이 나와서 끝 |
2025.x 시리즈는 매달 새로운 기능이 추가되는 최신 버전이에요. 업데이트를 자주 할 수 있는 환경이라면 좋은 선택이죠.
장기 지원 버전 (LTS)
| 버전 | 언제 나왔나요? | 언제까지 쓸 수 있나요? | 지원 기간 | 최신 패치 | 메모 |
|---|---|---|---|---|---|
| 5.26 LTS | 2024-12-06 | 2028년 6월 | 42개월 | 5.26.15 (2025-10-30) | Neo4j 5 시리즈 완결판 |
| 4.4 LTS | 2021-12-02 | 2025년 11월 30일 | 36개월 | 4.4.46 (2025-09-30) | ⚠️ 곧 지원 종료! |
Neo4j 5.26 LTS는 지금 가장 안정적인 선택이에요. 2028년 6월까지 지원받을 수 있고, Neo4j 5 시리즈의 모든 좋은 기능들이 다 들어있어요. 벡터 검색, 병렬 처리, 새로운 스토리지 포맷 같은 것들이요.
Neo4j 4.4 LTS는 조금 심각한 상황이에요. 약 2주 후면 지원이 완전히 끝나거든요. 혹시 지금 4.4를 쓰고 계시다면, 빠르게 업그레이드 계획을 세우셔야 해요.
관련 자료: Neo4j v5 Long-Term Support and the Continued Evolution
5. Neo4j 5 버전들 상세 보기 – 2년간의 여정
Neo4j 5 시리즈는 2022년 10월부터 2024년 12월까지 약 2년 동안 나온 버전들이에요. 각 버전마다 18개월씩 지원되는데, 5.26 LTS만 예외적으로 42개월이나 지원됩니다.
| 버전 | 출시일 | 지원 상태 | 최신 패치 | 무슨 기능이 새로 나왔나요? |
|---|---|---|---|---|
| 5.26 LTS | 2024-12-06 | ✅ 2028년 6월까지 | 5.26.15 | 동적 레이블/타입/속성, 불변 역할 기능 |
| 5.25 | 2024-10-31 | ❌ 2024-12-06 끝 | 5.25.1 | 5.26 LTS가 나와서 지원 종료 |
| 5.24 | 2024-09-27 | ❌ 2024-10-31 끝 | 5.24.2 | 속성 기반 접근 제어 (PBAC) |
| 5.23 | 2024-08-22 | ❌ 2024-09-27 끝 | 5.23.0 | HTTPS 쿼리 API |
| 5.22 | 2024-07-24 | ❌ 2024-08-22 끝 | 5.22.0 | – |
| 5.21 | 2024-06-28 | ❌ 2024-07-24 끝 | 5.21.2 | 동시 트랜잭션 처리 (CICT) |
| 5.20 | 2024-05-23 | ❌ 2024-06-28 끝 | 5.20.0 | – |
| 5.19 | 2024-04-12 | ❌ 2024-05-23 끝 | 5.19.0 | – |
| 5.18 | 2024-03-13 | ❌ 2024-04-12 끝 | 5.18.1 | – |
| 5.17 | 2024-02-23 | ❌ 2024-03-13 끝 | 5.17.0 | 블록 포맷 스토리지 (차세대 저장 방식) |
| 5.16 | 2024-01-22 | ❌ 2024-02-23 끝 | 5.16.0 | – |
| 5.15 | 2023-12-15 | ❌ 2024-01-22 끝 | 5.15.0 | – |
| 5.14 | 2023-11-24 | ❌ 2023-12-15 끝 | 5.14.0 | – |
| 5.13 | 2023-10-23 | ❌ 2023-11-24 끝 | 5.13.0 | 벡터 인덱스 (AI/ML 작업용) |
| 5.12 | 2023-09-15 | ❌ 2023-10-23 끝 | 5.12.0 | – |
| 5.11 | 2023-08-14 | ❌ 2023-09-14 끝 | 5.11.0 | – |
| 5.10 | 2023-07-19 | ❌ 2023-08-15 끝 | 5.10.0 | – |
| 5.9 | 2023-06-15 | ❌ 2023-07-19 끝 | 5.9.0 | 양적 경로 패턴 (QPP) |
| 5.8 | 2023-05-16 | ❌ 2023-06-15 끝 | 5.8.0 | – |
| 5.7 | 2023-04-20 | ❌ 2023-05-16 끝 | 5.7.0 | – |
| 5.6 | 2023-03-24 | ❌ 2023-04-20 끝 | 5.6.0 | – |
| 5.5 | 2023-02-16 | ❌ 2023-03-24 끝 | 5.5.0 | – |
| 5.4 | 2023-01-26 | ❌ 2023-02-16 끝 | 5.4.0 | – |
| 5.3 | 2022-12-15 | ❌ 2023-01-26 끝 | 5.3.0 | – |
| 5.2 | 2022-11-21 | ❌ 2022-12-15 끝 | 5.2.0 | – |
| 5.1 | 2022-10-24 | ❌ 2022-11-21 끝 | 5.1.0 | – |
| 5.0 | 2022-10-21 | ❌ 2022-11-21 끝 | – | 병렬 런타임, 자율 클러스터링 등 대거 도입 |
Neo4j 5 시리즈는 정말 많은 게 바뀌었어요. 특히 5.13부터 들어간 벡터 인덱스는 요즘 뜨고 있는 GraphRAG 같은 AI 애플리케이션을 만들 때 필수적인 기능이에요.
참고 자료: endoflife.date – Neo4j
6. Neo4j 4 버전들 돌아보기 – 클러스터의 시작
Neo4j 4 시리즈는 2020년부터 2021년까지 나온 버전들이에요. 멀티 데이터베이스를 지원하기 시작한 중요한 업데이트였죠.
| 버전 | 출시일 | 지원 종료일 | 지원 기간 | 최신 패치 | 특징 |
|---|---|---|---|---|---|
| 4.4 LTS | 2021-12-02 | 2025-11-30 | 36개월 | 4.4.46 | Neo4j 4의 마지막 버전, ⚠️ 곧 끝나요 |
| 4.3 | 2021-06-17 | 2022-12-16 | 18개월 | 4.3.23 | – |
| 4.2 | 2020-11-17 | 2022-05-16 | 18개월 | 4.2.19 | – |
| 4.1 | 2020-06-23 | 2021-12-22 | 18개월 | 4.1.12 | – |
| 4.0 | 2020-01-15 | 2021-07-14 | 18개월 | 4.0.12 | 여러 데이터베이스 동시 운영 가능 |
정말 중요한 공지: Neo4j 4.4 LTS는 2025년 11월 30일이면 완전히 지원이 끝나요. 지금 4.4를 쓰고 계시다면 정말 빠르게 움직이셔야 해요. 다행히 4.4에서 5.26 LTS로 바로 업그레이드할 수 있어요.
업그레이드할 때 꼭 알아야 할 것들:
- 4.4 → 5.26 LTS → 2025.x 순서로 올려야 해요
- 스토리지 포맷을 블록 포맷으로 바꾸는 게 좋아요
- 클러스터 쓰신다면 디스커버리 서비스를 V2로 바꿔보세요
- JSON 로깅을 켜두면 나중에 편해요
참고 문서: Upgrade to a Neo4j 2025 release
7. 옛날 버전들 (3.x 이하) – 이제는 안녕
Neo4j 3.x 이하 버전들은 이미 모두 지원이 끝났어요. 혹시라도 아직 쓰고 계시다면, 보안 문제도 있고 최신 도구들과 맞지 않을 수 있어서 꼭 업그레이드하시는 게 좋아요.
| 버전 | 출시일 | 지원 종료일 | 지원 기간 | 최신 패치 | 참고 |
|---|---|---|---|---|---|
| 3.5 LTS | 2018-11-29 | 2022-05-27 | 42개월 (연장됨) | 3.5.35 | 원래 2021년 11월 끝날 예정이었어요 |
| 3.4 | 2018-05-17 | 2020-03-31 | 23개월 | 3.4.18 | – |
| 3.3 | 2017-10-24 | 2019-04-28 | 18개월 | 3.3.9 | – |
| 3.2 | 2017-05-11 | 2018-11-30 | 19개월 | 3.2.14 | – |
| 3.1 | 2016-12-13 | 2018-06-13 | 18개월 | 3.1.9 | – |
| 3.0 | 2016-04-16 | 2017-10-31 | 18개월 | 3.0.12 | Neo4j 3의 시작 |
| 2.3 | 2015-10-21 | 2017-04-21 | 18개월 | 2.3.12 | – |
| 2.2 | 2015-03-25 | 2016-09-25 | 18개월 | 2.2.10 | – |
| 2.1 | 2014-05-29 | 2015-11-29 | 18개월 | 2.1.8 | – |
| 2.0 | 2013-12-11 | 2015-06-11 | 18개월 | 2.0.5 | Neo4j 2의 시작 |
| 1.9 | 2013-05-21 | 2014-11-21 | 18개월 | 1.9.9 | – |
| 1.8 | 2012-09-28 | 2014-03-28 | 18개월 | 1.8.3 | – |
Neo4j 3.5 LTS의 특별한 이야기: 원래 2021년 11월에 끝날 예정이었는데, Neo4j가 사용자들이 4.4 LTS로 넘어갈 시간을 더 주려고 6개월 연장해줬어요. 2022년 5월까지요. 이런 배려가 참 좋죠?
8. 어떤 버전을 골라야 할까? – 상황별 추천
Neo4j 버전을 고를 때는 환경과 필요에 따라 달라져요. 몇 가지 상황별로 살펴볼게요.
새로 시작하는 프로젝트라면
추천: Neo4j 2025.x (최신 버전)
새로 시작하는 거라면 최신 버전이 좋아요. 이런 경우에 특히 잘 맞아요:
- 아직 개발 초기라 버전 업데이트가 부담 없는 경우
- AI/ML 기능(벡터 검색, GraphRAG 등)을 써보고 싶은 경우
- 쿠버네티스나 도커로 배포해서 업데이트가 쉬운 환경
- 팀에서 매달 한 번씩 업데이트할 여유가 있는 경우
안정성이 제일 중요하다면
추천: Neo4j 5.26 LTS
금융이나 의료, 제조업처럼 “절대 문제 생기면 안 돼”라는 환경이라면 5.26 LTS가 답이에요:
- 2028년 6월까지 3년 넘게 안심하고 쓸 수 있어요
- 새 기능은 안 나오지만 보안 패치와 버그 수정은 계속 받을 수 있어요
- 규제가 까다로운 산업에서도 검증된 버전을 쓸 수 있어요
- 1년에 1~2번 정도만 업데이트하면 돼요
LTS를 쓴다고 해서 구식 기능만 있는 건 아니에요. 블록 포맷 스토리지, 벡터 인덱스, 병렬 처리 같은 Neo4j 5의 좋은 기능들 다 쓸 수 있어요.
지금 Neo4j 4.4 LTS를 쓰고 있다면
해야 할 일: 바로 업그레이드 계획 세우기
4.4 LTS는 2025년 11월 30일이면 끝나요. 이렇게 해보세요:
- 11월 전까지: 5.26 LTS로 옮기기
- 옮기는 순서:
- 테스트 서버에 5.26 LTS 설치해보기
- 지금 쓰는 기능들 다 잘 돌아가는지 확인
- 데이터 백업 확실히 하기
- 조금씩 단계적으로 옮기기 (블루-그린 방식 추천)
- 그다음은: 5.26 LTS에서 안정적으로 쓰거나, 준비되면 2025.x로 넘어가기
개발이나 테스트용이라면
추천: Neo4j 2025.x (최신 버전)
개발 환경에서는 늘 최신 버전을 써보는 게 좋아요:
- 새로운 기능들 미리 써보면서 배울 수 있어요
- 나중에 실제 서비스를 업그레이드할 때 어떤 문제가 생길지 미리 알 수 있어요
- 커뮤니티의 최신 예제나 팁들을 바로 써볼 수 있어요
클라우드 서비스(AuraDB)를 쓴다면
추천: 그냥 Neo4j가 알아서 해줘요
Neo4j AuraDB를 쓰신다면 버전 걱정 안 하셔도 돼요. Neo4j가 자동으로 관리해주거든요. 다만 요금제에 따라 업데이트 방식이 다를 수 있으니 확인해보세요.
9. 업그레이드 준비하기 – 실수 없이 안전하게
버전을 올릴 때는 꼼꼼하게 준비해야 해요. 하나씩 살펴볼게요.
업그레이드 전에 꼭 해야 할 것들
1. 변경 내용 먼저 확인하기
- 새 버전에서 뭐가 바뀌었는지 릴리스 노트 읽어보기
- 앞으로 없어질 기능(Deprecated) 체크하기
- 완전히 사라진 API나 설정 찾아보기
2. 호환성 테스트
- 지금 쓰는 Neo4j 드라이버 버전 확인하기
- Cypher 쿼리들이 새 버전에서도 잘 돌아가는지 보기
- APOC, GDS 같은 플러그인 호환 버전 체크하기
3. 백업은 필수
-- 현재 버전 확인하기
CALL dbms.components() YIELD versions, edition;
-- 버전 확인했으면 백업 실행!
- 데이터베이스 전체 백업 만들기
- 백업한 걸로 복구가 잘 되는지 테스트해보기
- 문제 생겼을 때 어떻게 되돌릴지 미리 정해두기
테스트 환경에서 먼저 해보기
1. 별도 테스트 서버 준비
- 실제 운영 환경과 똑같이 테스트 환경 만들기
- 진짜 데이터 일부로 업그레이드 테스트해보기
2. 성능 확인
- 주요 쿼리들 실행 시간 재보기
- 메모리 얼마나 쓰는지 보기
- 많은 사람이 동시에 접속했을 때 어떤지 테스트
3. 기능 확인
- 모든 기능이 잘 돌아가는지 확인
- 사용자 화면에서 이상한 거 없는지 보기
- 배치 작업이나 데이터 가져오기(ETL) 잘 되는지 체크
실제로 옮기기
1. 서비스 중단 시간 줄이기
- 클러스터 쓴다면: 한 대씩 차례로 업그레이드
- 서버 하나만 쓴다면: 블루-그린 방식 고려해보기
- 데이터 옮기는 데 시간이 얼마나 걸릴지 미리 재보기
2. 잘 돌아가는지 계속 보기
- 업그레이드 후 24~48시간 정도 집중해서 모니터링
- 에러 로그 실시간으로 확인
- 성능이 예전과 비교해서 어떤지 보기
3. 문제 생기면 되돌릴 준비
- 되돌리는 방법 문서로 정리해두기
- 되돌리기 테스트도 미리 해보기
- 관련된 팀원들 연락처 정리해두기
업그레이드 후 최적화
Neo4j 5.26 LTS로 올렸다면 이것도 해보세요:
- 스토리지 포맷 바꾸기: 기존 방식보다 블록 포맷이 훨씬 빨라요
- 클러스터 디스커버리 V2: 클러스터 관리가 더 안정적이에요
- JSON 로깅: 나중에 로그 분석할 때 편해요
참고 문서: Neo4j Operations Manual
10. 궁금한 점 – FAQ
Q1. Community Edition이랑 Enterprise Edition 지원이 다른가요?
네, 많이 달라요. 이 글에서 설명한 지원 일정은 전부 Enterprise Edition 기준이에요. Community Edition은 공식 지원이나 보안 패치가 보장되지 않아요. 실제 서비스 운영하시려면 Enterprise Edition을 꼭 쓰세요.
Q2. LTS 버전도 새 기능 쓸 수 있나요?
LTS 버전은 나올 때의 기능들은 다 있어요. 예를 들어 5.26 LTS는 벡터 인덱스, 병렬 처리, 블록 포맷 스토리지 같은 2024년 12월까지의 모든 기능을 쓸 수 있어요. 다만 LTS로 지정된 이후엔 새 기능이 안 들어가고, 보안이나 버그 수정만 해줘요.
Q3. 매달 새 버전 나오는데 매번 올려야 하나요?
꼭 그럴 필요는 없어요. 2025.x 시리즈 쓴다면 매달 올리는 게 좋긴 한데, 필수는 아니에요. 다만 보안 패치나 버그 수정을 받으려면 가끔은 올려야 해요. 그게 부담스럽다면 5.26 LTS를 쓰세요.
Q4. Neo4j 4.4에서 바로 2025.x로 올릴 수 있나요?
안 돼요, 바로는 안 되고 5.26 LTS를 꼭 거쳐야 해요. 즉, 4.4 → 5.26 LTS → 2025.x 순서로 올려야 하는 거죠. LTS 버전이 중간 체크포인트 역할을 해요.
Q5. AuraDB 쓰면 버전 신경 안 써도 되나요?
Neo4j AuraDB는 자동으로 버전을 관리해주긴 하는데, 요금제마다 조금씩 달라요. Enterprise 플랜에서는 업데이트 일정을 어느 정도 조절할 수 있어요. 자세한 건 AuraDB 문서 보시는 게 좋아요.
Q6. 지원 끝난 버전 계속 쓰면 어떻게 되나요?
지원이 끝나면:
- 보안 문제가 생겨도 패치를 안 해줘요
- 버그가 있어도 안 고쳐줘요
- 최신 도구나 드라이버랑 안 맞을 수 있어요
- 문제 생겨도 기술 지원을 못 받아요
특히 보안이 중요한 서비스라면 꼭 지원받는 버전을 쓰세요.
Q7. 드라이버 버전도 데이터베이스 버전이랑 맞춰야 하나요?
드라이버는 보통 하위 호환이 되긴 하는데, 새 기능 쓰려면 맞는 버전이 필요해요. 일반적으로 드라이버 메이저 버전(예: 5.x)과 데이터베이스 메이저 버전을 맞추는 게 좋아요. 자세한 호환성은 Neo4j Driver Manual에서 확인할 수 있어요.
마무리하며…
Neo4j는 정말 빠르게 발전하는 데이터베이스예요. 2025년부터 시작된 Calendar Versioning과 매달 나오는 새 버전은 더 빠른 혁신을 가능하게 하지만, 그만큼 버전 관리도 중요해졌어요.
제일 중요한 건 내 환경에 맞는 선택이에요. 안정성이 중요하다면 5.26 LTS를, 최신 기능이 필요하다면 2025.x를 선택하면 돼요. 그리고 무엇보다 지원 끝난 버전은 쓰지 않는 게 중요해요.
특히 Neo4j 4.4 LTS 쓰고 계신 분들, 2025년 11월 30일 전에 꼭 업그레이드하세요. 충분히 테스트하고 여유 있게 준비하시길 바라요.
궁금한 게 있으면 Neo4j 커뮤니티에서 물어보세요. 한국어 답변은 많지 않지만, 영어로 질문하면 친절하게 답해줘요.
도움되는 공식 자료들: