域名被墙检测

要解决的问题

网站在国内突然打不开，可能的原因很多：DNS 解析异常、源站故障、CDN 回源失败，或者域名被 GFW 屏蔽。对外贸站点和出海产品来说，最后一种最棘手——服务器没挂，海外访问正常，国内用户却完全打不开。靠本地 ping 或 curl 很难区分到底是不是被墙。这个技能针对的就是「域名在 PC 端是否被 GFW 屏蔽」这一个问题，给出明确的 true / false 结论。

核心能力与工作流程

技能的核心能力包括：

• 检测指定域名在 PC 端 是否被 GFW 屏蔽
• 通过 source 参数设置检测次数，取值 1–5 次，次数越多结果越准确
• 秒级返回，适合对多个域名做逐条排查

工作流程很简单：从用户请求中提取待检测的 url（可以是裸域名，也可以是完整 URL），脚本从环境变量读取 API Key，调用底层接口并把结果转成可读文本。底层返回的 JSON 中，关键字段是 statu（true 表示未被墙，false 表示已被屏蔽）和 msg（如「正常访问」「已被屏蔽」），code 为 1001 表示请求正常。一次调用只处理一个域名。

使用边界

需要注意几点：

• 本技能只覆盖 域名被墙检测 这一项功能，不做 DNS 污染检测，也不覆盖移动端被墙场景
• 如果「正常」但实际打不开，可能是 DNS 污染或其他网络问题，需另行排查
• source 超出 1–5 范围接口可能报错；GFW 策略会变化，建议对关键域名设置较高检测次数
• 脚本不会输出、复述或保存 API Key；批量任务需要逐条执行，建议在业务低峰期运行