jjakinn/ip-reputation-api
GitHub: jjakinn/ip-reputation-api
一个用于检查IP信誉、检测VPN/代理并获取威胁情报的自托管API。
Stars: 0 | Forks: 0
# IP 信誉与威胁情报 API
检查 IP 信誉，检测 VPN/代理，并获取任意 IP 地址的威胁情报。
## 公开 URL
**基础 URL:** `https://ip-reputation-api.onrender.com`
## 端点
| 方法 | 端点 | 描述 |
|--------|----------|-------------|
| GET | `/` | 服务信息 |
| GET | `/health` | 健康检查 |
| POST | `/check` | 检查 IP 信誉 |
| GET | `/docs` | Swagger UI |
## API 用法
### 检查 IP 信誉
```
curl -X POST https://ip-reputation-api.onrender.com/check \
-H "Content-Type: application/json" \
-d '{"ip": "8.8.8.8"}'
```
### 响应
```
{
"ip": "8.8.8.8",
"risk_score": 25,
"risk_level": "low",
"is_private": false,
"is_loopback": false,
"is_reserved": false,
"is_multicast": false,
"is_datacenter": true,
"datacenter_provider": "Google Cloud",
"is_vpn": false,
"is_proxy": false,
"is_tor": false,
"reverse_dns": "dns.google",
"classification": "datacenter",
"geolocation": {
"country": "United States",
"country_code": "US",
"city": "Mountain View",
"isp": "Google LLC",
"asn": "AS15169 Google LLC"
},
"threat_intel": {
"risk_score": 25,
"risk_level": "low",
"risk_reasons": ["Datacenter/cloud hosting IP"],
"known_malicious": false
},
"timestamp": "2026-05-20T22:00:00"
}
```
## 功能特点
- **风险评分**: 0-100 分，附带低/中/高分类
- **IP 类型检测**: 私有、环回、保留、多播
- **数据中心检测**: 识别 AWS、Azure、GCP、DigitalOcean、Linode、Vultr
- **VPN/代理检测**: 使用地理位置数据库
- **反向 DNS**: PTR 查询
- **地理位置**: 国家、城市、ISP、ASN，通过 ip-api.com
- **分类**: 住宅、数据中心、移动、可疑、私有
## 本地开发
```
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload
```
## Docker 容器技术
```
docker build -t ip-reputation .
docker run -p 8000:8000 ip-reputation
```
## 许可证
MIT
标签：AV绕过, DNS通配符暴力破解, Docker, FastAPI, IP信誉检查, IP分析, IP风险评估, Python, RESTful API, Swagger, Tor检测, VPN检测, 代理检测, 反向DNS, 地理定位, 威胁情报, 威胁情报API, 安全服务, 安全防御评估, 开发者工具, 提示词优化, 数据中心识别, 无后门, 欺诈检测, 网络威胁分析, 网络安全, 请求拦截, 逆向工具, 隐私保护, 风险评分