AdGuard Home. Serwer DNS z funkcją blokady reklam.

AdGuard Home to darmowy i potężny serwer DNS, który działa jako sieciowy bloker reklam i narzędzie do kontroli rodzicielskiej.
Poradnik: AdGuard Home. Serwer DNS z funkcją blokady reklam.

AdGuard Home to darmowy i potężny serwer DNS, który działa jako sieciowy bloker reklam i narzędzie do kontroli rodzicielskiej dla wszystkich urządzeń w Twojej sieci domowej. Działa na poziomie DNS, co oznacza, że zanim Twoja przeglądarka spróbuje załadować reklamę lub tracker, AdGuard Home przechwytuje zapytanie DNS i blokuje je, jeśli znajduje się na liście zablokowanych domen.

Dlaczego warto zainstalować usługę AdGuard Home na domowym serwerze?

  1. Blokowanie na Poziomie Sieci: Zamiast instalować blokery reklam na każdym urządzeniu (komputer, smartfon, tablet), konfigurujesz tylko jeden serwer (AdGuard Home). Wystarczy, że zmienisz ustawienia DNS w routerze lub na urządzeniach, aby cała sieć była chroniona.
  2. Lepsza Wydajność: Blokowanie na poziomie DNS jest szybsze i zużywa mniej zasobów niż blokowanie w przeglądarce.
  3. Większa Prywatność: Blokuje trackery i narzędzia analityczne, zwiększając Twoją prywatność online.
  4. Kontrola i Statystyki: Otrzymujesz centralny panel administracyjny (Web UI), który pokazuje statystyki zapytań DNS, zablokowane domeny, najczęściej używane urządzenia i umożliwia łatwe dodawanie własnych list blokowania (np. listę CERT Polska).

Konteneryzacja usługi

Opisywana aplikacja zostanie uruchomiona jako kontener Dockera. Jeśli chcesz zapoznać się z tematem konteneryzacji, zacznij od tego artykułu: Podstawy Konteneryzacji: Kontener i Proces Konteneryzacji.

Instalacja Docker i Docker Compose

Jeśli chcesz uruchomić pierwszą aplikację docker compose na swoim domowym serwerze to najpierw musisz zainstalować w systemie odpowiednie pakiety oprogramowania. Zapoznaj się z poradnikiem, gdzie opisana jest Instalacja silnika Docker oraz wtyczki Docker Compose bezpośrednio z poziomu terminala Instalacja Docker i Docker Compose

Plik konfiguracyjny usługi AdGuard Home docker compose

Plik docker-compose.yml to główny element każdego projektu opartego na Docker Compose. Jest to dokument zapisany w formacie YAML, który opisuje jak uruchamiać, konfigurować i łączyć ze sobą kontenery w ramach jednej aplikacji lub całego środowiska. To tutaj opisujesz, jakie obrazy mają zostać pobrane, jakie porty otwarte i jakie relacje zachodzą między poszczególnymi elementami systemu.

Jeśli robisz to pierwszy raz lub potrzebujesz przypomnienia zapoznaj się z poradnikiem o zawartości pliku konfiguracyjnego docker-compose.yml.

Poniżej znajdziesz zawartość pliku docker-compose.yml dla usługi AdGuard Home z dokładnymi komentarzami do każdej linii, która pozwoli Ci sprawnie uruchomić usługę.

Uwaga: Adres IP domowego serwera 192.168.1.200, na którym będzie zainstalowana usługa AdGuard Home jest podany jako przykładowy - zmień na IP twojego serwera.

