指南

将 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 请求吗?

不会。每个投递的事件在你的套餐中计为一次触发事件。

来源

步骤已对照以下页面核实。