instrukcja adguard

Home.md

@@ -1,53 +1,14 @@
-# ⛔ Blocklisty ICD
+# Blocklisty ICD - Wiki
 
-Ten projekt, realizowany przez [Fundację *Internet. Czas działać!*](https://www.internet-czas-dzialac.pl/), ma na celu utrzymanie czarnej listy stron internetowych, które generują niskiej jakości treści i przyczyniają się do obniżenia jakości internetu.
+Oto Wiki projektu *Blocklisty ICD*. W tym miejscu wyjaśnimy jak zainstalować publikowane przez nas listy w różnych, popularnych rozwiązaniach typu Adblock. 
 
-**⚠️ UWAGA!** Projekt nie zajmuje się ostrzeganiem przed niebezpiecznymi stronami (np. [phishingiem](https://pl.wikipedia.org/wiki/Phishing)). Po listy zwiększania bezpieczeństwa w Internecie odsyłamy na:
+## Blockery oparte o DNS
-- [CERT Polska: Lista Ostrzeżeń](https://cert.pl/lista-ostrzezen/)
-- [Phishing Army](https://phishing.army/)
 
-## 📜 Dostępne listy
+* [AdGuard Home](adguard_home.md)
+* Pi-Hole
+* Technitium DNS
+* NextDNS
 
-### 🗣️ SEO-bełkot
+## Blockery oparte o wtyczki
 
-SEO-bełkot to praktyka pisania artykułów pod kątem uzyskania jak najwyższej punktacji w wyszukiwarkach internetowych, ale niekoniecznie są wartościowe lub zrozumiałe dla użytkowników. Artykuły seo-bełkotu napisane są w sposób sztuczny i często zawierają nadmierną liczbę słów kluczowych. Kojarzysz te dłuuuuuugie artykuły o niedzielach handlowych, które można byłoby streścić do jednego zdania? To jest właśnie seo-bełkot.
+* uBlackList
-
-| Format     | Link                                                                                                   |
-|------------|--------------------------------------------------------------------------------------------------------|
-| AdGuard    | https://git.internet-czas-dzialac.pl/icd/blocklisty/raw/branch/master/dist/seo-nonsense/adguard.txt    |
-| uBlacklist | https://git.internet-czas-dzialac.pl/icd/blocklisty/raw/branch/master/dist/seo-nonsense/ublacklist.txt |
-
-### 🎫 Reflink Spam
-
-Reflinki to specjalne linki, które pozwalają użytkownikom uzyskiwać wynagrodzenie za polecanie produktów danej firmy. Strony typu "reflink spam" to witryny internetowe, które wykorzystują linki afiliacyjne ([marketing afiliacyjny](https://pl.wikipedia.org/wiki/Marketing_afiliacyjny)) w sposób nieetyczny lub agresywny, aby generować dochody z prowizji. Zazwyczaj są to witryny oferujące tzw. kody rabatowe, które w rzeczywistości nie istnieją. W praktyce jedynie przypisują kod polecenia do właściciela strony – potem kupujesz produkt, a właściciel zarabia za "polecenie" Ci produktu.
-
-| Format     | Link                                                                                                   |
-|------------|--------------------------------------------------------------------------------------------------------|
-| AdGuard    | https://git.internet-czas-dzialac.pl/icd/blocklisty/raw/branch/master/dist/reflink-spam/adguard.txt    |
-| uBlacklist | https://git.internet-czas-dzialac.pl/icd/blocklisty/raw/branch/master/dist/reflink-spam/ublacklist.txt |
-
-### 🎭 Strony satyryczne
-
-Strony typu [satyra](https://pl.wikipedia.org/wiki/Satyra) to typ stron, które nie niosą ze sobą żadnej wartości merytorycznej, ale wyglądają rzetelnie, co często wprowadza użytkowników w błąd i prowadzi do dezinformacji.
-
-| Format     | Link                                                                                              |
-|------------|---------------------------------------------------------------------------------------------------|
-| AdGuard    | https://git.internet-czas-dzialac.pl/icd/blocklisty/raw/branch/master/dist/satire/adguard.txt    |
-| uBlacklist | https://git.internet-czas-dzialac.pl/icd/blocklisty/raw/branch/master/dist/satire/ublacklist.txt |
-
-### 🪞 Strony lustrzane (mirror)
-
-Strony typu lustrzane (inaczej: [mirror](https://pl.wikipedia.org/wiki/Mirror)) to strony reprodukujące treść oryginalnych stron internetowych, często bez zgody ich właścicieli. Tego rodzaju kopie są zazwyczaj tworzone w sposób automatyczny. Głównym celem takich stron jest generowanie dochodu poprzez reklamy, co w praktyce oznacza, zarabianie na pracy i wysiłku innych osób, nie oferując im żadnej rekompensaty.
-
-| Format     | Link                                                                                              |
-|------------|---------------------------------------------------------------------------------------------------|
-| AdGuard    | https://git.internet-czas-dzialac.pl/icd/blocklisty/raw/branch/master/dist/mirror/adguard.txt    |
-| uBlacklist | https://git.internet-czas-dzialac.pl/icd/blocklisty/raw/branch/master/dist/mirror/ublacklist.txt |
-
-## ➕ Jak dodać stronę do listy?
-
-Obecnie projekt znajduje się w wczesnej fazie rozwoju i jedynie członkowie ICD mają możliwość dodawania stron do list blokujących.
-
-## 🔨 Budowanie listy blokowania z JSONa
-
-Podczas dodawania nowych pozycji do listy nie ma potrzeby ręcznego jej budowania, ponieważ git hook automatycznie zajmie się tym podczas akcji commita. Jeśli jednak chcesz zbudować listę samodzielnie, możesz skorzystać z konwertera używając polecenia `make build`. Aby wyczyścić listy użyj `make clean`.

adguard_home.md

@@ -0,0 +1,24 @@
+# AdGuard Home
+
+**AdGuard Home** to darmowy program, który pozwala blokować reklamy, śledzenie i niechciane strony na wszystkich urządzeniach w domowej sieci. Może zostać na komputerze, Raspberry Pi, serwerze lub routerze, gdzie działa jako serwer DNS – czyli system pośredniczący przy otwieraniu stron internetowych. Gdy urządzenie w sieci prosi o dostęp do strony, AdGuard Home sprawdza, czy znajduje się ona na czarnej liście i w razie potrzeby blokuje połączenie, zanim strona się otworzy.
+
+## Jak dodać listy ICD do AdGuard Home
+
+Dodanie naszych list do AdGuard Home jest bardzo proste! 
+
+1. Zaloguj się do panelu administracyjnego AdGuard Home.
+
+2. Kliknij w `Filtry` i z wysuniętego menu wybierz `Listy zablokowanych DNS`.
+![AdGuard-1](screenshots/adguard/adguard-1.png)
+3. Zjedź na sam dół i kliknij w `Dodaj listę do zablokowanych`.
+
+4. Pojawi się okno na środku ekranu z dwiema opcjami, wybierz `Dodaj listę niestandardową`. 
+
+5. Tutaj należy podać dwie wartości - nazwę listy oraz bezpośredni adres URL. Nazwę możesz podać dowolną, np. *icd-mirror*. W drugim polu tekstowym podaj adres URL do wybranej listy. Linki te znajdziesz w [README.md](https://git.internet-czas-dzialac.pl/icd/blocklisty/src/branch/master/README.md). Wybierz link opisany jako *AdGuard*.
+![AdGuard-2](screenshots/adguard/adguard-2.png)
+6. Naciśnij `Zapisz`. Po chwili oprogramowanie automatycznie pobierze listę stron do zablokowania  i zacznie je blokować.
+![AdGuard-3](screenshots/adguard/adguard-3.png)
+
+Warto tutaj zaznaczyć, że aktualizacja list jest automatyczna -- po dodaniu AdGuard będzie sam odświeżał plik z listą i pobierał nowe strony do blokowania.
+
+Korzystasz z Terraform lub OpenTofu do zarządzania konfiguracją AdGuard? Przykład dodania resource możesz podejrzeć [tutaj](https://codeberg.org/cichy1173/adguard-home-cm-repository/pulls/12)!

nextdns.md

@@ -0,0 +1,3 @@
+Niestety, NextDNS aktualnie nie wspiera dodawania własnych list do blokowania.
+
+

pi-hole.md

@@ -0,0 +1 @@
+Instrukcja w budowie :-) 

technitium_dns.md

@@ -0,0 +1 @@
+Instrukcja w budowie :-)

ublacklist.md

@@ -0,0 +1 @@
+Instrukcja w budowie :-)