跳转到主要内容

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
MySQL 中的 IP 地理定位的工作方式是:导入一个把 IP 范围映射到位置的数据库,然后用范围检查查询它。标准做法把 IP 范围存储为整数并使用 BETWEEN。VillageSQL 的 INET 类型让 schema 更具表达力,并在同一张表中处理 IPv4 和 IPv6。

IP 地理定位的工作原理

没有任何 MySQL 函数能把 IP 映射到国家。地理定位是一个查找问题:您有一张 IP 范围表——每一行说“从 X 到 Y 的地址在国家 Z”——然后您找出哪个范围包含传入的 IP。 像 MaxMind GeoLite2 这样的免费数据库以 CSV 文件的形式提供这些范围,供您导入 MySQL。

标准做法:整数范围

MaxMind GeoLite2(以及类似的数据库)提供的 network 是 CIDR 字符串,并以整数形式提供每个范围的起止值。整数做法紧凑且对索引友好:
这很快——start_ip 上的索引使范围扫描高效。局限是它只适用于 IPv4。IPv6 需要一张单独的表(使用 VARBINARY(16) 范围)。

使用 VillageSQL:用 INET 统一 IPv4/IPv6

VillageSQL 的 INET 类型以自然的顺序存储 IPv4 和 IPv6 地址,因此您可以用一张表同时存放两个地址族。inet_compare() 在范围检查中取代 BETWEEN。

按 CIDR 网络存储(替代 schema)

如果您的 GeoIP 数据提供的是 CIDR 块而不是起止对,请为网络列使用 CIDR,并通过子网查询判断包含关系:

选择方法

对于纯 IPv4 和最高的查询速度,INT UNSIGNED + BETWEEN 做法很难被超越。对于需要在一张表中同时处理 IPv4 和 IPv6 的 schema,INET 配合 inet_compare 更简洁,并且避免维护两张平行的表。

比较地理定位数据源

查询 schema 只是决策的一半——数据源决定了准确性、新鲜度和成本。以下是常见选项的比较: 国家级准确率数字由提供商自行报告,并因地区而异——在所有数据源中,亚太和拉美地区的覆盖率往往低于北美和欧洲。 如何选择:MaxMind GeoLite2 是标准的起点——它免费,以平面文件的形式提供,导入一次即可,并且查找完全在 MySQL 内部运行,没有外部依赖。对于生产环境中的城市级准确率,GeoIP2 Precision 是升级路径。基于 API 的数据源(ip-api.com、ipinfo.io)对低流量使用很方便,但会给每次查找增加 HTTP 延迟和速率限制的约束。

何时使用每种方法

导入 GeoLite2 数据

MaxMind GeoLite2(免费,需注册)提供 CSV 文件。对于基于范围的 schema:
MaxMind 还提供二进制的 .mmdb 格式,以及面向 Python、Node.js 和 Go 等语言的官方客户端库,在高流量场景下比 SQL 查找更快。

常见问题

我应该在 MySQL 中还是在应用程序代码中做地理定位?

对于高流量查找(每个 HTTP 请求),使用 MaxMind 的 .mmdb 读取器库在应用层做地理定位更快——在内存中二分查找,无需 SQL 往返。基于 SQL 的地理定位适合批量分析、报表查询,以及已经在 MySQL 中运行的数据流水线。

如何让 GeoIP 数据库保持最新?

MaxMind 每周更新 GeoLite2。编写脚本定期下载,并对地理定位表执行 TRUNCATE + 重新加载。或者,使用 MaxMind 的 mmdbinspect 或刷新脚本应用增量更新。

MySQL 中的 IP 地理定位有多准确?

准确性完全取决于数据源,而不是 MySQL schema。在国家级别,MaxMind GeoLite2(免费)对大约 98% 的 IPv4 地址是准确的。在城市级别,它降到 80% 左右。要获得更高的准确率,MaxMind 的付费产品 GeoIP2 Precision 达到约 99.8% 的国家级和约 85–90% 的城市级准确率。没有任何数据库是完美的——对于移动网络、VPN 和某些亚太地区的范围,准确率通常更低。MySQL 的查询方式对准确性没有影响;您得到的正是导入的数据所说的。

MySQL 可以在没有插件或外部 API 的情况下查找 IP 地理位置吗?

可以。标准做法——也是本指南所介绍的——使用一个 GeoIP 数据库(例如 MaxMind GeoLite2),以整数范围的形式导入到普通的 MySQL 表中。查找是普通的 SQL BETWEEN 查询。没有插件,没有外部 API,查询时没有网络调用。唯一的依赖是导入并定期刷新来自 MaxMind 的平面 CSV 文件。VillageSQL 的 vsql_network_address 扩展添加了 INET 类型,让 IPv4/IPv6 的处理更简洁,但基本做法并不需要它。

我可以在一个查询中把地理定位和访问日志联接起来吗?

可以——这正是把 GeoIP 数据保存在 MySQL 中的主要原因之一:

故障排除

另请参阅