InfoGrab DocsInfoGrab Docs

GUI 설치

요약

Owner 및 Admin 사용자만 가능 Owner 또는 Admin 역할을 가진 사용자만 셀프 호스팅된 n8n 인스턴스에서 npm의 커뮤니티 노드를 설치하고 관리할 수 있습니다. npm에서 커뮤니티 노드를 설치하려면 다음을 따르세요.

Note

Owner 및 Admin 사용자만 가능

Owner 또는 Admin 역할을 가진 사용자만 셀프 호스팅된 n8n 인스턴스에서 npm의 커뮤니티 노드를 설치하고 관리할 수 있습니다. 인스턴스 소유자는 사용자 관리를 설정하고 관리하는 사람입니다.

커뮤니티 노드 설치하기#

npm에서 커뮤니티 노드를 설치하려면 다음을 따르세요.

  1. Settings > Community Nodes로 이동합니다.

  2. Install을 선택합니다.

  3. 설치할 노드를 찾습니다.

    1. Browse를 선택합니다. n8n은 n8n-community-node-package 키워드로 태그된 모든 npm 패키지를 보여주는 npm 검색 결과 페이지로 이동합니다.
    2. 결과 목록을 살펴봅니다. 결과를 필터링하거나 키워드를 추가할 수 있습니다.
    3. 원하는 패키지를 찾으면 패키지 이름을 기록해 둡니다. 특정 버전을 설치하려면 버전 번호도 함께 기록해 둡니다.
    4. n8n으로 돌아갑니다.
  4. npm 패키지 이름과, 선택적으로 버전 번호 또는 dist-tag를 입력합니다. 예를 들어 "Storms"라는 날씨 API에 접근하도록 설계된 커뮤니티 노드가 있다고 가정해봅시다. 패키지 이름은 n8n-node-storms이며, 세 가지 주요 버전이 있습니다.

    • n8n-node-weather라는 패키지의 최신 버전을 설치하려면 Enter npm package namen8n-nodes-storms를 입력합니다.
    • 버전 2.3을 설치하려면 Enter npm package namen8n-node-storms@2.3을 입력합니다.
    • beta와 같은 dist-tag로 설치하려면 Enter npm package namen8n-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 버전을 기준으로 비교합니다.

  5. 커뮤니티 노드 사용에 따른 위험에 동의합니다. **I understand the risks of installing unverified code from a public source.**를 선택합니다.

  6. Install을 선택합니다. n8n이 노드를 설치하고 SettingsCommunity Nodes 목록으로 돌아갑니다.

Note

차단 목록에 있는 노드

n8n은 설치를 막는 커뮤니티 노드의 차단 목록을 관리합니다. 자세한 내용은 n8n 커뮤니티 노드 차단 목록을 참고하세요.

커뮤니티 노드 제거하기#

커뮤니티 노드를 제거하려면 다음을 따르세요.

  1. Settings > Community nodes로 이동합니다.
  2. 설치하려는 노드에서 Options Three dots options menu를 선택합니다.
  3. Uninstall package를 선택합니다.
  4. 확인 모달에서 Uninstall Package를 선택합니다.

커뮤니티 노드 업그레이드하기#

Warning

버전 간 호환성이 깨지는 변경사항(Breaking changes)

노드 개발자는 새 버전의 노드에서 호환성이 깨지는 변경사항을 도입할 수 있습니다. 호환성이 깨지는 변경사항이란 이전 기능을 손상시키는 업데이트를 말합니다. 노드 개발자가 선택한 노드 버전 관리 방식에 따라, 호환성이 깨지는 변경사항이 있는 버전으로 업그레이드하면 해당 노드를 사용하는 모든 워크플로가 손상될 수 있습니다. 노드를 업그레이드할 때는 주의하세요. 업그레이드로 인해 문제가 발생한다면 다운그레이드할 수 있습니다.

### 최신 버전으로 업그레이드하기

Settings > community nodes의 노드 목록에서 커뮤니티 노드를 최신 버전으로 업그레이드할 수 있습니다.

커뮤니티 노드의 새 버전을 사용할 수 있게 되면, n8n은 해당 노드에 Update 버튼을 표시합니다. 이 버튼을 클릭하면 최신 버전으로 업그레이드됩니다.

특정 버전으로 업그레이드하기#

특정 버전(최신 버전이 아닌 버전)으로 업그레이드하려면 노드를 제거한 다음, 대상 버전을 정확히 지정하여 다시 설치합니다. 자세한 안내는 설치 지침을 참고하세요.

커뮤니티 노드 다운그레이드하기#

커뮤니티 노드의 특정 버전에 문제가 있는 경우, 이전 버전으로 롤백하고 싶을 수 있습니다.

이렇게 하려면 커뮤니티 노드를 제거한 다음, 특정 노드 버전을 대상으로 다시 설치합니다. 자세한 안내는 설치 지침을 참고하세요.

