【更新日志】2023/09/19 PaoPaoDNS 增加ADDINFO调试信息功能，实时追踪结果来源

[kkkgo]

【更新日志】2023/09/19

• 新增ADDINFO调试信息功能
• 改进dnscrypt-proxy有效性自动测试流程，使用独立的测试项目，避免出现数据错误。( [Help] 国内解析正常，国外解析失败 开启了CUSTOM_FORWARD转发给openwrt的53  #36 )
• 修正关于KMS的文档配置说明（[Help] kms服务记录无效 #42 ）
• 修正CN_TRACKER功能的校验逻辑，避免更新错误数据导致错误的域名被进入list。（这个bug会导致和CUSTOM_FORWARD配合使用的时候有问题比如造成推特分流错误，建议低于此版本的容器升级。）
• 增加部分默认force_forward_list和force_nocn_list。( 谷歌商店可以浏览。无法下载 #35 ) 注意：从旧版本容器升级上来的不会被该数据更新覆盖。该数据仅为默认测试推荐，同时建议使用USE_MARK_DATA功能。
• 简化整理IPV6相关逻辑，使其表现预期更符合文档说明。
• 改进自动构建，推送前增加自检测试
• 修正一个redis新版本的警告

ADDINFO功能介绍

• ADDINFO： 默认为no,设置为yes时，在DNS查询结果中增加ADDITIONAL SECTION的调试信息，如结果来源、查询延迟、失败原因等，使用dig命令就可以实时追踪域名结果来源。

举例，当该功能开启后，使用dig命令查询一个域名将会有以下信息（示例中10.10.10.9是DNS的IP）：

dig www.taobao.com @10.10.10.9


; <<>> DiG 9.18.16 <<>> www.taobao.com @10.10.10.9
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 48989
;; flags: qr rd ra; QUERY: 1, ANSWER: 3, AUTHORITY: 0, ADDITIONAL: 1

;; QUESTION SECTION:
;www.taobao.com.                        IN      A

;; ANSWER SECTION:
www.taobao.com.         0       IN      CNAME   www.taobao.com.danuoyi.tbcache.com.
www.taobao.com.danuoyi.tbcache.com. 0 IN A      14.215.172.220
www.taobao.com.danuoyi.tbcache.com. 0 IN A      14.215.172.221

;; ADDITIONAL SECTION:
20230919200936.314.respond.paopaodns. 0 IN TXT  "0ms, Respond from:mmdb CN IP"

;; Query time: 9 msec
;; SERVER: 10.10.10.9#53(10.10.10.9) (UDP)
;; WHEN: Tue Sep 19 12:08:58 UTC 2023
;; MSG SIZE  rcvd: 271

可以看到，在ADDITIONAL SECTION区域，左边显示了域名请求：

请求时间戳: 20230919200936.314
回复类型:respond

右边显示了结果来源：

Respond from:mmdb CN IP # 说明他最终是因为被判断为CN IP而返回。
延迟：0ms #延迟是0ms。

因为ttl是0，所以综合判断查询结果是从redis乐观缓存中直接提取的。
此时再查一次：

; <<>> DiG 9.18.16 <<>> www.taobao.com @10.10.10.9
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 39496
;; flags: qr rd ra; QUERY: 1, ANSWER: 3, AUTHORITY: 0, ADDITIONAL: 1

;; QUESTION SECTION:
;www.taobao.com.                        IN      A

;; ANSWER SECTION:
www.taobao.com.         596   IN      CNAME   www.taobao.com.danuoyi.tbcache.com.
www.taobao.com.danuoyi.tbcache.com. 28 IN A     14.215.172.220
www.taobao.com.danuoyi.tbcache.com. 28 IN A     14.215.172.221

;; ADDITIONAL SECTION:
20230919201135.873.respond.paopaodns. 596 IN TXT "0ms, Respond from:mmdb CN IP"

;; Query time: 0 msec
;; SERVER: 10.10.10.9#53(10.10.10.9) (UDP)
;; WHEN: Tue Sep 19 12:10:57 UTC 2023
;; MSG SIZE  rcvd: 271

可以看到ttl发生了变化（596，也就是一般10分钟，说明得到的新结果），说明递归缓存被上次查询的时候，后台主动同步刷新。此时再查一次：

; <<>> DiG 9.18.16 <<>> www.taobao.com @10.10.10.9
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 29422
;; flags: qr rd ra; QUERY: 1, ANSWER: 3, AUTHORITY: 0, ADDITIONAL: 1

;; QUESTION SECTION:
;www.taobao.com.                        IN      A

;; ANSWER SECTION:
www.taobao.com.         593     IN      CNAME   www.taobao.com.danuoyi.tbcache.com.
www.taobao.com.danuoyi.tbcache.com. 58 IN A     14.215.172.221
www.taobao.com.danuoyi.tbcache.com. 58 IN A     14.215.172.220

;; ADDITIONAL SECTION:
20230919201308.371.respond.paopaodns. 593 IN TXT "0ms, Respond from:mosdns cache"

;; Query time: 0 msec
;; SERVER: 10.10.10.9#53(10.10.10.9) (UDP)
;; WHEN: Tue Sep 19 12:12:30 UTC 2023
;; MSG SIZE  rcvd: 273

可以看到结果来源于mosdns cache，说明ttl在有效期内直接从mosdns cache返回结果。

调试信息参考

• 如果DNS成功解析，则会返回respond类型信息，ADDITIONAL SECTION显示respond.paopaodns，附带解析结果来源、解析延迟；
• 如果DNS解析失败或者因选项设置拒绝解析，则会返回reject类型信息，ADDITIONAL SECTION显示reject.paopaodns，附带解析解析失败的原因、解析延迟；

Respond类型提示信息

• respond mmdb CN IP : 说明该结果是被判定为CN IP而返回。如果查询延迟为0ms并且ttl是0，则是从redis递归乐观缓存中提取；如果查询延迟是0ms，ttl不为0，说明上一次ttl有效期内被刷新过缓存。查询延迟不为0，一般就是初次获取到新纪录。
• mosdns cache ： 说明该记录在ttl有效期内，直接从mosdns cache返回，不执行任何查询操作。
• nocn forward_unbound : 从dnscrypt的unbound缓存中返回。非CN域名原始解析结果，或者手动指定了force_nocn_list的域名。
• nocn forward_dnscrypt : 从dnscrypt返回，同上，但一般是因为设置了超时的socks5或者其他原因而兜底的故障查询。
• local_unbound : 只有指定force_cn_list进行强制递归的域名才会有这个返回。
• local_unbound not_a_aaaa : 不常见，查询非A记录和非AAAA记录，从递归unbound中返回的结果。
• forward_unbound not_a_aaa : 同上，但是从dnscrypt的unbound缓存中返回的结果。
• respond forward ->IP@PORT : 使用了CUSTOM_FORWARD功能进行查询的域名，表示查询被转发IP@PORT。
• force_ttl_rules : 使用了force_ttl_rules功能进行查询的域名。
• respond AUTO_FORWARD_CHECK forward_unbound PRIVATE : 该显示仅会在同时开启CUSTOM_FORWARD、AUTO_FORWARD、AUTO_FORWARD_CHECK功能的时候出现，标明经过验证，该域名返回的是私有地址。

Reject类型提示信息

当域名的解析查询失败的时候，可能会有多种原因，调试信息仅返回最后失败的直接原因，你需要综合其他信息来判断。

• END by f_force_nocn_list. : 直接原因是dnscrypt查询失败，比如查询一个不存在的域名，递归查询失败，转移到dnscrypt，dnscrypt也查询失败，最终得到这个结果，又或者一开始该域名就是从force_nocn_list指定查询的但最终失败。
• END by f_local_unbound.: 直接原因是递归查询失败，只有指定force_cn_list进行强制递归的域名才会有这个返回。
• END by try_auto_check. : 直接原因是同时开启了CUSTOM_FORWARD、AUTO_FORWARD、AUTO_FORWARD_CHECK功能的时候，该域名被检查出不存在，或者所有查询办法均没法通过AUTO_FORWARD_CHECK检查而终止CUSTOM_FORWARD转发。
• END by block qtype 65. : 屏蔽qtype 65记录类型。
• END by IPv6=no. : 因为设置了IPv6=no，所以拒绝了aaaa记录的查询。
• END by IPv6=yes, force_nocn_list block aaaa. 因为设置了IPv6=yes，该域名位于force_nocn_list被判断为非CN域名而被直接拒绝aaaa记录的查询。
• END by IPv6=yes,NO CN IP block aaaa. 因为设置了IPv6=yes，该域名因被IP库判断为非CN域名而被直接拒绝aaaa记录的查询。

Block类型提示信息

仅在IPv6相关选项作用下出现，提示Records may exist, but blocked by PaoPaoDNS IPV6 option.，表示被拦截了IPv6查询请求。因IPV6=yes/only6选项而被过滤的AAAA记录查询，该情况仅在IPv4记录存在的时候出现。