IP 地理信息数据库

OpenResty Edge 产品集成了多种 IP 地理信息数据库的支持，包括 MaxMind Enterprise、MaxMind Lite、ipip.net 等。这些数据库为 OpenResty Edge 产品提供了强大的地理位置相关功能支持。

# IP 地理信息数据库的重要性

IP 地理信息数据库的集成使得 OpenResty Edge 能够提供以下关键功能：

1. 增强日志信息：在 错误日志、WAF 日志 等包含终端 IP 信息的页面中，系统自动解析 IP 地址的地理位置信息，提供更详细的访问来源数据。

2. 精细化规则配置：页面规则和 WAF 规则可以基于地理位置信息进行设置。管理员可以根据用户的大洲、国家、省份、城市等地理信息制定细化的规则。例如，可以为来自美国的用户设置特定的上游代理，并限制请求速率为每秒最多 1 万次。

3. 优化 DNS 解析：系统可以根据用户的来源 IP 确定其地理位置和使用的运营商，从而返回最优的 DNS 解析结果。

# 数据库选择

您可以选择使用以下几种方式获取 IP 地理信息数据库：

• 从 MaxMind 或 ipip.net、qqzeng 购买的商业版的 IP 地理信息数据库
• MaxMind 提供的免费产品 GeoLite2
• 自定义 IP 地理信息数据库

以下我们将详细介绍如何在 OpenResty Edge 中使用 MaxMind Lite（即免费的 GeoLite2）数据库。

# 配置 MaxMind Lite 数据库

# 步骤 1：获取 MaxMind License Key

1. 访问 MaxMind 官方网站
2. 注册并登录账户
3. 在控制面板中生成 License Key

# 步骤 2：在 OpenResty Edge Admin 中配置

1. 登录 OpenResty Edge Admin 控制台
2. 进入全局设置

3. 点击 IP 地理信息数据库

4. 选择 Maxmind Lite

5. 输入之前获取的 MaxMind License Key
6. 点击 保存 按钮

注意： 系统会自动验证输入的 License Key。如果不正确或已过期，将显示相应的错误提示。

# 数据库更新机制

• OpenResty Edge Admin 每天会自动与 IP 地理信息提供商同步最新的数据库。
• 更新后的数据库会自动同步到所有 OpenResty Edge Node 网关服务器，无需管理员手动干预。
• 页面下半部分显示 IP 地理信息数据库的更新日志，方便管理员查看同步状态。

# 注意事项

• 即使 License Key 过期，也不会影响 OpenResty Edge Node 网关服务器的业务逻辑。
• 过期的 License Key 只会导致无法同步最新的数据，但现有数据仍可使用。

# 自定义 IP 地理信息数据库

OpenResty Edge 支持自定义 IP 地理信息数据库，可与 Maxmind Lite 等标准数据库并行使用，为特定需求提供更精确的地理信息。

自定义 IP 地理信息数据库采用 CSV 格式，数据结构如下：

network,continent_iso_code,country_iso_code,country_name_en,province_name_en,city_name_en,latitude,longitude,isp
34.64.0.0/24,AS,KR,South Korea,,,37.46910095214844,126.45099639892578,
34.64.1.0/24,AS,KR,South Korea,,,37.46910095214844,126.45099639892578,
34.64.2.0/24,AS,KR,South Korea,,,37.46910095214844,126.45099639892578,

# IP 地理信息查询

OpenResty Edge Admin 控制台提供了便捷的 IP 地址查询功能：

该功能可用于：

• 配置 IP 地理信息数据库后，进行查询测试以确认配置正确。
• 当对 OpenResty Edge Node 网关上报的 IP 地址地理信息有疑问时，进行快速验证。

通过以上步骤，您可以轻松配置和利用 IP 地理信息数据库，充分发挥 OpenResty Edge 的地理位置相关功能。