szp2005/ipok-cli
GitHub: szp2005/ipok-cli
一款命令行 IP 质量检测工具，聚合多源风险数据并检测 AI 服务可用性与流媒体解锁情况。
Stars: 0 | Forks: 0
# IPOK CLI
[](https://ipok.io/?ip=1.1.1.1)
一行命令即可从您的 VPS 或终端检查任何 IP 的质量：风险评分、住宅 IP 还是数据中心 IP、**原生 IP**、是否支持 **ChatGPT / Claude / Gemini**、是否适用于 **TikTok / 电商 / 社交 / AI** 等。
一行命令测 IP 纯净度 / 风险值 / 能不能用 AI —— 数据由 [ipok.io](https://ipok.io) 提供。
```
IPOK ip check ipok.io
----------------------------------------------
IP 1.1.1.1 IPv4
Location Australia / South Brisbane
ASN AS13335 CLOUDFLARENET
Type business native: broadcast
Risk 11/100 Pristine
Signals hosting
AI ChatGPT:OK Claude:OK Gemini:OK
Use-case tiktok ** ecommerce ** social ** ai *****
Sources ip-api=55, Scamalytics=0, proxycheck=0, AbuseIPDB=0, ipapi.is=30, StopForumSpam=0
----------------------------------------------
full report: https://ipok.io/?ip=1.1.1.1
```
## 安装
根据您的技术栈选择合适的安装方式——它们都会提供相同的 `ipok` 命令：
```
# Node（免安装，运行一次）
npx ipok-cli # check this machine's egress IP
npx ipok-cli 1.1.1.1 # check a specific IP
# Python
pip install ipok # then: ipok / ipok 1.1.1.1
pipx run ipok 1.1.1.1 # zero-install one-off
# Homebrew (macOS / Linux)
brew install szp2005/ipok/ipok
```
### 使用方法
```
ipok # check this machine's egress IP
ipok 1.1.1.1 # check a specific IP
ipok --json 1.1.1.1 # raw JSON
ipok --help
```
设置 `IPOK_API` 以指向自托管的 endpoint；设置 `NO_COLOR=1` 以禁用颜色。
### 免安装单行命令（服务器 / CI）
仅需 `curl` + `python3`，无需安装任何内容——非常适合在纯净的 VPS 上使用：
```
bash <(curl -sL https://raw.githubusercontent.com/szp2005/ipok-cli/main/ipok.sh) # this server's IP
bash <(curl -sL https://raw.githubusercontent.com/szp2005/ipok-cli/main/ipok.sh) 1.1.1.1 # a specific IP
```
## 流媒体 / AI 解锁（在服务器上运行）
测试**此服务器的出口 IP** 能解锁哪些内容——Netflix（完整 / 仅限原创 / 被阻止 + 区域）、ChatGPT 区域支持、YouTube Premium、TikTok：
```
bash <(curl -sL https://raw.githubusercontent.com/szp2005/ipok-cli/main/media.sh)
```
结果反映了服务器的出站 IP（代理/VPS 使用场景）。流媒体提供商经常更改 endpoint，因此请将结果视为尽力而为。
## 为什么
大多数 IP 纯净度工具只提供一个黑盒评分。IPOK 聚合了多个风险来源，并展示了 IP 被标记的**原因**，外加 AI 服务的可用性和适用场景——这些才是对代理、跨境和 AI 账户真正重要的因素。
## 免费 API（无需身份验证，启用 CORS）
CLI 仅调用了 IPOK 的公开 API。您也可以这样做：
```
curl "https://ipok.io/api/ip?ip=1.1.1.1" # full IP report (JSON)
curl "https://ipok.io/api/bgp?asn=AS13335&ip=1.1.1.1" # BGP upstreams/downstreams (RIPEstat)
curl "https://ipok.io/api/reverse-ip?ip=1.1.1.1" # domains hosted on the IP
```
文档：
### 响应结构（`/api/ip`，节选）
```
{
"geo": { "ip", "version", "country", "city", "asn", "asName", "isp", "lat", "lon" },
"ipType": "residential | hosting | mobile",
"risk": 0,
"nativeType": "native | broadcast | unknown",
"scenarios": [{ "key": "tiktok", "stars": 3, "verdict": "try" }],
"services": [{ "key": "chatgpt", "status": "available" }],
"sources": [{ "source": "ip-api", "risk": 10, "flags": {} }],
"rdap": { "registry", "country", "registered", "org" }
}
```
## 许可证
MIT —— 详见 [LICENSE](./LICENSE)。与任何提供商均无隶属关系；数据为尽力而为，仅供诊断使用。
标签：Docker 部署, GNU通用公共许可证, IP查询, MITM代理, Node.js, Python, 动态分析, 应用安全, 无后门, 网络运维, 逆向工具