GUI 설치
n8n v2.29Owner 및 Admin 사용자만 가능 Owner 또는 Admin 역할을 가진 사용자만 셀프 호스팅된 n8n 인스턴스에서 npm의 커뮤니티 노드를 설치하고 관리할 수 있습니다. npm에서 커뮤니티 노드를 설치하려면 다음을 따르세요.
Owner 및 Admin 사용자만 가능
Owner 또는 Admin 역할을 가진 사용자만 셀프 호스팅된 n8n 인스턴스에서 npm의 커뮤니티 노드를 설치하고 관리할 수 있습니다. 인스턴스 소유자는 사용자 관리를 설정하고 관리하는 사람입니다.
커뮤니티 노드 설치하기#
npm에서 커뮤니티 노드를 설치하려면 다음을 따르세요.
-
Settings > Community Nodes로 이동합니다.
-
Install을 선택합니다.
-
설치할 노드를 찾습니다.
- Browse를 선택합니다. n8n은
n8n-community-node-package키워드로 태그된 모든 npm 패키지를 보여주는 npm 검색 결과 페이지로 이동합니다. - 결과 목록을 살펴봅니다. 결과를 필터링하거나 키워드를 추가할 수 있습니다.
- 원하는 패키지를 찾으면 패키지 이름을 기록해 둡니다. 특정 버전을 설치하려면 버전 번호도 함께 기록해 둡니다.
- n8n으로 돌아갑니다.
- Browse를 선택합니다. n8n은
-
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든 사용할 수 있습니다.
Dist-tag는 설치 시점에 한 번만 해석됩니다
dist-tag를 사용하여 패키지를 설치하면, n8n은 그 시점의 현재 버전으로 태그를 해석합니다. 이후 업데이트는 dist-tag를 따르지 않습니다. 예를 들어
n8n-node-storms@beta를 설치하고beta가 버전2.0.0-beta.1을 가리키는 경우, n8n은 해당 특정 버전을 설치합니다. 이후 업데이트는beta태그가 아니라 설치된 semver 버전을 기준으로 비교합니다. - n8n-node-weather라는 패키지의 최신 버전을 설치하려면 Enter npm package name에
-
커뮤니티 노드 사용에 따른 위험에 동의합니다. **I understand the risks of installing unverified code from a public source.**를 선택합니다.
-
Install을 선택합니다. n8n이 노드를 설치하고 Settings의 Community Nodes 목록으로 돌아갑니다.
커뮤니티 노드 제거하기#
커뮤니티 노드를 제거하려면 다음을 따르세요.
- Settings > Community nodes로 이동합니다.
- 설치하려는 노드에서 Options
를 선택합니다. - Uninstall package를 선택합니다.
- 확인 모달에서 Uninstall Package를 선택합니다.
커뮤니티 노드 업그레이드하기#
버전 간 호환성이 깨지는 변경사항(Breaking changes)
노드 개발자는 새 버전의 노드에서 호환성이 깨지는 변경사항을 도입할 수 있습니다. 호환성이 깨지는 변경사항이란 이전 기능을 손상시키는 업데이트를 말합니다. 노드 개발자가 선택한 노드 버전 관리 방식에 따라, 호환성이 깨지는 변경사항이 있는 버전으로 업그레이드하면 해당 노드를 사용하는 모든 워크플로가 손상될 수 있습니다. 노드를 업그레이드할 때는 주의하세요. 업그레이드로 인해 문제가 발생한다면 다운그레이드할 수 있습니다.
### 최신 버전으로 업그레이드하기
Settings > community nodes의 노드 목록에서 커뮤니티 노드를 최신 버전으로 업그레이드할 수 있습니다.
커뮤니티 노드의 새 버전을 사용할 수 있게 되면, n8n은 해당 노드에 Update 버튼을 표시합니다. 이 버튼을 클릭하면 최신 버전으로 업그레이드됩니다.
특정 버전으로 업그레이드하기#
특정 버전(최신 버전이 아닌 버전)으로 업그레이드하려면 노드를 제거한 다음, 대상 버전을 정확히 지정하여 다시 설치합니다. 자세한 안내는 설치 지침을 참고하세요.
커뮤니티 노드 다운그레이드하기#
커뮤니티 노드의 특정 버전에 문제가 있는 경우, 이전 버전으로 롤백하고 싶을 수 있습니다.
이렇게 하려면 커뮤니티 노드를 제거한 다음, 특정 노드 버전을 대상으로 다시 설치합니다. 자세한 안내는 설치 지침을 참고하세요.