引言

• 本地配置 Hexo 源码

• 利用本地的 markdown 编辑器书写文章

• Hexo 部署到 Github Pages/Coding Pages 上

• 本地编辑器鱼龙混杂，使用手感一言难尽

• 代码存储在本地不方便

• GitHub Pages 国内访问速度令人堪忧（有段时间我还双重部署在了 Coding Pages 上，但是太不稳定了）

开始

Hexo + 语雀 + yuque-hexo + web hook + severless + Github Actions

腾讯云的 COS 静态网站+自定义 CDN 加速

部署流程

PS：在Github Actions 持续集成 Docker 构建并部署 Node 项目到云服务器中，我已经将调用云函数改为调我自己的 node 项目了，再由 node 服务调用 github actions

初始化 Hexo

npx hexo-cli init blog

npx 可以在不全局安装依赖情况下使用 hexo-cli 的命令

安装 yuque-hexo 插件

安装依赖

npm i yuque-hexo

配置语雀

1. 访问工作台=>账户设置=Token=>新建 token 并配置好权限。Access Token 即为 YUQUE_TOKEN

1. 访问工作台=>账户设置=>账户设置=>个人路径，设置语雀的简易的个人路径（建议），拿到个人路径。

1. 新建一个放置博客的知识库（可见范围为互联网可见）

2. 进入博客知识库，设置博客知识库的路径（建议），拿到知识库的路径。

配置 hexo

package.json

{
  "scripts": {
    "hexo:build": "hexo generate",
    "hexo:clean": "hexo clean",
    "deploy": "hexo deploy",
    "server": "hexo server",
    "hexo": "npm run hexo:clean && npm run hexo:build && npm run server",
    "yuque:clean": "yuque-hexo clean",
    "yuque:sync": "yuque-hexo sync",
    "yuque": "npm run yuque:clean && npm run yuque:sync"
  },
  "yuqueConfig": {
    "postPath": "source/_posts",
    "baseUrl": "https://www.yuque.com/api/v2",
    "login": "语雀个人路径",
    "repo": "知识库路径",
    "onlyPublished": true,
    "onlyPublic": true
  }
}

配置腾讯云 COS

• 域名 （需要备案，不备案可临时使用 COS 提供的临时域名）

• 腾讯云账号 开通 COS 服务（建议使用 V5 版本 COS 控制台，如为 V4 版本可提交工单让后台升级为 V5 版本）

开启静态网站

配置自定义 CDN 加速域名

解析域名

获取配置参数

获取 SecretId 和 SecretKey

这里建议可以新增子用户，并设置权限，获取子用户的密钥，这里不作赘述。

获取 bucket 和 region

配置 Github Actions

配置 Github

获取 Github 访问 Token

注意下：这个 Token 只会出现一次，最好复制出来使用，如果忘记了，只能重新生成一个

Github Token 用途：

• 用来在流水线工作时，上传语雀文章到博客仓库。

• 下文中需要用到这个 token 外部调用 Github Actions

配置仓库 Actions secrets

SECRET_ID、SECRET_KEY、BUCKET、REGION 用于上传静态网站文件到 COS YUQUE_TOKEN 用于拉取语雀的文章 GITHUB_TOKEN 不用配置，可以在 Github Actions 中直接获取

配置博客仓库

name: Deplo To COS

on:
	# 本地测试时可以开启，部署后不建议开启，因为会涉及到更改一些配置，会多次频繁触发构建
	# 允许手动push触发
  # push:
  #    branches:
  #      - master
  # 允许外部仓库事件触发
  repository_dispatch:
    types:
    	# 这里的值需要和下文的云函数的event_type保持一致
      - start

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - name: 检查分支
        uses: actions/checkout@master

      - name: 安装node环境
        uses: actions/setup-node@master
        with:
          node-version: "12.x"

      - name: 缓存依赖
        uses: actions/cache@v1
        id: cache
        with:
          path: node_modules
          key: ${{runner.OS}}-${{hashFiles('**/package-lock.json')}}

      - name: 安装依赖
        if: steps.cache.outputs.cache-hit != 'true'
        run: |
          export TZ='Asia/Shanghai'
          npm install

      - name: 安装COS相关依赖
        run: |
          sudo pip install coscmd
          sudo pip install tccli

      - name: 配置COS
        env:
          SECRET_ID: ${{ secrets.SECRET_ID }}
          SECRET_KEY: ${{ secrets.SECRET_KEY }}
          BUCKET: ${{ secrets.BUCKET }}
          REGION: ${{ secrets.REGION }}
        run: |
          coscmd config -a $SECRET_ID -s $SECRET_KEY -b $BUCKET -r $REGION
          tccli configure set secretId $SECRET_ID
          tccli configure set secretKey $SECRET_KEY
          tccli configure set region $REGION

      - name: 拉取语雀的文章
        env:
          YUQUE_TOKEN: ${{ secrets.YUQUE_TOKEN }}
        run: |
          npm run yuque:clean
          npm run yuque:sync

      - name: 配置Git用户名邮箱
        run: |
          git config --global user.name "1874"
          git config --global user.email "1225751694@qq.com"

      - name: 提交yuque拉取的文章到GitHub仓库
        run: |
          echo `date +"%Y-%m-%d %H:%M:%S"` begin > time.txt
          git add .
          git commit -m "Refresh yuque json" -a

      - name: 推送文章到仓库
        uses: ad-m/github-push-action@master
        with:
        	# GITHUB_TOKEN不用配置在secrets
          github_token: ${{ secrets.GITHUB_TOKEN }}

      - name: 生成静态文件
        run: |
          npm run hexo:clean
          npm run hexo:build

      - name: 上传文章到cos并刷新CDN
        run: |
          coscmd upload -rfs --delete ./public/ /
          tccli cdn PurgePathCache --cli-unfold-argument --Paths https://1874.cool/ --FlushType flush

