一条命令开始
交互终端里脚本会先显示确认提示,按 Enter 继续、Ctrl-C 取消;管道、CI 或不确定的终端里加 -y 直接执行。
官方入口始终是 https://ipforai.cc/sh;版本号以脚本内 SCRIPT_VERSION 与响应头 X-IP-for-AI-Check-Version 为准。
curl -fsSL https://ipforai.cc/sh | sh
# 指定 IP:只查该 IP 的画像与环境质量分
curl -fsSL https://ipforai.cc/sh | sh -s -- 8.8.8.8
# CI 或重定向环境:跳过确认,并输出详细诊断
curl -fsSL https://ipforai.cc/sh | sh -s -- -y -d推荐做法:先审阅,再执行
curl | sh 会直接执行远端脚本。先下载通读一遍再运行是更稳妥的习惯:脚本只有一份纯 POSIX sh 文件,不依赖 bash 特性,读完就能确认它对系统做的每一件事。
curl -fsSL https://ipforai.cc/sh -o /tmp/ipforai-check.sh
less /tmp/ipforai-check.sh
sh /tmp/ipforai-check.sh 8.8.8.8参数与环境变量
运行时只依赖 curl。未指定 IP 时检测本机出口,并会探测多个 AI 服务与厂商端点(会访问第三方域名);指定 IP 时只做画像查询,不发起这些探测。
| 参数 | 作用 |
|---|---|
| IP(位置参数) | 只查询该 IP 的公开画像与环境质量分,不探测本机 AI 链路与分流 |
| -y / --yes | 跳过交互确认,直接执行 |
| -d / --detail | 显示设备、系统、HTTP 状态码等详细诊断 |
| IPFORAI_TEST_IP | 本地 API 只返回回环地址时使用的测试出口 |
| NO_COLOR | 设为非空值时禁用输出配色 |
脚本会做什么、不会做什么
会做的事
- 请求 ipforai.cc 与 v4-probe.ipforai.cc 获取出口画像(v4-probe 只有 A 记录,用于在代理下拿到可靠的 IPv4 出口)
- 探测 11 个 AI 服务的公开入口与 API 端点连通性
- 对照 20 多个服务的分流出口与本机同地址族出口
- 创建临时目录存放探测结果,进程结束时删除
不会做的事
- 不写入或修改本机任何配置
- 不安装任何软件
- 不需要 API key 或账号
- 不读取账号状态,不给出账号结论
怎么读输出:IP 质量与分流
社区把这类检测常称为 IP 质量检测或 IP 体检;脚本的输出正是按这些质量维度展开。
[01] 出口总览:逐地址族列出出口 IP、地区、ASN、网络类型(机房/住宅等)、路由类型(原生/广播等)与代理风险,IPv4 与 IPv6 分开显示。
[02] AI 服务链路:✓ 可连接、! 响应异常、× 连接失败三类结论基于公开端点的实测响应码;旁边会给出该服务官方地区政策的参考结论。
[03] AI 分流出口:列出各服务实际看到的出口 IP,并与本机同地址族出口对照;标记「不一致」说明该服务走了不同的路径。
[04] 环境质量分:由后端按出口画像计算(本机模式优先采用分流众数出口),并列出扣分项;脚本不在本地改写评分规则。
结果只描述本次网络环境,不代表账号登录、订阅资格或平台风控结论。
只要 JSON,不要报告
/json 是服务端出口画像接口,只接受可选参数 ip。它读取的是请求到达服务端时的出口信息,不接触本机系统或浏览器数据。
curl -sS 'https://ipforai.cc/json'
# 强制 IPv4 / IPv6 出口
curl -4 -sS 'https://ipforai.cc/json'
curl -6 -sS 'https://ipforai.cc/json'
# 查询指定 IP
curl -sS 'https://ipforai.cc/json?ip=8.8.8.8'使用边界
脚本与本页只描述网络环境,不读取账号状态,不能替代账号、订阅或平台风控结论。