Skip to content
xjokerababPublic

About

AI 网络环境检测:终端 CLI + JSON API,查看出口、IPv4/IPv6、路由与 AI 访问参考

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ipforai · AI 网络环境分与 IP 检测

English · 官网 · 命令行用法 · 检测方法

面向 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、时区、耗时和服务结果会随实际网络环境变化。

终端检测示例:出口总览与 AI 服务链路

终端检测示例:AI 分流出口与环境质量分

开发者 JSON(GET)

# 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 徽章(GET)

给任意项目 README 挂一张「AI 网络评分」徽章,点击回到官网结果页:

[![AI 网络评分](https://img.shields.io/endpoint?url=https%3A%2F%2Fipforai.cc%2Fbadge.json%3Fip%3D8.8.8.8)](https://ipforai.cc/?ip=8.8.8.8)

自托管 SVG(不依赖 Shields.io,任意网页 <img> 可直接嵌入):

[![AI 网络评分](https://ipforai.cc/badge.svg?ip=8.8.8.8)](https://ipforai.cc/?ip=8.8.8.8)

实际效果(8.8.8.8 查询时的快照):

AI 网络评分

README 徽章必须带 ?ip=:GitHub 的 README 图片由 camo 代理抓取并缓存,不带参数显示的是抓图方的分数,不是读者的。接口细节与颜色档位见 docs/badge.zh.md(English)。

MCP(AI 客户端)

在 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

谁在用(Used by)

如果你的项目把 ipforai 接进来了——README 徽章、/json?ip= 接口或 CLI 检测——欢迎开一个 issue 告知,我们会把你列在这里:

暂无。欢迎成为第一个。

集成前请阅读 JSON 接口说明 中的「稳定性承诺」与「跨域(CORS)」:?ip= 对任意来源开放,无参形式不对第三方站点开放跨域。


License

MIT

About

AI 网络环境检测:终端 CLI + JSON API,查看出口、IPv4/IPv6、路由与 AI 访问参考

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages