n8n-nodes-tencent-cos

这是一个为 n8n 开发的腾讯云 COS（对象存储）社区节点，基于 cos-js-sdk-v5 构建。

n8n 是一个可扩展的工作流自动化平台，允许你连接各种服务和应用。

功能特性

此节点支持以下腾讯云 COS 操作：

文件操作 (File)

• 上传 (Upload): 上传文件到 COS 存储桶
• 下载 (Download): 从 COS 下载文件
• 删除 (Delete): 删除 COS 中的文件
• 获取信息 (Get): 获取文件的元数据信息
• 列表 (List): 列出存储桶中的文件

存储桶操作 (Bucket)

• 创建 (Create): 创建新的存储桶
• 删除 (Delete): 删除存储桶
• 列表 (List): 列出所有存储桶

安装

社区节点安装（推荐）

1. 在 n8n 中，转到 设置 > 社区节点
2. 选择 安装
3. 输入 n8n-nodes-tencent-cos
4. 点击 安装

手动安装

在你的 n8n 根目录中运行：

npm install n8n-nodes-tencent-cos

配置

凭证设置

使用此节点前，你需要配置腾讯云 API 凭证：

1. 在 n8n 中创建新的 Tencent COS API 凭证
2. 填入以下信息：
   • Secret ID: 你的腾讯云 Secret ID
   • Secret Key: 你的腾讯云 Secret Key

如何获取腾讯云凭证

1. 登录 腾讯云控制台
2. 访问 API 密钥管理
3. 创建或查看你的 Secret ID 和 Secret Key

使用示例

上传文件

1. 添加 Tencent COS 节点到你的工作流
2. 选择凭证
3. 设置参数：
   • Resource: File
   • Operation: Upload
   • Bucket Name: 你的存储桶名称（例如：my-bucket-1250000000）
   • Region: 存储桶所在地域（例如：ap-guangzhou）
   • File Key: 文件在存储桶中的路径（例如：folder/file.txt）
   • Binary Property: 包含文件数据的二进制属性名（默认：data）

下载文件

1. 添加 Tencent COS 节点
2. 选择凭证
3. 设置参数：
   • Resource: File
   • Operation: Download
   • Bucket Name: 存储桶名称
   • Region: 地域
   • File Key: 要下载的文件路径
   • Put Binary Property: 存储下载文件的属性名

列出文件

1. 添加 Tencent COS 节点
2. 选择凭证
3. 设置参数：
   • Resource: File
   • Operation: List
   • Bucket Name: 存储桶名称
   • Region: 地域
   • Prefix: （可选）文件路径前缀
   • Max Keys: 最大返回数量

支持的地域

常用地域代码：

• ap-guangzhou - 广州
• ap-shanghai - 上海
• ap-beijing - 北京
• ap-chengdu - 成都
• ap-chongqing - 重庆
• ap-hongkong - 香港
• ap-singapore - 新加坡

更多地域请参考 腾讯云 COS 地域列表。

开发

构建

npm run build

监听模式

npm run build:watch

代码规范检查

npm run lint
npm run lint:fix

资源

• n8n 社区节点文档
• 腾讯云 COS 文档
• cos-js-sdk-v5 文档

许可证

MIT

问题反馈

如有问题或建议，请在 GitHub Issues 中提出。