Description

n8n-nodes-aliyun-oss

阿里云 OSS（对象存储服务）节点，用于 n8n 工作流自动化。

功能特性

• 生成预签名URL: 为 OSS 对象生成临时访问的预签名 URL
• 上传文件: 支持将文件上传到阿里云 OSS
  • 支持从二进制数据上传
  • 支持从字符串内容上传
  • 可配置存储类型（标准、低频、归档等）
  • 可配置文件 ACL 权限
  • 可设置 Content-Type

安装

在 n8n 中安装

1. 打开 n8n 设置
2. 进入 "Community Nodes"
3. 搜索 "@yuzhen177/n8n-nodes-aliyun-oss"
4. 点击安装

手动安装

npm install @yuzhen177/n8n-nodes-aliyun-oss

配置

凭证配置

在使用节点前，需要配置阿里云 OSS 凭证：

1. Access Key ID: 您的阿里云 Access Key ID
2. Access Key Secret: 您的阿里云 Access Key Secret

注意: 请确保您的 Access Key 具有相应的 OSS 操作权限。

使用方法

生成预签名URL

1. 选择操作模式：生成预签名URL
2. 填写存储空间名称（Bucket）
3. 填写对象键名（文件路径）
4. 选择区域（如：oss-cn-hangzhou）
5. 设置过期时间（可选，默认 3600 秒）

上传文件

1. 选择操作模式：上传文件
2. 填写存储空间名称（Bucket）
3. 填写对象键名（文件路径）
4. 选择区域
5. 选择文件来源（二进制数据或字符串内容）
6. 配置其他选项（存储类型、ACL、Content-Type 等）

参数说明

通用参数

• 存储空间名称: OSS 存储空间（Bucket）名称
• 对象键名: 对象（文件）在 OSS 中的键名（路径）
• 区域: 存储空间所在的区域，例如：oss-cn-hangzhou
• 自定义 Endpoint: 其他服务可用来访问 OSS 的域名（可选）

预签名URL参数

• 过期时间（秒）: 预签名 URL 的有效期，默认 3600 秒（1小时）

上传文件参数

• 文件来源: 选择文件来源方式（二进制数据或字符串内容）
• 二进制属性名: 包含二进制数据的属性名称（当选择二进制数据时）
• 文件内容: 要上传的文件内容（当选择字符串内容时）
• Content-Type: 文件的 MIME 类型，例如：image/jpeg, text/plain
• 存储类型: 文件的存储类型（标准、低频、归档等）
• 文件ACL: 文件的访问控制权限

错误处理

节点提供了详细的错误信息，帮助您快速定位问题：

• InvalidAccessKeyId: Access Key ID 无效
• SignatureDoesNotMatch: Access Key Secret 无效
• AccessDenied: 访问被拒绝，权限不足
• NoSuchBucket: 存储空间不存在
• InvalidBucketName: 存储空间名称无效

示例工作流

示例 1: 上传图片并生成访问链接

1. 使用 HTTP Request 节点获取图片
2. 使用阿里云 OSS 节点上传文件
3. 使用阿里云 OSS 节点生成预签名URL
4. 返回访问链接

示例 2: 批量上传文件

1. 使用 Read Binary Files 节点读取本地文件
2. 使用 Loop Over Items 节点遍历文件
3. 使用阿里云 OSS 节点上传每个文件

许可证

MIT

支持

如有问题或建议，请：

• 在 GitHub 上提交 Issue
• 在 n8n 社区论坛提问
• 查看 n8n 官方文档

更新日志

1.0.0

• 初始版本
• 支持生成预签名URL
• 支持上传文件
• 支持多种存储类型和 ACL 配置