Table of content

• Abstract
• Compile and Install
• Command line options and args
• Config
  • Client Config
• Drivers and Protocols
  • dns
  • rfc8484
  • google
  • doh/http/https
  • twin
• Public recursive server
  • Summary in China
  • Summary outside China
• Suggestions
• TODO

Abstract

DNS over HTTPS utils written by golang.

Compile and Install

make

The executable file is placed under bin/. Copy it to wherever you like. Enjoy.

Command line options and args

See doh --help.

Config

Defaultly doh will try to read configs from doh.json;~/.doh.json;/etc/doh.json.

• logfile: optional. indicate which file log should be written to. empty means stdout. empty by default.
• loglevel: optional. log level. warning by default.
• service: service config
  • driver: driver to use.
  • url: url to driver.
  • ... the rest of the config depends on the driver.
• client: client config
  • driver: driver to use.
  • url: url to driver.
  • ... the rest of the config depends on the driver.

aliases

Defaultly doh will try to read aliases from doh-aliases.json;~/.doh-aliases.json.

If the server from the command line matches the key, the value will be used.

Client Config

• driver: optional. determine which system will be used as a client. see "drivers and protocols". if empty, the program will auto guess.
• url: required. see "drivers and protocols".
• insecure: optional. don't verify the certificate from the server.

Drivers and Protocols

dns

There are three different protocols in driver dns:

• udp: default port 53
• tcp: default port 53
• tcp-tls: default port 853

This driver can be used in both client and server settings.

Client Config:

• timeout: as its name.

Server Config:

• ednsclientsubnet: as its name.
• certfile: file path of certificates.
• certkeyfile: file path of key.

rfc8484

There is one protocol in driver rfc8484.

• https: default port 443, default path is /dns-query.

This driver can only be used in client setting.

Client Config:

• insecure: don't check the certificates.
• timeout: as its name.

google

There is one protocol in driver rfc8484.

• https: default port 443, default path is /resolve.

This driver can only be used in client setting.

Client Config:

• insecure: don't check the certificates.
• timeout: as its name.

doh/http/https

This driver can only be used in server setting. It supports both rfc8484 and google.

Server Config:

• ednsclientsubnet: as its name. if it's client, then the actual client IP address will be put into the field.
• certfile: file path of the certificates.
• keyfile: file path of the key.

twin

This driver can only be used in client setting.

Client Config:

• primary: another client config.
• secondary: another client config.
• direct-routes: a route file.

The quiz will be sent to the primary. If none of the answers match any routes in direct-routes, the quiz will be sent to the secondary and we return the answers from the secondary. Otherwise the answers from the primary will be used.

Public recursive server

• Public Recursive Servers
• Shanghai Telecom, csv
• Shanghai Unicom, csv
• Japan IDC, csv
• Seattle IDC, csv

source:

• https://blog.skk.moe/post/which-public-dns-to-use/
• https://github.com/curl/curl/wiki/DNS-over-HTTPS
• https://www.publicdns.xyz/

Summary in China

• Ignore those that have an accuracy more than 30.
• Ignore those that have a latency more than 30.
• alidns, dnspod, and google support edns client subnet, at least in some way.
• cnnic hasn't been poisoned, at least not to twitter.
• alidns has the most wide protocol supportive in China.
• In China Unicom, sometime the latency of TCP are less than the latency of UDP. Have no idea why it been like that.

Summary outside China

• Ignore those that have an accuracy more than 30.
• Ignore those that have a latency more than 30.
• google support edns client subnet.
• Most of the dns get a dramatically high score in seattle accuracy test, because they get the same result for tmall. 47.246.24.233. he get a very close result, which is 47.246.18.236. The latency of 47.246.24.233 is 66.7, and the latency of 47.246.18.236 is 0.6.

Suggestions

4. adguard, cloudflare, comodo, google, he, nextdns, opennic, safedns are acceptable in Japan. dnspod are almost 50. opendns are more than 40.
5. adguard, google support edns client subnet, and they have the most wide protocol supportive in China. cloudflare, nextdns also support 4 protocols, except they don't support edns client subnet.
6. Seattle has almost the same situation as Japan. Except dyn becomes acceptable, and opennic becomes unacceptable.
7. If you are in China. alidns is the best choice you have. And if you are not in China, adguard and google are the best.

TODO

• cache