n8n 앱에서 npm으로 커뮤니티 노드 설치
n8n v2.25셀프 호스팅 n8n 인스턴스에서 npm을 통해 커뮤니티 노드를 설치하고 관리할 수 있는 권한은 Owner 또는 Admin 역할의 사용자에게만 부여됩니다. npm에서 커뮤니티 노드를 설치하려면 다음 단계를 따르세요: dist-tag를 사용하여 패키지를 설치할 때, n8n은 해당 시점의 현재 버전으로 태그를 확인합니다.
셀프 호스팅 n8n 인스턴스에서 npm을 통해 커뮤니티 노드를 설치하고 관리할 수 있는 권한은 Owner 또는 Admin 역할의 사용자에게만 부여됩니다. 인스턴스 소유자는 사용자 관리를 설정하고 운영하는 사람입니다.
커뮤니티 노드 설치#
npm에서 커뮤니티 노드를 설치하려면 다음 단계를 따르세요:
- Settings > Community Nodes로 이동합니다.
- Install을 선택합니다.
- 설치할 노드를 찾습니다:
- Browse를 선택합니다. n8n이 npm 검색 결과 페이지로 이동하며,
n8n-community-node-package키워드로 태그된 모든 npm 패키지가 표시됩니다. - 결과 목록을 탐색합니다. 결과를 필터링하거나 키워드를 추가할 수 있습니다.
- 원하는 패키지를 찾으면 패키지 이름을 메모해 둡니다. 특정 버전을 설치하려면 버전 번호도 메모해 둡니다.
- n8n으로 돌아옵니다.
- Browse를 선택합니다. n8n이 npm 검색 결과 페이지로 이동하며,
- npm 패키지 이름을 입력하고, 선택적으로 버전 번호 또는 dist-tag를 입력합니다. 예를 들어, "Storms"라는 날씨 API에 접근하는 커뮤니티 노드를 고려해 봅시다. 패키지 이름은 n8n-node-storms이며, 세 가지 주요 버전이 있습니다.
- n8n-node-weather라는 패키지의 최신 버전을 설치하려면: Enter npm package name에
n8n-nodes-storms를 입력합니다. - 버전 2.3을 설치하려면: Enter npm package name에
n8n-node-storms@2.3을 입력합니다. beta와 같은 dist-tag에서 설치하려면: Enter npm package name에n8n-node-storms@beta를 입력합니다. 패키지 작성자가 게시한beta,next,latest와 같은 npm dist-tag를 사용할 수 있습니다.
- n8n-node-weather라는 패키지의 최신 버전을 설치하려면: Enter npm package name에
dist-tag를 사용하여 패키지를 설치할 때, n8n은 해당 시점의 현재 버전으로 태그를 확인합니다. 이후 업데이트는 dist-tag를 따르지 않습니다. 예를 들어, n8n-node-storms@beta를 설치하고 beta가 버전 2.0.0-beta.1을 가리키는 경우, n8n은 해당 특정 버전을 설치합니다. 이후 업데이트는 beta 태그가 아닌 설치된 semver 버전과 비교합니다.
<!-- vale off -->
5. 커뮤니티 노드 사용의 위험성에 동의합니다: **I understand the risks of installing unverified code from a public source.**를 선택합니다. 6. Install을 선택합니다. n8n이 노드를 설치하고 Settings의 Community Nodes 목록으로 돌아갑니다.
n8n은 설치를 차단하는 커뮤니티 노드 차단 목록을 유지 관리합니다. 자세한 내용은 n8n 커뮤니티 노드 차단 목록을 참조하세요.
커뮤니티 노드 제거#
커뮤니티 노드를 제거하려면 다음 단계를 따르세요:
- Settings > Community nodes로 이동합니다.
- 제거할 노드에서 Options
를 선택합니다. - Uninstall package를 선택합니다.
- 확인 모달에서 Uninstall Package를 선택합니다.
커뮤니티 노드 업그레이드#
노드 개발자는 새 버전에서 호환성을 깨는 변경을 도입할 수 있습니다. 호환성을 깨는 변경은 이전 기능을 손상시키는 업데이트입니다. 노드 개발자가 선택한 노드 버전 관리 방식에 따라, 호환성을 깨는 변경이 포함된 버전으로 업그레이드하면 해당 노드를 사용하는 모든 워크플로가 중단될 수 있습니다. 노드를 업그레이드할 때는 주의하세요. 업그레이드로 인해 문제가 발생하면 다운그레이드할 수 있습니다.
최신 버전으로 업그레이드#
Settings > community nodes의 노드 목록에서 커뮤니티 노드를 최신 버전으로 업그레이드할 수 있습니다.
새 버전의 커뮤니티 노드가 사용 가능하면, n8n이 해당 노드에 Update 버튼을 표시합니다. 버튼을 클릭하면 최신 버전으로 업그레이드됩니다.
특정 버전으로 업그레이드#
특정 버전(최신 버전이 아닌 다른 버전)으로 업그레이드하려면, 노드를 제거한 후 타깃 버전을 지정하여 다시 설치합니다. 자세한 안내는 설치 지침을 따르세요.
커뮤니티 노드 다운그레이드#
특정 버전의 커뮤니티 노드에 문제가 있는 경우, 이전 버전으로 롤백할 수 있습니다.
이를 위해 커뮤니티 노드를 제거한 후, 특정 노드 버전을 타깃으로 지정하여 다시 설치합니다. 자세한 안내는 설치 지침을 따르세요.