---
title: "2026년 11월 n8n 최신 버전 주요 업데이트"
description: "n8n v2.44.0~v2.49.0은 에이전트 채널(WhatsApp·Microsoft Teams·Slack·웹훅)과 예산·도구 가드레일, n8n Assistant의 Apps 모듈, Promotions와 노드·자격 증명 유형 정책, 실행 데이터 마스킹(redaction) 확대를 담았고, 얼리 액세스 상태의 v3.0.0~v3.3.0은 Docker 기반 배포 필수와 제거 노드 등 브레이킹 체인지를 포함합니다."
url: https://insight.infograb.net/release/2026/11/18/n8n-update-release/
source: content/generated/release/2026-11-18-n8n-update-release.md
---

안녕하세요, 인포그랩입니다.

2026년 10월 8일부터 11월 18일까지 n8n은 2.x 라인에서 여섯 차례의 마이너 릴리즈(v2.44.0, v2.45.0, v2.46.0, v2.47.0, v2.48.0, v2.49.0)를 발표했고, 별도로 3.x 라인에서 네 차례의 마이너 릴리즈(v3.0.0, v3.1.0, v3.2.0, v3.3.0)를 내놓았습니다. 이번 기간의 방향은 세 갈래입니다. 에이전트 측면에서는 WhatsApp, Microsoft Teams, Slack, 웹훅 채널을 붙이고 예산 알림과 도구 가드레일, 버전 이력, 보관(archive) 상태를 더했습니다. 배포·통제 측면에서는 Promotions 모듈을 기본으로 불러오고 노드·자격 증명 유형 정책을 기본 활성화했으며, 실행 데이터 마스킹(redaction) 적용 범위를 넓혔습니다. 3.0 준비 측면에서는 마이그레이션 리포트에 영향 단계와 CSV 내보내기, 소유자 알림을 더했고, 3.0.0은 Docker 기반 배포 필수와 레거시 노드 제거를 포함한 얼리 액세스 릴리즈로 공개되었습니다. 핵심 변경은 다섯 가지입니다. 에이전트 채널과 가드레일, n8n Assistant의 Apps 모듈, Promotions·정책·Environments, 실행 데이터 마스킹과 관측성(OpenTelemetry) 확대, n8n 3.0 브레이킹 체인지와 마이그레이션 리포트입니다.  2.x 여섯 버전을 합치면 신규 기능 276건, 버그 수정 626건, 성능 개선 29건입니다. 같은 기간 2.x 패치 42건, 3.x 패치 2건(v3.0.1, v3.2.2), LTS(장기 지원) v1.123.x 패치 14건이 배포되었습니다.

릴리즈 채널 상태는 다음과 같습니다. 2026-11-17 기준 GitHub의 `stable` 태그는 v2.48.4, `beta` 태그는 v2.49.0을 가리킵니다. v3.0.0~v3.3.0은 GitHub Release에 모두 prerelease로 표시되어 있고, n8n 공식 문서(v3.0 Breaking changes)도 "n8n 3.0.0 is currently available as an early access release"라고 안내합니다. 이 노트는 stable·beta 라인인 2.44~2.49를 중심으로 다루고, 3.x는 얼리 액세스로 구분해 별도 섹션에서 정리합니다. v2.44.0~v2.49.0도 GitHub Release에 prerelease로 표시되어 있습니다.

## 한눈에 보는 11월 릴리즈 하이라이트

- 에이전트 채널과 가드레일 (v2.44.0~v2.49.0): WhatsApp 에이전트 채널(v2.44.0), Microsoft Teams 에이전트 채널과 Slack 멘션 전용 응답(v2.46.0), 웹훅 채널(v2.49.0)이 추가되었습니다. 월 예산 알림 이메일, 하위 에이전트 예산 적용, Gateway credits 지갑이 비면 실행 중지, 패턴 기반 도구 가드레일이 더해졌습니다.
- Agents 관리 기능 (v2.47.0~v2.49.0): 에이전트 버전 이력과 게시 타임라인, 초안과 별개로 저장 버전 게시, 보관(archive)과 복원, Public API의 에이전트 GET·POST·DELETE 엔드포인트가 추가되었습니다.
- n8n Assistant와 Apps (v2.47.0~v2.49.0): Apps 프런트엔드 모듈과 목록 페이지, 앱 게시, 앱 미리보기, 앱 바인딩 UI가 들어왔고 n8n Assistant에서 앱을 만들 수 있습니다. Assistant 기본 모델은 Claude Opus 5.5로 올랐습니다(v2.48.0).
- Promotions와 정책 (v2.44.0~v2.49.0): Promotions 모듈이 기본으로 로드되고(v2.47.0), 노드·자격 증명 유형 정책이 기본으로 켜졌습니다(v2.45.0). 폐기 노드가 들어 있는 워크플로의 생성·수정이 차단됩니다.
- 실행 데이터 마스킹과 권한 (v2.45.0~v2.49.0): 부모·하위 워크플로 실행의 마스킹, Assistant 실행 조회의 마스킹과 `execution:read` 확인, 로그 스트리밍·텔레메트리·오류 보고에 마스킹 정책 적용이 추가되었습니다. 인증 헤더 마스킹은 대소문자를 구분하지 않습니다.
- 관측성 (v2.44.0~v2.49.0): 모든 OTel 스팬에 실행 주체가 붙고, GenAI 속성과 도구 스팬 속성, `otel.configure` 외부 훅이 추가되었습니다.
- 노드·통합 (v2.44.0~v2.49.0): Microsoft SharePoint Trigger 노드가 신설되고, Google Vertex AI 자격 증명, Microsoft Work IQ OAuth2 자격 증명, GitHub Secret 리소스, Monday.com 노드 V2, Kafka 노드 v2 기본값, Edit Image 노드 v2가 추가되었습니다. Azure OpenAI 계열 노드와 자격 증명은 Microsoft Foundry로 이름이 바뀌었습니다.
- n8n 3.0 얼리 액세스 (v3.0.0~v3.3.0): Docker 기반 배포 필수, 레거시 노드 제거, `~/.n8n/binaryData`의 `~/.n8n/storage` 이름 변경, Slack API 자격 증명의 서명 시크릿 필수 등이 포함되었습니다. 업그레이드 전 Settings > Migration Report로 영향 범위를 확인해야 합니다. 상세는 별도 섹션에 정리했습니다.

---

## 11월 핵심 릴리즈 심층 분석

이번 업데이트 시리즈의 핵심 기능을 다섯 가지 주제로 정리합니다.

### 1) 에이전트 채널 확장과 예산·도구 가드레일 (v2.44.0~v2.49.0)

9월 말(v2.42.0)에 기본 활성화된 Agents는 이번 기간에 외부 채널과 운영 통제 기능을 갖췄습니다. 에이전트가 어디서 호출되는지, 얼마까지 쓸 수 있는지, 어떤 도구 호출을 막는지를 관리자가 정할 수 있게 하는 변경입니다.

핵심 변경 사항은 다음과 같습니다.

