清歌 · 自动友情链接申请
自动审核上链 · 定时反查撤链 · 双计数容错 · 违规站点识别 · 全链路安全防护
清歌 · 自动友情链接申请是一款自动友情链接插件：接收他人友链申请后自动检测对方是否已按要求添加本站友链，确认后自动上链；定时巡检对方是否撤链，采用「不可达」与「确认缺失」双计数容错，避免对方临时打不开被误删；连续缺失达到阈值（默认 3 次）自动撤下并留存证据快照；支持域名/关键词黑名单与可选的第三方安全 API（默认关闭，由用户自行填写免费 API Key）用于违规站点识别。
一套自动化友链管理插件：别人申请友链时自动检测对方是否已添加本站友链，确认后自动上链；之后定时巡检对方是否撤链，并可按规则自动下架。全程无需人工审核。
功能说明
1. 自动审核与上链
访客在友链申请页提交站点名称、地址、友链页地址与简介。
提交后插件立即抓取对方页面，检测其中是否出现本站友链。
检测通过即自动上链并显示在前台；也可改为「仅标记已验证，由站长手动上链」。
2. 定时反查，防止对方悄悄撤链
定时任务按设定频率巡检所有友链，检查本站友链是否仍在对方页面。
新添加的友链在 7 天内使用更高频率核验，之后转为常规频率。
3. 双计数容错，避免对方临时打不开被误删
不可达（超时、DNS 失败、5xx 等）与确认缺失分别计数。
抓取失败不计入缺失次数，只会累积「不可达」计数并告警，不会误删友链。
只有连续确认缺失达到阈值（默认 3 次，可配置）才会自动处理，并留存对方页面的 HTML 证据快照。
4. 违规站点识别
四层依据，逐层可配：
| 顺序 | 依据 | 匹配范围 |
|---|---|---|
| 1 | 域名黑名单（自行填写） | 对方域名 |
| 2 | 关键词黑名单（自行填写） | 站名 / 简介 / 页面标题 / meta keywords、description |
| 3 | 内置敏感词库（可停用、可排除单个词） | 同上 |
| 4 | 第三方安全 API（可选） | URL 信誉查询 |
内置词库分两级：高危词命中按配置处理（默认直接下架），灰色词只标记「疑似违规待复核」，不会自动下架。可一键停用内置词库，改用自己的黑名单。
支持的可选第三方 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 交换等，逐项出结果，便于排查「抓不到对方页面」这类问题。
懒触发巡检：低流量站点可开启，访问时按间隔自动补跑巡检；主方案仍推荐系统计划任务。
后台使用说明
进入 清歌友链，共五个页面：
| 页面 | 包含内容 |
|---|---|
| 友链管理 | 统计概览、前台页面地址、侧栏模块同步、简介批量补全、手动添加友链、友链列表（筛选 / 编辑 / 检测 / 上链 / 置顶 / 违规 / 删除） |
| 检测配置 | 本站标识、检测阈值、巡检频率、抓取参数、匹配与容错策略、前台开关、定时任务令牌等全部配置 |
| 违规与安全 | 违规检测原理说明、域名与关键词黑名单、内置词库开关与排除、命中处理策略、第三方安全 API |
| 日志 | 运行日志分页查看与清空 |
| 环境自检 | 分步检测服务器出网能力与抓取链路，定位问题时先看这里 |
首次使用建议顺序
进入 检测配置，确认「本站地址」与「本站名称」正确（用于比对对方是否添加了本站友链）。
进入 友链管理，复制「前台页面地址」，把它作为你的友链页地址对外公布。
配置 定时任务（见下节），否则撤链检测不会自动执行。
如需过滤违规站点，进入 违规与安全 维护黑名单。
配置定时任务（重要）
在服务器计划任务（crontab / Windows 任务计划程序）中定时访问下面这个地址，令牌可在 检测配置 页面查看与修改：
建议频率：每小时一次。
支持参数 ?limit=N 限制单次处理条数，?force=1 忽略时间间隔强制全量检测。
若无法配置计划任务，可在 检测配置 中开启「懒触发巡检」作为兜底。
常见问题
Q：申请后一直显示「待检测」？
先看对方站点是否已经添加了本站友链。再进 环境自检 看抓取链路是否正常；如果服务器出网受限，需要放行出站或配置代理。
Q：检测提示「不可达」，但用浏览器能打开对方站点？
这是抓取失败而非对方撤链，不会导致友链被删除。请到 环境自检 查看具体失败在哪一步（DNS / TCP / TLS / HTTP）。
Q：对方给友链加了 nofollow，算不算？
可在 检测配置 → nofollow 策略 中选择「接受」（默认）或「视为不合格」。
Q：友链很多会不会拖慢网站？
不会。检测只由定时任务或手动触发执行，前台页面不做任何抓取；每次处理的条数由「每批处理条数」控制。
Q：侧栏出现了两个「友情链接」？
主题通常自带一个「友情链接」模块。若重复，可在 后台 → 模块管理 中移除其中一个，或把本插件的模块标题改成「友链」以作区分。
更新记录
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 校验等一批问题。
1. 您在购买应用前，须要先确认该应用是否符合您的使用需求，数字化商品不支持试用。依据《消费者权益保护法》第二十五条规定，该应用为在线下载的数字化商品，在购买后一经下载安装不能退款。
2. 您在应用中心购买的应用，仅是该应用的许可使用权，该应用的所有权仍归应用提供方所有。
3. 一个应用仅可用于单一账号使用，未经本站和应用提供方同意，不得二次发布、赠送、转售、租让、盗版等，否则我们将永久关闭用户账号并保留继续追究相关责任的权利。
4. 如包含该应用的网站被转售或赠送、租让等，请另用新账号购买该应用或移除该应用，否则将视为违反使用协议被永久取消该账号的使用权利。
5. 如无特殊说明，已购买应用仅包括相关使用权及免费更新服务，应用中心及应用提供方不提供额外售后安装等服务。
6. 您使用应用中所存在的风险，完全由用户自己承担，包括系统受损、资料丢失以及其它任何风险。
7. 用户不得利用该应用以任何方式从事违反法律法规及社会公序良俗的行为，用户须对其不当使用行为可能带来的后果负全部法律责任，本站及应用提供方不承担任何责任。
8. 应用提供方和本站如发现用户将应用安装于黄赌毒诈等非法网站，将停止用户相关的使用权和服务，并将用户相关违法信息上报至网络监管部门。
9. 本站及应用提供方保留在不通知您及不对您承担责任的情况下变更、限制、冻结或终止您对某些内容的使用的权利。
1. 请先注册账号，然后登录“应用中心”。
2. 直接点击“购买应用”，跟随指引即可。
1. 购买者在自己的Z-Blog网站登录，进入后台，在左侧菜单栏点击“应用中心”菜单。
2. 在“应用中心”的首页，使用应用中心注册账号进行登录。
3. 进入“我的应用仓库”，即可看到已购买成功的应用，点击“下载”即可下载安装。
1. 如果通过自己网站后台无法正常访问应用中心，请谨慎购买，因为这将可能导致应用无法顺利下载安装。
2. 如已购买收费应用无法正常下载，请在自己网站后台检查Z-Blog及应用更新，如均已更新至最新版本仍无法下载请及时与我们联系。
3. 应用更新时有可能覆盖本地设置，请在更新前做好备份。
