dev.maxmind.com

MaxMind 开发者门户（dev.maxmind.com）是 MaxMind 面向开发者的技术文档与资源入口，核心围绕两类能力：IP 情报（GeoIP / GeoLite） 和 风险评分（minFraud）。如果你要开发需要识别访问者地理位置、判断交易或账号风险的应用，可以在这里找到快速入门、API 文档、数据库格式规范和客户端集成说明。门户还提供 GeoLite 账号注册入口，用于获取免费的 IP 地理定位数据。

门户覆盖的两条主线

minFraud Web Services：交易与行为风险评分

minFraud 面向需要评估风险分数的场景，例如电商支付、平台用户活动、激励流量等。门户中与它相关的内容包括：

• Transaction Risk API：用风险评分和数据识别高风险活动
• Evaluate a Transaction / Report a transaction：评估交易与回传交易结果
• Track Devices：覆盖 Web、Android、iOS
• minFraud Alerts：风险告警
• Working with Transaction Dispositions：处理交易处置结果
• Testing minFraud in the MaxMind Sandbox：在沙盒环境中测试
• API Documentation（Requests / Responses）：请求与响应说明
• Legacy Proxy Detection / Legacy Web Service：旧版代理检测与旧版 Web 服务
• minFraud Release Notes：版本更新记录

GeoIP 与 GeoLite：IP 地理定位与网络属性

GeoIP 用于内容定制、广告、数字版权管理、合规、欺诈检测、安全等场景。门户中相关内容包括：

• Geolocate an IP：对 IP 做地理定位
• Databases / Web Services：数据库与 Web 服务两种使用方式
• Client-side Javascript：客户端 JavaScript 集成
• Updating Databases：数据库更新
• Track Location Name Updates：跟踪地名更新
• Importing Databases：导入数据库，含 Import to PostgreSQL、Import to MySQL
• Web Services Documentation（Requests / Responses）：Web 服务请求与响应
• Sandbox Environment：沙盒环境
• Legacy Web Services：旧版 Web 服务

数据库文档涵盖哪些数据维度

门户的 Database Documentation 列出了 GeoIP 数据库可提供的数据类型，按需选择：

此外还有 GeoLite Databases and Web Services（免费版本）、GeoIP Exchange、Privacy Exclusions API、GeoIP Release Notes。

面向开发者的规范与辅助资源

除了产品文档，门户还提供工程实现所需的规范类内容：

• MMDB Format Spec：MaxMind 数据库文件格式规范
• OpenAPI Specs：OpenAPI 规范
• MaxMind Server IP Addresses：MaxMind 服务器 IP 地址列表
• License Key Validation API：许可证密钥校验 API
• Knowledge Base：知识库
• Contribute：参与贡献入口

如何开始使用

门户首页给出两条快速路径：

1. minFraud Web Services：通过 Quickstart 快速接入，再查阅完整文档，用于交易风险评分与高风险活动识别。
2. GeoIP / GeoLite：通过 Quickstart 快速接入，再查阅完整文档，用于 IP 地理定位与网络属性查询。

如果只需要基础的 IP 地理定位数据，可以注册 GeoLite 账号获取免费的 IP 地理定位数据；需要更完整的数据维度（如 Anonymous IP、Residential Proxy、Static IP Score 等）时，则对应 GeoIP 的付费数据库与 Web 服务文档。

适合谁使用

• 需要在支付或注册流程中做风险评分的后端开发者
• 需要按访问者地理位置做内容定制、广告或合规判断的产品与工程团队
• 需要把 IP 数据库导入 PostgreSQL / MySQL 或自行解析 MMDB 文件的数据工程师
• 需要对接 OpenAPI 规范或校验许可证密钥的集成方

如果你的需求只是判断 IP 所属国家或城市，从 GeoLite 免费数据入手即可；如果涉及代理识别、静态 IP 评分或交易风险评分，则需要查看 GeoIP 对应数据库和 minFraud 的文档与沙盒测试说明。

MaxMind 开发者门户提供两条主要产品线：minFraud 用于交易风险评分和欺诈识别，GeoIP/GeoLite 用于 IP 地理定位和网络属性查询。选择哪条线取决于你要解决的问题——判断一笔支付或用户行为是否高风险，用 minFraud；判断一个 IP 位于哪里、属于什么网络，用 GeoIP/GeoLite。

核心定位差异

minFraud 的定位是“用风险评分和数据识别高风险活动”，门户明确列举了电商支付、平台用户活动、激励流量等场景。GeoIP/GeoLite 的定位是“IP 情报”，用于内容定制、广告、数字版权管理、合规、欺诈检测、安全等。

minFraud 能做什么

