一条命令开始

交互终端里脚本会先显示确认提示,按 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 时只做画像查询,不发起这些探测。

check.sh 支持的参数与环境变量
参数作用
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。它读取的是请求到达服务端时的出口信息,不接触本机系统或浏览器数据。

开发者 JSON 接口
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'

使用边界

脚本与本页只描述网络环境,不读取账号状态,不能替代账号、订阅或平台风控结论。