Kompletný návod na inštaláciu Pi-hole pomocou Dockeru

Posledná aktualizácia: 30 augusta 2026

Už vás nebaví bombardovať sa reklamami pri každom prehliadaní internetu alebo používaní mobilnej aplikácie? Existuje fantastické riešenie s názvom Pi-hole, ktoré v podstate funguje ako inteligentný filter DNSNajlepšie na tom je, že nemusíte nič inštalovať na každé zariadenie vo vašej domácnosti; systém funguje z jadra vašej siete, zachytáva a blokuje nechcený obsah ešte predtým, ako sa dostane na vašu obrazovku.

Na nastavenie tohto systému je dnes najrozumnejšou možnosťou použiť Docker. Umiestnením Pi-hole do kontajnera sa vyhnete preplneniu operačného systému počítača, neuveriteľne zjednodušíte aktualizácie a môžete... čo najlepšie využiť hardvérči už ide o Raspberry Pi, starý server alebo dokonca virtuálny stroj na Ubuntu alebo Debiane, bez toho, aby sa služby navzájom kolidovali.

Blokujte reklamy pomocou Pi-hole
Súvisiaci článok:
Kompletný sprievodca blokovaním reklám pomocou Pi-hole

Predpoklady a príprava miesta

Predtým, ako sa do toho pustíme, je dobré vedieť, že Pi-hole je extrémne ľahký. Aby ste ho rozbehli ako sen, potrebujete len pár... 512 MB RAM a 2 až 4 GB úložného priestoru na disku. Čo sa týka operačného systému, funguje skvele s distribúciami, ktoré používajú systemd alebo sysvinit, ako napríklad Debian, Ubuntu, Fedora alebo Raspberry Pi OS.

Kritickým bodom je sieť. Aby bol systém stabilný, Pi-hole vyžaduje statická IP adresaAk si nechcete veci komplikovať manuálnou konfiguráciou servera, môžete si na smerovači rezervovať IP adresu, aby počítaču, v ktorom sa kontajner nachádza, vždy priradil rovnakú adresu.

  Čo je Webminal: Online Linuxový terminál na učenie

Nasadenie Pi-hole pomocou Dockeru

Najjednoduchší spôsob, ako začať, je cez súbor prístavný robotník-compose.ymlTáto metóda vám umožňuje definovať celú konfiguráciu naraz. Je nevyhnutné namapovať zväzky (ako napríklad /etc/pihole a /etc-dnsmasq.d) na lokálne priečinky na vašom hostiteľovi, aby v prípade aktualizácie obrazu kontajnera... Nestratite všetky svoje nastavenia ani vaše čierne listiny.

Mikropočítač Raspberry Pi v priehľadnom puzdre, predstavujúci hardvér pre server Pi-hole
Súvisiaci článok:
Kompletný sprievodca Pi-hole a Unbound pre online súkromie

V konfiguračnom súbore je potrebné venovať pozornosť portom. Port 53 je srdcom DNS a musí byť voľný. Ak vidíte, že sa kontajner nespúšťa, je pravdepodobné, že systemd-resolved alebo dnsmasq obsadzujú daný port na hostiteľovi. V takýchto prípadoch budete musieť vypnúť konfliktnú službu alebo nakonfigurovať most na presmerovanie prevádzky.

Ak sa rozhodnete použiť Pi-hole aj ako DHCP server, nezabudnite, že musíte pridať funkciu SPRÁVCA_SIETE v sekcii cap_add príkazu compose a najlepšie použiť režim hostiteľskej siete (network_mode: host), aby sa predišlo problémom s pripojením.

Počiatočné nastavenie a správa prístupov

Keď vykonáte príkaz docker-compose up -dSystém bude spustený. Ak chcete získať prístup k ovládaciemu panelu, pripojte sa k IP adrese vášho servera prostredníctvom portu, ktorý ste priradili (predvolene 80, hoci ho môžete zmeniť na 8080 alebo 89, aby ste sa vyhli konfliktom s inými webovými servermi). Ak ste v premennej prostredia nedefinovali heslo... WEBOVÉ HESLOSystém vygeneruje náhodný, ktorý môžete nájsť kontrolou protokolov pomocou príkazu docker logs pihole | grep random.

Pre zvýšenie bezpečnosti je najlepšie toto heslo rýchlo zmeniť. Do kontajnerového terminálu sa dostanete pomocou docker exec -it pihole /bin/bash a spustite príkaz pihole -a -p nastaviť heslo, ktoré si ľahko zapamätáte vy, ale ťažko zapamätáte ostatným.

  5 nástrojov, ktoré sa naučíte programovať v Pythone

Filtrovanie upstreamu a optimalizácia DNS

Aby Pi-hole vedel, koho má kontaktovať, keď nerozpozná adresu, je potrebné nakonfigurovať nadradený DNS server. Veľmi robustnou možnosťou je Quad9Výberom filtrovaných serverov (napríklad 9.9.9.9) na karte nastavení DNS môžete pri prehliadaní pridať ďalšiu vrstvu zabezpečenia a súkromia.

Srdcom Pi-hole sú jeho blokované zoznamy. Ak chcete začať s niečím solídnym, môžete pridať zoznam StevenBlackVždy, keď upravujete zoznamy, či už odstránením položiek pomocou SQLite3 alebo pridaním nových URL adries, je nevyhnutné prejsť do Nástrojov a spustiť Aktualizácia gravitácie aby sa databáza obnovila a zmeny sa prejavili.

Pokročilé tipy: Lokálne domény a ich správa

Ak máte doma viacero služieb, môžete si vytvoriť lokálne doménové mená aby ste sa vyhli nutnosti pamätať si IP adresy. Na to vytvorte súbor s názvom local.list na pripojenom zväzku Pi-hole s definovaním formátu IP adresy a domény. Potom vytvorte konfiguračný súbor pre dnsmasq, ktorý odkazuje na tento zoznam a reštartujte kontajner.

Na správu systému bez prístupu na webovú stránku existujú veľmi užitočné príkazy, ktoré môžete spustiť z hostiteľa. Napríklad na pridanie domény na čiernu listinu použite pihole -b mojadomena.com Alebo na dočasné vypnutie filtrovania na 10 minút môžete použiť Pihole disable 10mToto je veľmi užitočné, keď je legitímna webová stránka omylom zablokovaná.

Prevzatie kontroly nad domácou reklamou je úplne uskutočniteľné kombináciou skromného hardvéru s flexibilitou Dockeru, zabezpečením voľného portu 53 a správnou konfiguráciou zväzkov na uchovávanie dát. Po úprave DNS na smerovači a optimalizácii zoznamov Gravity si budete môcť vychutnať čistejšiu a oveľa rýchlejšiu sieť na všetkých svojich zariadeniach.

Detailný záber dosky Raspberry Pi s jej elektronickými súčiastkami, mikročipmi a portami viditeľnými na povrchu, ideálny na ilustráciu hlavného hardvéru tutoriálu
Súvisiaci článok:
Kompletný sprievodca inštaláciou a optimalizáciou AdGuard Home na Raspberry Pi