指南

將 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 會要求輸入密碼,確認是你本人。 如果啟用了雙重驗證,還需要輸入驗證碼。

    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. 新增 Nubbo 節點,選擇 Share Link › Create,並把 File or Folder ID 設為運算式 {{ $json.file.id }}。如有需要,可以加上有效期限。之後可以用電子郵件或訊息節點寄出 {{ $json.url }}。

    包含 Nubbo Trigger 和建立連結的 Nubbo 節點的 n8n 工作流程 包含 Nubbo Trigger 和建立連結的 Nubbo 節點的 n8n 工作流程

步驟 4:發佈

  1. 按下 Publish 並確認。觸發器每分鐘輪詢一次 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 請求嗎?

不會。每個送達的事件會在你的方案中計為一次觸發事件。

資料來源

步驟已對照以下頁面核實。