YML
name: adguardhome # Określa nazwę dla całego stosu Docker Compose. Ułatwia to zarządzanie i identyfikację.
services: # Sekcja definiująca usługi (kontenery) do uruchomienia.
    adguardhome: # Nazwa usługi wewnątrz pliku docker-compose.
        container_name: adguardhome # Nadaje stałą i czytelną nazwę kontenerowi, co ułatwia zarządzanie komendami Docker.
        image: docker.io/adguard/adguardhome # Obraz Docker, który zostanie pobrany i użyty do uruchomienia kontenera (oficjalny obraz AdGuard).
        ports: # Mapowanie portów z kontenera na porty hosta. Format: HOST_IP:HOST_PORT:CONTAINER_PORT/PROTOCOL
            # Twoja konfiguracja używa adresu IP 192.168.1.200, co oznacza, że AdGuard Home będzie
            # nasłuchiwał tylko na tym konkretnym interfejsie sieciowym serwera (BINDING).

            # DNS Standardowy (UDP i TCP)
            - 192.168.1.200:53:53/tcp # 53/TCP: Zwykłe zapytania DNS (do przesyłania dużych danych DNS).
            - 192.168.1.200:53:53/udp # 53/UDP: Standardowy port DNS. Jest to główny port, na którym AdGuard Home nasłuchuje zapytań z sieci domowej.

            # DHCP (Wykomentowane - opcjonalne, jeśli serwer ma przejąć funkcję routera/serwera DHCP)
            #- 67:67/udp # Port dla serwera DHCP (Bootstrap Protocol Server).
            #- 68:68/udp # Port dla klienta DHCP (Bootstrap Protocol Client).

            # Panel Administracyjny (Web UI)
            - 192.168.1.200:8053:80/tcp # Mapuje port 80 w kontenerze (domyślny port Web UI) na port 8053 na hoście. Użycie innego portu (8053 zamiast 80) zapobiega konfliktom z innymi usługami webowymi na serwerze.

            # HTTPS / DNS-over-HTTPS (DoH)
            - 192.168.1.200:443:443/tcp # 443/TCP: Używany przez Web UI (jeśli włączono HTTPS) oraz DNS-over-HTTPS.
            - 192.168.1.200:443:443/udp # 443/UDP: Używany przez DNS-over-HTTPS.

            # Alternatywny port Web UI (w trakcie inicjalizacji/konfiguracji)
            - 192.168.1.200:3000:3000/tcp # 3000/TCP: Alternatywny port używany domyślnie przez AdGuard Home do pierwszego ustawienia/konfiguracji.

            # Bezpieczne Protokoły DNS
            - 192.168.1.200:853:853/tcp # 853/TCP: DNS-over-TLS (DoT) – szyfrowana komunikacja DNS.
            - 192.168.1.200:784:784/udp # 784/UDP: DNS-over-QUIC (DoQ) – nowoczesny i szybki, szyfrowany protokół DNS oparty na QUIC.
            - 192.168.1.200:853:853/udp # Zazwyczaj nieużywany dla DoQ, ale może być pozostawiony dla kompatybilności.
            - 192.168.1.200:8853:8853/udp # Czasem używany jako alternatywny port dla DoQ.

            # DNSCrypt (Szyfrowanie DNS)
            - 192.168.1.200:5443:5443/tcp # 5443/TCP: Port dla DNSCrypt.
            - 192.168.1.200:5443:5443/udp # 5443/UDP: Port dla DNSCrypt.
        volumes: # Sekcja do mapowania katalogów hosta na katalogi w kontenerze, zapewniając trwałość danych.
            # Ważne: Wymagają istnienia podkatalogów 'work' i 'conf' obok pliku docker-compose.yml na hoście.
            - ./work:/opt/adguardhome/work # Mapuje katalog 'work' na hoście do katalogu roboczego AdGuard Home. Zawiera logi i tymczasowe dane.
            - ./conf:/opt/adguardhome/conf # Mapuje katalog 'conf' na hoście do katalogu konfiguracyjnego. Zawiera bazę danych z ustawieniami i statystykami. KLUCZOWE dla zachowania konfiguracji.
        restart: unless-stopped # Polityka restartu: Kontener zostanie automatycznie uruchomiony, jeśli się zatrzyma (np. po awarii lub restarcie serwera), chyba że został ręcznie zatrzymany przez użytkownika.

Zarządzanie Usługą (Docker Compose)

Do zarządzania usługą w kontenerze na serwerze domowym użyjesz komendy docker compose (lub starszej wersji docker-compose). Poniższe komendy wykonuje się w katalogu, w którym znajduje się plik docker-compose.yml.

Uruchomienie Usługi (Pierwsza Instalacja)

Aby uruchomić usługę i kontener w tle (detached mode) użyj polecenia poniżej:

Bash
docker compose up -d

