数据库文档

离线数据库与本站查询使用同一份数据，部署在你自己的服务器上本地查询，不依赖网络，也没有调用次数限制。每个版本都提供 mmdb 和 xdb 两种格式，覆盖 IPv4 和 IPv6。

• mmdb：一个文件同时包含 IPv4 和 IPv6，字段最全（含中英文名称），数据结构兼容 GeoIP2-City，可以直接使用现有的 mmdb 读取库。
• xdb：IPv4、IPv6 各一个文件，每条记录是用 | 分隔的 18 段文本，体积小、查询快，适合高并发场景。
• 每月 1 号更新；同一版本的文件名固定，替换文件即可升级。

文件与版本

文件名由版本代号决定，以 ipdb-enterprise 为例：

各版本包含的字段不同，见下方字段表的「包含于」一列；完整对比见 数据库下载。

字段说明

mmdb 路径用点号表示层级，[0] 表示数组第一项；xdb 位置是 18 段区域文本中的第几段，「—」表示 xdb 中不包含该字段。示例来自 42.203.32.1 的真实记录。

地理位置

网络 / ASN

英文名称

国际化

mmdb 格式

mmdb 的数据结构兼容 GeoIP2-City：continent、country、subdivisions、city、location 与标准结构一致，名称提供 zh-CN 和 en 两种语言；运营商、ASN、使用类型放在 traits 中，区县、行政区划代码等扩展字段放在 extra 中。

以 42.203.32.1 为例，全部字段的记录如下（字段较少的版本只包含其中一部分）：

{
  "continent": { "code": "AS", "names": { "en": "Asia", "zh-CN": "亚洲" } },
  "country": { "iso_code": "CN", "names": { "en": "China", "zh-CN": "中国" } },
  "registered_country": { "iso_code": "CN", "names": { "en": "China", "zh-CN": "中国" } },
  "subdivisions": [ { "names": { "en": "Liaoning", "zh-CN": "辽宁" } } ],
  "city": { "names": { "en": "Anshan", "zh-CN": "鞍山" } },
  "location": { "latitude": 41.089748, "longitude": 122.990852, "time_zone": "Asia/Shanghai" },
  "isp": "中国电信",
  "autonomous_system_number": 4134,
  "autonomous_system_organization": "CHINANET BACKBONE",
  "traits": {
    "isp": "中国电信",
    "autonomous_system_number": 4134,
    "autonomous_system_organization": "CHINANET BACKBONE",
    "domain": "chinatelecom.com.cn",
    "user_type": "broadband"
  },
  "extra": {
    "district": { "en": "Tiedong", "zh-CN": "铁东" },
    "geo_id": "210302",
    "country_alpha3": "CHN",
    "currency_code": "CNY",
    "phone_prefix": "86",
    "languages": "zh-CN",
    "emoji_flag": "🇨🇳",
    "usage_type": "Broadband"
  }
}

文件元数据中 database_type 为 IP-City，languages 为 zh-CN 和 en，description 包含版本名称和数据月份，build_epoch 是生成时间。

xdb 格式

xdb 为 IPv4、IPv6 两个文件（v3 结构，向量索引）。每个网段对应一条用 | 分隔的 18 段区域文本，没有数据的段为空：

示例（42.203.32.1）：

亚洲|中国|辽宁|鞍山|铁东|中国电信|122.990852|41.089748|210302|86||Asia/Shanghai|CNY|AS4134|Broadband|||CN

xdb 只包含中文名称；英文名称、国家三位代码、语言、国旗、AS 名称和 AS 域名只在 mmdb 中提供。ASN 带 AS 前缀。

读取示例

以下为通用写法（伪代码），各语言的 mmdb / xdb 读取库用法类似：打开文件，按 IP 查询，再按字段路径或段号取值。请把文件名换成你下载的版本。

mmdb

用任意 mmdb 读取库打开文件，按 IP 查询返回一个嵌套的字典 / 对象，按上表的 mmdb 路径取值；没有记录时返回空。

db     = open_mmdb("ipdb-enterprise.mmdb")
record = db.lookup("42.203.32.1")

country  = record.country.names["zh-CN"]           // 中国
province = record.subdivisions[0].names["zh-CN"]   // 辽宁
city     = record.city.names["zh-CN"]              // 鞍山
district = record.extra.district["zh-CN"]          // 铁东
isp      = record.traits.isp                       // 中国电信
asn      = record.traits.autonomous_system_number  // 4134
lat, lon = record.location.latitude, record.location.longitude

xdb

用支持 v3 结构的 xdb 查询库打开对应 IP 版本的文件（IPv6 用 -v6.xdb），查询返回一条区域文本，按 | 拆成 18 段后按段号取值（下标从 0 开始，即上表位置减 1）。

db     = open_xdb("ipdb-enterprise-v4.xdb")
region = db.search("42.203.32.1")
// "亚洲|中国|辽宁|鞍山|铁东|中国电信|122.990852|41.089748|210302|86||Asia/Shanghai|CNY|AS4134|Broadband|||CN"

parts   = split(region, "|")
country = parts[1]    // 中国
city    = parts[3]    // 鞍山
isp     = parts[5]    // 中国电信
asn     = parts[13]   // AS4134

下载与更新

购买套餐后，在 会员中心 下载已购版本的文件，或复制带 API Key 的 curl 命令。

在服务器上拉取（API Key 放在请求头中，支持断点续传）：

/api/databases 返回已购版本的文件清单（大小、SHA-256、构建时间），可以用来校验文件和判断是否有新版本，详见 API 文档。

数据每月 1 号更新，例如每月 2 号凌晨 4 点自动拉取最新版本：

0 4 2 * * curl -sfL -o /opt/ipdb/ipdb-enterprise.mmdb.new -H "Authorization: Bearer ipk_xxx" https://bgp.cx/dl/ipdb-enterprise.mmdb && mv /opt/ipdb/ipdb-enterprise.mmdb.new /opt/ipdb/ipdb-enterprise.mmdb

注意事项

• 没有数据的字段不会出现在 mmdb 记录中，在 xdb 中为空段。
• 私有和保留地址（如 10.0.0.0/8、192.168.0.0/16）不在 mmdb 中，查询没有结果；xdb 中返回标记为保留的记录。
• 经纬度是所在行政区的中心点，只适合地区级展示，不能用于精确定位。
• 数据仅供购买账号在授权范围内使用，不得转售或公开分发。