清歌 · 自动友情链接申请是一款自动友情链接插件：接收他人友链申请后自动检测对方是否已按要求添加本站友链，确认后自动上链；定时巡检对方是否撤链，采用「不可达」与「确认缺失」双计数容错，避免对方临时打不开被误删；连续缺失达到阈值（默认 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. 进入 检测配置，确认「本站地址」与「本站名称」正确（用于比对对方是否添加了本站友链）。

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

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

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

配置定时任务（重要）

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

建议频率：每小时一次。

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

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

常见问题

Q：申请后一直显示「待检测」？先看对方站点是否已经添加了本站友链。再进 环境自检 看抓取链路是否正常；如果服务器出网受限，需要放行出站或配置代理。

Q：检测提示「不可达」，但用浏览器能打开对方站点？这是抓取失败而非对方撤链，不会导致友链被删除。请到 环境自检 查看具体失败在哪一步（DNS / TCP / TLS / HTTP）。

Q：对方给了友链加了 nofollow，算不算？可在 检测配置 → nofollow 策略 中选择「接受」（默认）或「视为不合格」。

Q：友链很多会不会拖慢网站？不会。检测只由定时任务或手动触发执行，前台页面不做任何抓取；每次处理的条数由「每批处理条数」控制。

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

更新记录

v 1.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 校验等一批问题。