自动审核上链 · 定时反查撤链 · 双计数容错 · 违规站点识别 · 全链路安全防护

清歌 · 自动友情链接申请是一款自动友情链接插件：接收他人友链申请后自动检测对方是否已按要求添加本站友链，确认后自动上链；定时巡检对方是否撤链，采用「不可达」与「确认缺失」双计数容错，避免对方临时打不开被误删；连续缺失达到阈值（默认 3 次）自动撤下并留存证据快照；支持域名/关键词黑名单与可选的第三方安全 API（默认关闭，由用户自行填写免费 API Key）用于违规站点识别。

一套自动化友链管理插件：别人申请友链时自动检测对方是否已添加本站友链，确认后自动上链；之后定时巡检对方是否撤链，并可按规则自动下架。全程无需人工审核。

功能说明

1. 自动审核与上链

访客在友链申请页提交站点名称、地址、友链页地址与简介。

提交后插件立即抓取对方页面，检测其中是否出现本站友链。

检测通过即自动上链并显示在前台；也可改为「仅标记已验证，由站长手动上链」。

2. 定时反查，防止对方悄悄撤链

定时任务按设定频率巡检所有友链，检查本站友链是否仍在对方页面。

新添加的友链在 7 天内使用更高频率核验，之后转为常规频率。

3. 双计数容错，避免对方临时打不开被误删

不可达（超时、DNS 失败、5xx 等）与确认缺失分别计数。

抓取失败不计入缺失次数，只会累积「不可达」计数并告警，不会误删友链。

只有连续确认缺失达到阈值（默认 3 次，可配置）才会自动处理，并留存对方页面的 HTML 证据快照。

4. 违规站点识别

四层依据，逐层可配：

内置词库分两级：高危词命中按配置处理（默认直接下架），灰色词只标记「疑似违规待复核」，不会自动下架。可一键停用内置词库，改用自己的黑名单。

支持的可选第三方 API：微步在线 ThreatBook、VirusTotal、Google Safe Browsing（均需自行申请 Key，国内推荐微步）。

5. 安全防护

抓取全程 SSRF 防护：仅允许 http/https、仅 80/443 端口、拒绝内网与保留 IP、重定向逐跳校验、超时与响应体积限制。

申请表单：会话令牌防伪造 + 蜜罐字段 + 同 IP 频率限制，可选开启算术验证码。

所有输出均做转义，数据库操作使用 Z-Blog 链式对象。

6. 前台页面

插件提供两个独立页面（不依赖主题模板，任何主题都能用）：

友链展示页　zb_users/plugin/qinglink/links.php
卡片式展示已上链友链，含站点图标与简介，末尾固定「申请友链」入口。

友链申请页　zb_users/plugin/qinglink/apply.php
申请须知、本站信息与复制按钮、申请表单、申请进度查询。

两个页面均自适应移动端，配色与排版克制统一。

7. 侧栏友链模块

自动创建并同步「友情链接」侧栏模块，只展示已上链的友链。

模块内部的排版（两列、居中、虚线下划线）与主流主题自带的友链模块保持一致，不会显得突兀。

模块标题可自定义，留空则不显示标题。

8. 其他

简介自动补全：友链简介为空时，自动抓取对方站点标题补全；也可在后台一键批量补全（每次 20 条，避免跑超时）。

日志：完整记录检测、上链、下架、违规命中等操作，支持分页查看（每页 50/100/200/500 条）与一键清空。

环境自检：分步检测运行环境、DNS、TCP 连接、TLS/HTTP 交换等，逐项出结果，便于排查「抓不到对方页面」这类问题。

懒触发巡检：低流量站点可开启，访问时按间隔自动补跑巡检；主方案仍推荐系统计划任务。

后台使用说明

进入 清歌友链，共五个页面：

首次使用建议顺序

1. 进入 检测配置，确认「本站地址」与「本站名称」正确（用于比对对方是否添加了本站友链）。

2. 进入 友链管理，复制「前台页面地址」，把它作为你的友链页地址对外公布。

3. 配置 定时任务（见下节），否则撤链检测不会自动执行。

4. 如需过滤违规站点，进入 违规与安全 维护黑名单。

配置定时任务（重要）

在服务器计划任务（crontab / Windows 任务计划程序）中定时访问下面这个地址，令牌可在 检测配置 页面查看与修改：

• 建议频率：每小时一次。

• 支持参数 ?limit=N 限制单次处理条数，?force=1 忽略时间间隔强制全量检测。

• 若无法配置计划任务，可在 检测配置 中开启「懒触发巡检」作为兜底。

常见问题

Q：申请后一直显示「待检测」？

先看对方站点是否已经添加了本站友链。再进 环境自检 看抓取链路是否正常；如果服务器出网受限，需要放行出站或配置代理。

Q：检测提示「不可达」，但用浏览器能打开对方站点？

这是抓取失败而非对方撤链，不会导致友链被删除。请到 环境自检 查看具体失败在哪一步（DNS / TCP / TLS / HTTP）。

