mirror of
https://github.com/m13253/dns-over-https.git
synced 2026-03-30 14:15:40 +00:00
88 lines
3.1 KiB
Markdown
88 lines
3.1 KiB
Markdown
DNS-over-HTTPS
|
|
==============
|
|
|
|
Client and server software to query DNS over HTTPS protocol
|
|
|
|
## Easy start
|
|
|
|
Install [Go](https://golang.org), at least version 1.8.
|
|
|
|
First create an empty directory, used for `$GOPATH`:
|
|
|
|
mkdir ~/gopath
|
|
export GOPATH=~/gopath
|
|
|
|
To build the program, type:
|
|
|
|
make
|
|
|
|
To install DNS-over-HTTPS as Systemd services, type:
|
|
|
|
sudo make install
|
|
|
|
By default, [Google DNS over HTTPS](https://dns.google.com) is used. It should work
|
|
for most users (except for People's Republic of China). If you need to modify the
|
|
default settings, type:
|
|
|
|
sudo cp /usr/lib/systemd/system/doh-client.service /etc/systemd/system/
|
|
sudoedit /etc/systemd/system/doh-client.service
|
|
|
|
To automatically start DNS-over-HTTPS client as a system service, type:
|
|
|
|
sudo systemctl start doh-client.service
|
|
sudo systemctl enable doh-client.service
|
|
|
|
Then, modify your DNS settings (usually with NetworkManager) to 127.0.0.1.
|
|
|
|
To test your configuration, type:
|
|
|
|
dig www.google.com
|
|
|
|
If it is OK, you will wee:
|
|
|
|
;; SERVER: 127.0.0.1#53(127.0.0.1)
|
|
|
|
## Server Configuration
|
|
|
|
The following is a typical DNS-over-HTTPS architecture:
|
|
|
|
+--------------+ +------------------------+
|
|
| Application | | Recursive DNS Server |
|
|
+-------+------+ +-----------+------------+
|
|
| |
|
|
+-------+------+ +-----------+------------+
|
|
| Client side | | doh-server |
|
|
| cache (nscd) | +-----------+------------+
|
|
+-------+------+ |
|
|
| +--------------------------+ +-----------+------------+
|
|
+-------+------+ | HTTP cache server / | | HTTP service muxer |
|
|
| doh-client +--+ Content Delivery Network +--+ (Apache, Nginx, Caddy) |
|
|
+--------------+ +--------------------------+ +------------------------+
|
|
|
|
Although DNS-over-HTTPS can work alone, a HTTP service muxer would be useful as you
|
|
can host DNS-over-HTTPS along with other HTTPS services.
|
|
|
|
## Protocol compatibility
|
|
|
|
DNS-over-HTTPS use a protocol compatible to [Google DNS-over-HTTPS](https://developers.google.com/speed/public-dns/docs/dns-over-https),
|
|
except for absolute expire time is preferred to relative TTL value. Refer to
|
|
[json-dns/response.go](json-dns/response.go) for a complete description of the
|
|
API.
|
|
|
|
Currently supported features are:
|
|
|
|
- [X] IPv4 / IPv6
|
|
- [X] EDNS0 large UDP packet
|
|
- [X] EDNS0 Client Subnet
|
|
- [ ] DNSSEC
|
|
|
|
DNSSEC is planned but not implemented yet. Contributions are welcome. It is
|
|
suggested that you install `unbound` or `bind` to validate DNS records.
|
|
|
|
## License
|
|
|
|
DNS-over-HTTPS is licensed under [GNU Affero General Public License](LICENSE)
|
|
version 3 or later. That means, if you improved DNS-over-HTTPS or fixed a bug, you
|
|
**must** disclose your modification to the public, so that others may benefit from
|
|
your modification, in the same way you receive benefits from this project.
|