服务器配置要求

操作系统:CentOS7.2+ / Ubuntu15.04+

最低配置: 8 核心 CPU / 32G 可用内存 / 500G SSD 可用空间

推荐配置:16 核心 CPU / 64G 可用内存 / 500G SSD 可用空间

请根据各自需求情况自行测试好硬件情况。

安装与启动

先给予可执行权限: chmod +x ios (注:下载文件名称格式为 ios_数字 重命名即可)

直接启动:nohup ./ios --config=/etc/ipip.json &

安装服务:sudo ./ios --install --config=/etc/ipip.json

ipip.json 参数明细

{
    "//":[
        "data_path 数据存放目录,首次启动会下载数据到此目录。",
        "log_path 日志存放目录",
        "bind_addr (只能内网IP: 10.0.0.0/8,100.64.0.0/10,127.0.0.0/8,172.16.0.0/12,192.168.0.0/16)"
    ],
    "data_path":"/home/online/data",
    "log_path":"/home/online/log",
    "bind_addr":"127.0.0.1"
}

安装服务:sudo ./ios --install

启动服务:sudo ./ios --start

停止服务:sudo ./ios --stop

服务状态:sudo ./ios --status

删除服务:sudo ./ios --remove

OnlineServer状态

接口地址 http://localhost:9988/online/status
请求方式 HTTP GET
响应
{
    up_time: 123,
    active_connections: 1,
    server: 0,
    accepts: 6,
    handled_requests: 0,
    api: {
        ip_geo_hit: 0,
        ip_geo_miss: 0,
        cell_hit: 0,
        cell_miss: 0,
        wifi_hit: 0,
        wifi_miss: 0,
    }
}

检查数据更新

接口地址 http://localhost:9988/check/update
请求方式 HTTP GET
响应
ok

通用基站接口

接口: http://localhost:9988/v1/cell
请求: HTTP GET
参数: mcc 国家区域代码(说明)
mnc 运营商代码
lac 小区代码
cid 基站号
示例
curl "http://localhost:9988/v1/cell?lac=32888&cid=100543749&mnc=0&mcc=460"
响应:
{
  "code": 0,
  "data": {
    "longitude": 104.67396,
    "latitude": 31.048176,
    "radius": 200,
    "gps_district": {
      "country_code": "CN",
      "country": "中国",
      "province": "四川",
      "city": "德阳",
      "district": "中江县",
      "china_code": "510623"
    },
    "gps_aoi": [
      {
        "country_code": "CN",
        "country": "中国",
        "province": "四川",
        "city": "德阳",
        "district": "中江县",
        "china_code": "510623",
        "aoi_type": "住宅小区",
        "aoi_name": "万世达维克小镇"
      }
    ]
  }
}
国家区域代码 MCC(中国:460)目前只支持中国

IP高精度定位接口

接口: http://localhost:9988/v1/ip/geo
请求: HTTP GET
参数: ip IP地址
示例:
curl "http://localhost:9988/v1/ip/geo?ip=123.121.9.220"
响应:
{
	"code": 0,
	"data": {
		"ip": "123.121.162.225",
		"longitude": 116.409134,
		"latitude": 40.04252,
		"radius": 200,
		"credibility": 99,
		"gps_district": {
			"country_code": "CN",
			"country": "中国",
			"province": "北京",
			"city": "北京",
			"district": "朝阳区",
			"china_code": "110105"
		},
		"gps_aoi": [{
			"country_code": "CN",
			"country": "中国",
			"province": "北京",
			"city": "北京",
			"district": "朝阳区",
			"china_code": "110105",
			"aoi_type": "住宅小区",
			"aoi_name": "华发颐园"
		}, {
			"country_code": "CN",
			"country": "中国",
			"province": "北京",
			"city": "北京",
			"district": "朝阳区",
			"china_code": "110105",
			"aoi_type": "商圈",
			"aoi_name": "北苑"
		}]
	}
}

WIFI接口

接口: http://localhost:9988/v1/wifi
请求: HTTP GET
参数: bid mac地址
ssid SSID
示例:
curl "http://localhost:9988/v1/wifi?mac=286c070a2669&ssid=fangzheng"
响应:
{
    code: 0, // code 等于0说明请求成功
    error: "...." // code 不等于0时候的提示信息
    data: {
        longitude: 116.48943,   // WIFI定位经度WGS84
        latitude: 39.910435,    // WIFI定位纬度WGS84
        gps_district: {
            country_code: "CN",    // 购买gps定位(区县包)后显示
            country: "中国",      // 购买gps定位(区县包)后显示
            province: "北京",   // 购买gps定位(区县包)后显示
            city: "北京",      // 购买gps定位(区县包)后显示
            district: "朝阳区",   // 购买gps定位(区县包)后显示
            china_code: "110105"    // 购买gps定位(区县包)后显示
        }
    }
}