minFraud 以 Web 服务形式提供，核心是 Transaction Risk API。门户列出的能力包括：

• 评估交易（Evaluate a Transaction）：对一笔交易做风险评分
• 上报交易（Report a transaction）：把交易结果反馈回去
• 设备追踪（Track Devices）：覆盖 Web、Android、iOS
• minFraud Alerts：风险告警
• 交易处置（Working with Transaction Dispositions）
• 沙盒测试（Testing minFraud in the MaxMind Sandbox）

如果你的需求是“这笔订单该不该放行”“这个用户行为是否异常”，minFraud 是直接对应的工具。它还提供 Legacy Proxy Detection 和 Legacy Web Service 等历史接口。

GeoIP/GeoLite 能做什么

GeoIP/GeoLite 提供两种使用形式：

数据库形式

• 更新数据库（Updating Databases）
• 导入数据库（Importing Databases）：支持导入 PostgreSQL、MySQL
• 数据库文档覆盖 City and Country、Enterprise、Anonymous IP、Anonymous Plus、Residential Proxy、ISP、Connection Type、Domain、ASN、Static IP Score、User Count 等数据集

Web 服务形式

• 地理定位一个 IP（Geolocate an IP）
• 客户端 JavaScript（Client-side Javascript）
• 跟踪位置名称更新（Track Location Name Updates）
• 沙盒环境（Sandbox Environment）

GeoLite 是 GeoIP 的免费版本，门户提示“注册 GeoLite 账户即可获取免费 IP 地理定位数据”。如果你的需求是“这个 IP 在哪个城市”“这个 IP 属于哪个 ASN 或 ISP”，用 GeoIP/GeoLite。

怎么选

选 minFraud，如果：

• 你要对交易做风险评分，决定放行还是拦截
• 你要识别电商支付、平台用户活动、激励流量中的高风险行为
• 你需要设备追踪或风险告警能力

选 GeoIP/GeoLite，如果：

• 你要根据 IP 做内容定制、广告投放或数字版权管理
• 你要做合规判断或安全分析
• 你只需要 IP 的地理位置或网络属性，不需要风险评分
• 你希望用数据库本地部署，或通过 Web 服务按需查询

两者可以组合使用：GeoIP 提供 IP 情报作为基础数据，minFraud 在其上做风险评分。门户把两者并列在“IP intelligence and risk scoring”之下，说明它们面向不同层次的问题，而非互相替代。

接入前需要知道的

• minFraud 和 GeoIP Web 服务都提供 沙盒环境，可以在正式接入前测试。
• GeoIP 数据库支持导入 PostgreSQL 和 MySQL，适合本地查询场景。
• GeoLite 提供免费 IP 地理定位数据，但需注册账户；具体数据覆盖范围和许可条件以门户文档为准。
• 门户还提供 MMDB 格式规范、OpenAPI 规范、License Key Validation API 和知识库，接入时可参考。

如果你的问题只是“这个 IP 在哪”，不需要 minFraud；如果问题是“这笔交易风险多大”，GeoIP 单独用不够，需要 minFraud 的评分能力。

MaxMind 开发者门户（dev.maxmind.com）是接入其 IP 情报与风险评分服务的入口，主要分两条产品线：minFraud Web Services（交易风险评分）和 GeoIP / GeoLite（IP 地理位置与网络属性）。如果你的目标是识别高风险交易，从 minFraud 入手；如果目标是按 IP 做内容定制、合规判断或安全分析，从 GeoIP / GeoLite 入手。两者都提供快速入门（Quickstart）和 API 文档，minFraud 另有沙盒环境可用于测试。

先分清两条产品线

接入 minFraud Web Services

minFraud 的核心是 Transaction Risk API：提交一笔交易，获得风险评分和相关数据，用来判断该活动是否高风险。

1. 阅读概览：先看 minFraud Overview，了解可评估的对象和整体流程。
2. 走快速入门：从 Quickstart 入手，按文档完成首次调用。
3. 评估交易：使用 Transaction Risk API 对交易进行风险评分。
4. 回传结果：通过 Report a transaction 上报交易结果，用于后续改进。
5. 在沙盒中测试：用 MaxMind Sandbox 测试 minFraud，避免直接影响生产判断。
6. 查 API 文档：Requests / Responses 说明请求与响应结构；如涉及旧接口，可参考 minFraud Legacy 与 Proxy Detection Legacy Web Service。
7. 跟踪变更：关注 minFraud Release Notes，避免接口行为变化影响集成。

相关能力还包括 Track Devices（含 Web、Android、iOS）和 minFraud Alerts，以及 Working with Transaction Dispositions 这类交易处置说明。

接入 GeoIP 与 GeoLite

