hexo腾讯云COS一键部署工具hexo-deployer-qcloud-cos使用说明

发表于 更新于 分类于 阅读次数：

hexo腾讯云COS一键部署工具hexo-deployer-qcloud-cos使用说明

在您的hexo项目目录下执行：

1
npm install hexo-deployer-qcloud-cos --save

在hexo项目配置文件_config.yml中添加如下部署配置：

1
2
3
4
5
6
7
8
deploy:
    type: qcloud-cos
    cosRegion: <您的cos bucket所在区域代码>
    cosSecretId: <您的cos accessKeyId>
    cosSecretKey: <您的cos accessKeySecret>
    cosBucket: <您的cos bucket名称>
    cosAppid:  <您的腾讯云账户appid>
    remotePath: <您要部署的目录,默认为根目录,默认无需设置>

注意：

COS术语请参考 COS术语信息

region 代码查找请参照腾讯云可用地域代码

SecretId及SecretKey可在腾讯云控制台云API密钥获取，强烈建议您遵循最佳实践使用子用户的SecretId和SecretKey进行相关操作，而不要使用根帐户的Secret操作

appid在腾讯云控制台右上角 【腾讯云用户名】>账户信息>基本信息 中可以查看，如果您已经创建bucket，控制台显示的name-125xxxxx 格式的bucket名称中，name部分为我们需要配置的cosBucket的值，125xxxxx就是appid

需要说明的是新版本的腾讯云COS SDK已将appid参数废弃，合并到bucket参数中，但为便于部署工具在用户未创建bucket时直接使用部署工具创建bucket，我们仍将使用appid参数

配置完成后，执行部署命令

1
hexo d

说明：

  1. 默认情况下，将文件上传到bucket的根目录下，如果需要部署到其他目录，请在deploy下添加remotePath选项进行指定
1
2
> remotePath: <您要部署的目录,默认为根目录>
>
  1. 执行hexo d命令后，部署工具会检查bucket是否存在及是否具备访问权限，如果bucket不存在，命令行将进行创建bucket确认，回复y后将按照配置文件中的设置创建一个新的bucket
  2. 部署工具自动创建的bucket 默认权限为 public-read即公共读私有写 ，bucket中的对象如果不指定权限将继承bucket的权限。如果需要修改默认创建的bucket权限，请在配置中添加bucketAcl选项进行指定。请注意，如果将bucket访问权限设置为private，COS部署静态网站的索引文档功能将失效（即使对象的权限是可以公开访问的）
1
2
> bucketAcl: <自动创建的bucket权限 仅可设置为 private , public-read , public-read-write> 
>

由于腾讯云COS当前访问策略条目限制为1000条，所以取消文件权限设置参数，通过此部署工具上传的文件将继承bucket的权限（v1.0.4更新）

首次在腾讯云COS部署hexo 博客后，您还需要在控制台进行一些相关的设置，具体请参考COS域名管理及COS设置静态网站

使用中有任何问题可联系作者或者在github wertycn中进行反馈