Opis parametrów: * up: Tworzy i uruchamia kontenery. * -` (detached): Uruchamia kontenery w tle, zwalniając terminal.

Usunięcie Usługi

Aby zatrzymać i usunąć kontener, sieć oraz wszystkie powiązane zasoby (ale zachować zmapowane woluminy work i conf na hoście):

Bash
docker compose down

Aktualizacja Obrazu

Aby zaktualizować AdGuard Home do nowszej wersji (zakładając, że obraz docker.io/adguard/adguardhome został zaktualizowany przez twórców):

Pobierz najnowszy obraz

Bash
docker compose pull adguardhome

Zatrzymaj i ponownie utwórz kontener (używając nowego obrazu):

Bash
docker compose up -d

Docker Compose automatycznie wykryje, że obraz jest nowszy i zastąpi stary kontener nowym, zachowując wszystkie Twoje dane konfiguracyjne dzięki zdefiniowanym woluminom (./conf i ./work).

Wymuszenie ponownego utworzenia kontenera

Jeśli chcesz wymusić odtworzenie kontenera nawet bez zmiany obrazu (np. po zmianie zmiennych środowiskowych w pliku docker-compose.yml), ale bez używania down:

Bash
docker compose up -d --force-recreate

--force-recreate: Zmusza Docker Compose do ponownego utworzenia kontenera, nawet jeśli jego konfiguracja się nie zmieniła. Jest to szybsze niż down i up, ponieważ nie usuwa sieci i może być użyte bezpośrednio po zmianie pliku docker-compose.yml.

Pełna lista poleceń Docker Compose

Zestawienie najważniejszych komend na potrzeby uruchamiania usług Docker Compose zdefiniowanych w plikach docker-compose.yml znajdziesz w przygotowanym poradniku Polecenia Docker Compose

Konfiguracja niestandardowego Serwera DNS

Jeśli chcesz, aby Twoja sieć domowa zaczęła korzystać z AdGuard Home i blokować reklamy, musisz zmienić ustawienia serwera DNS w Twoim routerze na adres IP serwera, na którym działa AdGuard Home. Proces ten jest powszechnie nazywany Konfiguracją Niestandardowego Serwera DNS (ang. Custom DNS Server Setup).

Konfiguracja Routera: Zmiana Serwera DNS

Znajdź Adres IP AdGuard Home

Musisz znać adres IP serwera, na którym działa kontener AdGuard Home.

  1. W pliku docker-compose.yml został podany przykład, że AdGuard Home ma nasłuchiwać na adresie 192.168.1.200 na porcie 53.
  2. Ważne: Upewnij się, że ten adres IP (192.168.1.200) jest statycznym (stałym) adresem przypisanym do Twojego domowego serwera (np. Raspberry Pi, mini PC), na którym uruchomiłeś kontener Dockera z usługa AdGuard Home.

Dostęp do Panelu Routera

Zaloguj się do panelu administracyjnego swojego routera:

  1. Otwórz przeglądarkę internetową na komputerze podłączonym do sieci.
  2. Wpisz adres IP routera (zazwyczaj jest to 192.168.1.1 lub 192.168.0.1) - adres czesto znajdziesz na naklejce na twoim urządzeniu lub w instrukcji obsługi / umowie z operatorem internetu.
  3. Zaloguj się przy użyciu swoich poświadczeń (login i hasło administracyjne).

Lokalizacja Ustawień DNS (Przykład ASUS Router)

Na większości routerów ASUS, ustawienia DNS, które kontrolują całą sieć, znajdują się w sekcji WAN (Wide Area Network).

Zmiana Ustawień DNS

W sekcji "Połączenie internetowe" (WAN), szukaj opcji związanych z Serwerami DNS:

  1. "Łączenie z serwerem DNS automatycznie" (Connect to DNS Server automatically)
  2. "Serwer DNS 1" (DNS Server 1)
  3. "Serwer DNS 2" (DNS Server 2)

Wyłącz Automatyczne DNS:

  1. Zmień opcję "Łączenie z serwerem DNS automatycznie" z "Tak" na "Nie" lub "Ustaw ręcznie".
  2. Wprowadź adres AdGuard Home: W polu "Serwer DNS 1" wpisz statyczny adres IP Twojego domowego serwera: 192.168.1.200 (dla przedstawionego przykładu).
  3. W polu "Serwer DNS 2" możesz wprowadzić ten sam adres, lub pozostawić puste pole.
  4. Zapisz i Zastosuj: Kliknij przycisk "Zastosuj" (Apply) lub "Zapisz" (Save).
  5. Router może się zrestartować.

Kategoria: Usługi | Autor: Rafał Wójcik
Utworzono: 2025-11-29 00:37 | Ostatnia edycja: 2026-01-17 00:28

Pytania & Komentarze

Brak komentarzy. Bądź pierwszy!

Dodaj nowy komentarz