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)만 확인할 수 있습니다.

사용 흐름​

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

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

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

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

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

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