문제 해결 및 오류

커뮤니티 노드 사용 시 발생할 수 있는 문제 해결 및 오류 대응 방법을 설명합니다.

오류: 패키지 누락 # n8n은 커뮤니티 노드를 하드 디스크에 직접 설치합니다. n8n이 이를 로드하려면 시작 시 파일이 사용 가능한 상태여야 합니다. 시작 시 패키지를 사용할 수 없으면 패키지 누락을 경고하는 오류가 발생합니다. Docker를 사용해 n8n을 실행하는 경우: Docker 설정에 따라 컨테이너를 재생성하거나 n8n 버전을 업그레이드할 때 패키지가 사라질 수 있습니다. 다음 중 하나를 반드시 수행해야 합니다: ~/.n8n/nodes 디렉터리의 콘텐츠를 유지합니다. 이것이 가장 좋은 방법입니다. Docker 설치 가이드를 따르면 설치 단계에 이 디렉터리를 유지하는 과정이 포함됩니다. N8N_REINSTALL_MISSING_PACKAGES 환경 변수를 true 로 설정합니다. 두 번째 옵션은 시작 시간을 늘릴 수 있고 상태 확인(health check)이 실패하는 원인이 될 수 있습니다. n8n cloud에서 커뮤니티 노드 로드 방지 # n8n cloud 인스턴스가 크래시되어 시작하지 못하는 경우, 인스턴스 시작 시 설치된 커뮤니티 노드가 로드되지 않도록 방지할 수 있습니다. Cloud Admin Panel > Manage 로 이동하여 Disable all community nodes 토글을 ** true **로 전환합니다. 이 토글은 커뮤니티 노드 설치를 허용한 경우에만 표시됩니다.