GUI 설치

n8n v2.29
원문 보기
요약

Owner 및 Admin 사용자만 가능 Owner 또는 Admin 역할을 가진 사용자만 셀프 호스팅된 n8n 인스턴스에서 npm의 커뮤니티 노드를 설치하고 관리할 수 있습니다. npm에서 커뮤니티 노드를 설치하려면 다음을 따르세요.

Note

Owner 및 Admin 사용자만 가능

Owner 또는 Admin 역할을 가진 사용자만 셀프 호스팅된 n8n 인스턴스에서 npm의 커뮤니티 노드를 설치하고 관리할 수 있습니다. 인스턴스 소유자는 사용자 관리를 설정하고 관리하는 사람입니다.

커뮤니티 노드 설치하기#

npm에서 커뮤니티 노드를 설치하려면 다음을 따르세요.

  1. Settings > Community Nodes로 이동합니다.

  2. Install을 선택합니다.

  3. 설치할 노드를 찾습니다.

    1. Browse를 선택합니다. n8n은 n8n-community-node-package 키워드로 태그된 모든 npm 패키지를 보여주는 npm 검색 결과 페이지로 이동합니다.
    2. 결과 목록을 살펴봅니다. 결과를 필터링하거나 키워드를 추가할 수 있습니다.
    3. 원하는 패키지를 찾으면 패키지 이름을 기록해 둡니다. 특정 버전을 설치하려면 버전 번호도 함께 기록해 둡니다.
    4. n8n으로 돌아갑니다.
  4. npm 패키지 이름과, 선택적으로 버전 번호 또는 dist-tag를 입력합니다. 예를 들어 "Storms"라는 날씨 API에 접근하도록 설계된 커뮤니티 노드가 있다고 가정해봅시다. 패키지 이름은 n8n-node-storms이며, 세 가지 주요 버전이 있습니다.

    • n8n-node-weather라는 패키지의 최신 버전을 설치하려면 Enter npm package namen8n-nodes-storms를 입력합니다.
    • 버전 2.3을 설치하려면 Enter npm package namen8n-node-storms@2.3을 입력합니다.
    • beta와 같은 dist-tag로 설치하려면 Enter npm package namen8n-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 버전을 기준으로 비교합니다.

  5. 커뮤니티 노드 사용에 따른 위험에 동의합니다. **I understand the risks of installing unverified code from a public source.**를 선택합니다.

  6. Install을 선택합니다. n8n이 노드를 설치하고 SettingsCommunity Nodes 목록으로 돌아갑니다.

Note

차단 목록에 있는 노드

n8n은 설치를 막는 커뮤니티 노드의 차단 목록을 관리합니다. 자세한 내용은 n8n 커뮤니티 노드 차단 목록을 참고하세요.

커뮤니티 노드 제거하기#

커뮤니티 노드를 제거하려면 다음을 따르세요.

  1. Settings > Community nodes로 이동합니다.
  2. 설치하려는 노드에서 Options Three dots options menu를 선택합니다.
  3. Uninstall package를 선택합니다.
  4. 확인 모달에서 Uninstall Package를 선택합니다.

커뮤니티 노드 업그레이드하기#

Warning

버전 간 호환성이 깨지는 변경사항(Breaking changes)

노드 개발자는 새 버전의 노드에서 호환성이 깨지는 변경사항을 도입할 수 있습니다. 호환성이 깨지는 변경사항이란 이전 기능을 손상시키는 업데이트를 말합니다. 노드 개발자가 선택한 노드 버전 관리 방식에 따라, 호환성이 깨지는 변경사항이 있는 버전으로 업그레이드하면 해당 노드를 사용하는 모든 워크플로가 손상될 수 있습니다. 노드를 업그레이드할 때는 주의하세요. 업그레이드로 인해 문제가 발생한다면 다운그레이드할 수 있습니다.

### 최신 버전으로 업그레이드하기

Settings > community nodes의 노드 목록에서 커뮤니티 노드를 최신 버전으로 업그레이드할 수 있습니다.

커뮤니티 노드의 새 버전을 사용할 수 있게 되면, n8n은 해당 노드에 Update 버튼을 표시합니다. 이 버튼을 클릭하면 최신 버전으로 업그레이드됩니다.

특정 버전으로 업그레이드하기#

특정 버전(최신 버전이 아닌 버전)으로 업그레이드하려면 노드를 제거한 다음, 대상 버전을 정확히 지정하여 다시 설치합니다. 자세한 안내는 설치 지침을 참고하세요.

커뮤니티 노드 다운그레이드하기#

커뮤니티 노드의 특정 버전에 문제가 있는 경우, 이전 버전으로 롤백하고 싶을 수 있습니다.

이렇게 하려면 커뮤니티 노드를 제거한 다음, 특정 노드 버전을 대상으로 다시 설치합니다. 자세한 안내는 설치 지침을 참고하세요.