GPS经纬度定位接口

接口: http://localhost:9988/v1/gps
请求: HTTP GET
参数: lat 纬度
lng 经度
示例:
curl "http://localhost:9988/v1/gps?lat=39.121121&lng=117.12121"
响应:
{
    code: 0,
    data: {
        longitude: 116.32599,
        latitude: 40.0023,
        gps_district: { // 如果已购AOI,此处不显示
            country_code: "CN",    // 购买gps定位(区县包)后显示
            country: "中国",      // 购买gps定位(区县包)后显示
            province: "北京",   // 购买gps定位(区县包)后显示
            city: "北京",      // 购买gps定位(区县包)后显示
            district: "朝阳区",   // 购买gps定位(区县包)后显示
            china_code: "110105"    // 购买gps定位(区县包)后显示
        }
        gps_aoi: [ // 数组,可多条
            {
                country_code: "CN",  // 购买gps定位(AOI)后显示
                country: "中国",  // 购买gps定位(AOI)后显示
                province: "北京",  // 购买gps定位(AOI)后显示
                city: "北京",  // 购买gps定位(AOI)后显示
                district: "海淀区",  // 购买gps定位(AOI)后显示
                china_code: "110108", // 购买gps定位(AOI)后显示
                aoi_type: "高校学院",  // 购买gps定位(AOI)后显示
                aoi_name: "清华大学"   // 购买gps定位(AOI)后显示
            }
        ]
    }
}

GPS经纬度定位附近接口

接口: http://localhost:9988/v1/gps/nearby
请求: HTTP GET
参数: lat 纬度
lng 经度
distance 距离(可选;单位:米;默认为:200,最大支持500)
示例:
curl "http://localhost:9988/v1/gps/nearby?lat=39.121121&lng=117.12121"
响应:
{
    code: 0,
    data: {
        longitude: 116.32599,
        latitude: 40.0023,
        gps_aoi: [ // 数组,可多条
            {
                country_code: "CN",  // 购买gps定位(AOI)后显示
                country: "中国",  // 购买gps定位(AOI)后显示
                province: "北京",  // 购买gps定位(AOI)后显示
                city: "北京",  // 购买gps定位(AOI)后显示
                district: "海淀区",  // 购买gps定位(AOI)后显示
                china_code: "110108", // 购买gps定位(AOI)后显示
                aoi_type: "高校学院",  // 购买gps定位(AOI)后显示
                aoi_name: "清华大学"   // 购买gps定位(AOI)后显示
            }
        ]
    }
}

综合定位接口

接口: http://localhost:9988/v1/location
请求: HTTP POST
参数: recommend 推荐(yes|no)
示例:
curl http://localhost:9988/v1/location?recommend=yes -d'{"cell":{"mcc":460,"mnc":11,"lac":1,"cid":1},"ip":"123.121.9.220","wifi":{"mac":"286c070a2669","sid":"fangzheng"}}'
响应:
{
	"wifi": {
		"longitude": 116.48943,
		"latitude": 39.910435,
		"gps_district": {
			"country_code": "CN",
			"country": "中国",
			"province": "北京",
			"city": "北京",
			"district": "朝阳区",
			"china_code": "110105"
		}
	},
	"ip_geo": {
		"longitude": 116.51122,
		"latitude": 39.917526,
		"radius": 2000,
		"gps_district": {
			"country_code": "CN",
			"country": "中国",
			"province": "北京",
			"city": "北京",
			"district": "朝阳区",
			"china_code": "110105"
		}
	},
	"cell": {
		"longitude": 117.18914,
		"latitude": 34.27323,
		"radius": 200,
		"gps_district": {
			"country_code": "CN",
			"country": "中国",
			"province": "江苏",
			"city": "徐州",
			"district": "鼓楼区",
			"china_code": "320302"
		}
	},
	"recommend": {
		"longitude": 116.48943,
		"latitude": 39.910435,
		"gps_district": {
			"country_code": "CN",
			"country": "中国",
			"province": "北京",
			"city": "北京",
			"district": "朝阳区",
			"china_code": "110105"
		}
	}
}

IP信誉接口

