自动化工作流

Node.js 网站巡检脚本:检查 HTTP 状态、超时与失败退出码

下载零第三方依赖的脚本,先验证成功、404 和超时,再接入定时任务;说明它不能代替页面内容和交易流程测试。

这次做一个小而可验证的巡检

脚本依次向目标网址发 GET 请求,输出每个网址的状态、耗时和失败类型。全部最终响应为 2xx 才返回退出码 0;任一失败返回 1;参数错误返回 2。它适合可用性初查,不检查页面正文是否正确,也不模拟登录或支付。

准备 Node.js 22 或更新的兼容环境,不依赖额外 npm 包。只检查你负责或获准检查的网址,先手动执行,确认请求频率合适后再安排定时运行。macOS、Linux 等环境均可使用,租一台 Mac 不是前置条件。

第一步:下载并查看代码

下载 网站巡检脚本 site-check.mjs。先在编辑器查看,再保存在独立练习目录。它不会保存凭据、发送通知或修改网站内容。默认每个目标超时 5000 毫秒,最多 10 个网址,按顺序执行。

sh
node --version
node site-check.mjs https://itjc.com/ https://itjc.com/llms.txt

脚本打印 JSON 行,方便后续保存或解析。下面只是格式示例,毫秒数与状态以你的实际请求为准。

json
{"url":"https://example.com/","ok":true,"status":200,"durationMs":123}

第二步:理解状态与退出码

默认跟随重定向,检查最终响应。因此一个 301 跳转到正常页面可以通过,但这不能验证跳转链符合你的 SEO 设计。404、500 等非 2xx 响应标为 HTTP;超时标为 TIMEOUT;连接或证书等请求失败标为 NETWORK。

失败类型用于分流检查,不能仅凭 NETWORK 就认定服务器宕机。脚本运行机器自身的网络、DNS、证书环境也可能有问题。若需要检测特定跳转或页面标识,应另写针对性的检查,不要把一个 200 当作全部业务正常。

第三步:保存日志并观察退出码

在 macOS 或 Linux 终端可以这样执行。目标日志使用新名称,避免覆盖已有记录。

sh
node site-check.mjs https://itjc.com/ > check-first.jsonl
result=$?
cat check-first.jsonl
printf 'exit=%s
' "$result"

result 保存的是脚本退出状态。不要在其他命令之后才读 $?,那样读到的可能是 cat 的状态。Windows 使用对应终端的退出码查看方式。

第四步:主动验证失败路径

先在自己的测试站准备一个确定返回 404 的路径,观察 HTTP 错误与退出码 1。超时需要一个已知延迟的受控端点;不要依靠随便找一个网站“恰好很慢”。没有测试环境时,可运行项目附带的本地验证工具,由它创建成功、404、超时和拒绝连接场景。

本站已经用本地受控 HTTP 服务测试下载脚本:200 成功、404、超时、连接拒绝、非法 URL 和混合目标。该结果证明脚本的这些分支经过检查,不能证明读者网络或所有生产网址可达。测试源文件随脚本一起提供:本地验证工具,两份放在同一目录。

sh
node check-site-check.mjs

第五步:再考虑定时与通知

手动结果可靠后,定时系统只需要启动同一条命令并保留时间与退出状态。每轮避免重叠;连续失败可以先复查,再按明确阈值通知;恢复时通知一次;同样状态不要每分钟重复轰炸。

当前脚本只提供一次巡检,不内置调度、告警、重试或历史存储。你可以先写出规则:“每小时一次、最多一轮、连续两次失败通知、恢复通知一次”,再实现状态文件和通知渠道。不要把通知 API 密钥写进公开教程或日志。

验收与下一步

  • 成功目标退出 0;错误响应和受控超时退出 1。
  • 参数错误退出 2;日志有网址、耗时和失败类型。
  • 保存一份实际执行记录,能区分站点失败与巡检机器失败。
  • 定时前先确定负责人、频率、重叠处理和通知阈值。

继续阅读 设计自动化工作流 与 定时巡检的边界。若任务将在远端运行,再做 断开连接实验。

官方资料与参考

产品功能与命令可能调整。遇到差异时,以对应官方页面和当前环境为准。

读完了,动手试一次。

完成练习后,标记进度,方便继续学习。

需要独立的 macOS 开发环境?

了解三万主机的远程 Mac 租赁,或先看看你是否需要一台远程 Mac。

了解三万主机 ↗