n8n 패키지

n8n 패키지를 사용하여 n8n 인스턴스에서 콘텐츠를 내보내고 가져오는 방법을 설명합니다

Warning 베타 n8n 패키지 형식과 API는 아직 개발 중입니다. 주 버전(major version) 변경 없이도 호환성이 깨지는 변경이 발생할 수 있습니다. 메인 n8n 리포지터리의 GitHub 이슈를 통한 피드백을 환영합니다. 패키지는 워크플로와 해당 의존성을 설명하는 매니페스트 파일을 함께 묶은 "스냅샷" tar 파일로, npm 패키지와 비슷합니다. 한 n8n 인스턴스에서 패키지를 내보내 다른 인스턴스로 가져올 수 있습니다. n8n 인스턴스의 Public API 를 통해, 또는 동일한 Public API 엔드포인트를 감싸는 n8n CLI를 통해 n8n 패키지를 가져오고 내보낼 수 있습니다. 알려진 제한 사항 # 다음 항목은 아직 n8n 패키지에서 지원되지 않습니다: 서브 워크플로 오류 워크플로 데이터 테이블 폴더 프로젝트 이러한 항목에 대한 지원을 추가하기 위해 작업 중입니다. 패키지에 포함되는 내용 # 패키지는 확장자가 .n8np 인 tar 파일입니다. 여기에는 manifest.json 과 내보낸 워크플로, 그리고 해당 워크플로가 사용하는 자격 증명이 함께 포함됩니다. n8n은 자격 증명의 비밀 값을 패키지에 절대 포함하지 않습니다. 대신 자격 증명의 ID, 이름, 유형으로 이루어진 스텁을 내보내므로, 대상 인스턴스의 자격 증명과 매칭할 수 있습니다. 콘텐츠 개요 # .n8np 아카이브의 압축을 풀면 manifest.json 파일과 workflows 디렉터리가 포함된 디렉터리를 얻습니다. n8n은 내보낸 워크플로마다 하위 디렉터리를 하나씩 생성하며, 각 하위 디렉터리에는 해당 워크플로의 노드, 연결, 설정이 담긴 workflow.json 파일이 들어 있습니다: export/ ├── manifest.json └── workflows/ ├── marketing-agent/ │ └── workflow.json └── personal-ai-assistant/ └── workflow.json manifest.json 파일은 패키지의 내용을 다음과 같이 설명합니다: packageFormatVersion : 패키지 형식의 버전입니다. exportedAt : n8n이 패키지를 생성한 타임스탬프입니다. sourceN8nVersion : 패키지를 내보낸 n8n의 버전입니다. sourceId : 패키지를 내보낸 n8n 인스턴스의 식별자입니다. workflows : 내보낸 워크플로 목록으로, 각 항목에는 id , name , target ( workflows 하위의 디렉터리 경로)이 포함됩니다. requirements.credentials : 내보낸 워크플로가 사용하는 자격 증명 목록입니다. 각 항목에는 자격 증명의 id , name , type 이 있으며, 해당 자격 증명을 사용하는 워크플로들의 ID( usedByWorkflows )를 나열합니다. n8n은 자격 증명의 비밀 값을 패키지에 포함하지 않습니다. 사용 사례 # 인스턴스 간에 워크플로를 반복 가능하고 자동화된 방식으로 이동해야 할 때 n8n 패키지를 사용하세요. 일반적인 시나리오는 다