Kurs Pi-hole v6 po polsku: instalacja, konfiguracja i rozwiązywanie problemów

Pi-hole blokuje reklamy, trackery i złośliwe domeny na poziomie DNS — dla wszystkich urządzeń w sieci naraz, bez rozszerzeń w przeglądarkach. Przygotowałem darmowy kurs Pi-hole po polsku w dziale dokumentacji: od przygotowania Raspberry Pi po rozwiązywanie problemów.

Aktualizacja 2026-10-03

Kurs powstał w 2024 r. pod Pi-hole v5. 18 lutego 2025 r. wyszedł Pi-hole v6 (ogłoszenie), który zmienił sporo rzeczy opisanych w kursie. Rozdziały są już zaktualizowane na podstawie dokumentacji i kodu źródłowego Pi-hole v6:

• serwer WWW jest wbudowany w pihole-FTL — nie ma lighttpd ani PHP, panel działa też po HTTPS;
• hasło panelu zmienia się poleceniem sudo pihole setpassword (dawne pihole -a -p nie istnieje);
• pihole -c usunięto (pi-hole#5423), następcą jest PADD; logi na żywo pokazuje pihole -t;
• zakładka „Adlists” nazywa się teraz „Lists”;
• na Raspberry Pi OS od wersji Bookworm statyczny IP ustawia się przez NetworkManager (nmcli), a nie /etc/dhcpcd.conf.

Co jest w kursie

Rozdział	Co znajdziesz
Wstęp	czym jest Pi-hole, jak działa blokowanie na poziomie DNS, wymagania
1. Przygotowanie	Raspberry Pi lub inny serwer, system, statyczny adres IP
2. Instalacja	instalator, pytania podczas instalacji, pierwsze logowanie do panelu
3. Konfiguracja sieci	Pi-hole jako DNS w routerze lub na urządzeniach, DHCP
4. Zarządzanie i monitorowanie	panel, statystyki, logi, listy blokujące
5. Zabezpieczenia i optymalizacja	hasło panelu, listy złośliwych domen, firewall, aktualizacje
6. Zaawansowane funkcje	Unbound jako lokalny resolver, WireGuard, własne listy
7. Rozwiązywanie problemów	brak blokowania, niedziałający panel, FTL, reinstalacja
8. Scenariusze zastosowania	sieć domowa, mała firma, urządzenia mobilne i Smart TV
Załączniki	listy blokujące (m.in. Firebog), słownik pojęć

Najkrótsza ścieżka

Jeśli chcesz tylko uruchomić Pi-hole, wystarczą trzy kroki:

1. Oficjalny instalator (dokumentacja):

   curl -sSL https://install.pi-hole.net | bash

2. Panel pod http://<IP_serwera>/admin, hasło wyświetla się na końcu instalacji (zmiana: sudo pihole setpassword).

3. Adres Pi-hole jako serwer DNS w routerze — szczegóły w rozdziale 3.

Reszta kursu to to, co przydaje się później: dobór list, Unbound, zabezpieczenie panelu i diagnoza, gdy coś przestaje działać.

Pi-hole w praktyce

U siebie trzymam Pi-hole w Dockerze na VPS, obok WireGuarda i innych usług — monitoring tego zestawu opisałem we wpisie Prometheus i Grafana na VPS w Dockerze.

👉 Rozpocznij kurs Pi-hole