macOS Shell 脚本中用 curl 监控网络接口需组合静默模式(-sS)、超时控制(--max-time)、状态码校验(-f)及响应内容检查;基础用法验证 200 状态,进阶用 jq 解析 JSON 字段,生产环境建议加重试、日志和时间戳。
在 macos 的 shell 脚本中用 curl 监控网络接口(如 api 是否可访问、响应是否正常、状态码是否符合预期),关键在于组合 curl 的静默模式、超时控制、状态码捕获和响应内容检查。下面给出实用、可直接复用的方法。
基础监控:检查服务是否可达 + 状态码是否为 200
最常用场景是确认某个 HTTP 接口是否在线且返回成功状态。推荐使用以下简洁写法:
if curl -fsS --max-time 5 https://api.example.com/health > /dev/null; then echo "✅ 接口正常" else echo "❌ 接口异常(超时/连接失败/非2xx状态)" fi
说明:
- -f:对非 2xx 响应码(如 404、500)触发错误退出
- -s:静默模式,不输出进度/错误信息到终端
- -S:仅在出错时显示错误信息(配合 -s 使用更可控)
- --max-time 5:总耗时超过 5 秒则中断,防卡死
- > /dev/null:丢弃响应体,只关心是否成功
进阶监控:校验响应内容或 JSON 字段
若需确认返回内容符合预期(例如健康检查返回 {"status":"up"}),可用 jq(需先安装:brew install jq):
response=$(curl -fsS --max-time 5 https://api.example.com/health 2>/dev/null) if [ -n "$response" ] && echo "$response" | jq -e '.status == "up"' > /dev/null; then echo "✅ 服务状态为 up" else echo "❌ 响应为空或 status 不是 up" fi
注意:
- jq -e 在匹配失败时返回非零退出码,可用于 if 判断
- 先用 curl -fsS 获取响应,再用 jq 解析,避免因解析失败掩盖网络问题
- 若不用 jq,也可用 grep -q '"status":"up"' 简单匹配(但不推荐用于结构化 JSON)
带重试和日志的生产级脚本片段
实际监控常需自动重试、记录时间戳和失败详情:
url="https://api.example.com/health"
max_retries=3
for i in $(seq 1 $max_retries); do
if response=$(curl -fsS --max-time 3 -w "\n%{http_code}" "$url" 2>/dev/null); then
http_code=$(echo "$response" | tail -n1)
body=$(echo "$response" | head -n -1)
if [ "$http_code" = "200" ]; then
echo "$(date): ✅ OK (200)"
exit 0
else
echo "$(date): ⚠️ HTTP $http_code — $body"
fi
else
echo "$(date): ❌ Request failed (attempt $i/$max_retries)"
fi
sleep 2
done
echo "$(date): ? All retries exhausted" >&2
exit 1要点说明:
- -w "\n%{http_code}":让 curl 在响应体末尾追加换行+HTTP 状态码
- 分离提取 body 和 http_code,便于分别判断
- 每次失败后 sleep 2,避免高频探测
- 所有日志带 $(date),方便排查时间线
补充技巧:跳过 SSL 验证(仅测试环境)
内网自签名证书接口调试时,可临时加 -k 参数(⚠️ 生产环境禁用):
curl -fkSs --max-time 5 https://self-signed.local/api
更安全的做法是用 --cacert /path/to/cert.pem 指定可信 CA 证书。
不复杂但容易忽略:macOS 自带的 curl 默认支持 HTTPS,无需额外配置;确保脚本以 #!/bin/zsh 或 #!/bin/bash 开头,并赋予执行权限(chmod +x monitor.sh)即可运行。


















