가이드

Nubbo를 n8n에 연결하기

내 n8n에 Nubbo 노드를 설치하고, 코드를 작성하지 않고도 워크플로에서 스토리지를 자동화하세요.

Nubbo 노드로 n8n의 모든 워크플로에서 버킷을 다룰 수 있어요. 이 가이드에서는 인박스에 파일이 도착할 때마다 공유 링크를 만드는 워크플로를 만들어요.

제공되는 기능

  • 파일이 도착하거나, 인박스에 업로드가 있거나, 새 활동이 있을 때 워크플로를 시작해요.
  • 어떤 워크플로에서든 파일을 업로드, 이동, 이름 변경, 라벨 지정, 공유하거나 AI 에이전트에게 맡겨요.
  • 필요한 만큼만 권한을 가진 API 키. 언제든지 취소할 수 있어요.

시작하기 전에

Pro 또는 팀 요금제의 Nubbo 계정과, 내가 소유자나 관리자인 셀프 호스팅 n8n이 필요해요. Nubbo 팀에서는 소유자나 관리자가 API 키를 만들어요.

1단계: 노드 설치하기

  1. n8n에서 Settings › Community nodes를 열고 Install을 누르세요.

  2. n8n-nodes-nubbo를 입력하고 I understand the risks of installing unverified code from a public source를 선택한 뒤 Install을 누르세요. Nubbo와 Nubbo Trigger 두 노드가 나타나요.

    n8n-nodes-nubbo가 설치된 n8n 커뮤니티 노드 n8n-nodes-nubbo가 설치된 n8n 커뮤니티 노드

2단계: 키와 자격 증명 만들기

  1. Nubbo에서 설정 › API(팀이라면 팀 › API)를 열고 API 키 만들기를 누르세요. 이름을 정하고 권한, 범위, 만료를 선택한 뒤 키 만들기를 누르세요. 본인 확인을 위해 Nubbo가 비밀번호를 물어봐요. 2단계 인증을 켜 두었다면 코드도 물어봐요.

    Nubbo의 API 키 만들기 창 Nubbo의 API 키 만들기 창
  2. 키를 복사하고 저장했어요를 누르세요. 키 전체를 볼 수 있는 건 이번 한 번뿐이에요.

  3. n8n에서 Nubbo API 자격 증명을 만들고 API Key에 키를 붙여 넣은 뒤 저장하세요. n8n이 키를 바로 확인해요.

    키를 붙여 넣은 n8n의 Nubbo API 자격 증명 키를 붙여 넣은 n8n의 Nubbo API 자격 증명

3단계: 워크플로 만들기

  1. 워크플로를 만들고 Nubbo Trigger를 추가하세요. Event에서 New File Request Upload를, File Request에서 인박스를 선택하세요. 모든 인박스를 감시하려면 비워 두세요.

    New File Request Upload 이벤트가 설정된 Nubbo Trigger 노드 New File Request Upload 이벤트가 설정된 Nubbo Trigger 노드
  2. Fetch Test Event를 눌러 최근 업로드를 가져오세요.

  3. Share Link › Create로 Nubbo 노드를 추가하고 File or Folder ID에 {{ $json.file.id }} 표현식을 넣으세요. 원한다면 만료를 추가하세요. 그다음 메일이나 메시지 노드로 {{ $json.url }}을 보낼 수 있어요.

    Nubbo Trigger와 링크를 만드는 Nubbo 노드가 있는 n8n 워크플로 Nubbo Trigger와 링크를 만드는 Nubbo 노드가 있는 n8n 워크플로

4단계: 게시하기

  1. Publish를 누르고 확인하세요. 트리거는 1분마다, 또는 노드에서 선택한 빈도로 Nubbo를 조회하고, 새 업로드가 있을 때마다 워크플로가 실행돼요. 이전 업로드는 포함되지 않아요.

    실행에 성공한 n8n의 게시된 워크플로 실행에 성공한 n8n의 게시된 워크플로

문제가 생겼을 때

  • 자격 증명이 테스트를 통과하지 못하면 키가 유효하지 않거나, 취소됐거나, 만료됐거나, 공간에 Pro 또는 팀 요금제가 없는 거예요. Nubbo에서 새 키를 만드세요.
  • API_KEY_READ_ONLY: 읽기 전용 키예요. 읽기 및 쓰기 키를 만드세요.
  • API_RATE_LIMITED: 짧은 시간에 요청이 너무 많아요. 노드가 기다렸다가 최대 세 번까지 다시 시도해요.
  • API_QUOTA_EXCEEDED: 공간이 이번 달 한도를 다 썼어요. 갱신되면 다시 작동하고 이벤트는 사라지지 않아요.

할 수 있는 일은 n8n용 Nubbo에서 더 알아보세요. 다른 도구를 쓰고 싶다면 Zapier 또는 Make 가이드를 따라 하세요.

자주 묻는 질문

어떤 n8n에 설치할 수 있나요?

셀프 호스팅 n8n에서 Settings › Community nodes로 설치할 수 있어요. 커뮤니티 노드는 그 n8n의 소유자나 관리자만 설치할 수 있어요.

같은 이벤트가 두 번 올 수 있나요?

아니요. 트리거가 어디까지 처리했는지 기억해요. n8n이 다시 시작되거나 워크플로를 일시중지해도 각 이벤트는 한 번만, 순서대로 와요.

감시 중인 폴더에 파일을 업로드하는 워크플로가 스스로 트리거되나요?

Ignore Changes Made by This Key를 켜 두면 트리거되지 않아요. 기본값으로 켜져 있어요. 트리거는 같은 키가 한 작업을 건너뛰어요.

Nubbo를 조회하면 API 요청이 소모되나요?

아니요. 전달된 이벤트는 각각 요금제의 트리거 이벤트로 한 번 집계돼요.

출처

단계는 아래 페이지로 확인했어요.