이 문서에서는 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 File, CLI, Public API.
• 작동하지 않는 노드 — 제거됩니다.

---

이 페이지는 v3 출시가 다가옴에 따라 세부 정보, 마이그레이션 가이드, 링크가 포함되어 계속 업데이트될 예정입니다.