Skip to content

Latest commit

 

History

History
67 lines (49 loc) · 3.44 KB

README.md

File metadata and controls

67 lines (49 loc) · 3.44 KB

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

使用腾讯云COS部署HEXO博客教程

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

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

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

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参数

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

hexo d

说明:

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

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

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

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