qcloud-cos-upload
上传单个文件到腾讯云COS服务,用于静态文件上传。
Tips
适配腾讯云官方 COS Nodejs SDK(XML API) cos-nodejs-sdk-v5
批量上传文件参见 gulp-qcloud-cos-upload
为安全起见,建议为每个存储桶提供独立的子账号,使用子账号的 SecretId 和 SecretKey 来上传文件。
在存储桶配置的权限管理
页卡配置存储桶访问权限
和Policy权限设置
,提供子账号的访问权限。
Getting Started
安装:
npm i qcloud-cos-upload
选项配置参见 腾讯云存储说明文档
使用:
const upload = require('qcloud-cos-upload');
upload({
// 是否开启调试模式,默认为 false,调试模式下,报错时输出详细错误信息
debug: false,
// 是否在控制台打印上传日志,默认为 true
log: true,
// 是否允许文件覆盖,默认为 false
overwrite: false,
// 为 true 则输出文件路径为腾讯云默认 CDN 地址。为具体域名,则替换腾讯云默认 CDN 域名。
cdn: '',
// 文件远程路径协议,默认为 'https:',这个选项仅影响输出结果。
protocol: 'https:',
// 在腾讯云申请的 AppId
AppId: '1000000000',
// 配置腾讯云 COS 服务所需的 SecretId
SecretId: 'AKIDxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
// 配置腾讯云 COS 服务所需的 SecretKey
SecretKey: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
// COS服务配置的存储桶名称
Bucket: 'static',
// 地域名称
Region: 'ap-chengdu',
// 要上传的本地文件路径
FilePath: './1.zip',
// 文件在存储桶中的路径
Key: '1.zip'
}).then(rs => {
// 线上路径
console.info(rs.url);
// 为 true 表明线上文件已存在
console.info(rs.isExists);
// 为 true 表明进行了覆盖
console.info(rs.overwrited);
// 为 true 表明已进行了上传
console.info(rs.uploaded);
// 文件在对象存储的线上访问路径
console.info(rs.cosUrl);
// 文件在 CDN 的线上访问路径,如果没有配置 cdn 选项则为 undefined
console.info(rs.cdnUrl);
// 如果进行了上传,可以通过 uploadData 取得详细上传信息
console.info(rs.uploadData);
});