面向 AI 访问场景,用 AI 网络环境分、出口 IP 画像、风险信号与服务连通性,帮助排查当前网络环境。官网覆盖 ChatGPT、Claude、Gemini、Grok,以及 DeepSeek、Kimi、豆包、通义千问、智谱清言、MiniMax、MiMo,共 11 家 AI 服务。
结果只描述网络环境,不代表账号登录、订阅资格或平台风控结论。
| 入口 | 适用场景 |
|---|---|
| 网页版 | 查看 AI 网络环境分、IP 画像与浏览器侧连通性,并排查 WebRTC、双栈和分流出口 |
| CLI | 在终端或服务器检测本机出口、公开 AI 端点与分流路径;探测清单与浏览器版单独维护 |
| JSON | 程序查询出口画像、环境质量分及 AI 地区政策参考;不从指定 IP 发起实时连通探测 |
| MCP | 在 AI 客户端调用 JSON 画像查询,查看当前请求出口或指定 IP 的信息 |
快捷执行(sh 和 bash 均可):
curl -fsSL https://ipforai.cc/sh | sh
curl -fsSL https://ipforai.cc/sh | bash先审阅再执行(推荐):
curl -fsSL https://ipforai.cc/sh -o /tmp/ipforai-check.sh
less /tmp/ipforai-check.sh
sh /tmp/ipforai-check.sh -y
# 也可以用 bash 执行:bash /tmp/ipforai-check.sh -y常用参数:
# 跳过确认
curl -fsSL https://ipforai.cc/sh | sh -s -- -y
# 指定 IP(仅画像与环境质量分,不含本机 AI 链路探测)
curl -fsSL https://ipforai.cc/sh | sh -s -- -y 8.8.8.8
# 详细输出
curl -fsSL https://ipforai.cc/sh | sh -s -- -y -d以上命令中的 sh 均可替换为 bash;两者执行同一份 POSIX 兼容脚本。
权威脚本地址始终是官网
https://ipforai.cc/sh。本仓库中的check.sh为审阅镜像;请以官网版本为准。
完整参数、探测范围和结果解读见命令行检测指南。
以下为脱敏的双栈终端检测示例。IP、时区、耗时和服务结果会随实际网络环境变化。
# GET /json:查看服务端看到的本次请求源 IP
curl -fsSL 'https://ipforai.cc/json'
# GET /json?ip=:服务端查询指定 IPv4 或 IPv6
curl -fsSL 'https://ipforai.cc/json?ip=8.8.8.8'
curl -fsSL 'https://ipforai.cc/json?ip=2001:4860:4860::8888'
# 强制分别查看请求的 IPv4 / IPv6 出口
curl -4 -fsSL 'https://ipforai.cc/json'
curl -6 -fsSL 'https://ipforai.cc/json'
# 使用 GET 参数编码传入 ip
curl --get -fsSL --data-urlencode 'ip=8.8.8.8' 'https://ipforai.cc/json'ip 是唯一可选查询参数:省略或留空时查询本次请求源 IP;填入地址时只做服务端画像查询,不会从该 IP 发起实时连接,也不会读取调用方本机系统或浏览器数据。非法 IP 返回 HTTP 400。合法 ?ip= 响应带 Cache-Control: public, max-age=600,允许 CDN 缓存;无参响应始终 private, no-store。
字段说明见 docs/api.zh.md(English),示例响应见 examples/sample.json。
给任意项目 README 挂一张「AI 网络评分」徽章,点击回到官网结果页:
[](https://ipforai.cc/?ip=8.8.8.8)自托管 SVG(不依赖 Shields.io,任意网页 <img> 可直接嵌入):
[](https://ipforai.cc/?ip=8.8.8.8)实际效果(8.8.8.8 查询时的快照):
README 徽章必须带 ?ip=:GitHub 的 README 图片由 camo 代理抓取并缓存,不带参数显示的是抓图方的分数,不是读者的。接口细节与颜色档位见 docs/badge.zh.md(English)。
在 Claude、Cursor 等支持 MCP 的客户端里直接问「我现在的 IP 能不能用 Claude」:
claude mcp add ipforai -- npx -y ipforai-mcp提供 check_my_ip(本机出口)和 lookup_ip(指定 IP)两个工具,支持 HTTPS_PROXY。其他客户端的配置见 mcp/README.md。
| 能力 | 说明 |
|---|---|
| 出口画像 | 地理位置、ASN、网络类型、接入形态、路由属性 |
| 风险信号 | 代理相关风险档位、Tor 出口等(有数据时) |
| 环境质量分 | 网络环境参考分,不是 AI 账号分 |
| AI 可用性参考 | 服务端画像与地区政策参考:可用 / 受限 / 不可用 / 待确认;与本机端点实测分开解读 |
| 终端链路探测 | CLI 在本机出口下探测公开入口与分流(指定 IP 时不跑链路) |
- 不判断账号是否会被封、能否登录、订阅是否有效
- 不提供「纯净度 / 防封 / 解锁」承诺
- 不把任意 IP 的字符串当成「从该 IP 真实访问 AI」的连通探测(指定 IP 只查画像)
- CLI:POSIX
sh、curl和系统常用命令;只读检测,不写系统配置、不安装软件、不需要 API Key - 网络请求:CLI 会向 ipforai.cc、IPv4 探测域名及脚本列出的 AI/厂商公开域名发起探测;JSON 只请求官网后端画像接口
- 数据来源:离线库与规则由官网维护,仓库中的
check.sh只是审阅镜像 - 会创建临时目录并在退出时删除
- 一次 TCP 请求只能看到一个源地址族;双栈请
-4/-6各查一次
.
├── README.md / README_EN.md
├── LICENSE
├── check.sh # /sh 的审阅镜像,以官网为准
├── docs/api.zh.md / api.md # /json 说明
├── docs/badge.zh.md / badge.md # /badge.json、/badge.svg 说明
├── mcp/ # MCP 服务(npm 包 ipforai-mcp)
└── examples/sample.json # 示例响应(单次请求仅一侧有值)
- 脚本版本以运行输出中的版本号及响应头
X-IP-for-AI-Check-Version为准(当前镜像:v2.1) - JSON 模式:
X-IP-for-AI-Schema: json-v1;单次/json只填一个地址族,dualStack多为false - 更新镜像:
curl -fsSL https://ipforai.cc/sh -o check.sh
如果你的项目把 ipforai 接进来了——README 徽章、/json?ip= 接口或 CLI 检测——欢迎开一个 issue 告知,我们会把你列在这里:
暂无。欢迎成为第一个。
集成前请阅读 JSON 接口说明 中的「稳定性承诺」与「跨域(CORS)」:?ip= 对任意来源开放,无参形式不对第三方站点开放跨域。

