推荐使用 IP2Region 本地库：免费、高性能、离线可用；安装 go get 包，下载 ip2region.db，用 NewSearcher 查询，结果按“国家|区域|省份|城市|ISP”顺序以 | 分隔。
用 Go 实现 IP 地理信息查询，核心是获取 IP 对应的国家、省份、城市、运营商等信息。这通常不靠自己“识别”，而是调用本地 IP 库（如纯真、IP2Region、GeoLite2）或第三方 API。下面从实用角度说明几种主流方式，重点讲清楚怎么做、怎么选、怎么用。
使用 IP2Region 本地库（推荐：免费 + 高性能）
IP2Region 是开源、轻量、离线可用的 IP 库，Go 有官方维护的 ip2region 包，支持内存加载、B树/BitMap 索引，查询毫秒级。
- 安装：运行
go get -u github.com/lionsoul2014/ip2region/binding/golang/ip2region - 下载 db 文件：从 GitHub 项目页 下载
ip2region.db（建议用 v2.0 格式） - 基础查询示例：
db, err := ip2region.NewSearcher("ip2region.db")
if err != nil {
log.Fatal(err)
}
defer db.Close()
// 查询 IPv4 或 IPv6 字符串
result, err := db.Search("8.8.8.8")
if err == nil {
fmt.Println(result) // "美国|0|谷歌DNS服务器|"
}
注意：v2.0 的 result 是字符串拼接（用 | 分隔），字段顺序为：国家|区域|省份|城市|ISP。可按需切分解析；也支持结构化返回（启用 WithFields 选项）。
接入 GeoLite2（精准但需合规 + 定期更新）
MaxMind 提供的 GeoLite2 是行业标准数据源，精度高、支持 IPv6 和丰富字段（时区、经纬度、ASN 等），但需注册账号、同意许可协议，并每月底更新 db 文件。
Evez Github Manager
下载
在 OpenClaw 中管理 GitHub 仓库、Pull Request、Issue 与工作流。适用于审查 PR、管理 Issue、自动化 GitHub Actions、同步仓库等场景。
立即学习“go语言免费学习笔记（深入）”；
- 下载 GeoLite2 City / Country 数据库（.mmdb 格式）
- 安装 Go 库：
go get -u github.com/oschwald/maxminddb-golang - 简单查询示例：
db, err := maxminddb.Open("GeoLite2-City.mmdb")
if err != nil {
log.Fatal(err)
}
defer db.Close()
var record struct {
Country struct {
Names map[string]string `maxminddb:"names"`
} `maxminddb:"country"`
City struct {
Names map[string]string `maxminddb:"names"`
} `maxminddb:"city"`
Location struct {
Latitude float64 `maxminddb:"latitude"`
Longitude float64 `maxminddb:"longitude"`
} `maxminddb:"location"`
}
err = db.Lookup("1.1.1.1", &record)
if err == nil {
fmt.Println(record.Country.Names["zh-CN"], record.City.Names["zh-CN"])
}
调用 HTTP API（适合快速验证或小流量场景）
如果不想管理本地库，可用成熟 API，比如：
• 淘宝 IP 库（免费，简单，仅基础字段）：http://ip.taobao.com/invoke/GetIpInfo.php?ip=8.8.8.8
• IP-API（免费版限频，含经纬度/时区）：http://ip-api.com/json/8.8.8.8
• 腾讯云/阿里云 IP 定位 API（需鉴权，商用更稳）
- Go 中用
net/http发起 GET 请求，解析 JSON 即可 - 注意加超时、错误重试、限流保护（尤其免费接口）
- 别在高频服务中直接调用——延迟和稳定性不如本地库
注意事项与优化建议
无论选哪种方式，这几个点容易踩坑：
- IPv4 和 IPv6 要分开处理：IP2Region v2.0 支持双栈，GeoLite2 原生支持，API 多数也支持，但需确认
- 私有 IP（如 192.168.x.x、10.x.x.x）查不到地理信息，应提前过滤或返回“局域网”
- 本地库建议加载到内存（
ip2region.NewMemorySearcher()或maxminddb的内存模式），避免磁盘 IO 拖慢查询 - 生产环境建议封装成单例或服务，配合缓存（如 LRU 缓存最近查过的 IP）提升并发性能
基本上就这些。IP 地理查询本身不复杂，关键在选对数据源、用对方式、避开常见边界问题。
