Hexo静态网站托管到腾讯云COS+CDN加速以及缓存自动刷新完美方案

自建博客地址：https://www.bytelife.net，欢迎访问！ 本文为博客同步发表文章，为了更好的阅读体验，建议您移步至我的博客

本文作者： Jeffrey
本文链接： https://www.bytelife.net/articles/47472.html
版权声明： 本博客所有文章除特别声明外，均采用 BY-NC-SA 许可协议。转载请注明出处！

---

近期把博客折腾到腾讯云了，对比了腾讯云和阿里云后，发现腾讯云近期CDN做了很多升级，对于CDN缓存节点的配置更加细致，另外毕竟腾讯云价格更低嘛，对个人站长更友好一些。这篇文章主要讲讲如何使用腾讯云的COS+CDN部署静态网站，以及使用腾讯云函数服务完美解决（对官方提供的刷新函数做了些优化）CDN节点的缓存自动刷新问题。

我的部署方案

• 运行环境：站点解析采用境内和境外分开解析的方案，境内解析到腾讯云的CDN节点，境外解析到Vercel的CDN节点，虽然站点的主要访问由于就是国内用户，但毕竟谷歌、必应等等搜索引擎都是国外的，而国内CDN对于境外的加速又比较贵，所以就分开解析啦。
  • 境内：腾讯云COS对象存储+腾讯云CDN加速
  • 境外：Vercel静态网站托管
• 自动化部署：由于站点的源码托管在GitHub上面，所以使用GitHub Actions进行自动化部署，写完文章直接push上去就可以自动部署到多个平台，简直不要太方便。

GitHub Actions自动部署到腾讯云COS

腾讯云提供了非常好用的cli工具，执行一些简单的命令就可以快速上传文件到COS对象存储。在Git工程的根目录下创建.github/workflows/xxx.yml文件，就可以创建一个Actions配置。
使用下面的配置可以将Hexo部署到腾讯云COS对象存储：

# workflow
name: Blog

on:
  push:
    branches:
      - master

jobs:
  deploy:
    name: Deploy Blog
    runs-on: ubuntu-latest
    env:
      TZ: Asia/Shanghai

    steps:
    # check it to your workflow can access it
    # from: https://github.com/actions/checkout
    - name: Checkout Repository master branch
      uses: actions/checkout@v2
      with: 
        ref: 'master'
        submodules: true

  # from: https://github.com/actions/setup-node
    - name: Setup Node.js
      uses: actions/setup-node@master
      with: 
        node-version: "14.x"

    - name: Yarn Install Cache
      uses: c-hive/gha-yarn-cache@v1

    - name: Install Dependencies
      run: yarn install

    ## generate files
    - name: Generate Hexo Site Public Files & Create Files for Blog Assets
      run: yarn build

    ## deploy to tencent cos
    - name: Deploy to Tencent COS
      env:
        SECRET_ID: ${{ secrets.TENCENT_SECRET_ID }}
        SECRET_KEY: ${{ secrets.TENCENT_SECRET_KEY }}
        BUCKET: ${{ secrets.TENCENT_COS_BUCKET }}
        REGION: ap-shanghai
      run: |
        sudo pip install coscmd
        coscmd config -a ${SECRET_ID} -s ${SECRET_KEY} -b ${BUCKET} -r ${REGION}
        coscmd upload -rs --delete ./public/ / -f

其中：

• ${{ secrets.TENCENT_SECRET_ID }}、${{ secrets.TENCENT_SECRET_KEY }}、${{ secrets.TENCENT_COS_BUCKET }}需要在github仓库的secrets设置中进行配置。
• 命令coscmd upload -rs --delete ./public/ / -f的意思是比较当前COS存储桶内的文件，如果发生变更则更新，如果存储桶中存在但public目录中不存在，则删除对应的文件，coscmd的具体使用方法可以参考腾讯云官方文档。

开启COS静态网站功能

将网站文件上传到COS还不够，需要开启COS的静态网站功能，打开存储桶->基础配置->静态网站，按照下图所示进行配置：

这时就可以通过图中的访问节点提供的域名来访问网站了，当然也可以绑定自定义域名，前提是域名已经备案。

