Skip to content

Commit dff031a

Browse files
committed
docs: add guide to use DNS-over-HTTPS with AdguardTeam/dnsproxy
Signed-off-by: Carlos <835129+cvscarlos@users.noreply.github.com>
1 parent 8271543 commit dff031a

File tree

1 file changed

+16
-3
lines changed

1 file changed

+16
-3
lines changed

docs/guides/dns/dnsproxy-doh.md

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ But should work on any Linux distributionm, maybe with some minor changes.
1212

1313
You just need to download it from the [releases page](https://github.com/AdguardTeam/dnsproxy/releases). Choose your architecture and download the binary.
1414

15-
For this guide we will use the `dnsproxy-linux-amd64-v0.61.1.tar.gz` binary available at https://github.com/AdguardTeam/dnsproxy/releases/download/v0.61.1/dnsproxy-linux-amd64-v0.61.1.tar.gz
15+
For this guide we will use the `dnsproxy-linux-amd64-v0.61.1.tar.gz` binary available at `https://github.com/AdguardTeam/dnsproxy/releases/download/v0.61.1/dnsproxy-linux-amd64-v0.61.1.tar.gz`
1616

1717

1818
```bash
@@ -26,23 +26,32 @@ mv linux-amd64/dnsproxy ./
2626
### Configuring `dnsproxy` to run on startup
2727

2828
1. Copy the `dnsproxy` binary to `/usr/bin`:
29+
2930
```bash
3031
sudo cp ./dnsproxy /usr/bin/
3132
```
33+
3234
2. Create a `dnsproxy` user to run the daemon:
35+
3336
```bash
3437
sudo useradd -s /usr/sbin/nologin -r -M dnsproxy
3538
```
39+
3640
3. Allow the `dnsproxy` user to run the `dnsproxy` binary:
41+
3742
```bash
3843
sudo chown dnsproxy:dnsproxy /usr/bin/dnsproxy
3944
```
45+
4046
4. Create a service file for `dnsproxy`:
47+
4148
```bash
4249
sudo nano /etc/systemd/system/dnsproxy.service
4350
```
51+
4452
And copy the following into `/etc/systemd/system/dnsproxy.service`.
4553
This will control the running of the service and allow it to run on startup:
54+
4655
```ini
4756
[Unit]
4857
Description=DNS Proxy over HTTPS
@@ -59,13 +68,17 @@ mv linux-amd64/dnsproxy ./
5968
[Install]
6069
WantedBy=multi-user.target
6170
```
71+
6272
5. Enable the `systemd` service to run on startup, then start the service and check its status:
73+
6374
```bash
6475
sudo systemctl enable dnsproxy
6576
sudo systemctl start dnsproxy
6677
sudo systemctl status dnsproxy
6778
```
79+
6880
6. Now test that it is working! Run the following `dig` command, a response should be returned similar to the one below:
81+
6982
```bash
7083
$ dig @127.0.0.1 -p 5353 example.com
7184
@@ -79,10 +92,10 @@ mv linux-amd64/dnsproxy ./
7992
;; OPT PSEUDOSECTION:
8093
; EDNS: version: 0, flags:; udp: 1232
8194
;; QUESTION SECTION:
82-
;example.com. IN A
95+
;example.com. IN A
8396
8497
;; ANSWER SECTION:
85-
example.com. 79150 IN A 93.184.216.34
98+
example.com. 79150 IN A 93.184.216.34
8699
87100
;; Query time: 20 msec
88101
;; SERVER: 127.0.0.1#5353(127.0.0.1) (UDP)

0 commit comments

Comments
 (0)