Q：对方给友链加了 nofollow，算不算？

可在 检测配置 → nofollow 策略 中选择「接受」（默认）或「视为不合格」。

Q：友链很多会不会拖慢网站？

不会。检测只由定时任务或手动触发执行，前台页面不做任何抓取；每次处理的条数由「每批处理条数」控制。

Q：侧栏出现了两个「友情链接」？

主题通常自带一个「友情链接」模块。若重复，可在 后台 → 模块管理 中移除其中一个，或把本插件的模块标题改成「友链」以作区分。

更新记录

v2.0.0更新说明

• 新增友链分组、保护名单、JSON 导入导出、检测历史时间线、撤链快照对比、可选邮件通知（后台新增「导入导出」「检测历史」两个页面）

• 修正反向检测：严格模式改为解析 <a href> 并按域名全等比对，不再因页面文字里出现本站域名就误判为已加友链

• 前台展示页支持分页、侧栏模块支持条数上限，友链多时不再一次性输出整页数据；后台统计与列表改为按页查询

• 申请回执不再显示内部检测判定；IPv6 私网地址（6to4 / NAT64 / Teredo 等）一并纳入 SSRF 拦截

• 修复第三方安全接口配置异常时可能被误判为违规、证据快照脚本过滤上限、关闭申请后侧栏仍显示申请入口等问题

• 修复普通站点被误判为 JS 渲染页面、安全接口组件异常中断巡检、并发写日志可能行交错等稳定性问题

v1.5.0更新说明

• 新增 4 套前台模板：素白（白卡三列）、墨线（编号索引）、瓷贴（紧凑四列）、深题（深色题头），原有默认样式保留，在「检测配置 → 前台模板」一键切换

• 模板只作用于友链展示页与申请页，不改主题文件；切换即时生效，随时可以切回默认

• 申请进度查询改为脱敏展示，不再输出内部判定细节；同一 IP 每小时最多查询 20 次

• 表单标签与输入框建立关联（点标签可聚焦，读屏器可朗读）；窄屏顶栏不再被裁切

• 申请页合并重复的数据库查询，减少一次全表读取

v1.4.5更新说明

- 证据快照可以直接打开了：日志与友链说明里的文件名变成可点击链接，按后台登录状态校验后查看（此前只显示一个打不开的文件名）

- 快照改为沙箱方式打开，对方页面里的脚本不会在后台执行；日志与证据目录同时禁止外部直接访问（日志含访客 IP，快照是对方站点的原始 HTML）

- 日志页显示证据快照的数量与占用空间，可一键清理，同时清掉 7 天前的申请节流记录

- 修复多标签页打开申请页后，先打开的那份表单提交时被判「已过期」的问题

- 申请频率限制提前到表单校验之前，超限请求不再触发对外抓取

- 提交申请后立即回执，检测转到后台执行，不再让申请人在页面上等抓取（原实现最长要等十几秒）

- 支持只有 IPv6 地址的站点检测；批量巡检改为批次结束统一更新侧栏友链，减少重复查询

- 证据快照文件名加随机后缀，同一秒生成的两份不再互相覆盖；保存上限从 64KB 提到 128KB，页脚友链靠后的站点也能截到

v1.4.4

• 修复后台删除友链报错（500）的问题

• 修复新安装站点侧栏不显示友链模块的问题；仅在新模块创建时自动登记，站长手动移除后不会被强行加回

• 申请反馈更明确：未检测到本站友链时提示连续缺失次数与进度（如 1/3 次），疑似 JS 渲染、疑似骗链、违规等状态各有对应说明，不再统一回复「已收到申请」

• 友链展示页在「无友链且关闭申请入口」时不再显示空白页

• 前台访问不再被巡检拖慢：懒触发改为非阻塞通知后台任务执行，访客零等待（原实现极端情况下可阻塞十几秒）

• 检测稳定性提升：修复个别网站抓取超时不可控导致巡检卡住的问题；一键补全简介增加时长上限，避免在配置较低的虚拟主机上超时失败

v1.4.3

增加友链页同域校验。首页可达性抽查

v1.3.11

修复在 PHP 8.x 下可能产生提示的若干写法。优化侧栏模块与主题自带友链模块的观感一致性。

v1.3.7 ~ v1.3.9

• 违规检测改为分级词库（高危 / 灰色），扩充内置词条，新增「排除内置词」。

• 新增「简介自动补全」开关与「一键补全空简介」。

• 日志支持分页与每页条数设置。

v1.3.0 ~ v1.3.6

• 界面重做：去渐变、统一圆角与间距，前台后台风格一致。

• 环境自检改为分步加载，可实时看到卡在哪一步。

• 新增友链编辑、图标 URL、外链 rel 策略。

• 修复侧栏模块内容不同步、nofollow 分支绕过阈值等问题。

v1.2.x

• 重写抓取层，不再依赖框架内部网络组件，兼容更多主机环境。

• 修复重定向跟随、表单令牌、SSL 校验等一批问题。