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。

相关链接

• 七牛云对象存储文档
• 七牛云 Node.js SDK
• n8n 文档