.NET C#查询全球IP地址信息 IPTools库 使用教程

IPTools 是一个用于快速查询全球 IP 地址信息的库，支持国内和国际 IP 查询，提供详细的地理位置信息（如国家、省份、城市）以及经纬度等数据。

IPTools GitHub地址：https://github.com/stulzq/IPTools

IPTools.China

IPTools.China 专注于快速查询中国 IP 地址信息，包括国家、省份、城市和网络运营商。对于非中国 IP，仅支持查询国家信息。

安装 IPTools.China 包

Install-Package IPTools.China

下载数据库文件

可以从 GitHub 下载数据库文件，并将其放置在项目根目录（与 .csproj 文件同级），设置为“复制到输出目录”。

数据库文件文件地址：https://github.com/stulzq/IPTools/raw/master/db/ip2region.db

1.2.0 版本开始取消了将数据库文件嵌入程序集，以方便更新并减少程序集大小。

使用IPTools.China查询IP信息代码示例

var ipinfo = IpTool.Search("171.210.12.163");
Console.WriteLine(ipinfo.Country); // 中国
Console.WriteLine(ipinfo.Province); // 四川省
Console.WriteLine(ipinfo.City); // 成都市
Console.WriteLine(ipinfo.NetworkOperator); // 电信

查询性能测试

单线程双重 for 循环查询 65,025 个 IP 地址，花费约 170 毫秒。

自定义 IP 数据库文件

IpToolSettings.ChinaDbPath = "path/to/your/ip2region.db";

IPTools.International

IPTools.International 支持全球 IP 地址查询，提供多语言支持，地理信息包括国家、省份、城市、邮政编码、纬度和经度。

安装 IPTools.International 包

Install-Package IPTools.International

下载全球IP地址数据库文件

从 GitHub 下载数据库文件，并将其放置在项目根目录（与 .csproj 文件同级），设置为“复制到输出目录”。

数据库文件下载地址：https://github.com/stulzq/IPTools/raw/master/db/GeoLite2-City.mmdb

注意：1.2.0 版本开始取消了将数据库文件嵌入程序集，以方便更新并减少程序集大小。

使用IPTools.International查询IP信息代码示例

var ipinfo = IpTool.SearchWithI18N("171.210.12.163");
Console.WriteLine(ipinfo.Country); // China
Console.WriteLine(ipinfo.CountryCode); // CN
Console.WriteLine(ipinfo.Province); // Sichuan
Console.WriteLine(ipinfo.ProvinceCode); // SC
Console.WriteLine(ipinfo.City); // Chengdu
Console.WriteLine(ipinfo.Latitude); // 30.6667
Console.WriteLine(ipinfo.Longitude); // 104.6667
Console.WriteLine(ipinfo.AccuracyRadius); // 50

设置语言

默认语言为中文，可以通过以下代码设置其他语言（例如英文）：

IpToolSettings.DefaultLanguage = "en";

提升查询速度

通过将数据库文件加载到内存中，可以显著提升查询速度（大约提升一倍），但会增加 60-70MB 内存占用。

IpToolSettings.LoadInternationalDbToMemory = true;

查询性能测试

单线程双重 for 循环查询 65,025 个 IP 地址，花费约 1500 毫秒（内存模式）。

自定义 IP 数据库文件

IpToolSettings.InternationalDbPath = "path/to/your/GeoLite2-City.mmdb";

ASP.NET Core 支持

IPTools 提供了对 HttpContext 对象的扩展方法，便于在 ASP.NET Core 应用中获取远程 IP 信息。

var ipInfo = HttpContext.GetRemoteIpInfo();
// 或者从请求头获取 IP 地址信息（适用于 Nginx、HAProxy 等代理）
var ipInfoFromHeader = HttpContext.GetRemoteIpInfo("X-Forwarded-For");

同时使用 IPTools.China 和 IPTools.International

IPTools.China 和 IPTools.International 都实现了 IIpSearcher 接口，IpTool 类在加载时会根据已安装的程序包进行初始化。

• DefaultSearcher：默认使用的 IP 搜索器。
• IpChinaSearcher：对应 IPTools.China 实现的搜索器。
• IpAllSearcher：对应 IPTools.International 实现的搜索器。

如果你只安装了 IPTools.China，那么 DefaultSearcher 将是 IpChinaSearcher，IpAllSearcher 为 null。

如果你只安装了 IPTools.International，那么 DefaultSearcher 将是 IpAllSearcher，IpChinaSearcher 为 null。

如果你同时安装了两个组件，默认情况下 DefaultSearcher 将是 IpChinaSearcher，IpChinaSearcher 和 IpAllSearcher 都不会为 null。

可以通过以下代码更改默认的搜索器：

IpToolSettings.DefalutSearcherType = IpSearcherType.China;
IpToolSettings.DefalutSearcherType = IpSearcherType.International;