Telescope DNS

灵活快速的DNS分组转发器

设计目标

灵活解析

• 支持按ABP风格规则/GFWList对DNS请求进行分组
• 支持按CIDR对DNS请求进行重定向
• 支持DNS over UDP/TCP/TLS/HTTPS、socks5代理、ECS
• 支持将查询结果中的IPv4地址添加至IPSet

  快速解析

• 支持并发请求上游DNS，选择最快响应
• 选择ping值最低的IPv4地址（tcp/icmp ping）
• 支持hosts/DNS缓存/屏蔽指定查询类型
• 支持热重载配置文件

解析流程

查找hosts -> 查找缓存 -> 匹配规则 -> 指定group处理 -> 重定向 -> 设置缓存

使用说明

1. 在Releases页面下载对应系统和平台的压缩包；
2. 解压后按需求编辑配置文件ts-dns.toml（可选）并运行进程：

   # ./ts-dns -h  # 显示命令行帮助信息
   # ./ts-dns -c ts-dns.toml  # 指定配置文件名
   ./ts-dns
   kill -SIGHUP <PID> # 重载配置文件

配置示例

完整配置文件参见ts-dns.full.toml

1. 默认配置（ts-dns.toml），开箱即用

   listen = ":53"
   
   [groups]
   [groups.clean]
   dns = ["223.5.5.5", "114.114.114.114"]
   concurrent = true
   
   [groups.dirty]
   dns = [""] # 省略
   gfwlist_file = "gfwlist.txt"

2. 选择ping值最低的IPv4地址（启用时建议以root权限运行本程序）

   # ...
   [groups.clean]
   dns = ["223.5.5.5", "114.114.114.114"]
   fastest_v4 = true
   # ...

3. 指定hosts文件和自定义hosts

   # ...
   hosts_files = ["adaway.txt"]
   [hosts]
   "www.example.com" = "1.1.1.1"
   # ...

4. 使用socks5代理转发DNS请求

   # ...
   [groups.dirty]
   socks5 = "127.0.0.1:1080"
   # ...

5. 转发至上游DNS时默认附带指定ECS信息（暂不支持DOH）

   # ...
   [groups.clean]
   ecs = "1.2.4.0/24"
   # ...

6. 自定义域名分组

   # ...
   [groups.work]
   dns = ["10.1.1.1"]
   rules = ["company.com"]
   # ...

7. 动态添加IPSet记录（使用前请阅读ts-dns.full.toml对应说明）

   # ...
   [groups.dirty]
   ipset = "blocked"
   ipset_ttl = 86400
   # ...

未来规划

• [ ] 支持定期拉取最新gfwlist
• [ ] 支持http接口管理
• [ ] 降低gfwlist的匹配优先级
• [ ] DoT/GFWList域名解析自闭环

特别鸣谢

• github.com/arloan/prdns
• github.com/gfwlist/gfwlist