커뮤니티 노드 제작하기

커뮤니티 노드를 직접 제작하고 제출하는 방법을 안내합니다.

커뮤니티 노드는 npm 레지스트리에 호스팅되는 npm 패키지입니다. 커뮤니티 노드 저장소에 제출할 노드를 빌드할 때, 노드 설정이 올바른지 확인하려면 다음 리소스를 활용하세요: n8n은 노드 빌드 및 테스트를 위해 n8n-node CLI 도구 를 사용하도록 권장합니다. 특히 검증을 위해 노드를 제출 할 계획이라면 중요합니다. 이 도구는 노드가 올바른 구조를 갖추고 커뮤니티 노드 요구사항을 충족하도록 보장합니다. 또한 린팅과 테스트를 단순화합니다. 노드에서 사용할 수 있는 패턴 예시는 n8n의 자체 노드 를 참고하세요. 자체 노드 빌드 문서를 참고하세요. 노드가 커뮤니티 노드의 표준 을 따르는지 확인하세요. 표준 # n8n-node 도구 로 개발하면 노드가 n8n 커뮤니티 노드 저장소에서 사용 가능하도록 요구되는 다음 표준을 준수하게 됩니다: 패키지 이름이 n8n-nodes- 또는 @<scope>/n8n-nodes- 로 시작하는지 확인하세요. 예: n8n-nodes-weather 또는 @weatherPlugins/n8n-nodes-weather . 패키지 키워드에 n8n-community-node-package 를 포함하세요. package.json 파일의 n8n 속성 내에 노드와 자격증명을 추가했는지 확인하세요. 린터( npm run lint )로 노드를 확인하고 로컬에서 테스트( npm run dev )하여 작동하는지 확인하세요. 패키지를 npm에 배포하세요. n8n Creator Portal 을 통해 검증을 위해 노드를 제출할 계획이라면 출처 명세서 를 사용하여 GitHub Actions 워크플로우로 배포해야 합니다. 아래 npm에 배포하기 를 참고하세요. npm에 배포하기 # Creator Portal 검증을 위한 필수 요건 2026년 5월 1일부터 검증을 위해 제출되는 노드는 출처 명세서 를 사용하여 GitHub Actions 워크플로우로 배포되어야 합니다. n8n은 로컬 머신에서 직접 배포된 검증 노드는 수락하지 않습니다. n8n Creator Portal을 통해 노드를 검증 제출하려면 출처 명세서가 포함된 GitHub Actions 워크플로우를 사용하여 배포하세요. 출처는 특정 워크플로우가 특정 저장소와 커밋에서 패키지를 빌드했음을 암호화 방식으로 검증할 수 있도록 합니다. GitHub Actions는 OIDC 인프라를 사용하여 출처 명세서에 서명합니다. 신규 노드 # npm create @n8n/node 로 노드를 스캐폴딩하면 즉시 사용 가능한 publish.yml 워크플로우가 포함됩니다. 로컬에서 npm run release 를 실행하여 버전을 올리고, 커밋, 태그 지정 및 푸시합니다. 이렇게 하면 npm에 배포하는 워크플로우가 트리거됩니다. 기존 노드 # n8n-nodes-starter의 배포 워크플로우 를 저장소의 .github/workflows/publish.yml 에 추가하세요. 또한 프로젝트에 @n8n/node-cli 버전 0.23.0 이상이 devDependency 로 있는지 확인하세요. 이전 버전은 워