服务器配置要求

操作系统: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
云计算服务商2018-2H
产品服务
IP 数据定位
IP 高精度定位
综合定位服务
网络安全基础数据
其他服务
BestTrace
Windows
Mac OS
iOS
Android
Linux
网络工具
Whois 查询
Country ASNs
Internet eXchange
Best NetTools
关于IPIP
公司简介
工作机会
联系我们
隐私声明
实验室
微信公共号

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

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

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