腾讯云CDN加速

创建域名

如果你的域名有备案的话，同时可以使用腾讯云CDN加速COS静态网站，配置十分简单，在CDN页面中创建一个域名，按下图所示进行配置：

配置缓存

缓存配置十分重要，由于站点是静态站点，网站的内容变化比较少，为了降低CDN的回源请求，一定要配置节点缓存策略，可以参考我的配置如下，其中浏览器缓存可以按需配置：

注意：这里不用担心节点缓存时间配置的过长会导致页面无法更新，后面我会讲如何配置缓存的自动刷新。

关于CDN配置的更多细节就不讲了，都很简单，一看就懂。

CDN节点缓存自动刷新

官方方案

由于上一步中配置了CDN节点的缓存策略，请求只要能够命中缓存，就不会进行回源请求了，这会导致我们的页面更新不能及时的展现给用户，因此需要考虑如何进行CDN节点的缓存自动刷新。

腾讯云官方给我们提供了一个解决方案，可以在COS存储桶的函数计算->CDN缓存刷新函数中配置一个函数，可参考下图所示配置：

但这个方案存在一个问题，由于我们的静态网站有默认索引页面index.html，而官方提供的这个函数只会刷新对应的文件的URL，而不会刷新索引URL，例如http://www.bytelife.net/index.html这个文件，通常我们的请求是http://www.bytelife.net/，因此官方的方案针对于静态网站来说不算完美。

优化方案

可以通过简单修改官方的函数来解决这个问题，点击刚刚创建的CDN缓存刷新函数列表中的函数名称，可以跳转的函数的编辑页面：

将index.js文件内容替换为下面的代码，最后点击右上角的“部署”按钮即可：

'use strict'

const CosSdk = require('cos-nodejs-sdk-v5')
const CdnSdk = require('./common/CdnSdk')
const CdnRefreshTask = require('./common/CdnRefreshTask')
const {
  getParams,
  getObjectUrl,
  logger,
  getLogSummary
} = require('./common/utils')

exports.main_handler = async (event, context, callback) => {
  /**
   * parse param from event and process.env
   */
  const { objects, cdnHosts, secretId, secretKey, token } = getParams(event)

  logger({
    title: 'param is parsed success, param as follow: ',
    data: { objects, cdnHosts, event }
  })
  /**
   * init cos instance
   */
  if (!secretId || !secretKey || !token) {
    throw new Error(`secretId, secretKey or token is missing`)
  }

  const cdnSdkInstance = new CdnSdk({ secretId, secretKey, token })
  const cosInstance = new CosSdk({
    SecretId: secretId,
    SecretKey: secretKey,
    XCosSecurityToken: token
  })

  const taskList = objects.map(({ bucket, region, key }) => {
    const purgeUrls = [];
    // 主要变更内容在这个位置
    cdnHosts.forEach(host => {
      const tempUrl = getObjectUrl({
        cosInstance,
        bucket,
        region,
        key,
        origin: `${/^(http\:\/\/|https\:\/\/)/.test(host) ? '' : 'https://'}${host}`
      });
      purgeUrls.push(tempUrl);
      // 如果以 /index.html 结尾，则增加目录首页/
      // 例如 https://www.xxxx.com/index.html, 则增加 https://www.xxxx.com/
      if(tempUrl.lastIndexOf('/index.html') == (tempUrl.length - 11)){
        purgeUrls.push(tempUrl.substr(0, tempUrl.length - 10))
      }
    });
    return new CdnRefreshTask({
      cdnSdkInstance,
      urls: purgeUrls
    })
  })

  const taskResults = []
  for (const task of taskList) {
    const results = await task.runPurgeTasks()
    taskResults.push(...results)
  }

  logger({
    title: 'cdn refresh full logs:',
    data: taskResults
  })

  const { status, messages } = getLogSummary(taskResults)

  logger({
    messages: messages.map(item => item.replace(/\,\ /g, '\n'))
  })

  if (status === 'fail') {
    throw messages.join('; ')
  } else {
    return messages.join('; ')
  }
}