Github Actions与EdgeOne自动化刷新

写前哔哔

老早就看到别人用Github Actions来实现Hexo自动化部署，但是看见一长串教程就退缩了，正好趁着休假抄一下店长的作业。

Hexo自动化部署 By Github Actions

想当初挡住我的第一步就是上传仓库，各种git搞得我眼花缭乱，后来才知道Github官方还有个图形化应用程序Github Desktop可以极大简化操作：

• 首先在本地电脑上新创建一个用于存放博客源码的文件夹（我的文件夹名是blog_source），然后将博客根目录（我的是blog）下的所有文件复制粘贴到blog_source中。
• 打开 [Blogroot]/.gitignore,输入以下内容：

.DS_Store
Thumbs.db
db.json
*.log
node_modules/
public/
.deploy*/
.deploy_git*/
.idea
themes/butterfly/.git

最好把butterfly目录下的.git文件夹删除，这是因为[Blogroot]/themes/butterfly 本身是一个独立的 Git 仓库（里面包含 .git 文件夹），所以 Git 会把它识别为 “嵌入式仓库”，而不是普通文件目录，直接 git add 无法正常跟踪其内容。

• 在 [Blogroot] 新建 .github 文件夹,注意开头是有个 . 的。然后在 .github 内新建 workflows 文件夹，再在 workflows 文件夹内新建 autodeploy.yml,在 [Blogroot]/.github/workflows/autodeploy.yml 里面输入：

# 当有改动推送到master分支时，启动Action
name: 自动部署

on:
  push:
    branches:
      - main #2020年10月后github新建仓库默认分支改为main，注意更改

  release:
    types:
      - published

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
    - name: 检查分支
      uses: actions/checkout@v2
      with:
        ref: main #2020年10月后github新建仓库默认分支改为main，注意更改

    - name: 安装 Node
      uses: actions/setup-node@v1
      with:
        node-version: "24.x" #action使用的node版本，建议大版本和本地保持一致。可以在本地用node -v查询版本号。

    - name: 安装 Hexo
      run: |
        export TZ='Asia/Shanghai'
        npm install hexo-cli -g

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

    - name: 安装依赖
      if: steps.cache.outputs.cache-hit != 'true'
      run: |
        npm install --save

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

    - name: 部署 
      run: |
        cd ./public
        git init
        git config --global user.name '${{ secrets.GITHUBUSERNAME }}'
        git config --global user.email '${{ secrets.GITHUBEMAIL }}'
        git add .
        git commit -m "${{ github.event.head_commit.message }} $(date +"%Z %Y-%m-%d %A %H:%M:%S") Updated By Github Actions"
        git push --force --quiet "https://${{ secrets.GITHUBUSERNAME }}:${{ secrets.GITHUBTOKEN }}@github.com/${{ secrets.GITHUBUSERNAME }}/${{ secrets.GITHUBUSERNAME }}.github.io.git" master:master
        #git push --force --quiet "https://${{ secrets.GITHUBUSERNAME }}:${{ secrets.GITHUBTOKEN }}@github.com/${{ secrets.GITHUBUSERNAME }}/仓库名.git" master:main

需要注意的主要有三点：

一是要保证uses: actions/cache@v4，因为GitHub Actions 工作流中使用了已被废弃的 actions/cache@v1 版本，GitHub 已不再支持该版本，需要更新到 v3 或 v4 版本。

二是如果新仓库，那么分支应该都是main，但是最后一行的分支为master:main，而不是main:main。

三是如果博客部署的仓库不是Github Pages所在的仓库的话，如仓库名.github.io，那么最后一行应该修改为git push --force --quiet "https://${{ secrets.GITHUBUSERNAME }}:secrets.GITHUBUSERNAME:${{ secrets.GITHUBTOKEN }}@github.com/${{ secrets.GITHUBUSERNAME }}/仓库名.git" master:main

• 参照以下视频利用Github Desktop上传博客源码至Github仓库：

• 参照店长教程添加相关环境变量并查看部署情况：

使用Github Action实现全自动部署

https://akilar.top/posts/f752c86d/

在Github Actions中添加EdgeOne自动化刷新

在之前一篇教程中实现了在本地端用Hexo 的deployAfter钩子触发EdgeOne自动化刷新，但这种方法貌似在Actions中不起作用，于是大法启动。

• 在scripts文件夹中新建edgeone-cache-actions.js，然后复制粘贴以下代码：

const tencentcloud = require("tencentcloud-sdk-nodejs-teo");
const TeoClient = tencentcloud.teo.v20220901.Client;

// 关键：判断脚本是否被直接执行（而非被Hexo自动加载）
// 只有通过 `node scripts/edgeone-cache-actions.js` 执行时才会进入逻辑
if (require.main === module) {
  main().catch(err => {
    console.error("执行失败:", err);
    process.exit(1);
  });
} else {
  // 被Hexo自动加载时，不执行任何逻辑（避免干扰）
  console.log("[EdgeOne] 脚本被Hexo加载，跳过执行（仅手动执行生效）");
}

