如何使用Golang实现IP地理信息查询_Golang IP识别功能实现说明_技术教程

推荐使用 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 文件。

下载 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（需鉴权，商用更稳）