抓取网页并检测断链、重定向和HTTP错误。适用于审计站点链接、发现404错误及上线前验证URL。
链接检查器 : 检查 HTTP 状态代码的 URL, 在文档中找到断开的链接, 并跟踪链接的健康
功能概述
链接检查器 : 检查 HTTP 状态代码的 URL, 在文档中找到断开的链接, 并跟踪链接的健康是一项面向实际任务的技能，主要用于给它一个 URL, 完整的文件, 或一个批次地址 —— 它点击 ea。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
核心要点
- 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
- 该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
- 从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
使用与执行
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。
结果检查与注意事项
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。
链接检查器（Link Checker）
检查 URL 的 HTTP 状态码，定位文档中的失效链接，并长期跟踪链接健康状况。可向其输入单个 URL、包含多个链接的文件，或一批地址列表 —— 它将使用 curl 逐一发起请求，记录响应状态码，并明确告知哪些链接有效、哪些已失效。所有结果均保存在 ~/.link-checker/ 目录下，便于回溯历史记录、提取统计信息及导出报告。
命令
check
检查单个 URL。发送 HTTP HEAD 请求并返回状态码。
link-checker check
输出内容包括状态码、人类可读的标签（如 OK、REDIRECT、CLIENT_ERROR 等）以及对应图标。
scan
从文件中提取全部 URL（支持 Markdown、HTML、纯文本等任意含 http:// 或 https:// 链接的格式），并对每个链接执行检查。
link-checker scan
使用 grep 提取 URL，自动去重后逐条检测。最终输出汇总统计，含成功与失败数量。
batch
一次性检查多个 URL。将待检 URL 作为参数传入即可。
link-checker batch...
report
基于当前会话的结果生成报告，支持三种格式。
link-checker report [txt|csv|json]
默认格式为 txt。报告将保存至 ~/.link-checker/report.。
history
显示历史日志中最近 50 条检查结果。
link-checker history
每条记录包含时间戳、状态码、状态标签及对应 URL。
broken
筛选并仅显示失败链接 —— 包括状态码为 4xx、5xx、超时及连接错误的情况。
link-checker broken
stats
展示全部检查记录的统计信息：总请求数、各状态类别（2xx、3xx、4xx、5xx、timeout、error）分布、成功率百分比，以及最常出现的状态码。
link-checker stats
export
将完整历史日志导出为文件，支持 csv、json 和 txt 格式。
link-checker export
导出文件将附带时间戳，并保存至 ~/.link-checker/ 目录。
config
查看当前配置或修改设置项。
link-checker config link-checker config set
可用配置项包括：timeout（每次请求的超时秒数）、retries（失败时重试次数）、user_agent。
help
显示使用说明及所有可用命令。
link-checker help
version
输出当前版本号。
link-checker version
示例
# 检查某个 URL 是否可达 link-checker check https://example.com # 扫描 Markdown 文件中的失效链接 link-checker scan ./README.md # 批量检查多个 URL link-checker batch https://example.com https://httpstat.us/404 https://httpstat.us/500 # 仅显示失效链接 link-checker broken # 获取统计概览 link-checker stats # 生成 JSON 格式报告 link-checker report json # 将完整历史日志导出为 CSV link-checker export csv # 设置请求超时时间为 15 秒 link-checker config set timeout 15 # 设置失败重试次数为 3 link-checker config set retries 3
配置
所有配置项以键值对形式存储于 ~/.link-checker/config 文件中。
| 键（Key） | 默认值 | 说明 |
|---|---|---|
timeout |
10 |
每次请求的连接超时时间（单位：秒） |
retries |
2 |
发生超时或错误时的重试次数 |
user_agent |
LinkChecker/1.0.0 |
随请求发送的 User-Agent 请求头 |
可通过 link-checker config set 修改任意配置项。
数据存储
所有数据均存放于 ~/.link-checker/ 目录下：
| 文件 | 用途 |
|---|---|
results.log |
当前会话结果（管道符分隔） |
history.log |
所有历史检查记录的累积日志 |
config |
配置键值对文件 |
report.* |
生成的报告文件（txt/csv/json） |
export_*.* |
带时间戳的导出文件 |
日志格式为：timestamp|url|status_code|status_label
状态分类
| 图标 | 分类 | 对应状态码或情形 |
|---|---|---|
| ✅ | OK | 2xx |
| 🔄 | Redirect | 3xx |
| ❌ | Client Error | 4xx |
| ⚠️ | Server Error | 5xx |
| ⏱️ | Timeout | 连接超时 |
| 🚫 | Error | DNS 解析失败、连接被拒绝等 |
依赖要求
bash（4.0 及以上版本）curlgrep、sort、awk（标准 Unix 工具）
由 BytesAgain 提供支持 | bytesagain.com | hello@bytesagain.com
相关专题
Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章，帮助读者完成上线流程。
2026.10.28
0
16
Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章，帮助读者完成从初始化到日常开发的配置。
2026.10.28
0
15
Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章，帮助读者理解各文件夹的用途与引用方式。
2026.10.28
0
10
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
2026.10.22
0
11
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
2026.10.22
0
10
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
2026.10.22
0
15
本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。
2026.10.22
0
10
本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。
2026.10.22
0
25
本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。
2026.10.22
0
15
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.1万人学习
共49课时 | 82.5万人学习
最新文章