ph-whitelist

Partendo dall'ottimo lavoro di anudeepND ho voluto realizzare ph-whitelist, un fork che in un solo script racchiude la possibilità di modificare dinamicamente la whitelist utilizzata da Pi-hole. Lo script permette infatti di aggiungere rapidamente siti web dichiarati leciti dal forum ufficiale della comunità, sbloccare l'uso di Social Network (che spesso vedono finire loro domini in blacklist comunemente utilizzate), integrare siti web che mancano all'appello delle liste di anudeepND, file che sono comunque alla base del funzionamento di ph-whitelist.

Caratteristiche

• Codice sempre sotto controllo: ph-whitelist è su GitHub, chiunque può rilasciare un fix, un aggiornamento, una nuova versione. Se vuoi contribuire, sei il benvenuto (o la benvenuta :-)).
• Liste sempre aggiornate: il lavoro svolto da anudeepND è egregio. ph-whitelist utilizza la sua whitelist costantemente aggiornata e permette di integrarla con domini da lui non utilizzati.
• Adatte a ogni sistema: non importa dove tu stia facendo girare Pi-hole, le whitelist sono compatibili con ogni sistema (sì, potresti utilizzarle anche con prodotti di terze parti che nulla c'entrano con Pi-hole).
• Pronto per RPi: ph-whitelist è stato scritto e testato su Raspbian per Raspberry Pi 3B+.

Download e Utilizzo

Lo script è utilizzabile da riga di comando. Puoi eseguirlo manualmente richiedendo il tipo di lista da scaricare e integrare nella tua whitelist (te le propongo qua di seguito), pensa lui a tutto. Ho incluso inoltre un'opzione che ti permette di cancellare completamente l'attuale whitelist in uso sulla tua installazione di Pi-hole.

Per scaricare lo script sul tuo RPi, lancia da terminale un semplice wget dello stesso, poi rendilo eseguibile:

wget -N https://raw.githubusercontent.com/gioxx/ph-whitelist/master/scripts/whitelist.sh
chmod +x whitelist.sh

sudo ./whitelist safe|referral|stats|facebook

sudo ./whitelist safe
pi@raspbiantest:~ $ sudo ./whitelist.sh safe
Download and add safe sites to whitelist (official: anudeepND) ...
 [ ✔ ]  Adding to whitelist...
 [ ✔ ]  Removing duplicates...
Download and add safe sites to whitelist (integration: gioxx) ...
 [ ✔ ]  Adding to whitelist...
 [ ✔ ]  Removing duplicates...
 [...]  Pi-hole gravity rebuilding lists. This may take a while...
 [ ✔ ]  Pi-hole's gravity updated
 [ ✔ ]  Done!
pi@raspbiantest:~ $

sudo ./whitelist trusted

sudo ./whitelist clear

sudo ./whitelist upgrade

pi@raspbiantest:~ $ sudo crontab -l
# Edit this file to introduce tasks to be run by cron.
#
# Each task to run has to be defined through a single line
# indicating with different fields when the task will be run
# and what command to run for the task
#
# To define the time you can provide concrete values for
# minute (m), hour (h), day of month (dom), month (mon),
# and day of week (dow) or use '*' in these fields (for 'any').#
# Notice that tasks will be started based on the cron's system
# daemon's notion of time and timezones.
#
# Output of the crontab jobs (including errors) is sent through
# email to the user the crontab file belongs to (unless redirected).
#
# For example, you can run a backup of all your user accounts
# at 5 a.m every week with:
# 0 5 * * 1 tar -zcf /var/backups/home.tgz /home/
#
# For more information see the manual pages of crontab(5) and cron(8)
#
# m h  dom mon dow   command
5 4 * * 1,3,5 /home/pi/whitelist.sh safe
7 4 * * 1,3,5 /home/pi/whitelist.sh referral
9 4 * * 1,3,5 /home/pi/whitelist.sh stats

sudo ./whitelist demo

Articoli pubblicati

Ti lascio qui di seguito i riferimenti necessari per lavorare con Pi-hole e ph-whitelist.

ph-whitelist: Gestisci dinamicamente la Whitelist di Pi-hole

Ho pubblicato un articolo dedicato a ph-whitelist all'interno del quale ti spiego il perché del progetto e quello che devi sapere per utilizzare lo script.

Pi-hole: installazione e prima configurazione

Tutto (o quasi) quello che devi sapere sull'installazione di Pi-hole sul tuo Raspberry Pi. Configurazione, utilizzo, liste di blocco e non solo.

Raspberry Pi: la base di partenza

Sei completamente a digiuno di nozioni riguardanti Raspberry Pi e le possibilità che questo piccolo computer può offrirti? Dai un'occhiata a questo mio articolo introduttivo.

Licenza d'uso, distribuzione e supporto

Il progetto è auto-finanziato e mantenuto da Giovanni F. 'Gioxx' Solone. Tutte le informazioni riguardanti progetto sono disponibili nel repository GitHub e nel mio blog.

Dove non diversamente specificato, il contenuto di questo sito web viene rilasciato con licenza Creative Commons, versione 4.0 by-nc-sa internazionale, descritta punto per punto a questo indirizzo: creativecommons.org/licenses/by-nc-sa/4.0/deed.it (oppure in inglese: creativecommons.org/licenses/by-nc-sa/4.0/deed.en).

Lo script è invece soggetto a licenza originale MIT di Anudeep:

MIT License
Copyright (c) 2018 Anudeep ND anudeep@protonmail.com
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE

ph-whitelist è e rimarrà gratuito, ma se ti va puoi offrirmi un caffè, o magari diventare sostenitore! :-)

• Dona ora con PayPal o con SatisPay
• Offri un caffè con Buy Me A Coffee
• Sostieni il progetto con Patreon