GeoIP 用于获取 IP 的地理与网络属性，GeoLite 是其可免费注册获取的数据版本。

1. 阅读概览：从 GeoIP Overview 开始，明确你要做的是地理定位还是网络属性判断。
2. 选择形态：
   • 需要本地查询：使用 Databases，并参考 Updating Databases 保持数据更新。
   • 需要在线查询：使用 Web Services，参考 Web Services Documentation 的 Requests / Responses。
   • 需要在浏览器端判断：使用 Client-side Javascript。
3. 导入数据库：如需入库查询，可按文档导入 PostgreSQL 或 MySQL。
4. 按需选数据维度：数据库文档覆盖 City and Country、Enterprise、Anonymous IP、Anonymous Plus、Residential Proxy、ISP、Connection Type、Domain、ASN、Static IP Score、User Count 等。
5. 免费起步：注册 GeoLite 账号即可获取免费 IP 地理定位数据；GeoLite Databases and Web Services 是对应入口。
6. 跟踪变更：关注 GeoIP Release Notes 和 Track Location Name Updates。

通用配套资源

无论走哪条线，这些资源都会用到：

• MaxMind Server IP Addresses：确认服务端 IP 范围。
• License Key Validation API：校验许可密钥。
• MMDB Format Spec：数据库文件格式规范。
• OpenAPI Specs：接口规范文件。
• Knowledge Base：常见问题与操作说明。
• Contribute：参与贡献的入口。

常见卡点

• 测试环境用错：minFraud 有 Sandbox，正式判断前先在沙盒验证请求与响应，避免把测试数据混入生产。
• 数据库忘记更新：使用 Databases 时需按 Updating Databases 定期更新，否则地理与网络属性会过时。
• 接口版本混淆：文档中同时存在当前接口与 Legacy 接口（如 minFraud Legacy、Legacy Web Services），集成前确认自己用的是哪一套。
• 免费范围误解：GeoLite 可注册免费账号获取数据；minFraud 的定价与登录限制在现有资料中未说明，接入前需自行确认账号与授权条件。

MaxMind 的 GeoIP 产品线可以分成三层：地理定位数据库（City、Country）、网络与机构属性数据库（ISP、Domain、ASN、Connection Type 等）、匿名与风险检测数据库（Anonymous IP、Anonymous Plus、Residential Proxy、Static IP Score）。GeoLite 是同一套数据体系的免费版本，字段范围更窄；Web Services 则把这些数据库以 API 形式提供，免去自行更新文件的步骤。选择哪一款，取决于你需要的是“IP 在哪里”，还是“这个 IP 背后是谁、是否可疑”。

地理定位类数据库

City 与 Country

• Country：只回答 IP 所属国家/地区，字段最少，适合做地区跳转、内容本地化这类只需国家级判断的场景。
• City：在国家级之上补充城市、行政区、邮政编码、经纬度、时区等更细的地理信息，适合广告定向、内容定制、合规判断。

两者是包含关系：City 覆盖 Country 的信息并向下细化。如果你的业务只需要“是不是某个国家的用户”，用 Country 即可，不必为城市级精度付费。

Enterprise

Enterprise 是地理定位的合集型产品，把 City 级别的地理数据与后文的网络属性、匿名检测数据打包在一起，适合同时需要“位置 + 网络属性 + 风险信号”的场景，例如风控、数字版权管理、访问合规。它面向的是需要多维度判断、不想分别采购多个数据库的用户。

网络与机构属性数据库

这一组回答的不是“IP 在哪”，而是“这个 IP 属于谁、是什么类型的连接”：

这些字段常被组合使用。例如识别企业网络、区分住宅与数据中心流量、判断某个 IP 是否代表大量共享用户，都会用到上表中的一项或多项。

匿名与风险检测数据库

• Anonymous IP：判断 IP 是否来自匿名化渠道，例如 VPN、代理、Tor 出口节点、托管/数据中心。
• Anonymous Plus：在 Anonymous IP 的基础上提供更细的匿名类型与相关信号。
• Residential Proxy：专门识别住宅代理——这类 IP 看起来像普通家庭宽带，但实际被用于代理转发，是传统匿名检测容易漏掉的一类。
• Static IP Score：给 IP 打一个“静态程度”的分值，辅助判断地址稳定性。

如果你的目标是反欺诈、反刷量、识别规避行为，这一组是关键；如果只是做地理展示，通常不需要它们。

GeoLite 与 Web Services 的关系

GeoLite 是 MaxMind 提供的免费 IP 地理定位数据，字段范围小于对应的付费 GeoIP 产品，适合开发测试、非商业或精度要求不高的场景。官网明确提供注册 GeoLite 账号以获取免费 IP 地理定位数据的入口。