async function main() {
  // 从环境变量读取配置
  const edgeoneCfg = {
    enable: process.env.EDGEONE_ENABLE === 'true', // 严格判断字符串'true'
    secretId: process.env.EDGEONE_SECRET_ID,
    secretKey: process.env.EDGEONE_SECRET_KEY,
    zoneId: process.env.EDGEONE_ZONE_ID,
    region: process.env.EDGEONE_REGION || 'ap-guangzhou',
    type: process.env.EDGEONE_TYPE || 'purge_host',
    targets: process.env.EDGEONE_TARGETS ? process.env.EDGEONE_TARGETS.split(',') : [],
    method: process.env.EDGEONE_METHOD || 'invalidate',
    retry: process.env.EDGEONE_RETRY ? parseInt(process.env.EDGEONE_RETRY) : 2,
  };

  // 打印环境变量状态（调试用，可保留）
  console.log("[EdgeOne] 环境变量检测:", {
    enable: edgeoneCfg.enable,
    hasSecretId: !!edgeoneCfg.secretId, // 只显示是否存在，不打印具体值
    hasZoneId: !!edgeoneCfg.zoneId
  });

  // 若未启用，直接退出
  if (!edgeoneCfg.enable) {
    console.log("[EdgeOne] 缓存刷新已禁用（EDGEONE_ENABLE != 'true'）");
    process.exit(0);
  }

  // 校验必填参数
  const requiredFields = ['secretId', 'secretKey', 'zoneId'];
  const missingFields = requiredFields.filter(field => !edgeoneCfg[field]);
  if (missingFields.length > 0) {
    console.error(`[EdgeOne] 配置错误：缺少必填参数 ${missingFields.join(', ')}`);
    process.exit(1);
  }

  // 初始化客户端
  const client = new TeoClient({
    credential: {
      secretId: edgeoneCfg.secretId,
      secretKey: edgeoneCfg.secretKey,
    },
    region: edgeoneCfg.region,
    profile: { httpProfile: { endpoint: "teo.tencentcloudapi.com" } },
  });

  // 带重试的缓存刷新
  await refreshCacheWithRetry(client, edgeoneCfg, edgeoneCfg.retry);
}

async function refreshCacheWithRetry(client, config, retryLeft) {
  try {
    const params = {
      ZoneId: config.zoneId,
      Type: config.type,
      Targets: config.targets,
      Method: config.method,
    };

    const res = await client.CreatePurgeTask(params);

    // 修正：根据实际API响应结构校验（EdgeOne返回JobId而非TaskId）
    // 正确响应结构：{ RequestId: "xxx", JobId: "xxx", FailedList: [] }
    if (!res || !res.JobId) {
      throw new Error(`无效响应: 缺少JobId | ${JSON.stringify(res)}`);
    }
    // 检查是否有失败的目标
    if (res.FailedList && res.FailedList.length > 0) {
      throw new Error(`部分目标刷新失败: ${JSON.stringify(res.FailedList)}`);
    }

    console.log(`✅ EdgeOne 刷新成功 | 任务 JobId：${res.JobId}`);
    console.log(`→ 类型：${params.Type} | 方式：${params.Method}`);
    console.log(`→ 目标：${JSON.stringify(params.Targets)}`);
    return true;

  } catch (err) {
    if (retryLeft > 0) {
      console.log(`⚠️ 刷新失败（剩余重试 ${retryLeft} 次）：${err.message}`);
      return refreshCacheWithRetry(client, config, retryLeft - 1);
    } else {
      console.error(`❌ 最终刷新失败：${err.message}`);
      process.exit(1);
    }
  }
}

• 在autodeploy.yml中添加以下代码：

- name: 刷新EdgeOne缓存
  if: success()  # 只有部署成功才执行
  env:
    EDGEONE_ENABLE: 'true'
    EDGEONE_SECRET_ID: ${{ secrets.EDGEONE_SECRET_ID }}
    EDGEONE_SECRET_KEY: ${{ secrets.EDGEONE_SECRET_KEY }}
    EDGEONE_ZONE_ID: ${{ secrets.EDGEONE_ZONE_ID }}
    EDGEONE_REGION: 'ap-guangzhou'  # 默认为广州地域
    EDGEONE_TYPE: 'purge_host'      # 刷新类型：域名级
    EDGEONE_TARGETS: 'www.sunboy.ltd,image.sunboy.ltd'  # 替换为你的实际域名
    EDGEONE_METHOD: 'invalidate'    # 清除方式：标记失效
  run: |
    node ./scripts/edgeone-cache-actions.js

• 然后再在仓库的Settings > Secrets and variables > Actions中添加以下密钥：

  • EDGEONE_SECRET_ID：腾讯云 API 密钥 ID

  • EDGEONE_SECRET_KEY：腾讯云 API 密钥 Key

  • EDGEONE_ZONE_ID：EdgeOne 的站点 ZoneID

具体获取方法见：

Hexo博客实现腾讯云EdgeOne自动化刷新

https://www.sunboy.ltd/posts/308ecd71/

• 最后在Actions处查看deploy流程，如果显示以下内容说明EdegeOne缓存刷新成功：

最后叨叨

个人纯小白，全程豆包编码，仅做个人成功案例分享，大佬勿喷。