CoreDNS-Plugins 是一套基于 CoreDNS 的智能DNS解析插件集合，包含三个核心插件：

• azroute: 可用区智能路由插件
• splitnet: 内外网区分解析插件
• georoute: 基于地理位置的就近解析插件

本项目支持两种编译方式：

将插件编译为 .so 文件，运行时动态加载：

# 编译所有插件
cd plugins/azroute && go build -buildmode=plugin -o azroute.so
cd ../splitnet && go build -buildmode=plugin -o splitnet.so  
cd ../georoute && go build -buildmode=plugin -o georoute.so

将插件源码直接集成到 CoreDNS 中，编译生成单一可执行文件：

# 本地开发测试
./download-coredns.sh          # 下载CoreDNS源码（一次性）
./build-test.sh ~/coredns-src  # 本地编译测试

# Docker构建
cd docker
docker build -f Dockerfile.coredns -t coredns-with-plugins .

详细说明请参考：静态编译指南

正确的插件执行顺序为：

客户端请求 → georoute → splitnet → azroute → hosts → forward → 返回结果

1. georoute 插件: 识别客户端IP类型

   • 内网IP: 返回所有服务器IP
   • 外网IP: 根据地理位置计算距离，筛选最优服务器IP

2. splitnet 插件: 根据客户端IP类型过滤服务器IP

   • 内网客户端: 优先返回内网服务器IP，如果没有内网IP则返回所有服务器IP
   • 外网客户端: 优先返回外网服务器IP，如果没有外网IP则返回所有服务器IP

3. azroute 插件: 根据可用区进行智能路由

   • 从过滤后的IP列表中，选择与客户端同可用区的IP
   • 如果没有同可用区IP，则返回所有可用IP

coredns-plugins/
├── plugins/           # 插件源码
│   ├── azroute/      # 可用区智能路由插件
│   ├── splitnet/     # 内外网区分解析插件
│   ├── georoute/     # 地理位置就近解析插件
│   └── common/       # 公共函数包
├── az-mock-api/      # API模拟服务
├── examples/         # 配置示例和测试脚本
└── docs/            # 详细文档

# 编译所有插件
cd plugins/azroute && go build -buildmode=plugin -o azroute.so
cd ../splitnet && go build -buildmode=plugin -o splitnet.so  
cd ../georoute && go build -buildmode=plugin -o georoute.so

cd az-mock-api
go run main.go

参考 examples/Corefile 进行配置：

.:53 {
    georoute {
        geoip_db /path/to/GeoLite2-City.mmdb
        cache_size 2048
        distance_threshold 1000
    }
    
    splitnet {
        api_url http://localhost:8080/internal_cidr
        api_interval 30s
        cache_size 1024
    }
    
    azroute {
        api_url http://localhost:8080/azmap
        api_interval 30s
        cache_size 1024
    }
    
    hosts ./hosts
    forward . 8.8.8.8
    cache
}

cd examples
./test.sh

根据客户端可用区信息，从解析结果中优选同可用区的IP地址。

特性:

• 支持动态可用区映射配置
• LRU缓存提升性能
• 自动热加载配置更新

配置参数:

• api_url: 可用区映射API地址
• api_interval: API刷新间隔
• cache_size: 缓存大小

根据客户端IP类型（内网/外网），过滤解析结果中的服务器IP。

特性:

• 动态获取内网CIDR配置
• 支持IPv4和IPv6
• 缓存机制减少API调用

配置参数:

• api_url: 内网CIDR获取API地址
• api_interval: API刷新间隔
• cache_size: 缓存大小

基于GeoIP2数据库，根据客户端地理位置进行智能路由解析。如同古代的驿站系统，为每个客户端找到最近的服务器节点。

特性:

• 支持GeoIP2 City数据库，精准定位客户端位置
• 内网IP自动识别，内网客户端享受最优路由
• 距离阈值过滤，确保网络延迟最小化
• LRU缓存优化性能，快速响应查询请求

配置参数:

• geoip_db: GeoIP2数据库文件路径
• cache_size: LRU缓存大小
• distance_threshold: 距离阈值（公里）

1. 客户端IP: 192.168.1.100 (内网)
2. georoute插件: 识别为内网IP，返回所有服务器IP
3. splitnet插件: 优先返回内网服务器IP，如果没有内网IP则返回所有服务器IP
4. azroute插件: 根据可用区筛选最优内网IP
5. 返回结果

1. 客户端IP: 203.0.113.1 (外网)
2. georoute插件: 根据地理位置计算距离，筛选最优服务器IP
3. splitnet插件: 优先返回外网服务器IP，如果没有外网IP则返回所有服务器IP
4. azroute插件: 根据可用区筛选最优外网IP
5. 返回结果

• 静态编译指南
• Corefile配置示例
• GeoIP插件优化说明
• 插件编译测试指南
• GeoIP2数据库配置指南
• 性能压测指引

MIT License