n8n v3.0 주요 변경 사항

n8n 3.0 버전으로 전환하며 발생하는 주요 변경 사항과 준비 사항을 설명합니다.

이 문서에서는 2026년 10월로 예정된 n8n v3.0으로의 전환을 준비하기 위한 주요 변경 사항과 필요한 조치를 안내합니다. 이번 업데이트는 보안을 강화하고, 구성을 단순화하며, 레거시 기능을 제거합니다. n8n 3.0 릴리즈는 안전하고 신뢰할 수 있으며 프로덕션에 바로 사용할 수 있는 자동화 플랫폼을 제공하겠다는 n8n의 약속을 이어갑니다. 이 메이저 버전에는 중요한 보안 강화 사항과 지원 종료된 기능의 정리가 포함됩니다. 배포 # 셀프 호스팅 n8n에 Docker 기반 배포 필수 # 셀프 호스팅 n8n은 Docker 기반 배포가 필수가 됩니다. npm / npx n8n 으로 실행하는 설치 방식은 더 이상 지원되지 않습니다. 조치 사항: 현재 npm 또는 npx n8n 으로 n8n을 실행하고 있다면, v3로 업그레이드하기 전에 Docker 기반 배포로 전환할 계획을 세우세요. 로컬 설치의 경우 Docker Compose가 가장 쉬운 경로가 될 것으로 예상됩니다. 단계별 마이그레이션 안내가 곧 제공될 예정입니다. 제거되는 노드 및 헬퍼 # 새로운 패턴으로 대체된 오래된 노드, 모드, 헬퍼가 v3에서 제거됩니다. 제거되는 노드 # Function 노드(레거시) Function Item 노드(레거시) Item Lists 노드(레거시) 조치 사항: 업그레이드하기 전에 영향을 받는 워크플로를 현재 권장되는 대안으로 마이그레이션하세요. Function 및 Function Item 노드를 Code 노드로 교체하세요. Function 대신 Run Once for All Items 모드를, Function Item 대신 Run Once for Each Item 모드를 사용하세요. Item Lists 노드는 사용 중인 작업에 맞는 노드로 교체하세요: Split Out , Aggregate , Sort , Limit , Remove Duplicates , Summarize 중에서 선택합니다. 변경되는 노드 동작 # Execute Workflow 노드: 이전 동작 방식이 제거됩니다. 제거되는 표현식 헬퍼 # 지원이 종료된 $getPairedItem 표현식 헬퍼가 제거됩니다. 조치 사항: 대신 n8n의 표준 항목 연결 기능을 사용하세요. 예를 들어 pairedItem 속성이나 $("<node-name>").item 을 사용할 수 있습니다. 보안 # n8n을 기본적으로 더 안전하게 만들기 위해 보안 기본값이 더 엄격해집니다. 이러한 변경 사항은 기존 워크플로나 자격 증명에 영향을 줄 수 있습니다. 위험한 리소스 이름에 대한 처리 강화. 더 안전해진 자격 증명 동작 방식. 키 로테이션 기본 활성화. 지원 종료 기능 # 일부 레거시 기능 또는 사용률이 낮은 제품 기능이 v3에서 지원 종료됩니다. 마이그레이션 경로나 대안이 있는 경우 관련 안내가 제공됩니다. Chat hub — 지원 종료됩니다. 에디터에서 URL로 워크플로 가져오기 — 제거됩니다. 그 외 가져오기 방법 은 계속 지원됩니다: 복사-붙여넣기, 에디터 UI 메뉴의 Import from Fil