地理位置

说明

地理位置插件添加与客户机 IP 关联的地理位置数据，它允许您配置一个 geoIP2 maxmind database 来添加与 IP 地址关联的地理位置数据。

数据利用元数据插件进行添加，然后还可以使用它来检索值，例如

import (
    "strconv"
    "github.com/coredns/coredns/plugin/metadata"
)
// ...
if getLongitude := metadata.ValueFunc(ctx, "geoip/longitude"); getLongitude != nil {
    if longitude, err := strconv.ParseFloat(getLongitude(), 64); err == nil {
        // Do something useful with longitude.
    }
} else {
    // The metadata label geoip/longitude for some reason, was not set.
}
// ...

数据库

支持的数据库使用城市架构，例如 City 和 Enterprise。当前还不支持其他具有不同架构的数据库类型。

您可以下载一个 免费的和公开的城市数据库。

语法

geoip [DBFILE]

或

geoip [DBFILE] {
    [edns-subnet]
}

• DBFILE mmdb 数据库文件路径。我们建议定期更新您的 mmdb 数据库以获得更准确的结果。

• edns-subnet：可选。对于地理 IP，使用 EDNS0 子网（如果存在），而不是 DNS 请求的源 IP。这有助于通过中间 DNS 解析器识别最接近的源 IP 地址，并且还可以简化地理 IP 测试：dig +subnet=1.2.3.4 @dns-server.example.com www.geo-aware.com.

  注意：出于安全原因，递归 DNS 解析器可能会屏蔽客户机 IP 地址的几位，这会导致地理 IP 分辨不准确。

  标准中没有定义掩码大小，但有示例：RFC 7871’s example 隐藏 IPv6 源地址的最后 72 位，而 NS1 帮助中心 提到 启用 ECS 的 DNS 解析器仅发送源 IPv4 地址的前三个八位组（例如 /24）。

示例

以下配置配置 City 数据库，并根据 EDNS0 子网（如果存在）查找地理位置。

. {
    geoip /opt/geoip2/db/GeoLite2-City.mmdb {
      edns-subnet
    }
    metadata # Note that metadata plugin must be enabled as well.
}

视图插件可以使用 地理位置元数据作为选择标准来提供 GSLB 功能。在此示例中，“Exampleshire”市中的客户机将从 example.com.exampleshire-db 中定义的区域接收 example.com 的答案。所有其他客户机将从 example.com.db 中定义的区域接收答案。请注意，下面两个 example.com 服务器块的顺序很重要；无视图的默认服务器块必须是最后一个。

example.com {
    view exampleshire {
      expr metadata('geoip/city/name') == 'Exampleshire'
    }
    geoip /opt/geoip2/db/GeoLite2-City.mmdb
    metadata
    file example.com.exampleshire-db
}

example.com {
    file example.com.db
}

元数据标签

一组有限的字段将导出为标签，所有值都使用字符串存储无论其基础值类型如何，因此您可能必须将其转换回原始类型，请注意，数字值始终以 10 为基数表示。

Continent Codes