Web Services 与数据库是同一批数据的两种交付方式：

• 数据库：下载文件到本地，自行集成和定期更新（支持导入 PostgreSQL、MySQL 等）。
• Web Services：通过 API 请求实时查询，由 MaxMind 维护数据更新，无需自己管理文件。

此外还有 Client-side JavaScript 方式，用于在浏览器端获取位置信息。选择哪种交付方式，取决于你是否愿意承担本地更新和存储的成本。

怎么选

• 只要国家/地区 → Country
• 要城市级定位 → City
• 要位置 + 网络属性 + 匿名检测 → Enterprise
• 只要网络/机构属性 → 按需选 ISP、Domain、ASN、Connection Type、User Count、Static IP Score
• 只要匿名/代理识别 → Anonymous IP、Anonymous Plus、Residential Proxy
• 预算有限或做开发测试 → 先看 GeoLite，确认字段够用再升级

具体每款产品包含哪些字段、是否单独售卖，以 MaxMind 开发者门户对应产品的文档页为准；不同产品在字段覆盖和精度上存在差异，采购前建议对照文档逐项核对。

MaxMind 的 API 文档、OpenAPI 规范、MMDB 格式规范和知识库都集中在开发者门户 dev.maxmind.com 上。门户首页把入口分成两条主线：minFraud Web Services（交易风险评分）和 GeoIP / GeoLite（IP 地理位置与网络情报）。如果你要找的是某个具体接口的请求/响应字段，走对应产品的 API Documentation；如果要看机器可读的接口定义或数据库文件格式，走 OpenAPI Specs 和 MMDB Format Spec；如果是要排查集成问题或查更新记录，走 Knowledge Base 和 Release Notes。

minFraud 相关文档入口

minFraud 是交易风险评分服务，门户首页给出的入口包括：

• minFraud Overview：产品总览
• Evaluate a Transaction / Report a transaction：交易评估与上报
• Track Devices（Web、Android、iOS）：设备追踪
• minFraud Alerts：告警
• Working with Transaction Dispositions：交易处置结果的处理
• Testing minFraud in the MaxMind Sandbox：沙箱测试
• API Documentation（Requests / Responses）：接口请求与响应说明
• minFraud Legacy：旧版接口
• Proxy Detection Legacy Web Service：旧版代理检测服务
• minFraud Release Notes：版本更新记录

需要评估一笔交易时，先看 Evaluate a Transaction 了解输入字段，再看 API Documentation 的 Requests/Responses 确认返回结构；正式接入前用 Sandbox 环境验证，避免用生产数据试错。

GeoIP 与 GeoLite 相关文档入口

GeoIP 和 GeoLite 覆盖数据库和 Web 服务两种交付方式，门户列出的入口包括：

• Geolocate an IP：单 IP 查询
• Databases / Web Services：数据库与 Web 服务两种形态
• Client-side Javascript：浏览器端调用
• Updating Databases：数据库更新
• Track Location Name Updates：地名变更跟踪
• Importing Databases：导入数据库，含 Import to PostgreSQL 和 Import to MySQL
• Web Services Documentation（Requests / Responses / Sandbox Environment）
• Legacy Web Services：旧版 Web 服务
• Database Documentation：数据库字段文档，按产品分列，包括 City and Country、Enterprise、Anonymous IP、Anonymous Plus、Residential Proxy、ISP、Connection Type、Domain、ASN、Static IP Score、User Count
• GeoLite Databases and Web Services：免费版本
• GeoIP Exchange、Privacy Exclusions API、GeoIP Release Notes

选型时先确定用数据库还是 Web 服务：数据库适合本地高频查询、需要自行控制更新节奏的场景；Web 服务适合不想维护本地文件、按请求调用的场景。字段差异看 Database Documentation 下对应产品的页面，不要假设所有产品字段一致。

规范与格式文档

门户单独列出了两类规范：

• MMDB Format Spec：MaxMind 数据库文件（.mmdb）的二进制格式规范。需要自己解析数据库文件、或验证第三方读取库是否正确时看这里。
• OpenAPI Specs：接口的机器可读定义。用于生成客户端代码、导入 Postman/Apifox 等工具，或核对字段类型。

知识库、贡献与其他入口

• Knowledge Base：集成与使用问题的排查入口。
• Contribute：贡献渠道。
• MaxMind Server IP Addresses：MaxMind 服务器 IP 列表，配置防火墙白名单时需要。
• License Key Validation API：许可证密钥校验接口。

按需求找入口的对照

GeoLite 账号可以注册获取免费的 IP 地理位置数据，具体覆盖范围和字段以 GeoLite Databases and Web Services 页面为准。