qiniucloud

Package Information

Released: 7/9/2025
Downloads: 0 weekly / 0 monthly
Latest Version: 1.0.2
Author: simons2333

Documentation

n8n-nodes-qiniucloud

这是一个用于 n8n 的七牛云对象存储节点,支持文件上传功能。

安装

在 n8n 项目中安装:

npm install n8n-nodes-qiniucloud

配置

  1. 在 n8n 中创建新的七牛云 API 凭据
  2. 填入以下信息:
    • Access Key: 七牛云访问密钥
    • Secret Key: 七牛云私钥
    • Region: 存储区域
      • z0: 华东
      • z1: 华北
      • z2: 华南
      • na0: 北美
      • as0: 东南亚

使用方法

  1. 在工作流中添加"Qiniu Cloud"节点
  2. 选择凭据
  3. 配置以下参数:
    • Bucket Name: 存储空间名称
    • File Key: 文件在七牛云中的键名(文件名)
    • Input Type: 选择输入类型
      • Binary Data: 从二进制数据字段上传
      • URL: 从网络地址下载并上传

二进制数据上传

当选择"Binary Data"输入类型时:

  • Input Data Field Name: 包含文件数据的二进制字段名(默认: data)

URL 上传

当选择"URL"输入类型时:

  • File URL: 要下载并上传的文件网络地址
  • Download Timeout: 下载超时时间(秒,默认30秒)
  • Auto Extract Filename: 当File Key为空时是否自动从URL提取文件名

可选配置

  • Content Type: 文件的 MIME 类型
  • Overwrite: 是否覆盖同名文件

使用示例

上传本地文件

  1. 使用 "Read Binary Files" 节点读取本地文件
  2. 连接到 "Qiniu Cloud" 节点
  3. 设置 Input Type 为 "Binary Data"
  4. 配置 Bucket Name 和 File Key

从URL上传文件

  1. 设置 Input Type 为 "URL"
  2. 在 File URL 字段填入文件网络地址,例如:
    • https://example.com/image.jpg
    • https://cdn.example.com/files/document.pdf
  3. 配置 Bucket Name 和 File Key
  4. 可选:设置下载超时时间

功能特性

  • ✅ 支持文件上传
  • ✅ 支持从网络URL下载并上传
  • ✅ 支持多区域配置
  • ✅ 支持文件覆盖选项
  • ✅ 支持自定义 Content-Type
  • ✅ 支持可配置的下载超时
  • ✅ 支持从URL自动提取文件名
  • ✅ 错误处理和重试机制

依赖

  • qiniu - 七牛云官方 JavaScript SDK
  • axios - HTTP 客户端,用于从URL下载文件

许可证

MIT

贡献

欢迎提交 Issue 和 Pull Request。

相关链接

Discussion