n8n 3.0 베타가 2026년 10월 27일 출시됐습니다. 이번 버전은 새 기능 추가보다 안정성·보안·신뢰성 강화에 집중하며, 레거시 노드 제거·보안 기본값 변경·셀프호스팅 방식 변경 등 다수의 파괴적 변경(breaking changes)을 포함합니다. 안정 버전 출시는 12월 초 예정이며, 지금 Migration Report를 확인해 두는 것이 핵심입니다.
n8n 3.0에서 달라지는 것 — 전체 요약
n8n 공식 블로그(2026년 10월 27일 게시)에 따르면 3.0은 새 기능보다 내부 구조 개선에 초점을 맞춥니다. 공식 설명에서 "3.0은 신뢰성, 안정성, 보안을 개선하는 내부 변경에 집중하며, 다음에 만들 개선 사항의 기반을 마련한다"고 명시합니다.
주요 변경 영역은 세 가지입니다.
– **신뢰성·안정성**: 큐 모드(Queue mode) 변경, 인메모리 바이너리 데이터 모드 제거, Code 노드 타임아웃 단축, 스케줄링 방식 변경
– **보안**: 암호화 키 로테이션 항상 활성화, Slack 자격증명에 서명 시크릿 필수화, SSRF 차단 목록 확대, 미검증 커뮤니티 패키지 기본 비활성화
– **정리**: 레거시 노드(Function, Function Item, Item Lists, Cron, Interval, 레거시 OpenAI 노드, 이전 AI Agent 모드 등) 제거
공식 설명에서 "3.0은 파괴적 변경을 포함하므로 일부 워크플로우와 설정이 업그레이드 전에 수정이 필요할 수 있다"고 명시합니다.
- 베타: 2026-10-27 출시 / 안정 버전: 2026년 12월 초 예정
- 파괴적 변경 포함 — 워크플로우·설정 수정 필요 가능성 있음
- 새 기능은 2.x에서 계속 출시됐고 3.x 이후에도 계속 출시 예정
- 2.x에서 3.x로의 업그레이드는 되돌릴 수 없음 — 전체 백업 필수
근거: Introducing n8n 3.0 – n8n Blog
지금 해야 할 첫 번째 단계 — Migration Report 확인
공식 블로그에서 "Migration Report를 확인하는 것이 이 글에서 하나만 읽는다면 읽어야 할 부분"이라고 명시합니다.
**Migration Report 위치**: 설정(Settings) > Migration Report (n8n 버전 2.39 이상)
**Migration Report가 하는 것(공식 명시)**:
– 3.0에 영향을 받는 워크플로우와 인스턴스 수준 설정 목록 표시
– 많은 문제를 자동으로 수정 — 각 수정은 새 워크플로우 버전으로 저장되며 검토 후 게시 가능
– 게시된 워크플로우는 수정 작업 중에도 v2에서 계속 실행됨
– 마지막 편집자를 각 워크플로우의 담당자로 제안, 관리자가 재배정 가능
– 게시되지 않았거나 오래된 워크플로우는 필터링하여 '수정 안 함'으로 표시 가능
– CSV 요약 내보내기 가능
– 관리자는 모든 워크플로우, 일반 사용자는 접근 권한이 있는 워크플로우만 표시 (관리자 아니어도 확인 가능)
**권장 절차(공식 안내)**:
1. 최신 2.x 버전으로 업데이트 후 Migration Report 열기
2. 표시된 항목 수정 또는 '수정 안 함' 표시
3. 전체 백업 실행
4. 테스트·스테이징 인스턴스 먼저 업그레이드 후 프로덕션 적용
- Migration Report: 설정(Settings) > Migration Report (v2.39 이상 필요)
- 자동 수정 가능한 항목은 새 워크플로우 버전으로 저장 — 게시 전 검토 가능
- 업그레이드 전 전체 백업 필수 — 3.x에서 2.x로 롤백 불가 (공식 명시)
- 테스트 인스턴스 먼저 업그레이드 후 프로덕션 적용 권장
근거: Introducing n8n 3.0 – n8n Blog
AI 워크플로우에 직접 영향을 주는 노드 제거
n8n을 AI 자동화에 사용하고 있다면 다음 노드 제거가 직접 영향을 줄 수 있습니다.
공식 블로그에 명시된 제거 노드(레거시):
– **Function 노드** → Code 노드로 교체
– **Function Item 노드** → Code 노드로 교체
– **Item Lists 노드** → Split Out, Aggregate, Sort, Limit, Remove Duplicates, Summarize 노드로 교체
– **Cron 노드** → Schedule Trigger로 교체
– **Interval 노드** → Schedule Trigger로 교체
– **레거시 OpenAI 노드** → 현행 OpenAI 노드로 교체
– **이전 AI Agent 모드** → 현행 AI Agent 노드로 교체
– **이전 버전의 Edit Image 노드**
– **서비스가 더 이상 존재하지 않는 서비스의 노드**
공식 설명에서 "대부분은 직접 대체 노드가 있으며, 많은 경우 자동으로 마이그레이션된다"고 명시합니다.
**AI Agent 관련**: 이전 AI Agent 모드가 제거됩니다. 현재 n8n AI Agent 노드를 사용 중인 경우 구체적인 영향 여부는 Migration Report에서 확인해야 합니다.
**Ask AI 탭 제거**: Code 노드의 Ask AI 탭이 제거됩니다.
**Chat Hub**: 기본적으로 비활성화됩니다(3.x에서 다시 켤 수 있음). n8n AI 어시스턴트와 에이전트(agents)가 이를 대체한다고 공식 블로그에 명시합니다.
- Function·Function Item → Code 노드 / Item Lists → Split Out 등으로 교체 (다수 자동 마이그레이션)
- Cron·Interval → Schedule Trigger 교체 — 스케줄 기반 AI 워크플로우 확인 필요
- 레거시 OpenAI 노드·이전 AI Agent 모드 제거 — Migration Report에서 영향 확인
- Code 노드 Ask AI 탭 제거 / Chat Hub 기본 비활성화
근거: Introducing n8n 3.0 – n8n Blog
보안 기본값 강화 — 변경 전후 비교
공식 블로그에 명시된 보안 기본값 변경 사항입니다.
**암호화 키 로테이션**: 항상 활성화(before: 옵션). 기존 자격증명과의 호환성에 영향이 있을 수 있으므로 Migration Report 확인이 필요합니다.
**Slack 자격증명**: 이제 서명 시크릿(signing secret)이 필수입니다. 공식 설명에서 "서명 시크릿이 없으면 Slack인 척 위조된 요청을 보낼 수 없다"고 이유를 명시합니다. Slack Trigger나 Slack 노드를 사용하는 워크플로우는 자격증명에 서명 시크릿을 추가해야 합니다.
**SSRF 차단 목록**: SSRF 보호가 활성화된 경우 차단 목록이 더 넓어집니다. HTTP Request 노드로 내부 네트워크 주소를 호출하는 워크플로우는 영향을 받을 수 있습니다.
**미검증 커뮤니티 패키지**: 기본값이 비활성화로 변경됩니다. 커뮤니티 노드를 사용하는 경우 설정에서 명시적으로 허용해야 합니다.
이 보안 변경사항은 AI 자동화 워크플로우에서 외부 API를 호출하거나, Slack을 채널로 사용하거나, 커뮤니티 노드를 사용하는 팀에 직접 영향을 줍니다.
- Slack 자격증명: 서명 시크릿 이제 필수 — Slack 트리거·노드 사용 워크플로우 자격증명 업데이트 필요
- SSRF 차단 목록 확대 — 내부 주소 HTTP Request 워크플로우 영향 가능성 확인
- 미검증 커뮤니티 패키지 기본 비활성화 — 사용 중인 커뮤니티 노드는 설정에서 명시 허용 필요
- 암호화 키 로테이션 항상 활성화 — Migration Report에서 자격증명 영향 확인
근거: Introducing n8n 3.0 – n8n Blog
신뢰성·안정성 변경 — 큐 모드·바이너리 데이터·타임아웃
공식 블로그에 명시된 신뢰성·안정성 관련 변경사항입니다.
**큐 모드(Queue mode)**: 수동 실행이 이제 항상 워커(worker)에서 실행됩니다. 이전에는 메인 인스턴스에서 실행됐으나 3.0부터는 메인 인스턴스가 해당 작업을 처리하지 않습니다. 큐 모드를 사용하는 셀프호스팅 환경에서는 아키텍처 확인이 필요합니다.
**인메모리 바이너리 데이터 모드 제거**: 인메모리 방식이 제거되고 파일시스템, S3 또는 외부 스토리지를 사용합니다. 공식 설명에서 "부하 상황에서 더 예측 가능하다"고 이유를 명시합니다. 이미지·파일을 처리하는 AI 워크플로우(OCR, 문서 처리 등)는 스토리지 설정을 확인해야 합니다.
**Code 노드 타임아웃**: 기본값이 5분에서 1분으로 단축됩니다. 공식 설명에서 "태스크 러너 기준이며 설정 가능하다"고 명시합니다. Code 노드에서 긴 처리 로직을 실행하는 워크플로우는 타임아웃 설정을 검토해야 합니다.
**압축 해제 한도**: 'zip bombs'(과도한 크기의 아카이브)로부터 인스턴스를 보호하기 위해 압축 해제 한도가 낮아집니다.
**스케줄링**: 이전 Cron·Interval 노드가 Schedule Trigger로 교체됩니다. Schedule Trigger는 n8n의 더 안정적인 스케줄러에서 실행됩니다.
- 수동 실행: 메인 인스턴스 → 워커 이동 (큐 모드 환경 아키텍처 확인 필요)
- 인메모리 바이너리 데이터 모드 제거 → 파일시스템·S3 필요 (이미지·파일 처리 워크플로우 확인)
- Code 노드 기본 타임아웃: 5분 → 1분 (설정 가능, 긴 처리 로직 검토 필요)
- Cron·Interval → Schedule Trigger 교체 (더 안정적인 스케줄러)
근거: Introducing n8n 3.0 – n8n Blog
셀프호스팅 방식 변경 — Docker 필수화
공식 블로그에 따르면 셀프호스팅 n8n은 이제 Docker에서 실행됩니다.
**npm/npx 방식 종료**: 공식 설명에서 "npm 또는 npx n8n으로 설치하는 것은 더 이상 지원되지 않는다"고 명시합니다. 이유로는 "새 보안 기능이 컨테이너 설정에 의존하기 때문"이라고 명시합니다.
**빠른 시작 방법**: 공식 설명에서 "npx n8n의 빠른 시작을 좋아했다면, 같은 결과를 얻을 수 있는 원라인 설치 스크립트가 있다"고 안내합니다.
**영향받지 않는 환경**: 공식 명시에 따르면 Kubernetes와 Helm 배포는 영향을 받지 않습니다.
**2.x 지원 기간**: 안정 버전 출시 후 2.x는 12개월간 보안 및 치명적 버그 수정을 받습니다. 새 기능은 3.x에서만 출시됩니다.
**1.x 사용자**: 공식 설명에서 "1.x에서 3.x로의 직접 업그레이드 경로는 없다. 먼저 2.x로 업그레이드해야 한다"고 명시합니다. 또한 1.x 지원은 2026년 12월 31일 종료됩니다.
현재 npm/npx로 n8n을 설치한 팀은 Docker 기반으로 전환 계획을 세워야 합니다.
- npm·npx 설치 방식 종료 → Docker 필수 (보안 기능이 컨테이너 의존)
- Kubernetes·Helm 배포는 영향 없음 (공식 명시)
- 1.x → 3.x 직접 업그레이드 불가, 2.x 경유 필요 / 1.x 지원 2026-12-31 종료
- 2.x 안정 버전은 12개월간 보안·치명적 버그 수정만 제공, 신기능은 3.x 전용
근거: Introducing n8n 3.0 – n8n Blog
n8n Cloud 사용자의 업그레이드 방법
공식 블로그에 따르면 베타를 지금 바로 사용할 수 있습니다.
**n8n Cloud**: 버전 변경 시 '3.0.0 Beta (early access)'를 선택하면 됩니다. 별도 설치 과정이 없습니다.
**셀프호스팅**: 다른 베타 릴리스와 동일한 방법으로 설치합니다.
**중요 주의사항(공식 명시)**: "3.x로 이동하는 것은 일방통행입니다. 2.x로 되돌아갈 수 없습니다. 테스트 인스턴스에서 먼저 시도하고 전체 백업을 하세요."
**타임라인 요약**:
– 베타(3.0.0): 2026-10-27 (현재 사용 가능)
– 안정 버전(3.x): 2026년 12월 초 예정
– 1.x 지원 종료: 2026-12-31
– 2.x 지원(보안·버그 수정): 안정 버전 출시 후 12개월
**커뮤니티 포럼**: 공식 블로그에서 질문이 있으면 커뮤니티 포럼 공지 스레드에 답글을 달면 도움을 받을 수 있다고 안내합니다.
- Cloud: 버전 선택에서 '3.0.0 Beta (early access)' 선택으로 즉시 사용 가능
- 셀프호스팅: 다른 베타 릴리스와 동일한 설치 방법 / 원라인 스크립트 제공 예정
- 베타 전환은 되돌릴 수 없음 — 반드시 테스트 인스턴스 먼저·전체 백업 후 진행
- 안정 버전은 2026년 12월 초 예정
근거: Introducing n8n 3.0 – n8n Blog
누가 지금 행동해야 하는가
공식 블로그에 따르면 지금 당장 행동이 필요한 경우와 그렇지 않은 경우가 구분됩니다.
**지금 Migration Report를 확인해야 하는 경우**:
– 프로덕션에서 n8n을 실행 중인 모든 팀 — 안정 버전 출시 전 준비 시간을 확보
– Function, Cron, Interval, 레거시 OpenAI 노드, 이전 AI Agent 모드를 사용하는 워크플로우가 있는 경우
– Slack 트리거를 사용하는 경우 — 서명 시크릿 추가 필요
– 커뮤니티 노드를 사용하는 경우 — 미검증 패키지 기본 비활성화 대응
– npm/npx로 셀프호스팅 중인 경우 — Docker 전환 계획 필요
– n8n 1.x를 사용 중인 경우 — 2026-12-31 이전에 2.x → 3.x 업그레이드 필요
**지금 당장 업그레이드하지 않아도 되는 경우**:
– 2.x 안정 버전을 사용 중이고 Migration Report 확인 후 문제가 없는 경우 — 12월 안정 버전 출시 후 업그레이드 가능
– Kubernetes/Helm 배포로 운영 중인 경우 — 셀프호스팅 방식 변경 영향 없음
**공식 설명의 권장사항**: "지금 업그레이드 계획이 없더라도 Migration Report를 지금 확인하는 것이 좋다(It's worth taking a look now, even if you're not planning to upgrade right away)."
- Function·Cron·레거시 OpenAI·이전 AI Agent 모드 사용 워크플로우: Migration Report 즉시 확인
- Slack 트리거 사용: 자격증명에 서명 시크릿 추가 계획 필요
- 커뮤니티 노드 사용: 미검증 패키지 비활성화 기본값 대응 필요
- npm/npx 셀프호스팅: Docker 전환 계획 필요 / 1.x: 2026-12-31 이전 업그레이드 필수
근거: Introducing n8n 3.0 – n8n Blog
공식 자료 확인 기준
이 글의 공식 자료 확인일은 2026년 10월 28일이며, 원문 게시일은 2026년 10월 27일입니다. n8n 3.0은 현재 베타 단계이며 안정 버전(3.x) 출시 전까지 세부 변경사항이 바뀔 수 있습니다. Migration Report의 자동 수정 범위, 개별 노드 마이그레이션 세부 절차, 설정 가능한 타임아웃 값은 n8n 공식 3.0 파괴적 변경 문서와 마이그레이션 도구 문서에서 최신 정보를 확인하세요.
이 글에서 제시한 영향 범위(커뮤니티 노드, SSRF, 큐 모드 등)는 공식 블로그에 명시된 내용을 기반으로 하며, 구체적인 워크플로우별 영향은 각 인스턴스의 Migration Report를 직접 확인해야 합니다.
- 공식 자료: n8n 공식 블로그(blog.n8n.io) 2026-10-27 게시
- 베타 단계 — 안정 버전 출시 전까지 세부 변경사항 변경 가능
- 개별 노드 마이그레이션 절차: n8n 공식 3.0 파괴적 변경 문서 별도 확인
- 각 인스턴스별 실제 영향: Migration Report 직접 확인 필수
근거: Introducing n8n 3.0 – n8n Blog
자료 확인 기준
2026년 10월 28일에 공식 원문을 확인했습니다. 확인일과 정책·공연의 시행일은 다를 수 있으며 변경 공지는 원문을 우선합니다.
답글 남기기