2025년 12월 n8n 최신 버전 주요 업데이트

n8n이 메이저 버전 2.0.0을 출시했습니다. 이번 2.x 전환은 대규모 신규 기능보다 보안, 안정성, 실행 모델 개선에 초점을 둔 릴리즈입니다.

한눈에 보는 2.x 릴리즈 하이라이트

메이저 버전 2.0.0 출시
보안 기본값 대폭 강화
워크플로 실행 안정성 및 관리 개선

1) n8n 2.0.0 메이저 버전: 보안과 실행 모델의 전환점

n8n 2.0.0은 플랫폼 전반에 영향을 미치는 Breaking Changes를 포함한 메이저 릴리즈입니다. 이 버전에서는 보안 위험을 줄이고 실행 환경을 분리하기 위한 구조적 변화가 도입됐습니다. 2.0은 새로운 기능 추가보다 보안, 안정성, 실행 신뢰성에 집중한 'hardening release'입니다.

보안 정책 강화

Task Runners 기본 활성화

Code 노드 실행은 이제 Task Runner를 통해 격리된 환경에서 처리됩니다.
Task Runners는 보안 기능일 뿐만 아니라 더 나은 격리와 리소스 관리를 제공합니다.
n8n 2.0부터 Task Runner는 기본 활성화됩니다.

환경 변수 접근 차단

Code 노드 및 표현식에서 환경 변수 접근이 기본적으로 차단됐습니다.
환경 변수에 직접 접근하던 Code 노드는 업데이트 후 실패할 수 있습니다.

기타 보안 강화

ExecuteCommand 노드와 LocalFileTrigger 노드는 보안상의 이유로 기본 비활성화 상태로 제공됩니다.
파일 시스템 접근을 제한하는 기본 보안 설정이 적용됐습니다.

실행 모델 변경

바이너리 데이터 처리 변경

실행 중 바이너리 데이터를 메모리에 보관하던 in-memory 모드는 제거됐습니다.

데이터베이스 지원 변경

n8n 플랫폼 내부 데이터 저장용 데이터베이스 백엔드로서 MySQL과 MariaDB 지원이 제거됐습니다.

이제 PostgreSQL과 SQLite만 공식 지원됩니다.
MySQL/MariaDB를 n8n 인스턴스의 내부 데이터베이스로 사용 중인 경우, 업그레이드 전 반드시 PostgreSQL 또는 SQLite로 마이그레이션해야 합니다.
단, 워크플로에서 사용하는 MySQL/MariaDB 노드 자체는 계속 지원됩니다.

2) Publish / Save: 워크플로 배포 방식의 근본적 변화

n8n 2.0에서 가장 눈에 띄는 사용자 경험 변화는 워크플로 저장과 배포의 분리입니다.

이전 방식 (v1.x)

활성화된 상태의 워크플로를 저장하면 즉시 프로덕션에 반영됐습니다.
디버깅 중 실수로 "Save"를 누르면 미완성 로직이 프로덕션에 반영될 위험이 있었습니다.

새로운 방식 (v2.0)

Save 버튼: 편집 내용을 저장하지만 프로덕션 실행에 영향을 주지 않습니다.
Publish 버튼: 저장된 변경 사항 중 하나를 선택해 명시적으로 프로덕션에 반영합니다.

이 방식의 장점:

워크플로를 원하는 만큼 반복 작업하고 테스트할 수 있습니다.
프로덕션 실행은 항상 게시된(Published) 버전만 사용합니다.
실수로 인한 프로덕션 변경을 방지할 수 있습니다.

버전 관리

워크플로를 저장할 때마다 새 버전이 생성됩니다.
게시할 때 버전 이름과 설명을 추가할 수 있습니다.
버전 히스토리에서 이전 버전을 복원할 수 있습니다.
워크플로를 unpublish해 프로덕션에서 제거할 수 있습니다.

3) Migration Report 도구

n8n은 2.0 업그레이드를 위한 전용 Migration Report 도구를 제공합니다.

기능

n8n 인스턴스를 스캔해 잠재적 호환성 문제를 식별합니다.
문제를 두 가지 카테고리로 분류합니다.
- Workflow Issues: 특정 노드나 동작이 2.0에서 중단될 수 있는 워크플로
- Instance Issues: 환경 변수, 설정, 인프라 구성 문제

심각도 태그

Critical: 업그레이드 시 워크플로가 중단됩니다. 먼저 수정해야 합니다.
Medium/Low: 즉각적인 중단은 없으나 수정이 권장됩니다.

접근 방법

Settings → Migration Report에서 확인할 수 있습니다.
전역 관리자(Global Admin)만 확인할 수 있습니다.

사용 흐름

Migration Report 실행
Critical 이슈 먼저 해결
Refresh를 클릭해 재스캔
모든 항목이 정상일 경우 업그레이드 진행

4) 마이그레이션 및 운영 시 유의 사항

n8n 2.x로 업그레이드할 때, 다음 사항을 점검해야 합니다.

공식 Breaking Changes 문서 확인
Migration Report 도구 실행
n8n 인스턴스 DB가 MySQL/MariaDB인지 확인
Code 노드에서 환경 변수 직접 접근 여부 점검
기본 비활성화된 노드(ExecuteCommand, LocalFileTrigger) 사용 여부 확인
Git 관련 보안 설정이 변경된 기본 정책과 충돌하지 않는지 점검
서브워크플로 반환 데이터 동작 변경의 영향 여부 검토
Task Runner 기반 실행 구조에 따른 리소스 요구 사항 점검

본 콘텐츠는 n8n Release Note의 영문 원본을 한국어로 번역하고 재구성했습니다. 인포그랩은 n8n의 한국 공식 파트너사입니다.

n8n 구축부터 성공적인 워크플로까지 n8n 공식 파트너사 인포그랩과 함께하세요! 지금 문의하기