接口: http://localhost:9988/v1/ip/reputation
请求: HTTP GET
参数: ip IP地址
示例:
curl "http://localhost:9988/v1/ip/reputation?ip=42.51.12.61"
响应:
{
    code: 0,
    data: {
        ip: "42.51.12.61",
        now: [ // 三个月内的行为标签
            "Robot", // 机器人
            "BruteForce", // 撞库
            "Spider", // 爬虫
            "Abuse", // 刷量
            "Botnet", // 僵尸网络
            "Spam", // 垃圾邮件
            "Fraud", // 欺诈
            "Malware", // 恶意软件
            "Proxy", // 代理
            "P2P", // 僵尸网络P2P节点
            "Hijacked", // 劫持
            "Exploit", // 漏洞利用
            "Attacks", // 网络攻击
            "Compromised", // 失陷主机
            "C2", // 远控
            "BlackDNS", // 黑DNS
            "Phishing", // 钓鱼
        ],
        history: [ // 三到六个月内的行为标签
            "Robot",
            "Botnet"
        ],
        origin_list: [// 来源
            {
                name: "ibm",
                date: 20171222,
                type: "Botnet"
            }
        ],
        location: [
            "中国",   //国家
            "河南",   //省份
            "洛阳",   //城市
            "htu.cc", //所有者
            "电信/联通/移动", //运营商
            "34.663041" // 纬度(地区中心点)
            "112.434468", //经度(地区中心点)
        ],
        type: ["IDC"] //IP应用类别(UNKNOWN, CELL, IDC, ADSL, Reserved, LAN, Loopback, Backbone)
    }
}
机器人:自动化攻击的来源IP
撞库:撞库攻击来源IP
爬虫:爬虫攻击来源IP
刷量:刷访问量、下载量、播放量等的来源IP
僵尸网络:受C2C分布式控制的机器的IP,比如DDoS肉鸡
垃圾邮件:发送垃圾邮件服务器的IP
欺诈:高风险欺诈性的IP
恶意软件:与恶意软件相关联的IP,比如C2C的IP、托管恶意软件服务器的IP、挂马服务器的IP等
代理:代理IP
恶意P2P节点:有不良行为的P2P节点
劫持:未被授权使用的IP
网络攻击:网络攻击(比如SSH爆破、Telnet爆破等)来源IP
失陷主机:失陷主机IP
黑DNS:黑DNS
钓鱼:钓鱼网站IP
Tor节点:Tor节点IP
                            

IP端口协议(代理识别)接口

接口: http://localhost:9988/v1/ip/port
请求: HTTP GET
参数: ip IP地址
示例:
curl "http://localhost:9988/v1/ip/port?ip=8.8.8.8"
响应:
{
    code: 0,
    data: {
        ip: "8.8.8.8", // 查询IP
        is_proxy_maybe: false, // 是否可能为代理
        ports: [
            {
                port: 53, // 端口号
                date: 20180113, // 时间
                protocol: "dns" // 协议
            }
        ]
    }
}

IP资产数据接口

接口: http://localhost:9988/v1/ip/property
请求: HTTP GET
参数: ip IP地址
示例:
curl "http://localhost:9988/v1/ip/property?ip=8.8.8.8"
响应:
{
    code: 0,
    data: {
        ip: "8.8.8.8",
        asn_list: [
            {
                id: "3356",
                source: "arin",
                info: "LEVEL3 - Level 3 Communications, Inc., US",
                start_ip: "8.0.0.0",
                end_ip: "8.255.255.255"
            },
            {
                id: "3356",
                source: "arin",
                info: "LEVEL3 - Level 3 Communications, Inc., US",
                start_ip: "8.0.0.0",
                end_ip: "8.127.255.255"
            },
            {
                id: "9",
                source: "arin",
                info: "CMU-ROUTER - Carnegie Mellon University, US",
                start_ip: "8.8.8.0",
                end_ip: "8.8.8.255"
            },
            {
                id: "15169",
                source: "arin",
                info: "GOOGLE - Google LLC, US",
                start_ip: "8.8.8.0",
                end_ip: "8.8.8.255"
            }
        ],
        ports: [
            {
                port: 53,
                date: 20180113,
                protocol: "dns"
            }
        ],
        location: [
            "GOOGLE.COM", // 所属国家
            "GOOGLE.COM", // 所属省份
            "",             //所属城市
            "google.com",  // 拥有者
            "level3.com"  // 运营商
        ]
    }
}
错误码列表
code 错误描述 备注
0 成功
403 服务不存在或者服务到期
404 暂无数据
行业报告
云计算服务商2019-1H
云计算服务商2018-2H
云计算服务商2018-1H
云计算服务商2017-2H
云计算服务商2017-1H
产品服务
IP 地理位置定位
IP 应用场景
IPv4 高精度定位
IPv6 地理位置库
IPv4 风险画像
网络安全基础数据
BestTrace
Windows
Mac OS
iOS
Android
Linux
网络工具
TraceRoute
PING
IP/ASN Whois 查询
Country ASNs
Internet eXchange
Best NetTools
关于IPIP
公司简介
工作机会
隐私声明
联系我们
实验室
联系我们
电     话:010-85867767
售后技术QQ:290525907
邮     件:sales(at)ipip.net
用户交流群:907401083
数据反馈:correction(at)ipip.net

© 2013 - 2023 北京天特信科技有限公司 所有权利保留

本网站 SSL 证书由 TRUSTASIA 提供
本网站安全防护服务由 上海云盾 提供

京ICP备15064887号-6  京公网安备 11010502045129号