- 채널 추가 (v2.44.0~v2.49.0): WhatsApp 에이전트 채널이 추가되었고, 인바운드 미디어 처리, 메시지 품질 속도 제한 처리, 입력 중 표시와 미디어 다운로드·보관, 자격 증명 확인과 웹훅 핸드셰이크 상태, 10개를 넘는 목록 옵션 페이지 처리, 고객 서비스 창 밖의 템플릿 메시지 전송이 차례로 더해졌습니다. Microsoft Teams 에이전트 채널이 제공되고(v2.46.0), Slack에는 멘션할 때만 응답하는 모드가 생겼습니다. 웹훅 채널은 v2.49.0에서 추가된 뒤 이름이 API 채널로 바뀌었고, 웹훅 채널에서도 승인 요청을 처리할 수 있습니다. ([#38750](https://github.com/n8n-io/n8n/issues/38750), [#39409](https://github.com/n8n-io/n8n/issues/39409), [#39205](https://github.com/n8n-io/n8n/issues/39205), [#41867](https://github.com/n8n-io/n8n/issues/41867), [#41815](https://github.com/n8n-io/n8n/issues/41815), [#42989](https://github.com/n8n-io/n8n/issues/42989), [#43758](https://github.com/n8n-io/n8n/issues/43758), [#43056](https://github.com/n8n-io/n8n/issues/43056))
- 예산 알림과 중지 (v2.44.0~v2.48.0): 월 예산 알림이 임계값을 넘으면 에이전트 소유자에게 이메일을 보내고, 외부 에이전트 채널에는 예산 중지 메시지를 게시합니다. 예산 알림과 중지는 하위 에이전트 실행에도 적용되며, 예산 가드레일 중지는 세션 타임라인에 표시됩니다. Gateway credits 지갑이 비면 에이전트 실행이 멈춥니다. ([#40544](https://github.com/n8n-io/n8n/issues/40544), [#40767](https://github.com/n8n-io/n8n/issues/40767), [#40884](https://github.com/n8n-io/n8n/issues/40884), [#41692](https://github.com/n8n-io/n8n/issues/41692), [#41473](https://github.com/n8n-io/n8n/issues/41473))
- 도구 가드레일과 승인 (v2.45.0~v2.49.0): 에이전트용 MCP 도구 권한 체계가 개편되었고, 정책이 도구 호출을 거부하면 그 이유가 표시됩니다. 에이전트 설정 스키마에 도구 가드레일을 넣을 수 있으며, 패턴 기반 도구 가드레일이 도구 호출에 실행됩니다. 무인 작업 승인은 waiting 상태로 유지됩니다. ([#39878](https://github.com/n8n-io/n8n/issues/39878), [#40673](https://github.com/n8n-io/n8n/issues/40673), [#43404](https://github.com/n8n-io/n8n/issues/43404), [#43664](https://github.com/n8n-io/n8n/issues/43664), [#41399](https://github.com/n8n-io/n8n/issues/41399))
- 버전·보관 (v2.47.0~v2.49.0): 에이전트 버전과 게시 이력이 저장되고 타임라인으로 확인할 수 있으며, 저장된 버전을 초안과 독립적으로 게시할 수 있습니다. 에이전트에 보관 상태가 생겨 UI에서 보관·복원하고, 보관 상태는 n8n 패키지에도 담깁니다. 에이전트 목록은 오프셋·limit 페이지네이션과 워크플로와 같은 필터를 지원하고, 태그를 붙일 수 있습니다. ([#41816](https://github.com/n8n-io/n8n/issues/41816), [#42296](https://github.com/n8n-io/n8n/issues/42296), [#41817](https://github.com/n8n-io/n8n/issues/41817), [#43392](https://github.com/n8n-io/n8n/issues/43392), [#43394](https://github.com/n8n-io/n8n/issues/43394), [#43329](https://github.com/n8n-io/n8n/issues/43329), [#43814](https://github.com/n8n-io/n8n/issues/43814), [#43324](https://github.com/n8n-io/n8n/issues/43324))
- Public API와 MCP (v2.49.0): 에이전트를 읽는 GET, 생성하는 POST, 삭제하는 DELETE 엔드포인트가 추가되었습니다. MCP의 에이전트 삭제 도구는 보관 도구로 교체되었고, 에이전트 세션 로그를 읽는 MCP 도구에는 도구 값 한도와 페이지가 생겼습니다. ([#43719](https://github.com/n8n-io/n8n/issues/43719), [#43562](https://github.com/n8n-io/n8n/issues/43562), [#44011](https://github.com/n8n-io/n8n/issues/44011), [#43393](https://github.com/n8n-io/n8n/issues/43393), [#43794](https://github.com/n8n-io/n8n/issues/43794))
- 모델·메모리 (v2.44.0~v2.49.0): 에이전트 빌더가 Microsoft Foundry 모델을 설정하고 Foundry의 Claude 배포를 지원하며, 배포 목록을 모델 선택기에 표시합니다. 에피소드 기억 회상과 통합이 개선되었고, 에이전트 지식 파일 업로드 한도가 25 MB로 늘었습니다. Instance AI에는 옵트인 관찰 메모리 정책이 추가되었습니다. ([#41913](https://github.com/n8n-io/n8n/issues/41913), [#41905](https://github.com/n8n-io/n8n/issues/41905), [#41892](https://github.com/n8n-io/n8n/issues/41892), [#42438](https://github.com/n8n-io/n8n/issues/42438), [#42395](https://github.com/n8n-io/n8n/issues/42395), [#43304](https://github.com/n8n-io/n8n/issues/43304))

에이전트를 외부 채널에 연결하는 인스턴스는 예산 알림과 도구 가드레일을 함께 설정해 두어야 채널 단위 비용과 도구 호출 범위를 관리할 수 있습니다.

### 2) n8n Assistant와 Apps 모듈 (v2.44.0~v2.49.0)

n8n Assistant에는 워크플로·에이전트에 이어 앱을 만드는 경로가 더해졌습니다. 워크플로 검증과 스킬 편집 기능도 함께 확장되었습니다.

핵심 변경 사항은 다음과 같습니다.

- Apps 모듈 (v2.47.0~v2.49.0): Apps 프런트엔드 모듈과 목록 페이지, 앱 상세 경로와 앱 뷰, 앱 미리보기, 앱 게시가 추가되었습니다. n8n Assistant에서 앱을 만들 수 있고, 앱 청사진 카드를 먼저 보여 줍니다. v2.48.0에서 앱 미리보기의 요소 선택, 앱 바인딩 UI, 앱과 Assistant 채팅 연결이 더해졌고 v2.49.0에서는 모든 응답에 앱용 CSP가 붙으며 게시할 때 연결 리소스도 함께 게시됩니다. ([#42180](https://github.com/n8n-io/n8n/issues/42180), [#42410](https://github.com/n8n-io/n8n/issues/42410), [#42552](https://github.com/n8n-io/n8n/issues/42552), [#42634](https://github.com/n8n-io/n8n/issues/42634), [#42636](https://github.com/n8n-io/n8n/issues/42636), [#42815](https://github.com/n8n-io/n8n/issues/42815), [#42930](https://github.com/n8n-io/n8n/issues/42930), [#42986](https://github.com/n8n-io/n8n/issues/42986), [#42969](https://github.com/n8n-io/n8n/issues/42969), [#43532](https://github.com/n8n-io/n8n/issues/43532), [#43660](https://github.com/n8n-io/n8n/issues/43660))
- 켜기·끄기와 모델 (v2.45.0~v2.49.0): n8n Assistant를 켜고 끄는 스위치와 환경 변수가 추가되었고, 기본 Assistant 모델이 Claude Opus 5.5로 올랐습니다. Assistant 메모리 작업용 모델을 따로 지정할 수 있습니다. v2.49.0에서는 보조 호출을 유틸리티 모델에서 실행하고 검증 보조 호출을 크레딧에 포함합니다. ([#42121](https://github.com/n8n-io/n8n/issues/42121), [#42990](https://github.com/n8n-io/n8n/issues/42990), [#41137](https://github.com/n8n-io/n8n/issues/41137), [#43498](https://github.com/n8n-io/n8n/issues/43498), [#43499](https://github.com/n8n-io/n8n/issues/43499))
- 스킬 (v2.47.0~v2.49.0): Assistant가 만들거나 수정한 스킬이 아티팩트로 표시됩니다. v2.49.0에서는 스킬 하위 메뉴, 폴더·SKILL.md 업로드, 아티팩트 패널의 스킬 편집·저장, 스킬 소스 상태 확인과 자격 증명 교체가 추가되었습니다. ([#41631](https://github.com/n8n-io/n8n/issues/41631), [#43312](https://github.com/n8n-io/n8n/issues/43312), [#43171](https://github.com/n8n-io/n8n/issues/43171), [#43314](https://github.com/n8n-io/n8n/issues/43314), [#43795](https://github.com/n8n-io/n8n/issues/43795))
- 검증과 권한 (v2.46.0~v2.49.0): Assistant 변경이 스레드의 프로젝트로 제한되고, 자격 증명 도구가 워크플로 빌더와 에이전트 빌더에서 공유됩니다. 저장하지 않은 수동 실행을 읽을 수 있고, 프로젝트 멤버를 자가 치유(self-healing) 검토자로 지정할 수 있습니다. 시간 기반 Wait 노드는 검증 실행에서 대기 없이 실행됩니다. ([#41700](https://github.com/n8n-io/n8n/issues/41700), [#41748](https://github.com/n8n-io/n8n/issues/41748), [#42125](https://github.com/n8n-io/n8n/issues/42125), [#42283](https://github.com/n8n-io/n8n/issues/42283), [#42950](https://github.com/n8n-io/n8n/issues/42950))
- MCP 서버 (v2.47.0~v2.49.0): Assistant와 MCP가 자격 증명 설명을 수정할 수 있고, 인스턴스 MCP 서버에 의존성 조회 도구와 마이그레이션 리포트 도구가 추가되었습니다. `publish_workflow` MCP 도구는 버전 이름을 지정할 수 있습니다. ([#42425](https://github.com/n8n-io/n8n/issues/42425), [#43161](https://github.com/n8n-io/n8n/issues/43161), [#40817](https://github.com/n8n-io/n8n/issues/40817), [#43767](https://github.com/n8n-io/n8n/issues/43767))

### 3) Promotions·정책·Environments (v2.44.0~v2.49.0)

9월에 도입된 Promotions는 이번 기간에 기본 모듈이 되었고, 어떤 노드·자격 증명 유형을 쓸 수 있는지 정하는 정책이 기본으로 켜졌습니다.

핵심 변경 사항은 다음과 같습니다.

- Promotions 모듈 기본 로드 (v2.47.0): 롤아웃 플래그가 제거되고 Promotions 모듈이 기본으로 로드됩니다. Apply 연결 단계에서 누락된 프로젝트를 만들 수 있습니다. v2.49.0에서는 워크플로를 고르지 않고도 프로젝트와 폴더를 승격·적용할 수 있고, Inbox에서 승격 리뷰를 닫을 수 있으며, 흔한 Git 실패 원인을 설명합니다. ([#42247](https://github.com/n8n-io/n8n/issues/42247), [#42870](https://github.com/n8n-io/n8n/issues/42870), [#43260](https://github.com/n8n-io/n8n/issues/43260), [#43362](https://github.com/n8n-io/n8n/issues/43362), [#43453](https://github.com/n8n-io/n8n/issues/43453))
- 승격 범위와 데이터 테이블 (v2.44.0~v2.46.0): 선택한 워크플로와 함께 폴더·프로젝트 이름 변경이 승격되고, 데이터 테이블 패키지 가져오기에 덮어쓰기 충돌 정책(overwrite, overwrite-non-destructive)과 열 ID 기준 매칭이 추가되었습니다. 파괴적 데이터 테이블 변경은 사전 점검에서 보고되며 계속 적용할 때 확인을 받습니다. 승격 커밋 메시지는 선택 사항이고 기본 메시지가 생성됩니다. ([#40502](https://github.com/n8n-io/n8n/issues/40502), [#40345](https://github.com/n8n-io/n8n/issues/40345), [#40446](https://github.com/n8n-io/n8n/issues/40446), [#40709](https://github.com/n8n-io/n8n/issues/40709), [#40454](https://github.com/n8n-io/n8n/issues/40454), [#40491](https://github.com/n8n-io/n8n/issues/40491), [#41888](https://github.com/n8n-io/n8n/issues/41888))
- 유형 정책 기본 활성화 (v2.45.0): 노드·자격 증명 유형 정책이 기본으로 켜졌습니다. 소스 컨트롤 pull 모달에는 정책으로 막힌 항목이 표시되고, 제한된 프로젝트로 이동하면 거부하는 대신 게시가 해제됩니다. 자격 증명 전용 노드는 유형 정책에 따라 숨겨질 수 있습니다. ([#41022](https://github.com/n8n-io/n8n/issues/41022), [#40604](https://github.com/n8n-io/n8n/issues/40604), [#41865](https://github.com/n8n-io/n8n/issues/41865), [#39652](https://github.com/n8n-io/n8n/issues/39652))
- 폐기 노드 차단 (v2.42.6·v2.43.3·v2.44.0): 폐기 노드가 들어 있는 워크플로의 생성·수정이 차단됩니다. 에디터에서도 폐기 노드 사용이 막힙니다. ([#31360](https://github.com/n8n-io/n8n/issues/31360), [#31392](https://github.com/n8n-io/n8n/issues/31392))
- 환경과 API 키 (v2.46.0~v2.49.0): 소스 컨트롤 API 키 스코프에 Environments 그룹이 추가되었고, 승격 제공자·환경 변경에 감사 이벤트가 남습니다. 세분화된 자격 증명 공유가 항상 켜집니다. ([#41537](https://github.com/n8n-io/n8n/issues/41537), [#43277](https://github.com/n8n-io/n8n/issues/43277), [#41376](https://github.com/n8n-io/n8n/issues/41376))
- 의존성 API (v2.46.0): 워크플로, 자격 증명, 데이터 테이블의 의존성 엔드포인트가 Public API에 추가되었습니다. ([#42040](https://github.com/n8n-io/n8n/issues/42040))

### 4) 실행 데이터 마스킹·인증·관측성 (v2.44.0~v2.49.0)

민감한 실행 데이터를 보는 경로와 외부 요청을 받는 경로가 이번 기간에 넓게 손질되었습니다.

핵심 변경 사항은 다음과 같습니다.

- 마스킹 적용 범위 (v2.45.0~v2.49.0): 하위 워크플로 중 하나라도 마스킹이 켜져 있으면 부모 실행이 마스킹됩니다. 보는 사람이 쓸 수 없는 자격 증명을 하위 워크플로가 쓰는 경우에도 부모 실행이 마스킹됩니다. Assistant의 실행 조회와 1회성 노드 실행, MCP 워크플로 실행 오류, 로그 스트리밍·텔레메트리·오류 보고에도 마스킹 정책이 적용됩니다. 소비된 인증 헤더는 대소문자를 구분하지 않고 마스킹됩니다. ([#41129](https://github.com/n8n-io/n8n/issues/41129), [#41085](https://github.com/n8n-io/n8n/issues/41085), [#41565](https://github.com/n8n-io/n8n/issues/41565), [#41582](https://github.com/n8n-io/n8n/issues/41582), [#42574](https://github.com/n8n-io/n8n/issues/42574), [#42905](https://github.com/n8n-io/n8n/issues/42905), [#43061](https://github.com/n8n-io/n8n/issues/43061))
- 전역 자격 증명 실행의 마스킹 해제 (v2.47.7·v2.48.4·v2.49.0): 전역 자격 증명을 쓰는 실행은 더 이상 마스킹되지 않도록 수정되었습니다. ([#43223](https://github.com/n8n-io/n8n/issues/43223), [#43775](https://github.com/n8n-io/n8n/issues/43775), [#43776](https://github.com/n8n-io/n8n/issues/43776))
- `execution:read` 확인 (v2.45.7·v2.46.0·v2.47.0): 워크플로 범위 라우트가 실행 데이터를 읽을 때 `execution:read`를 요구하고, 권한이 없으면 재시도 응답에서 실행 데이터를 제외합니다. Assistant의 실행 조회에서도 같은 권한을 확인합니다. ([#42446](https://github.com/n8n-io/n8n/issues/42446), [#42305](https://github.com/n8n-io/n8n/issues/42305), [#41871](https://github.com/n8n-io/n8n/issues/41871), [#41863](https://github.com/n8n-io/n8n/issues/41863))
- 신뢰 소스와 서명 검증 (v2.45.0~v2.49.0): Form·Chat 트리거의 리다이렉트 로그인이 신뢰 소스를 기준으로 동작하고, Webhook과 MCP Trigger 노드는 신뢰 소스로 인증합니다. Workable, Mailchimp, Venafi TLS Protect Cloud 트리거에 웹훅 서명 검증이 추가되었고 Jira Trigger는 Cloud(OAuth2) 웹훅의 서명 토큰을 검증합니다. ([#41123](https://github.com/n8n-io/n8n/issues/41123), [#41455](https://github.com/n8n-io/n8n/issues/41455), [#41683](https://github.com/n8n-io/n8n/issues/41683), [#41561](https://github.com/n8n-io/n8n/issues/41561), [#42250](https://github.com/n8n-io/n8n/issues/42250), [#42800](https://github.com/n8n-io/n8n/issues/42800))
- OAuth·MCP (v2.44.0~v2.49.0): 폐기된 액세스 토큰은 인바운드 파이프라인에서 거부되고, 각 OAuth 인가 요청은 자체 세션에 묶입니다. 외부 MCP 연결은 사용자 승인 없이 저장되지 않습니다. 아웃바운드 MCP OAuth는 CIMD를 지원하고 2026-07-28 인가 사양에 맞춰졌습니다. Automatic OAuth 모드는 선택한 서비스에 클라이언트를 등록합니다. ([#41266](https://github.com/n8n-io/n8n/issues/41266), [#39930](https://github.com/n8n-io/n8n/issues/39930), [#39996](https://github.com/n8n-io/n8n/issues/39996), [#42608](https://github.com/n8n-io/n8n/issues/42608), [#42907](https://github.com/n8n-io/n8n/issues/42907), [#42782](https://github.com/n8n-io/n8n/issues/42782))
- OpenTelemetry (v2.44.0~v2.49.0): 모든 OTel 스팬에 실행 주체가 붙고, 워크플로·노드 실행의 시작 마커 스팬을 옵트인으로 낼 수 있습니다. AI Agent와 채팅 모델 스팬에 GenAI 속성이 붙고, 사용자 정의 속성 키 접두어를 설정할 수 있습니다. Sentry는 v11로 올라 OpenTelemetry를 시작 시 한 번 설정하며, `otel.configure` 외부 훅이 추가되었습니다. ([#40649](https://github.com/n8n-io/n8n/issues/40649), [#40762](https://github.com/n8n-io/n8n/issues/40762), [#41874](https://github.com/n8n-io/n8n/issues/41874), [#41695](https://github.com/n8n-io/n8n/issues/41695), [#41584](https://github.com/n8n-io/n8n/issues/41584), [#42164](https://github.com/n8n-io/n8n/issues/42164))
- 감사 이벤트 (v2.48.0~v2.49.0): 사용자 로그아웃, 자격 증명 데이터 읽기, 워크플로 자동 게시 해제, Public API 속도 제한 변경에 감사 이벤트가 남습니다. 개인 자격 증명을 쓰는 실행을 추적합니다. ([#42413](https://github.com/n8n-io/n8n/issues/42413), [#43063](https://github.com/n8n-io/n8n/issues/43063), [#43162](https://github.com/n8n-io/n8n/issues/43162), [#43712](https://github.com/n8n-io/n8n/issues/43712), [#43246](https://github.com/n8n-io/n8n/issues/43246))
- 실행 엔진 (v2.44.0~v2.45.0): 내구 스케줄러가 기본으로 켜졌고(v2.45.0), 워커 종료 시 진행 중인 프로덕션 실행이 일시 중단됩니다. 워크플로 이력 정리는 내구 일일 시스템 작업으로 실행되며 크래시된 실행은 시작 로그 복구에서 보고됩니다. 헬스 체크 타임아웃을 설정할 수 있고, 데이터베이스가 내려가 있어도 Prometheus 지표를 제공합니다. ([#40891](https://github.com/n8n-io/n8n/issues/40891), [#40568](https://github.com/n8n-io/n8n/issues/40568), [#40085](https://github.com/n8n-io/n8n/issues/40085), [#40390](https://github.com/n8n-io/n8n/issues/40390), [#39548](https://github.com/n8n-io/n8n/issues/39548), [#39908](https://github.com/n8n-io/n8n/issues/39908))

### 5) n8n 3.0 얼리 액세스와 마이그레이션 리포트 (v2.44.0~v3.3.0)

3.0 대비 도구는 이번 기간에 리포트를 읽고 처리하는 기능을 갖췄고, 3.0.0은 얼리 액세스로 공개되었습니다.

핵심 변경 사항은 다음과 같습니다.

- 얼리 액세스 상태 (v3.0.0): v3.0.0(2026-10-27)은 GitHub에 prerelease로 표시되어 있고, 공식 문서도 얼리 액세스 릴리즈로 안내합니다. v3.1.0(11-03), v3.2.0(11-10), v3.3.0(11-17)이 이어졌고 패치는 v3.0.1(10-28)과 v3.2.2(11-13)입니다. 2026-11-17 기준 stable 태그는 v2.48.4입니다.
- 리포트 열람과 알림 (v2.44.0~v2.48.0): 모든 사용자가 자신이 편집할 수 있는 워크플로 범위로 마이그레이션 리포트를 봅니다. 관리자는 마이그레이션 발견 항목을 워크플로 소유자에게 알릴 수 있고(일괄 알림 포함), 알림 메일에서 열면 수신자 기준으로 필터링됩니다. 알림을 보낸 발견 항목은 미해결로 간주되며, 소유자 알림 재발송에는 쿨다운이 적용됩니다. ([#40449](https://github.com/n8n-io/n8n/issues/40449), [#40952](https://github.com/n8n-io/n8n/issues/40952), [#40949](https://github.com/n8n-io/n8n/issues/40949), [#41060](https://github.com/n8n-io/n8n/issues/41060), [#43089](https://github.com/n8n-io/n8n/issues/43089), [#40951](https://github.com/n8n-io/n8n/issues/40951), [#42567](https://github.com/n8n-io/n8n/issues/42567))
- 영향 단계와 필터 (v2.46.0~v2.48.0): "Executions might fail" 영향 단계가 추가되고 프로젝트별 필터, 워크플로의 프로젝트 표시, CSV 내보내기, 해결 안내가 더해졌습니다. 보관된 워크플로는 기본으로 숨겨지고, 리포트 로딩이 길면 안내 메시지가 표시됩니다. ([#41673](https://github.com/n8n-io/n8n/issues/41673), [#41869](https://github.com/n8n-io/n8n/issues/41869), [#41989](https://github.com/n8n-io/n8n/issues/41989), [#41534](https://github.com/n8n-io/n8n/issues/41534), [#42531](https://github.com/n8n-io/n8n/issues/42531), [#42781](https://github.com/n8n-io/n8n/issues/42781), [#42996](https://github.com/n8n-io/n8n/issues/42996))
- 제거 노드 자동 마이그레이션 (v2.45.0~v2.46.0): 제거 대상 노드에 대한 자동 마이그레이션이 구현되었고, Edit Image 노드에는 v3 마이그레이션이 추가되었습니다. Slack 서명 시크릿과 `$evaluateExpression` 규칙이 리포트 규칙으로 올라왔습니다. ([#40877](https://github.com/n8n-io/n8n/issues/40877), [#41389](https://github.com/n8n-io/n8n/issues/41389), [#41781](https://github.com/n8n-io/n8n/issues/41781), [#42298](https://github.com/n8n-io/n8n/issues/42298))
- 3.0.0 릴리즈 노트의 되돌림: v3.0.0 릴리즈 본문에는 Execute Sub-workflow 노드의 "Run once for each item" 모드 제거와 "Any workflow" 호출자 정책 제거를 되돌린 항목이 있습니다. 두 제거는 공식 브레이킹 체인지 목록에도 없습니다.

---

## n8n 3.0 업그레이드 주의사항 (브레이킹 체인지)

이 섹션은 n8n 공식 문서 [v3.0 Breaking changes](https://docs.n8n.io/changelog/v30-breaking-changes.md)와 [v3.0 Migration tool](https://docs.n8n.io/changelog/v30-migration-tool.md)을 기준으로 정리했습니다. 3.0.0은 얼리 액세스 릴리즈이므로 프로덕션 적용 여부는 상태 확인 후 정해야 합니다. 업그레이드 전에 Settings > Migration Report에서 영향받는 워크플로와 인스턴스 설정을 확인합니다. 리포트의 영향 단계는 Upgrade blocked, Executions will fail, Executions might fail, Behavior changes, Capability removed 다섯 가지입니다.

### 배포

- 자체 호스팅은 Docker 기반 배포 필수: `npm`과 `npx n8n`으로 실행하는 설치는 지원되지 않고, 3.0은 실행 가능한 `n8n` 패키지를 npm에 게시하지 않습니다. 대응은 업그레이드 전에 Docker 기반 배포로 옮기는 것입니다. 이미 자체 Docker Compose 파일을 쓰고 있으면 전환이 필요 없습니다.

### 제거된 노드와 헬퍼

제거된 노드를 쓰는 워크플로는 실행 시 실패하고, 게시된 워크플로라면 n8n 3.0 시작 시 활성화되지 않아 트리거가 멈춥니다.

- 제거 노드와 대체 경로: Function·Function Item(→ Code), Item Lists(→ Split Out·Aggregate·Sort·Limit·Remove Duplicates·Summarize), Cron·Interval(→ Schedule Trigger), HTML Extract(→ HTML 노드의 Extract HTML Content), iCalendar(→ Convert to File의 Convert to ICS), Convert to/from binary data(→ Convert to File·Extract from File), Read/Write Binary File(s)(→ Read/Write Files from Disk), Read PDF(→ Extract from File의 Extract From PDF), Workflow Trigger(→ n8n Trigger), 레거시 OpenAI·OpenAI Assistant(→ OpenAI 노드의 Assistant 리소스), OpenAI Model(→ OpenAI Chat Model), 레거시 HTTP Request Tool(→ AI Agent의 Tool 입력에 연결한 HTTP Request), Manual Chat Trigger(→ Chat Trigger), Chat Messages Retriever(→ Chat Memory Manager 또는 Chat Trigger의 이전 세션 불러오기), Binary Input Loader·JSON Input Loader·GitHub Document Loader(→ Default Data Loader), 벡터 스토어 Insert·Load 노드(→ Simple Vector Store·Pinecone Vector Store·Supabase Vector Store 단일 노드)입니다.
- 직접 대체가 없는 노드: LangChain Code, Motorhead, Zep 메모리, Zep Vector Store, SerpApi (Google Search)는 직접 대체가 없습니다. Orbit은 서비스가 종료되어 대체가 없습니다.
- AI Transform 노드: 더 이상 추가하거나 실행할 수 없습니다. Settings > Migration Report에서 Code 노드로 마이그레이션하면 생성된 JavaScript가 유지됩니다. 업그레이드 시 자동으로 바뀌지 않으며, 코드를 생성한 적이 없는 노드는 직접 Code 노드로 바꿔야 합니다.
- `$getPairedItem` 제거: 표현식에서 호출하면 실행이 실패합니다. `$('<node-name>').item`, `$('<node-name>').itemMatching(<item-index>)`, `$('<node-name>').pairedItem(<item-index>)` 중 하나로 바꿉니다.
- Execute Sub-workflow 노드의 Local File·URL 소스 제거: 노드 버전 1.1 이하에서만 제공되던 옵션입니다. 서브 워크플로를 인스턴스로 가져와 Database 소스로 선택하거나 Define Below 소스로 JSON을 붙여 넣습니다.
- Code 노드의 `$evaluateExpression()` 제거: 안전하지 않은 모드(`N8N_RUNNERS_INSECURE_MODE=true`)의 태스크 러너가 영향 대상입니다. 표현식 평가는 Edit Fields (Set) 노드 필드에서 하고 결과를 Code 노드에서 읽습니다.
- AI Agent 노드 v1 제거: SQL Agent, Conversational Agent, OpenAI Functions Agent, Plan and Execute Agent, ReAct Agent 모드가 사라집니다. 최신 버전으로 올리면 Tools Agent로 대체되고, SQL Agent 용도는 Postgres 또는 MySQL 도구 서브 노드와 최신 AI Agent 노드로 바꿉니다.
- Edit Image 노드 v1·v1.1 제거: 해당 버전을 쓰는 워크플로는 오류가 납니다. 노드 v2는 이미지 처리 라이브러리가 달라 출력이 달라질 수 있습니다. 블러 설정은 변환되지만 Sigma는 제거되고, 텍스트 위치가 바뀔 수 있으며 PNG·TIFF 출력은 Quality 설정을 무시합니다. 마이그레이션 후 출력을 시험해야 합니다.

### 동작 변경

- Always Output Data: If, Switch처럼 출력이 여러 개인 노드는 모든 출력이 비었을 때만 빈 항목을 추가합니다. 이전에는 비어 있는 출력마다 빈 항목이 생겨 분기가 의도와 달리 실행될 수 있었습니다.
- Gmail Trigger 노드 v1~v1.3: v1.4 동작으로 실행됩니다. Max Emails per Poll(기본 10, 최대 50)이 모든 폴링에 적용되고, 초안은 Include Drafts 필터를 켜야 포함되며, 받은편지함에 없는 발신 메일과 예약 메일은 트리거하지 않습니다.
- Webflow OAuth2 자격 증명: Legacy 토글 기본값이 꺼짐입니다. 새 자격 증명과 다시 연결하는 기존 자격 증명은 Webflow v2 API 스코프(`cms:read cms:write sites:read forms:read`)를 요청합니다. v1 Data API를 쓰면 다시 연결하기 전에 Legacy를 켭니다.
- Chat Trigger 노드의 WebSocket 메시지: Using Response Nodes 응답 모드에서 모든 프레임이 `type` 필드(`heartbeat`, `continue`, `error`, `message`, `with-buttons`)를 가진 JSON 객체로 전송됩니다. 사용자 정의 채팅 클라이언트는 JSON으로 파싱해야 하고, `@n8n/chat`을 직접 임베드하면 v1.31.0 이상으로 올립니다.

### 보안

- 암호화 키 교체 기본 활성화: 데이터 암호화 키 교체 기능이 기본으로 켜집니다. 이전 데이터는 그대로 읽히고 레코드를 갱신할 때 새 키로 다시 암호화됩니다. 필요한 조치는 없으며 업그레이드 전 데이터베이스 백업만 권장됩니다. n8n 2.40.3부터는 이 기능을 다시 끌 수 있습니다.
- Slack API 자격 증명에 서명 시크릿 필수: Slack Trigger 노드가 있는 워크플로는 업그레이드 전에 Slack 앱의 Signing Secret을 자격 증명의 Signature Secret 필드에 넣어야 합니다. 넣지 않으면 게시에 실패하고, 이미 게시된 워크플로는 업그레이드 뒤 활성화되지 않아 이벤트를 받지 못합니다. 그 밖의 Slack 워크플로는 자격 증명을 다음에 수정할 때 넣으면 됩니다.
- SSRF 차단 목록 확대: `N8N_SSRF_PROTECTION_ENABLED`가 `true`이고 `N8N_SSRF_BLOCKED_IP_RANGES`에 `default`가 있을 때 `::/128`, `100.64.0.0/10`, `2002::/16`, `64:ff9b::/96`이 기본 목록에 추가됩니다. 해당 대역 호스트를 호출하면 `N8N_SSRF_ALLOWED_IP_RANGES` 또는 `N8N_SSRF_ALLOWED_HOSTNAMES`에 추가합니다. `default` 키워드는 유지합니다.
- Compression 노드 해제 한도 축소: `N8N_COMPRESSION_NODE_MAX_DECOMPRESSED_SIZE_BYTES` 기본값이 2 GiB에서 256 MiB로, `N8N_COMPRESSION_NODE_MAX_ZIP_ENTRIES` 기본값이 5,000에서 1,000으로 줄어듭니다. 더 큰 압축 파일을 다루면 업그레이드 전에 이전 값(2147483648, 5000)을 명시합니다.

### 설정 변경

- `N8N_PRE_EXECUTE_ERROR_CREATES_EXECUTION` 제거: `workflow.preExecute` 외부 훅이 예외를 던지면 실행 기록이 만들어지지 않으며 이전 동작으로 되돌릴 방법이 없습니다. 업그레이드 전에 변수를 제거하고, 실패 실행 기록으로 알림을 보냈다면 알림을 외부 훅 안으로 옮깁니다.
- 저장소 디렉터리 이름 변경: 첫 시작 때 `~/.n8n/binaryData`가 `~/.n8n/storage`로 바뀌고 `N8N_MIGRATE_FS_STORAGE_PATH`가 제거됩니다. 두 디렉터리가 모두 있으면 n8n이 오류와 함께 시작하지 않습니다. 볼륨을 `~/.n8n/binaryData`에 마운트했다면 `~/.n8n/storage`로 마운트하거나 `N8N_STORAGE_PATH`를 이전 경로로 지정합니다.
- 메모리 내 바이너리 데이터 모드 제거: `N8N_DEFAULT_BINARY_DATA_MODE=default`는 유효하지 않으며 `filesystem`으로 전환됩니다. `filesystem`, `s3`, `azure`, `database` 중에서 지정하고 컨테이너 디스크 여유를 확인합니다.
- 커뮤니티 패키지 기본값: `N8N_UNVERIFIED_PACKAGES_ENABLED` 기본값이 `true`에서 `false`로 바뀌어 미검증 커뮤니티 노드를 npm에서 설치할 수 없고 이미 설치된 노드도 로드되지 않습니다.
- 태스크 러너 타임아웃 단축: `N8N_RUNNERS_TASK_TIMEOUT` 기본값이 `300`(5분)에서 `60`(1분)으로 줄어 1분을 넘는 Code 노드 작업이 실패합니다.
- 큐 모드 수동 실행: 수동 실행이 항상 워커에서 실행되고 `OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS`가 제거됩니다. 워커 메모리를 점검합니다.
- `N8N_DB_PING_TIMEOUT` 제거: `DB_PING_TIMEOUT_MS`를 대신 설정합니다.
- `N8N_WORKFLOW_TAGS_DISABLED` 제거: 워크플로 태그가 항상 켜지며 이전에 저장된 태그가 다시 표시됩니다.

### 중단된 기능

- Chat Hub: 기본으로 꺼지고 Chat 메뉴와 엔드포인트가 사라지지만 대화 데이터는 남습니다. n8n 4.0에서 기능이 제거됩니다. 계속 쓰려면 `N8N_ENABLED_MODULES`에 `chat-hub`를 추가합니다(예: `agents,chat-hub`). 3.x 라인에서만 유지되며 시작 시 폐기 경고가 나옵니다.
- 에디터의 URL로 워크플로 가져오기: 메뉴에서 Import from URL이 사라집니다. 복사·붙여넣기, 파일 가져오기, CLI, n8n API를 씁니다.
- 프로젝트 역할의 외부 시크릿 활성화 설정: 설정이 제거되어 프로젝트 편집자와 관리자가 기본으로 외부 시크릿에 접근합니다(Enterprise). 접근을 제한했다면 업그레이드 전에 커스텀 프로젝트 역할을 만들어야 합니다.
- Code 노드의 Ask AI 탭: 제거됩니다. 이미 생성된 코드는 그대로 동작합니다.

### 커뮤니티 노드 개발

- `defaults.color` 속성이 노드 설명 타입에서 제거됩니다. 기존 노드는 동작하지만 Font Awesome 아이콘이 중립 색으로 표시됩니다.
- `n8n-node dev`는 Docker 또는 Podman이 필요하고, 테스트 데이터는 `n8n-node-cli-data-<image>` 컨테이너 볼륨에 저장되며 이전 데이터는 이어지지 않습니다. 외부 인스턴스는 `--external-n8n`과 `N8N_DEV_RELOAD=true`로 씁니다. `--custom-user-folder`는 `--external-n8n`일 때만 적용됩니다.

---

## 세부 기능 개선 사항

### AI 모델·에이전트 노드

- Azure OpenAI Chat Model 노드와 자격 증명 이름이 Microsoft Foundry로 바뀌었고(v2.44.0), Foundry의 Claude 배포는 Anthropic Messages 스키마를 쓰며 자격 증명에 선택 Project 필드가 있습니다. Embeddings Azure OpenAI 노드에는 Entra ID 인증이 추가되었습니다. ([#40398](https://github.com/n8n-io/n8n/issues/40398), [#40306](https://github.com/n8n-io/n8n/issues/40306), [#41181](https://github.com/n8n-io/n8n/issues/41181), [#39390](https://github.com/n8n-io/n8n/issues/39390))
- Google Vertex AI 자격 증명이 추가되고 프로젝트를 선택할 수 있습니다. Google Gemini 노드의 이미지 모델 목록에 Nano Banana 2.1과 2 Lite가 표시되고, Gemini 모델은 이름으로 표시되며 우선 모델이 먼저 나열됩니다. Microsoft Work IQ OAuth2 자격 증명이 추가되었습니다. ([#40665](https://github.com/n8n-io/n8n/issues/40665), [#40667](https://github.com/n8n-io/n8n/issues/40667), [#40596](https://github.com/n8n-io/n8n/issues/40596), [#40965](https://github.com/n8n-io/n8n/issues/40965), [#43172](https://github.com/n8n-io/n8n/issues/43172))
- Text Classifier 노드는 옵트인 신뢰도 점수를 출력하고, LLM 서브 노드 실행 데이터에는 응답한 모델 이름이 표시됩니다. MCP Client Tool 노드는 일반 OAuth2 API 자격 증명을 받습니다. ([#40743](https://github.com/n8n-io/n8n/issues/40743), [#41161](https://github.com/n8n-io/n8n/issues/41161), [#37371](https://github.com/n8n-io/n8n/issues/37371))
- Databricks 노드는 Vector Store, Embeddings, AI Agent 노드가 노드 선택기에 표시되고 Lakebase 리소스와 Lakebase Chat Memory 서브 노드가 활성화되었습니다. 에이전트 응답에 노드 도구 출처가 덧붙고 Genie 출처와 딥링크가 추가되었습니다. ([#41206](https://github.com/n8n-io/n8n/issues/41206), [#41795](https://github.com/n8n-io/n8n/issues/41795), [#40765](https://github.com/n8n-io/n8n/issues/40765))
- AI 모델 선택 화면에서 제한된 모델 제공자는 비활성화되고 제한 사유가 팝오버로 표시됩니다. 에이전트 워크플로 도구의 입력을 설정할 수 있습니다. ([#40658](https://github.com/n8n-io/n8n/issues/40658), [#40705](https://github.com/n8n-io/n8n/issues/40705), [#40285](https://github.com/n8n-io/n8n/issues/40285))

### 협업·에디터

- 명령 막대가 유형 탭과 페이지 검색으로 다시 만들어졌고 에이전트를 검색·생성·재열기할 수 있습니다. 개인 설정 페이지와 설정 사이드바 링크가 정리되었습니다. 사용자 링크는 사이드바 하단의 계정 메뉴로 이동했습니다. ([#40461](https://github.com/n8n-io/n8n/issues/40461), [#40504](https://github.com/n8n-io/n8n/issues/40504), [#40298](https://github.com/n8n-io/n8n/issues/40298), [#42642](https://github.com/n8n-io/n8n/issues/42642))
- n8n 브랜드 자산이 교체되고 UI가 리브랜딩되었습니다. 필수 자격 증명 필드가 표시되고, 자격 증명 공유 목록은 사람, 프로젝트 순으로 정렬됩니다. ([#40342](https://github.com/n8n-io/n8n/issues/40342), [#41510](https://github.com/n8n-io/n8n/issues/41510), [#42028](https://github.com/n8n-io/n8n/issues/42028), [#40478](https://github.com/n8n-io/n8n/issues/40478))
- MCP 클라이언트 연결 대화상자에 Antigravity가 추가되고 Windsurf는 Devin으로 교체되었습니다. 데이터 테이블 페이지 크기 컨트롤은 All 옵션으로 정리되었습니다. ([#40879](https://github.com/n8n-io/n8n/issues/40879), [#40912](https://github.com/n8n-io/n8n/issues/40912), [#39850](https://github.com/n8n-io/n8n/issues/39850))
- 제한된 템플릿 노드가 템플릿 페이지와 설정 패널에 표시되고, 제한 노드가 포함된 워크플로를 가져오면 토스트가 나타납니다. 에이전트 설정 체크리스트가 추가되었습니다. ([#43739](https://github.com/n8n-io/n8n/issues/43739), [#43553](https://github.com/n8n-io/n8n/issues/43553), [#39919](https://github.com/n8n-io/n8n/issues/39919))

### Core·인프라

- Public API는 POST 요청의 `Idempotency-Key`를 지원하고, 워크플로 조회 엔드포인트가 상위 폴더를 반환합니다. 패키지 내보내기(`POST /api/v1/n8n-packages/export`)의 보관 포함 플래그가 `includeArchivedWorkflows`에서 `includeArchived`로 바뀌었고, OpenAPI 스펙에 n8n 버전이 기록됩니다. 패키지 가져오기는 사용하는 API 키 스코프만 요구합니다. ([#40978](https://github.com/n8n-io/n8n/issues/40978), [#40981](https://github.com/n8n-io/n8n/issues/40981), [#43391](https://github.com/n8n-io/n8n/issues/43391), [#43352](https://github.com/n8n-io/n8n/issues/43352), [#43293](https://github.com/n8n-io/n8n/issues/43293))
- n8n 패키지는 워크플로·자격 증명 설명을 담고, 패키지 가져오기에 누락 자격 증명을 값과 함께 만드는 모드가 추가되었습니다. ([#43401](https://github.com/n8n-io/n8n/issues/43401), [#36767](https://github.com/n8n-io/n8n/issues/36767))
- 커뮤니티 노드는 활성 자격 증명을 하나만 갖도록 강제되고, 로컬 커뮤니티 패키지 디렉터리를 제출 전에 검사할 수 있으며 UX 가이드라인을 벗어나는 작업 이름에는 경고가 표시됩니다. ([#39122](https://github.com/n8n-io/n8n/issues/39122), [#42948](https://github.com/n8n-io/n8n/issues/42948), [#41932](https://github.com/n8n-io/n8n/issues/41932))
- 모든 메인에 버전 불일치 경고가 표시되고, 텔레메트리는 배포 아티팩트, 실행 런타임, CPU·메모리 한도, 관리형 데이터베이스·Redis 서비스를 보고합니다. W3C baggage가 웹훅에서 아웃바운드 요청으로 전달됩니다. ([#40097](https://github.com/n8n-io/n8n/issues/40097), [#40319](https://github.com/n8n-io/n8n/issues/40319), [#40420](https://github.com/n8n-io/n8n/issues/40420), [#40421](https://github.com/n8n-io/n8n/issues/40421), [#40427](https://github.com/n8n-io/n8n/issues/40427), [#42532](https://github.com/n8n-io/n8n/issues/42532))
- 성능: 실행 런타임의 항목별 준비 작업이 줄고 QuickJS WASM 파일은 장기 캐시로 제공되며 런타임 번들에서 `replaceSpecialChars` 문자 맵이 빠졌습니다. 에디터는 모달을 지연 로드해 시작 번들이 작아지고, 캔버스 상태 애니메이션 CPU 사용이 줄었습니다. 마이그레이션 리포트 스캔은 키셋 페이징을 쓰고, Google Drive Trigger는 변경 목록 대신 감시 대상 항목을 읽습니다. ([#43335](https://github.com/n8n-io/n8n/issues/43335), [#44023](https://github.com/n8n-io/n8n/issues/44023), [#43418](https://github.com/n8n-io/n8n/issues/43418), [#43331](https://github.com/n8n-io/n8n/issues/43331), [#43667](https://github.com/n8n-io/n8n/issues/43667), [#42691](https://github.com/n8n-io/n8n/issues/42691), [#42134](https://github.com/n8n-io/n8n/issues/42134))

### 노드·통합

- Microsoft SharePoint Trigger: 노드가 신설되었습니다. ([#40055](https://github.com/n8n-io/n8n/issues/40055))
- Monday.com: 노드 V2가 V1과 같은 기능을 갖춘 채 기본값이 되었습니다. ([#35515](https://github.com/n8n-io/n8n/issues/35515))
- Kafka: 새 Kafka 노드와 트리거는 v2가 기본입니다. ([#40744](https://github.com/n8n-io/n8n/issues/40744))
- Edit Image: 노드 v2가 napi-rs/canvas로 추가되었습니다. ([#41182](https://github.com/n8n-io/n8n/issues/41182))
- GitHub·n8n·Postgres: GitHub 노드에 Secret 리소스가 추가되었습니다. n8n 노드에는 프로젝트에 사용자 추가 작업과 사용자 조회 작업이 추가되었습니다. Postgres 노드는 사용자 정의 SSL 인증서를 지원합니다. ([#25441](https://github.com/n8n-io/n8n/issues/25441), [#41253](https://github.com/n8n-io/n8n/issues/41253), [#42566](https://github.com/n8n-io/n8n/issues/42566), [#41593](https://github.com/n8n-io/n8n/issues/41593))
- Zendesk·OpenWeatherMap·Redis Vector Store: Zendesk 새 노드는 OAuth2 인증이 기본입니다. OpenWeatherMap 노드는 자격 증명의 기본 URL과 인증을 사용하고, Redis Vector Store 노드는 `FluentRedisVectorStore`를 사용합니다. ([#39310](https://github.com/n8n-io/n8n/issues/39310), [#42184](https://github.com/n8n-io/n8n/issues/42184), [#27978](https://github.com/n8n-io/n8n/issues/27978))
- Chat·Paddle·Microsoft Agent 365: Chat 노드의 Respond to Chat이 임베디드 채팅 모드에서 허용됩니다. Paddle 노드는 Paddle Classic으로 이름이 바뀌었고, Microsoft Agent 365 노드는 OpenTelemetry 설정으로 Microsoft에 스팬을 보냅니다. ([#41955](https://github.com/n8n-io/n8n/issues/41955), [#43042](https://github.com/n8n-io/n8n/issues/43042), [#42174](https://github.com/n8n-io/n8n/issues/42174))

---

## 주요 버그 수정 내역

이번 11월 릴리즈 시리즈의 2.x 마이너(v2.44.0~v2.49.0)에서는 276건의 신규 기능을 추가하고 626건의 버그를 수정했으며 29건의 성능 개선을 반영했습니다. 아래 수정 건수는 6개 마이너 릴리즈의 변경 로그 접두어 기준이며 패치 릴리즈 항목은 포함하지 않습니다.

| 영역         | 수정 건수 | 주요 내용                                                                                                                                |
| ---------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Core·실행 엔진 | 252건  | 큐 작업의 유휴 워커 배정과 종료 시 재개, 대기·큐 실행의 재개 시도 한도, 마이그레이션 발견 항목 소유권 제한, 표현식 런타임의 `__proto__` 키와 Error 값 처리, OAuth 인가 요청 세션 분리, 실행 마스킹 규칙 보완 |
| 에디터·UI     | 164건  | 라이트 모드 대비, 캔버스 노드 테두리, 에이전트 아티팩트 표시, 소스 컨트롤 모달, 마이그레이션 리포트 목록과 필터                                                                    |
| 접두어 없음     | 116건  | OAuth2 사용자 정의 스코프, 사용자 정보 대체 처리, Salesforce 인스턴스 URL 보존, 폴더 목록 프로젝트 스코프, 의존성 범위                                                      |
| 노드·통합      | 68건   | Email Trigger(IMAP) 재연결 백오프와 표현식 해석, Postgres 전역 pgtypes 덮어쓰기 방지, Microsoft SharePoint 열 매퍼 403, Execution Data 노드의 불리언·falsy 값 저장   |
| AI Builder | 16건   | Assistant 실행 조회의 `execution:read` 확인, 자가 치유 채팅 프로젝트, 검증 보조 호출                                                                        |
| Public API | 10건   | 401 응답의 OAuth 리소스 챌린지, 읽기 전용 자격 증명 노드 편집 거부, API 키 스코프                                                                               |

### 패치 릴리즈 요약

같은 기간 배포된 패치 릴리즈(2.x 42건, 3.x 2건, LTS 14건) 중 운영에 영향이 큰 수정은 다음과 같습니다.

- v2.42.5~v2.43.8 (10-08~10-19): 폐기 노드가 있는 워크플로의 생성·수정 차단(v2.42.6, v2.43.3), Gemini 이미지 모델 목록 표시, `chunk()` 표현식 확장의 크기 인수 검증(v2.43.5), 웹훅 요청 본문마다 XML 파서 생성(v2.43.6), 워커 종료 시 진행 중 프로덕션 실행 일시 중단(v2.43.7), 표현식 스팬 기본 끔(v2.43.8). ([#40706](https://github.com/n8n-io/n8n/issues/40706), [#40911](https://github.com/n8n-io/n8n/issues/40911), [#41113](https://github.com/n8n-io/n8n/issues/41113), [#40944](https://github.com/n8n-io/n8n/issues/40944), [#41310](https://github.com/n8n-io/n8n/issues/41310))
- v2.44.1~v2.44.7 (10-14~10-26): 로그 스트리밍 웹훅 대상의 연결 재사용, 큐 작업 결과를 작업별로 키 지정, Postgres 노드의 전역 pgtypes 덮어쓰기 방지, 사전 점검 실패 시 서브 워크플로 오류 워크플로 시작, IMAP 서버가 새 연결을 계속 끊을 때 재연결 백오프. ([#41281](https://github.com/n8n-io/n8n/issues/41281), [#41404](https://github.com/n8n-io/n8n/issues/41404), [#41667](https://github.com/n8n-io/n8n/issues/41667), [#41978](https://github.com/n8n-io/n8n/issues/41978), [#41927](https://github.com/n8n-io/n8n/issues/41927))
- v2.45.1~v2.45.7 (10-21~10-30): 유휴 워커의 다음 큐 작업과 락을 한 번에 확보, 유형 가용성 정책을 메모리에서 읽기, 표현식의 `ExpressionError` 이름과 undefined 값 유지, 워크플로 범위 라우트의 실행 데이터 조회에 `execution:read` 요구(v2.45.7), IMAP 트리거 표현식을 활성화 뒤 해석. ([#41558](https://github.com/n8n-io/n8n/issues/41558), [#41621](https://github.com/n8n-io/n8n/issues/41621), [#42309](https://github.com/n8n-io/n8n/issues/42309), [#42264](https://github.com/n8n-io/n8n/issues/42264), [#42446](https://github.com/n8n-io/n8n/issues/42446), [#42611](https://github.com/n8n-io/n8n/issues/42611))
- v2.46.1~v2.46.7 (10-28~11-09): 마이그레이션 리포트의 제거 노드·Edit Image 항목 개선, 새 큐 작업을 유휴 워커 하나에 배정, 소유자 알림 쿨다운, `__proto__` 키와 Error 값 유지, 모든 플랫폼에서 npm 설치가 다시 동작하도록 수정(v2.46.6), 대기·큐 실행의 재개 시도 한도(v2.46.7). ([#42270](https://github.com/n8n-io/n8n/issues/42270), [#42400](https://github.com/n8n-io/n8n/issues/42400), [#42567](https://github.com/n8n-io/n8n/issues/42567), [#42806](https://github.com/n8n-io/n8n/issues/42806), [#42805](https://github.com/n8n-io/n8n/issues/42805), [#43035](https://github.com/n8n-io/n8n/issues/43035), [#42862](https://github.com/n8n-io/n8n/issues/42862))
- v2.47.1~v2.47.7 (11-04~11-13): 보관된 워크플로를 마이그레이션 리포트에서 숨김, 편집 가능한 사용자만 마이그레이션 발견 항목 소유(v2.47.3), 만료 예약 작업을 반복 배치로 정리, 표현식 이전 뒤 전송 유지, 읽기 전용 자격 증명 노드 편집을 Public API에서 거부(v2.47.5), 신뢰 소스 캐시 키를 Redis 클러스터 슬롯 하나에 유지(v2.47.6), 전역 자격 증명 실행의 마스킹 해제(v2.47.7). ([#42994](https://github.com/n8n-io/n8n/issues/42994), [#43101](https://github.com/n8n-io/n8n/issues/43101), [#43096](https://github.com/n8n-io/n8n/issues/43096), [#43360](https://github.com/n8n-io/n8n/issues/43360), [#43555](https://github.com/n8n-io/n8n/issues/43555), [#43627](https://github.com/n8n-io/n8n/issues/43627), [#43776](https://github.com/n8n-io/n8n/issues/43776))
- v2.48.1~v2.48.4 (11-11~11-13): 표현식 엔진 간 노드 참조 일치와 전송 유지, 읽기 전용 자격 증명 노드 편집 거부, 캐시 필드를 거부하는 엔드포인트에서 에이전트 프롬프트 캐싱 끄기, 전역 자격 증명 실행의 마스킹 해제(v2.48.4). ([#43357](https://github.com/n8n-io/n8n/issues/43357), [#43359](https://github.com/n8n-io/n8n/issues/43359), [#43554](https://github.com/n8n-io/n8n/issues/43554), [#43672](https://github.com/n8n-io/n8n/issues/43672), [#43775](https://github.com/n8n-io/n8n/issues/43775))
- v3.0.1·v3.2.2 (10-28·11-13): v3.0.1은 `ExpressionError` 이름 유지, QuickJS 표현식 결과의 undefined 값 유지, 에디터 첫 로드 속도 개선을 담았습니다. ([#42309](https://github.com/n8n-io/n8n/issues/42309), [#42264](https://github.com/n8n-io/n8n/issues/42264), [#41987](https://github.com/n8n-io/n8n/issues/41987))
- LTS v1.123.84~v1.123.97 (10-08~11-16): SQLite 쓰기 연결 열기 실패 시 쓰기 락 해제와 task runner의 certifi 2026.10.23 반영(v1.123.88), Google Drive 노드 v1 페이지네이션 무한 루프와 MCP Server Trigger 유휴 세션 정리(v1.123.89), 초대 수락에 서명된 토큰 요구(v1.123.90), 레거시 Code 노드 출력의 `$('Node')` 표현식 null 수정(v1.123.91), 대기·큐 실행 재개 시도 한도(v1.123.93), 트리거 재활성화 직후 실패 시 재시도 백오프 유지(v1.123.94), `@modelcontextprotocol/sdk` 업데이트(v1.123.96). ([#41918](https://github.com/n8n-io/n8n/issues/41918), [#41995](https://github.com/n8n-io/n8n/issues/41995), [#42124](https://github.com/n8n-io/n8n/issues/42124), [#42120](https://github.com/n8n-io/n8n/issues/42120), [#42292](https://github.com/n8n-io/n8n/issues/42292), [#42249](https://github.com/n8n-io/n8n/issues/42249), [#42864](https://github.com/n8n-io/n8n/issues/42864), [#43178](https://github.com/n8n-io/n8n/issues/43178), [#43527](https://github.com/n8n-io/n8n/issues/43527))
> 전체 변경 내역은 각 버전의 GitHub Release 노트에서 확인하실 수 있습니다(하단 참조 링크).

### 보안 관련 수정 정리

보안에 영향이 있는 항목을 골라 정리했으며, 이번 기간 릴리즈 노트에 CVE 번호가 명시된 항목은 없습니다.

- 초대 수락 (v1.123.90): 초대를 수락할 때 서명된 토큰을 요구합니다. ([#42292](https://github.com/n8n-io/n8n/issues/42292))
- 실행 데이터 접근 (v2.45.7·v2.46.0·v2.47.0): 워크플로 범위 라우트가 실행 데이터를 읽을 때 `execution:read`를 요구하고, 이 권한이 없으면 재시도 응답에서 실행 데이터를 뺍니다. 프로젝트 스코프가 폴더 목록과 MCP 인스턴스 컨텍스트 요약에도 적용됩니다. ([#42446](https://github.com/n8n-io/n8n/issues/42446), [#41871](https://github.com/n8n-io/n8n/issues/41871), [#42171](https://github.com/n8n-io/n8n/issues/42171), [#42173](https://github.com/n8n-io/n8n/issues/42173))
- 실행 데이터 마스킹 (v2.45.0~v2.49.0): 부모·하위 워크플로, Assistant, MCP 오류, 로그 스트리밍·텔레메트리·오류 보고에 마스킹을 적용하고 인증 헤더는 대소문자 구분 없이 가립니다. 전역 자격 증명 실행은 마스킹 대상에서 빠집니다(v2.47.7, v2.48.4, v2.49.0).
- 입력 검증 (v2.43.5·v2.43.6): `chunk()` 표현식 확장의 크기 인수를 검증하고, 웹훅 요청 본문마다 XML 파서를 새로 만듭니다. ([#40911](https://github.com/n8n-io/n8n/issues/40911), [#41113](https://github.com/n8n-io/n8n/issues/41113))
- 토큰·인증 (v2.45.0~v2.49.0): 폐기된 액세스 토큰 거부, OAuth 인가 요청의 세션 분리, Jira Cloud 웹훅 서명 토큰 검증, Workable·Mailchimp·Venafi 웹훅 서명 검증이 추가되었습니다. Public API는 읽기 전용 자격 증명 노드 편집을 거부합니다(v2.47.5, v2.48.2). ([#41266](https://github.com/n8n-io/n8n/issues/41266), [#39930](https://github.com/n8n-io/n8n/issues/39930), [#42800](https://github.com/n8n-io/n8n/issues/42800), [#43555](https://github.com/n8n-io/n8n/issues/43555), [#43554](https://github.com/n8n-io/n8n/issues/43554))
- 의존성 (v1.123.86·v1.123.88·v1.123.96·2.x): LTS에서 sharp 0.35.5, certifi 2026.10.23, `@modelcontextprotocol/sdk` 업데이트가 반영되었습니다. ([#41995](https://github.com/n8n-io/n8n/issues/41995), [#43527](https://github.com/n8n-io/n8n/issues/43527))

---

## 마이그레이션 및 운영 체크리스트

2.x 라인의 업그레이드 영향과 3.0 대비 항목을 함께 정리했습니다. 3.0 항목의 상세는 위 「n8n 3.0 업그레이드 주의사항」에 있습니다.

- [ ] 3.x 적용 여부 결정: v3.0.0~v3.3.0은 GitHub prerelease이며 공식 문서상 얼리 액세스입니다. stable 태그는 v2.48.4, beta 태그는 v2.49.0입니다. 프로덕션 인스턴스는 stable 라인을 유지하고, 3.x는 사전 검증용으로 쓰는 편이 안전합니다.
- [ ] 마이그레이션 리포트 실행: Settings > Migration Report에서 영향받는 워크플로와 인스턴스 설정을 확인하고, 영향 단계가 Upgrade blocked와 Executions will fail인 항목부터 처리합니다. 관리자는 소유자 알림과 CSV 내보내기를 쓸 수 있습니다.
- [ ] 배포 방식 점검: `npm` 또는 `npx n8n`으로 운영하는 인스턴스는 3.0 전에 Docker 기반 배포로 옮겨야 합니다.
- [ ] 제거 노드 점검: Function, Function Item, Item Lists, Cron, Interval, Workflow Trigger, 레거시 OpenAI 노드 등 제거 대상 노드를 쓰는 워크플로를 대체 노드로 바꿉니다. v2.45.0부터 제거 노드의 자동 마이그레이션이 일부 제공됩니다.
- [ ] Slack Trigger 자격 증명 점검: Slack Trigger 노드를 쓰는 워크플로는 Slack API 자격 증명에 서명 시크릿을 넣고 다시 게시해야 합니다.
- [ ] 환경 변수 점검: `N8N_PRE_EXECUTE_ERROR_CREATES_EXECUTION`, `OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS`, `N8N_DB_PING_TIMEOUT`, `N8N_WORKFLOW_TAGS_DISABLED`, `N8N_MIGRATE_FS_STORAGE_PATH` 설정 여부를 확인하고, `N8N_UNVERIFIED_PACKAGES_ENABLED`, `N8N_RUNNERS_TASK_TIMEOUT`, `N8N_DEFAULT_BINARY_DATA_MODE`, Compression 노드 한도 변수는 값을 명시합니다.
- [ ] 볼륨 마운트 점검: `~/.n8n/binaryData`에 볼륨을 마운트했다면 `~/.n8n/storage`로 바꾸거나 `N8N_STORAGE_PATH`를 지정하고, 두 디렉터리가 함께 존재하지 않는지 확인합니다.
- [ ] Chat Hub 사용 여부 확인: 쓰고 있다면 `N8N_ENABLED_MODULES`에 `chat-hub`를 추가해야 하며, 이는 3.x 라인에 한정됩니다.
- [ ] 노드·자격 증명 유형 정책 확인: v2.45.0부터 유형 정책이 기본으로 켜졌습니다. 제한된 노드가 들어 있는 워크플로와 소스 컨트롤 pull에서 차단되는 항목을 확인합니다.
- [ ] 폐기 노드 포함 워크플로 정리: v2.42.6, v2.43.3 이후 폐기 노드가 있는 워크플로는 생성·수정이 차단됩니다.
- [ ] 마스킹 동작 확인: 하위 워크플로나 사용할 수 없는 자격 증명으로 인해 부모 실행이 마스킹될 수 있습니다. 실행 조회 권한 `execution:read`가 필요한 경로도 늘었으므로 실행 데이터를 조회하는 자동화는 권한을 점검합니다.
- [ ] 내구 스케줄러 기본 활성화 확인: v2.45.0부터 내구 스케줄러가 기본입니다. 스케줄 트리거가 많은 인스턴스는 업그레이드 뒤 실행 시각을 확인합니다.
- [ ] 이름 변경 반영: Azure OpenAI Chat Model 노드·자격 증명은 Microsoft Foundry로, Paddle 노드는 Paddle Classic으로 이름이 바뀌었습니다. 사내 문서와 노드 검색 키워드를 갱신합니다.
- [ ] Public API 변경 확인: 패키지 내보내기의 `includeArchivedWorkflows`가 `includeArchived`(CLI는 `--include-archived`)로 바뀌었고 이전 이름은 별칭 없이 400 응답이 반환되므로 기존 호출을 점검합니다.
- [ ] 채널 태그 재확인: 이 노트의 채널 상태는 2026-11-17 기준입니다. 적용 시점에 stable·beta 태그를 다시 확인해야 합니다.

---

## 참조 링크 및 버전 정보

| 버전                  | 릴리즈 날짜           | 유형                                                                                     | Release Notes                                                       |
| ------------------- | ---------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| v2.44.0             | 2026-10-13       | Minor (prerelease)                                                                     | [GitHub](https://github.com/n8n-io/n8n/releases/tag/n8n%402.44.0)   |
| v2.45.0             | 2026-10-20       | Minor (prerelease)                                                                     | [GitHub](https://github.com/n8n-io/n8n/releases/tag/n8n%402.45.0)   |
| v2.46.0             | 2026-10-27       | Minor (prerelease)                                                                     | [GitHub](https://github.com/n8n-io/n8n/releases/tag/n8n%402.46.0)   |
| v2.47.0             | 2026-11-03       | Minor (prerelease)                                                                     | [GitHub](https://github.com/n8n-io/n8n/releases/tag/n8n%402.47.0)   |
| v2.48.0             | 2026-11-10       | Minor (prerelease)                                                                     | [GitHub](https://github.com/n8n-io/n8n/releases/tag/n8n%402.48.0)   |
| v2.49.0             | 2026-11-17       | Minor (prerelease, beta 태그)                                                            | [GitHub](https://github.com/n8n-io/n8n/releases/tag/n8n%402.49.0)   |
| v3.0.0              | 2026-10-27       | Minor (prerelease, 얼리 액세스)                                                             | [GitHub](https://github.com/n8n-io/n8n/releases/tag/n8n%403.0.0)    |
| v3.0.1              | 2026-10-28       | Patch (prerelease)                                                                     | [GitHub](https://github.com/n8n-io/n8n/releases/tag/n8n%403.0.1)    |
| v3.1.0              | 2026-11-03       | Minor (prerelease)                                                                     | [GitHub](https://github.com/n8n-io/n8n/releases/tag/n8n%403.1.0)    |
| v3.2.0              | 2026-11-10       | Minor (prerelease)                                                                     | [GitHub](https://github.com/n8n-io/n8n/releases/tag/n8n%403.2.0)    |
| v3.2.2              | 2026-11-13       | Patch (prerelease, 유지보수 릴리즈)                                                           | [GitHub](https://github.com/n8n-io/n8n/releases/tag/n8n%403.2.2)    |
| v3.3.0              | 2026-11-17       | Minor (prerelease)                                                                     | [GitHub](https://github.com/n8n-io/n8n/releases/tag/n8n%403.3.0)    |
| v2.42.5~v2.43.8     | 2026-10-08~10-19 | Patch                                                                                  | [GitHub](https://github.com/n8n-io/n8n/releases/tag/n8n%402.43.8)   |
| v2.44.1~v2.44.7     | 2026-10-14~10-26 | Patch                                                                                  | [GitHub](https://github.com/n8n-io/n8n/releases/tag/n8n%402.44.7)   |
| v2.45.1~v2.45.7     | 2026-10-21~10-30 | Patch                                                                                  | [GitHub](https://github.com/n8n-io/n8n/releases/tag/n8n%402.45.7)   |
| v2.46.1~v2.46.7     | 2026-10-28~11-09 | Patch                                                                                  | [GitHub](https://github.com/n8n-io/n8n/releases/tag/n8n%402.46.7)   |
| v2.47.1~v2.47.7     | 2026-11-04~11-13 | Patch                                                                                  | [GitHub](https://github.com/n8n-io/n8n/releases/tag/n8n%402.47.7)   |
| v2.48.1~v2.48.4     | 2026-11-11~11-13 | Patch (v2.48.4는 stable 태그)                                                             | [GitHub](https://github.com/n8n-io/n8n/releases/tag/n8n%402.48.4)   |
| v1.123.84~v1.123.97 | 2026-10-08~11-16 | LTS Patch (v1.123.84, v1.123.85, v1.123.87, v1.123.92, v1.123.95, v1.123.97은 유지보수 릴리즈) | [GitHub](https://github.com/n8n-io/n8n/releases/tag/n8n%401.123.97) |

- n8n 릴리즈 노트 전체: [https://docs.n8n.io/release-notes/](https://docs.n8n.io/release-notes/)
- n8n v3.0 Breaking changes: [https://docs.n8n.io/changelog/v30-breaking-changes.md](https://docs.n8n.io/changelog/v30-breaking-changes.md)
- n8n v3.0 Migration tool: [https://docs.n8n.io/changelog/v30-migration-tool.md](https://docs.n8n.io/changelog/v30-migration-tool.md)
- n8n GitHub Releases: [https://github.com/n8n-io/n8n/releases](https://github.com/n8n-io/n8n/releases)

::faq::

- q: 이번 기간 n8n의 핵심 변경은 무엇인가요?

a: 2.x 라인(v2.44.0~v2.49.0)에서는 WhatsApp, Microsoft Teams, Slack, 웹훅 에이전트 채널과 예산 알림·도구 가드레일이 추가되었습니다. n8n Assistant의 Apps 모듈, Promotions 모듈 기본 로드와 노드·자격 증명 유형 정책 기본 활성화, 실행 데이터 마스킹 확대도 포함됩니다. 3.x 라인에서는 v3.0.0~v3.3.0이 얼리 액세스로 공개되었습니다.

- q: n8n 3.0으로 지금 올려도 되나요?

a: 프로덕션 인스턴스는 stable 라인을 유지하고 3.x는 사전 검증용으로 쓰는 편이 안전합니다. v3.0.0~v3.3.0은 GitHub에 prerelease로 표시되어 있고 n8n 공식 문서도 얼리 액세스 릴리즈로 안내하며, 2026-11-17 기준 stable 태그는 v2.48.4입니다. 올리기 전에 Settings > Migration Report에서 영향받는 워크플로와 인스턴스 설정을 확인합니다.

- q: 3.0 업그레이드 전에 어떤 브레이킹 체인지를 점검해야 하나요?

a: 자체 호스팅은 Docker 기반 배포가 필수이므로 `npm` 또는 `npx n8n`으로 운영한다면 먼저 옮겨야 합니다. Function·Item Lists 같은 제거 노드를 쓰는 워크플로는 대체 노드로 바꿔야 하고, Slack Trigger 노드를 쓰는 워크플로는 Slack API 자격 증명의 Signature Secret 필드에 서명 시크릿을 넣어야 합니다. `~/.n8n/binaryData`가 `~/.n8n/storage`로 바뀌는 점과 환경 변수 기본값 변경도 점검 대상입니다.

::faq-end::

::button::[에이전트 채널 확장과 n8n 3.0 얼리 액세스 브레이킹 체인지를 함께 점검해야 한다면 n8n 공식 파트너 인포그랩과 상담하세요](https://insight.infograb.net/contact/)::

본 콘텐츠는 n8n Release Note의 [영문 원본](https://github.com/n8n-io/n8n/releases)을 한국어로 번역하고 재구성한 것으로 인포그랩은 n8n의 한국 공식 파트너사입니다.

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