VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
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:.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 表中。查找是普通的 SQLBETWEEN 查询。没有插件,没有外部 API,查询时没有网络调用。唯一的依赖是导入并定期刷新来自 MaxMind 的平面 CSV 文件。VillageSQL 的 vsql_network_address 扩展添加了 INET 类型,让 IPv4/IPv6 的处理更简洁,但基本做法并不需要它。
我可以在一个查询中把地理定位和访问日志联接起来吗?
可以——这正是把 GeoIP 数据保存在 MySQL 中的主要原因之一:故障排除
另请参阅
- 在 MySQL 中存储 IP 地址——地理定位查询之前的高效 IP 存储
- 在 MySQL 中按子网查询——地理定位所基于的范围式 IP 查找