n8n 3.0 호환성을 깨는 변경

n8n 3.0에 적용될 호환성을 깨는 변경

이 문서는 2026년 10월 예정인 n8n 3.0 전환에 대비해 알아야 할 호환성을 깨는 변경과 필요한 조치를 안내합니다. 이번 업데이트는 보안을 강화하고, 구성을 단순화하며, 레거시 기능을 제거합니다. n8n 3.0 릴리즈는 안전하고 신뢰할 수 있으며 프로덕션에 적합한 자동화 플랫폼을 제공하겠다는 n8n의 노력을 이어가는 버전입니다. 이 메이저 버전에는 중요한 보안 개선과 사용 중단 예정 기능의 정리가 포함됩니다. 배포 # 셀프 호스팅 n8n에는 Docker 기반 배포 필요 # 셀프 호스팅 n8n에는 Docker 기반 배포가 필요합니다. n8n 3.0은 npm 또는 npx n8n 으로 실행하는 설치 방식을 더 이상 지원하지 않습니다. 해야 할 일: npm 또는 npx n8n 으로 n8n을 실행하고 있다면, n8n 3.0으로 업그레이드하기 전에 Docker 기반 배포로 이전할 계획을 세우세요. 로컬 설치라면 Docker Compose가 가장 간단한 방법이 될 것으로 예상됩니다. 단계별 마이그레이션 가이드는 곧 공개될 예정입니다. 커뮤니티 노드 개발 # 이 변경은 n8n-node dev 의 테스트 루프에만 적용됩니다. n8n-node build , n8n-node lint , n8n-node release , npm create @n8n/node 는 변경되지 않습니다. n8n-node dev에 Docker 또는 Podman 필요 # n8n-node dev 는 기존에 npx n8n@latest 로 n8n을 시작했습니다. n8n 3.0은 npm에 실행 가능한 n8n 패키지를 게시하지 않으므로, 이 명령은 이제 컨테이너에서 공식 이미지를 실행합니다. 해야 할 일: Docker 또는 Podman을 설치하세요. n8n을 직접 실행하려면 n8n-node dev --external-n8n 을 사용하고 해당 인스턴스를 N8N_DEV_RELOAD=true 로 시작하세요. n8n 버전을 고정하려면 태그를 지정하세요. n8n-node dev --n8n-image docker.n8n.io/n8nio/n8n:<n8n-version> . 핫 리로드는 POST /rest/dev/reload 를 제공하는 이미지에서만 작동하므로, 이전 태그에서는 노드가 로드되지만 변경 사항을 적용하려면 다시 시작해야 합니다. n8n-node dev 테스트 데이터가 이미지별 컨테이너 볼륨으로 이동 # 노드를 테스트하면서 만든 워크플로와 크리덴셜은 이제 ~/.n8n-node-cli/.n8n 이 아니라 n8n-node-cli-data-<image> 컨테이너 볼륨에 저장됩니다. 이전 버전의 데이터는 넘어오지 않습니다. n8n은 데이터베이스를 앞으로만 마이그레이션하므로 --n8n-image 마다 별도 볼륨이 할당됩니다. 이미지를 바꾸면 이전 n8n이 읽을 수 없는 데이터베이스 대신 빈 인스턴스가 생깁니다. 해야 할 일: 업그레이드하거나 이미지를 변경하기 전에 보관하려는 테스트 워크플로를 내보내세요. 볼륨을 나열하고 재설정하려면 docker volume ls --filter n