jackjyq / ip

考拉IP归属地，可查询用户IP地址及归属地, 及设备型号、操作系统及浏览器版本。

考拉 IP 归属地

查询我的 IP 地址、归属地、设备类型、操作系统、浏览器版本、屏幕分辨率、经纬度、地理位置等。

API 文档

我的 IP(文本格式)

HTTP GET：https://ip.jackjyq.com/text

或: curl 'https://ip.jackjyq.com/'

我的 IP(JSON 格式)

HTTP GET：https://ip.jackjyq.com/json

或: curl 'https://ip.jackjyq.com/' -H 'Content-Type: application/json'

批量查询 IP 归属地

HTTP POST: https://ip.jackjyq.com/ips

请求:

{
  "ips": ["127.0.0.1", "114.114.114.114", "8.8.8.8"],
  "database": "both"
}

database 选项：

• both: 默认值，返回完整
• ip2region: 速度快，请求数量大
• GeoLite2: 可选

返回:

{
  "127.0.0.1": {
    "ip": "127.0.0.1",
    "country": null,
    "region": null,
    "province": null,
    "city": "内网IP",
    "isp": "内网IP",
    "database_name": "ip2region",
    "database_href": "https://gitee.com/lionsoul/ip2region/"
  },
  "114.114.114.114": {
    "ip": "114.114.114.114",
    "country": "**",
    "region": null,
    "province": "江苏省",
    "city": "南京市",
    "isp": null,
    "database_name": "ip2region",
    "database_href": "https://gitee.com/lionsoul/ip2region/"
  },
  "8.8.8.8": {
    "ip": "8.8.8.8",
    "country": "美国",
    "region": null,
    "province": "加州",
    "city": "洛杉矶",
    "isp": null,
    "database_name": "GeoLite2",
    "database_href": "https://www.maxmind.com/"
  }
}

部署运行

系统要求

操作系统：

实测：兼容 Ubuntu 22 LTS、Ubuntu 22 LTS for WSL2、macOS

理论：因用到 sh 而不兼容 Windows.

Python 版本：

实测: Python 3.10

理论: 不清楚

安装

# 配置虚拟环境
python3.10 -m venv venv
pip install -r requirements.txt

# 更新 ip2region 数据库
python upgrade_ip2region.py

# 更新 GeoLite2 数据库
chmod +x upgrade_GeoLite2.sh && ./upgrade_GeoLite2.sh

# 安装 whois
sudo apt install whois

运行

# 调试模式
DEBUG=True python main.py runserver

# 生产模式
gunicorn --workers 3 --worker-class=gevent main

数据源

IP 归属地

• 国内 IP: ip2region
• 国外 IP: MaxMind GeoLite2

经纬度位置

• Nominatim

参考

• Information about your Web browser