关键文件#

反链检测怎么做的#

访问对方的友链页面，用正则提取所有真实的 <a href> 链接，解析主机名后跟自己的域名比对。

注意：只有真实超链接才算反链。如果对方只是在文章里提了一嘴你的域名（纯文本），不算。之前旧版用字符串匹配，结果把 5 个只是文字提及的站点误判成了有反链，后来重写了这块逻辑。

第一步：Fork 仓库#

把 fqzlr/check-flink fork 到你自己的 GitHub。

第二步：配置 Secrets#

在仓库 Settings → Secrets and variables → Actions 里添加：

第三步：开启 Actions 写权限#

仓库 Settings → Actions → General → Workflow permissions → 选 Read and write permissions。

不然 workflow 没法把 result.json 提交回仓库。

第四步：准备友链数据源#

你的博客需要暴露一个 JSON 接口，格式类似：

1
[
2
  {
3
    "name": "番茄的博客",
4
    "link": "https://blog.example.com",
5
    "avatar": "https://...",
6
    "linkpage": "https://blog.example.com/friends"
7
  }
8
]

其中 linkpage 是对方的友链页面地址（反链检测会访问这个页面）。

第五步：准备图床#

截图需要上传到图床。我用的是 Cloudflare-ImgBed（博客系列第 4 期讲过），API 兼容 cfbed.sanyue.de 规范。

第六步：首次触发#

Actions → Run workflow → task 选 both → target_link 留空 → 跑！

首次全量跑一遍，之后日常就自动了。

第七步：部署到 Vercel#

把仓库导入 Vercel，Output Directory 填 static，得到一个 CDN 地址。博客前端 fetch 这个地址的 result.json 就行。

自动触发（不用管）#

手动触发（按需）#

进 Actions → Run workflow，有两个参数：

task（选执行内容）：

• status_only：仅状态检测（默认）
• screenshots_only：仅截图（用上次检测数据）
• both：检测 + 截图

target_link（只处理指定友链）：

• 填友链名称或 URL 关键词，如 番茄 或 blog.example.com
• 留空 = 处理全部

常见场景#

增量处理是什么#

当你填了 target_link，只有匹配的友链会被重新检测/截图，其余友链保留上次结果。不会出现”只跑了一个友链，其他 46 个数据全没了”的情况。total_count 始终不变。

截图兜底链#

1
Selenium 本地截图
2
  ├─ 成功 → 上传图床 → 图床 URL
3
  └─ 失败 → thum.io 在线截图（永远可用）

所以即使 GitHub Actions 环境抽风装不上 Chrome，也不会出现白屏。

截图频率为什么是 6 天#

Selenium + Chrome 安装要 2-3 分钟，截完全部友链要 5-10 分钟。每天跑太浪费 Actions 配额（每月 2000 分钟），6 天一次刚刚好。

状态检测就轻量多了，纯 requests 请求，1 分钟跑完，所以每天 2 次不心疼。

数据源只维护一份#

友链配置只在博客侧维护（我的 friends.json），检测仓库自动读取。不用两边同步，加友链只需要在博客加一次。