mirrors/AdGuardHome
1
0
Fork 0
mirror of https://github.com/AdguardTeam/AdGuardHome.git synced 2024-11-24 14:05:45 +03:00
Code Issues Projects Releases Packages Wiki Activity

Created VPS (markdown)

Vasily Bagirov 2018-10-10 19:17:18 +03:00
parent e3cb2a5561
commit 7dc677695c
1 changed files with 109 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

109
VPS.md Normal file

@ -0,0 +1,109 @@
To run AdGuard DNS on a VPS, you need a server with Debian 8 or 9, x64 or x32.
## Initial installation
First let's ensure that your VPS has neccessary minimal requirements, run this as root:
```bash
apt-get install sudo nano bind9-host
```
Go to [AdGuard DNS page](https://github.com/AdguardTeam/AdguardDNS#installation) and download binaries for your architecture (64-bit Linux in this example).
As of time of writing, latest version is v0.1
To download AdGuard DNS and unpack it execute following commands:
```bash
wget https://github.com/AdguardTeam/AdguardDNS/releases/download/v0.1/AdguardDNS_0.1_linux_amd64.tar.gz
tar xvf AdguardDNS_0.1_linux_amd64.tar.gz
```
You can find out the directory where you've unpacked it to by running these commands:
```bash
cd AdguardDNS
pwd
```
In this example it is `/root/AdguardDNS`, now let's make it run on VPS boot:
```bash
sudo nano /etc/systemd/system/adguard-dns.service
```
A file will be opened, fill the file contents with this text:
```ini
[Unit]
Description=AdGuard DNS
After=syslog.target
After=network.target
[Service]
Type=simple
User=root
Group=root
WorkingDirectory=/root/AdguardDNS
ExecStart=/root/AdguardDNS/AdguardDNS --host 0.0.0.0
Restart=always
[Install]
WantedBy=multi-user.target
```
Note that I've used `/root/AdguardDNS` in that file, replace both instances with your own values there. Write to the file and close it.
After you're done with that, let's enable and start AdGuard DNS:
```bash
sudo systemctl enable adguard-dns
sudo systemctl start adguard-dns
```
You can verify that it's working properly by running this command:
```bash
host doubleclick.net 127.0.0.1
```
If everything works correctly, you will get this output:
```
Using domain server:
Name: 127.0.0.1
Address: 127.0.0.1#53
Aliases:
Host doubleclick.net not found: 3(NXDOMAIN)
```
## Visit the web interface
You can access your AdGuard DNS web interface on port 3000 by typing this in your browser — `http://1.2.3.4:3000/`
Replace 1.2.3.4 with the IP address of your VPS.
## Configure your devices to use your AdGuard DNS
Now, once you've established that AdGuard DNS works on your VPS, you can use it on your machine by changing system DNS settings to use your VPS's public IP address.
## (optional) Password-protect web interface
You have an option to password-protect your AdGuard DNS's web interace so only you can access it.
To do so, stop it first:
```bash
sudo systemctl stop adguard-dns
```
Then edit `/root/AdguardDNS/AdguardDNS.yaml` (substitute this path with your own as appropriate):
```bash
sudo nano /root/AdguardDNS/AdguardDNS.yaml
```
Find lines containing `auth_name: ""` and `auth_pass: ""` and replace them with username and password:
```ini
auth_name: "your-secret-name"
auth_pass: "your-secret-password"
```
Substitute name and password with your own, of course.
After you're done editing, save the file and start your AdGuard DNS again:
```bash
sudo systemctl start adguard-dns
```
After that, visiting web interface in browser will require entering username and password.