Przejdź do głównej zawartości

Rozdział 2: Instalacja Pi-hole

Pi-hole v6

Kurs jest zaktualizowany pod Pi-hole v6 (wydany 18 lutego 2025 r., ogłoszenie). W v6 serwer WWW i API są wbudowane w pihole-FTL — nie ma już lighttpd ani PHP, konfiguracja jest w /etc/pihole/pihole.toml, a hasło zmienia się poleceniem pihole setpassword. Jeśli masz Pi-hole v5, część poleceń z kursu będzie wyglądać inaczej.

📥 2.1 Instalacja krok po kroku​

  1. Zaloguj się do Raspberry Pi przez SSH (jeśli jeszcze nie jesteś zalogowany):
ssh [email protected]
  1. Zaktualizuj listę pakietów i upewnij się, że system jest aktualny:
sudo apt update && sudo apt upgrade -y
  1. Pobierz i uruchom skrypt instalacyjny Pi-hole:
curl -sSL https://install.pi-hole.net | bash

  1. Podczas instalacji instalator zapyta m.in. o:

    • interfejs sieciowy → jeśli masz więcej niż jeden (np. eth0 i wlan0).
    • Upstream DNS Provider(s) → np. Google (8.8.8.8), Cloudflare (1.1.1.1) lub inny.
    • Blocklists → czy dodać domyślną listę StevenBlack's Unified Hosts (możesz dodać własne po instalacji).
    • Enable Logging → czy zapisywać zapytania DNS.
    • Privacy mode → poziom prywatności statystyk FTL, według własnych preferencji.

    W v6 instalator nie pyta już o interfejs webowy ani lighttpd — serwer WWW jest częścią pihole-FTL. Pytanie o lighttpd pojawia się tylko przy aktualizacji z v5: instalator proponuje wtedy jego wyłączenie.

2.2 Konfiguracja podstawowa​

  1. Dostęp do panelu administracyjnego:

    • Otwórz przeglądarkę i przejdź do adresu:
    http://<IP_Raspberry_Pi>/admin

    (Zamień <IP_Raspberry_Pi> na adres IP Twojego Raspberry Pi, np. 192.168.0.12)

    • Panel działa też po HTTPS (https://<IP_Raspberry_Pi>/admin) — instalator tworzy certyfikat self-signed (dokumentacja), więc przeglądarka pokaże ostrzeżenie.

  2. Zaloguj się do panelu przy użyciu hasła wyświetlonego na końcu instalacji.

    • Jeśli zapomniałeś hasła, ustaw nowe poleceniem (dokumentacja):
sudo pihole setpassword
  1. Dodaj nowe listy blokujące lub usuń istniejące w zakładce "Group Management" > "Lists" (w v5 nazywała się "Adlists").

2.3 Ustawienie statycznego IP (jeśli nie zostało ustawione wcześniej)​

Od Raspberry Pi OS Bookworm (2023) siecią zarządza NetworkManager, a nie dhcpcd — edycja /etc/dhcpcd.conf nic nie da (Raspberry Pi). Dokumentacja Raspberry Pi zaleca zamiast tego rezerwację adresu (DHCP reservation) na routerze. Jeśli chcesz ustawić adres na samym Raspberry Pi, użyj nmcli:

# Nazwa połączenia, np. "Wired connection 1"
nmcli connection show

sudo nmcli connection modify "Wired connection 1" \
  ipv4.method manual \
  ipv4.addresses 192.168.0.12/24 \
  ipv4.gateway 192.168.0.1 \
  ipv4.dns "8.8.8.8 8.8.4.4"
sudo nmcli connection up "Wired connection 1"

Szczegóły: Rozdział 1.

🟢 Podsumowanie​

✅ Zainstalowano Pi-hole.
✅ Skonfigurowano interfejs webowy.
✅ Ustawiono statyczny adres IP.