服务器配置要求

操作系统: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.67404, // 基站定位经度WGS84
        latitude: 31.048662, // 基站定位纬度WGS84
        radius: 200,   // 基站覆盖半径
        gps_district: {
            country_code: "CN",   // 购买gps定位(区县包)后显示
            country: "中国",    // 购买gps定位(区县包)后显示
            province: "四川",   // 购买gps定位(区县包)后显示
            city: "德阳",      // 购买gps定位(区县包)后显示
            district: "中江县",   // 购买gps定位(区县包)后显示
            china_code: "510623"  // 购买gps定位(区县包)后显示
        }
    }
}
国家区域代码 MCC(中国:460)目前只支持中国

IP综合定位接口

接口: http://localhost:9988/v1/ip/location
请求: HTTP GET
参数: ip IP地址
示例:
curl "http://localhost:9988/v1/ip/location?ip=123.121.9.220"
响应:
{
    code: 0,
    data: {
        ip: "123.121.9.220",
        city_db: {  // 购买每日高级版
            country: "中国",
            province: "北京",
            city: "北京",
            org: "",
            isp: "联通",
            lat: "39.904989",
            lng: "116.405285",
            time_zone: "Asia/Shanghai",
            time_zone_2: "UTC+8",
            china_code: "110000",
            phone_prefix: "86",
            iso_2: "CN",
            continent: "AP"
        },
        district_db: { // 购买国内区县库
            country: "中国",
            province: "北京",
            city: "北京",
            district: "朝阳区",
            code: "110105",
            radius: "2.7",
            lng: "116.48548",
            lat: "39.9484"
        },
        geo_db: {  // 购买高精度IP库
            longitude: 116.51122,
            latitude: 39.917526,
            radius: 2000,
            credibility: 96,
            gps_district: { // 购买gps定位(区县包)后显示
                country_code: "CN",
                country: "中国",
                province: "北京",
                city: "北京",
                district: "朝阳区",
                china_code: "110105"
            },
            gps_aoi: [  // 购买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: "青年路商圈"
                }
            ]
        }
    }
}

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: {
        longitude: 116.51124,    // IP定位经度WGS84
        latitude: 39.917572,     // IP定位纬度WGS84
        radius: 50,             // IP覆盖半径
        credibility: 100,      // 可信度 最大值为100(即为百分百可信任)
        gps_district: {
            country_code: "CN",  // 购买gps定位(区县包)后显示
            country: "中国",      // 购买gps定位(区县包)后显示
            province: "北京",    // 购买gps定位(区县包)后显示
            city: "北京",         // 购买gps定位(区县包)后显示
            district: "朝阳区",    // 购买gps定位(区县包)后显示
            china_code: "110105"    // 购买gps定位(区县包)后显示
        }
    }
}

IP定位到区县(区县库)接口

接口: http://localhost:9988/v1/ip/district
请求: HTTP GET
参数: ip IP地址
示例:
curl "http://localhost:9988/v1/ip/district?ip=123.121.9.220"
响应:
{
    code: 0,
    data: {
        country: "中国", // 国家
        province: "北京", // 省份
        city: "北京", // 城市
        district: "朝阳区", // 区县
        code: "110105", // 行政区划代码
        radius: "2.6", // 覆盖半径
        lng: "116.48548", // 精度
        lat: "39.9484" // 维度
    }
}

IP定位到地级市(每日高级版)接口

接口: http://localhost:9988/v1/ip/city
请求: HTTP GET
参数: ip IP地址
示例:
curl "http://localhost:9988/v1/ip/city?ip=123.121.9.220"
响应:
{
    code: 0,
    data: {
        country: "中国", // 国家
        province: "北京", // 省份
        city: "北京", // 地级市
        org: "", // 所有者
        isp: "联通", // 运营商
        lat: "39.904989", // 纬度
        lng: "116.405285", // 精度
        time_zone: "Asia/Shanghai", // 时区
        time_zone_2: "UTC+8", // 时区
        china_code: "110000", // 行政区划代码
        phone_prefix: "86", // 国家电话号码
        iso_2: "CN", // 国家代码
        continent: "AP" // 大洲代码
    }
}

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: "Karma", // 数据来源
                date: 20171222, // 时间
                type: "Robot" // 行为标签
            },
            {
                name: "Karma",
                date: 20171222,
                type: "Botnet"
            }
        ],
        location: [
            "中国",   //国家
            "河南",   //省份
            "洛阳",   //城市
            "htu.cc", //所有者
            "电信/联通/移动", //运营商
            "34.663041" // 纬度(地区中心点)
            "112.434468", //经度(地区中心点)
        ],
        type: ["IDC"] //IP应用类别(UNKNOWN, CELL, IDC, ADSL, Reserved, LAN, Loopback, Backbone)
    }
}
机器人:自动化攻击的来源IP(karma捕获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 暂无数据
报告
云计算服务商2017-1H
云计算服务商2017-2H
云计算服务商2018-1H
BestTrace
Windows
Mac OS
iOS
Android
Linux
产品
IP 数据定位
IP 高精度定位
综合定位服务
网络安全基础数据
其他服务
关于IPIP
公司简介
工作机会
联系我们
隐私声明
实验室
微信公共号

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

京ICP备13047193号-1  京公网安备 11010802020247号

本网站安全防护服务由知道创宇云安全提供
本网站 SSL 证书由 TRUSTASIA 提供
本公司为 烽火台安全威胁情报联盟 成员