配置腾讯云函数

PS：在Github Actions 持续集成 Docker 构建并部署 Node 项目到云服务器中，我已经将调用云函数改为调我自己的 node 项目了，因为腾讯云函数现在（2022-07-16）好贵了！

1. 访问云数控制台=>新建云函数

2. 模版选择从头开始，函数类型选择事件函数，运行环境选择 python2.7

3. 在线编写函数代码

# -*- coding: utf8 -*- 
import requests 
def main_handler(event, context):
    r = requests.post("https://api.github.com/repos/LetTTGACO/1874/dispatches",
    json = {"event_type": "start"},
    headers = {"User-Agent":'curl/7.52.1',
              'Content-Type': 'application/json',
              'Accept': 'application/vnd.github.everest-preview+json',
              'Authorization': 'token Github访问token'})
    if r.status_code == 204:
        return "This's OK!"
    else: 
        return r.status_code

event_type 说明 event_type 值需要和 Github Actions 中配置的 repository_dispatch 的 types 值保持一致 Authorization 说明 Authorization 值为 字符串 “token + Github 访问 token”，不要忘了加 token

1. 触发期配置=>自定义创建=>配置如下图所示

1. 部署完成后进入触发管理，最下面就是云函数地址

配置语雀 webhook

发布文档和更新文档，需要选择文档有较大更新，推送给关注者，才会触发 webhook。 但是经过我的测试，一旦某一篇文章选择文档有较大更新，推送给关注者。后续的更新，不管选没选文档有较大更新，推送给关注者，都会触发 webhook。如果因为部署频繁导致出错的话，建议选择评审阶段触发。也可以每次通过测试按钮手动触发。

Done！发布文章

常见问题

语雀图片显示异常（防盗链）的解决办法

1. 在语雀上使用图片的时候，避开直接复制图片到语雀。先将图片上传到自己的图床后，直接使用 markdown 的图片语法：![](https://xxxx.com/a.jpg)插入图片到适当位置，例如：

1. 为了不破坏语雀编辑器的体验，我修改了 yuque-hexo 的源代码，发布了yuqe-hexo-with-cdn插件。适配了将语雀中的图片上传到腾讯云 COS 图床后，将原有的语雀图片链接替换掉。

yuqe-hexo-with-cdn 插件

npm i yuqe-hexo-with-cdn

目前 x-code 已经将我的方案合并到主分支了，可以直接使用yuque-hexo进行配置

{
  "scripts": {
    "hexo:build": "hexo generate",
    "hexo:clean": "hexo clean",
    "deploy": "hexo deploy",
    "server": "hexo server",
    "hexo": "npm run hexo:clean && npm run hexo:build && npm run server",
    "yuque:clean": "yuque-hexo clean",
    "yuque:sync": "yuque-hexo sync",
    "yuque": "npm run yuque:clean && npm run yuque:sync"
  },
  "yuqueConfig": {
    "postPath": "source/_posts",
    "baseUrl": "https://www.yuque.com/api/v2",
    "login": "语雀个人路径",
    "repo": "知识库路径",
    "onlyPublished": true,
    "onlyPublic": true,
    "imgCdn": {
      "enabled": true,
      "bucket": "COS存储桶名称",
      "region": "COS地域名称",
      "prefixKey": "blog-images"
    }
  }
}

prefixKey 说明： 如果需要将图片上传到 COS 的根目录，那么 prefixKey 不用配置。 如果想上传到指定目录 blog/image 下，则需要配置 prefixKey 为“prefixKey”: “blog/image”。 目录名前后都不需要加斜杠