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

写前哔哔

最近也是上了腾讯云EdgeOne的免费末班车，但是对于我这种懒人来说，每次都要手动刷新缓存简直是太难了，尤其是腾讯云老是要求要扫码更要老命了。后来无意中看到了青桔气球的文章，实现了不用登陆腾讯云就能刷新缓存，但这个方法还是要手动node EdgeOne.js才行，那对我这种懒人必须得优化优化，于是豆包大法开始（为什么用豆包，因为我毫无相关基础，只是代码的搬运工。。。）。

正片开始

首先在博客根目录下新建一个scripts文件夹，然后在该文件夹内新建一个edgeone-cache.js文件。
安装必要依赖（我也不知道装哪个，反正我都装了）：

1 2	npm install tencentcloud-sdk-nodejs npm install tencentcloud-sdk-nodejs-teo

复制粘贴以下代码：

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

// 从 Hexo 配置读取 EdgeOne 参数
const edgeoneCfg = hexo.config.edgeone || {};

// 若未启用，直接退出
if (!edgeoneCfg.enable) {
  console.log("[EdgeOne] 缓存刷新已禁用（edgeone.enable=false）");
  return;
}

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

/**
 * 执行 EdgeOne 缓存刷新
 */
async function refreshCache() {
  try {
    const params = {
      ZoneId: edgeoneCfg.zoneId, // 必传：EdgeOne 站点 ID
      Type: edgeoneCfg.type || "purge_host", // 刷新类型
      Targets: edgeoneCfg.targets || [hexo.config.url], // 刷新目标
      Method: edgeoneCfg.method || "invalidate", // 清除方式
    };

    const res = await client.CreatePurgeTask(params);
    // 空值保护：校验响应结构
    if (res && res.Response) {
      if (res.Response.TaskId) {
        console.log(`✅ EdgeOne 刷新成功 | 任务 ID：${res.Response.TaskId}`);
        console.log(`→ 类型：${params.Type} | 方式：${params.Method}`);
        console.log(`→ 目标：${JSON.stringify(params.Targets)}`);
      } else {
        console.error(`⚠️ API 响应无 TaskId：`, res.Response);
      }
    } else {
      console.error(`⚠️ API 响应异常：`, res);
    }
  } catch (err) {
    console.error(`❌ EdgeOne 刷新失败：${err.code} | ${err.message}`);
    hexo.log.error(err); // 记录错误，不中断部署
  }
}

// 绑定 Hexo 部署完成钩子
hexo.on("deployAfter", async () => {
  console.log("\n=== EdgeOne 缓存自动刷新启动 ===");
  await refreshCache();
  console.log("=== EdgeOne 缓存刷新结束 ===\n");
});

根据豆包描述，这个脚本利用了 Hexo 的deployAfter钩子，确保在部署完成后才执行缓存刷新操作，保证了内容已经更新到服务器后再刷新缓存，避免了无效的缓存刷新。

然后在_config.yaml里边添加以下配置文件：

edgeone:
  enable: true               # 是否启用（必填，true/false）
  secretId: "***"  # 访问密钥 ID（必填）
  secretKey: "***" # 访问密钥 Key（必填）
  zoneId: "***"      # EdgeOne 站点 ID（必填，格式如 zone-xxx）
  type: "***"         # 刷新类型：purge_host/purge_url/purge_prefix/purge_all
  targets:                   # 刷新目标（数组，根据 type 填写）
    - "***"
    - "***"   
  method: "***"       # 清除方式：invalidate/delete

关键参数解释：

secretId和secretKey在腾讯云访问密钥 - 控制台创建，一组密钥secretKey只在创建的时候出现一次，注意保存。

zoneId在腾讯云EO服务总览->站点概览。

type与targets对应关系，可同时配置多个targets：

需求	配置值	示例 Targets
全站缓存	`purge_all`	无需填写 Targets
域名级缓存	`purge_host`	`"blog.qjqq.cn"`
目录级缓存（如 /blog）	`purge_prefix`	`"https://blog.qjqq.cn/blog/"`
单页面缓存	`purge_url`	`"https://blog.qjqq.cn/posts/123.html"`