[1] AdGuard Home – Instalacja

Pobierz źródła AdGuard Home z oficjalnego kanału Git, dostępne pod adresem (na dzień 11.01.2025 jest to wersja 0.107.55):

https://github.com/AdguardTeam/AdGuardHome/releases/tag/v0.107.55

[root@vrl01 ~]# wget https://github.com/AdguardTeam/AdGuardHome/releases/download/v0.107.55/AdGuardHome_linux_amd64.tar.gz

Zaktualizuj system.

[root@vrl01 ~]# dnf -y update && dnf -y upgrade

Rozpakuj pobrane archiwum z AdGuard Home.

[root@vrl01 ~]# tar zxvf AdGuardHome_linux_amd64.tar.gz

Przenosimy rozpakowane archiwum do należnego mu miejsca – czyli [/usr/local/bin].

[root@vrl01 ~]# mv AdGuardHome /usr/local/bin/

Zmieniamy prawa katalogu AdGuard Home.

[root@vrl01 ~]# chmod -R 755 /usr/local/bin/AdGuardHome/

Wydajemy polecenie instalacji usługi AdGuard Home.

[root@vrl01 ~]# /usr/local/bin/AdGuardHome/AdGuardHome -s install
2025/01/12 21:08:14 [info] AdGuard Home, version v0.107.55
2025/01/12 21:08:14 [info] service: control action: install
2025/01/12 21:08:14 [info] service: started
2025/01/12 21:08:14 [info] Almost ready!
AdGuard Home is successfully installed and will automatically start on boot.
There are a few more things that must be configured before you can use it.
Click on the link below and follow the Installation Wizard steps to finish setup.
AdGuard Home is now available at the following addresses:
2025/01/12 21:08:14 [info] go to http://127.0.0.1:3000
2025/01/12 21:08:14 [info] go to http://[::1]:3000
2025/01/12 21:08:14 [info] go to http://192.168.1.101:3000
2025/01/12 21:08:14 [info] go to http://[fe80::20c:29ff:fe75:5366%ens32]:3000
2025/01/12 21:08:14 [info] service: action install has been done successfully on linux-systemd

Jeśli w systemie działa SELinux należy zmodyfikować jego politykę bezpieczeństwa odnośnie binariów AdGuard Home.

[root@vrl01 ~]# chcon -t bin_t /usr/local/bin/AdGuardHome/AdGuardHome

Sprawdzamy czy AdGuard Home faktycznie został uruchomiony i czy pracuje.

[root@vrl01 ~]# systemctl status AdGuardHome.service

• AdGuardHome.service - AdGuard Home: Network-level blocker

     Loaded: loaded (/etc/systemd/system/AdGuardHome.service; enabled; preset: disabled)
     Active: active (running) since Sun 2025-01-12 21:09:15 CET; 6min ago
   Main PID: 44182 (AdGuardHome)
      Tasks: 11 (limit: 48705)
     Memory: 14.9M
        CPU: 121ms
     CGroup: /system.slice/AdGuardHome.service
             └─44182 /usr/local/bin/AdGuardHome/AdGuardHome -s run

Jak widać pierwsza faza instalacji AdGuard Home już za nami, teraz\ należy otworzyć w przeglądarce podany adres WWW, aby dokończyć konfigurację AdGuard Home. Jednak jeśli w systemie jest zainstalowana i pracuje zapora sieciowa Firewalld, należy najpierw otworzyć porty domyślnie wykorzystywane przez AdGuard Home.

Aby mógł on świadczyć usługi serwera DNS należy otworzyć port 53/UDP

[root@vrl01 ~]# firewall-cmd --add-service=dns

Do zarządzania AdGuard Home za pomocą przeglądarki internetowej wykorzystywany jest standardowy port dla usługi http – czyli 80/TCP.

[root@vrl01 ~]# firewall-cmd --add-service=http

No i na czas wstępnej konfiguracji, potrzebny jest otwarty port 3000/TCP.

[root@vrl01 ~]# firewall-cmd --add-port=3000/tcp

Aby te ustawienia zapory Firewalld były trwałe należy o tym ją poinformować.

[root@vrl01 ~]# firewall-cmd --runtime-to-permanent

Zatem przechodzimy pod wskazany przez instalatora jeden z adresów w celu dalszej instalacji i konfiguracji AdGuard Home.

AdGuard Home is now available at the following addresses:
2025/01/12 21:08:14 [info] go to http://127.0.0.1:3000
2025/01/12 21:08:14 [info] go to http://[::1]:3000
2025/01/12 21:08:14 [info] go to http://192.168.1.101:3000
2025/01/12 21:08:14 [info] go to http://[fe80::20c:29ff:fe75:5366%ens32]:3000

Możliwa jest także instalacja AdGuard Home bezpośrednio z Internetu, wykonując poniższe polecenie.

[root@vrl01 ~]# curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v

Dodając opcję [-u] przeprowadzimy deinstalację.

Dodając opcję [-r] przeprowadzimy reinstalację.

Zatem przechodzimy do interfejsu webowego AdGuard Home, aby dokończyć instalację i konfigurację AdGuard Home.

Kliknij przycisk [Zaczynamy].

W pierwszej części okna wybieramy interfejs sieciowy na którym ma nasłuchiwać zapytań interfejs administracyjny AdGuard Home. Jeśli mamy tylko jeden to śmiało możemy zostawić domyślny wpis [Wszystkie interfejsy], jeśli jednak mamy kilka to należy wybrać odpowiedni lub pozwolić na nasłuchiwanie na wszystkich interfejsach. W polu [Port] konfigurujemy na jakim porcie nasłuchiwać żądań będzie interfejs administracyjny AdGuard Home. Port [80] jest domyślnym i jeśli nie posiadamy innego serwera http pracującego na serwerze, to możemy zostawić ten port. Jeśli jednak mamy już uruchomiony inny serwer, należy zmienić numer portu na wolny, a także przekonfigurować zaporę sieciową Firewalld.

Kolejna grupa to konfiguracja adresu/interfejsu oraz portu na którym będzie nasłuchiwał zapytań DNS nasz AdGuard Home. Procedura i konfiguracja jest taka sama jak poprzednio dotycząca interfejsu administracyjnego. Zalecam pozostawienie ustawień domyślnych, chyba że mamy uruchomiony inny serwer DNS.

Przewijamy okno na sam dół i naciskamy przycisk [Dalej].

W tym oknie ustawiamy login i hasło dla interfejsu administracyjnego. Wypełniamy odpowiednio pola [Nazwa użytkownika], [Hasło] oraz powtarzamy hasło w polu [Potwierdź hasło]. Naciskamy [Dalej].

Kolejne okno to krótka i zwięzła instrukcja konfiguracji klientów do korzystania z AdGuard Home. Wszystkie informacje zostaną opisane w dalszych artykułach na temat konfiguracji AdGuard Home (do lektury których gorąco zachęcam), więc śmiało możemy kliknąć [Dalej] na samym dole okna.

Ostatnie okno to potwierdzenie zakończenia konfigurowania AdGuard Home. Kliknięcie przycisku [Otwórz panel sterowania], przeniesie nas do interfejsu administracyjnego AdGuard Home.

Wpisujemy ustawiony wcześniej login i hasło, a następnie klikamy [Zaloguj się].

Przejdziemy do strony administracyjnej AdGuard Home.

Po zakończeniu konfiguracji końcowej AdGuard Home można zamknąć port 3000/tcp, aby nie stanowił otwartej furtki dla crackerów.

[root@vrl01 ~]# firewall-cmd --remove-port=3000/tcp
[root@vrl01 ~]# firewall-cmd --runtime-to-permanent