DNS MANAGER - istruzioni d'uso
==============================

Il programma e' gia' compilato: non serve compilare nulla.

CONTENUTO
---------
  dnsmanager.jar        il programma
  lib\                  librerie necessarie (non spostare, non cancellare)
  start.bat / stop.bat  avvio e arresto a mano su Windows (prove)
  installa_servizio.bat e *_servizio.bat   Windows come server (consigliato)
  start.sh  / stop.sh   avvio e arresto su Linux

La cartella va tenuta intera: dnsmanager.jar cerca le librerie in lib\.

REQUISITI
---------
- Java 11 o successivo (basta il JRE). Verifica con:  java -version
- La porta 53 (DNS) deve essere libera.
  Windows: se l'avvio fallisce con "Address already in use: bind",
           un altro servizio sta gia' usando la porta 53.
  Linux:   serve root (sudo) per usare la porta 53; se c'e' gia'
           systemd-resolved o dnsmasq sulla porta 53 vanno disattivati.
- La porta 8080 deve essere libera (console web di gestione).

AVVIO
-----
Windows (avvio a mano, per prove; per l'uso normale vedi WINDOWS COME SERVER):
  start.bat                         chiede quale file blacklist usare
  start.bat C:\percorso\lista.txt   usa quel file senza chiedere
  start.bat default                 blacklist locale + sorgenti online

Linux (prima volta: chmod +x *.sh):
  sudo ./start.sh                              blacklist predefinita
  sudo ./start.sh --blacklist=/percorso/lista.txt
  sudo ./start.sh --default
  sudo ./start.sh --gui                        apre anche la finestra
                                               (solo dal desktop del server)

Su Linux il programma parte senza finestre e si gestisce dalla console
web: va bene anche avviarlo da SSH. Il server resta attivo anche dopo
aver chiuso la sessione SSH (si ferma con stop.sh).
Se dal proprio PC la porta 8080 del server non e' raggiungibile, si puo'
aprire la console con un tunnel SSH:
  ssh -L 8080:localhost:8080 utente@server
e poi nel browser del proprio PC: http://localhost:8080/
Se sul server sono attivi systemd-resolved o dnsmasq sulla porta 53,
il DNS non parte ("Address already in use"): vanno disattivati.

WINDOWS COME SERVER (consigliato su Windows)
--------------------------------------------
Con start.bat il server si chiude quando l'utente si disconnette. Per un
server vero si installa come servizio, una volta sola:
  1. Copiare la cartella in un percorso fisso, es. C:\dnsmanager
     (NON in "Programmi", NON in OneDrive, NON in cartelle condivise).
  2. Doppio clic su installa_servizio.bat e confermare la richiesta di
     amministratore. Per usare un file blacklist preciso:
       installa_servizio.bat C:\dnsmanager\blacklist.txt
L'installazione:
  - crea l'attivita' pianificata "DNS Manager" che parte all'accensione di
    Windows, anche senza nessuno collegato, e riparte da sola se si blocca;
  - la esegue con l'account di sistema "Servizio locale" (non amministratore,
    nessuna password da gestire);
  - limita l'accesso alla cartella ad amministratori e servizio: contiene
    password, impostazioni e registro (Windows potrebbe chiedere conferma
    per aprirla in Esplora file);
  - apre nel firewall UDP 53 e TCP 8080 solo per la rete locale;
  - disattiva la sospensione del PC quando e' collegato alla corrente;
  - avvia il server e mostra la password iniziale della console.
Poi:
  avvia_servizio.bat / ferma_servizio.bat   avvio e arresto
  stato_servizio.bat                        e' in esecuzione?
  disinstalla_servizio.bat                  rimuove attivita' e regole firewall
Con il servizio installato non usare start.bat / stop.bat.
Se l'installazione segnala la porta 53 occupata: disattivare il ruolo
"Server DNS" (Windows Server) o la Condivisione connessione Internet.
Le liste usate dai laboratori conviene tenerle nella cartella del programma:
il servizio puo' non avere accesso a file in altre cartelle.
Aggiornare il programma: ferma_servizio.bat, sovrascrivere i file del
pacchetto (come amministratore), avvia_servizio.bat.

AVVIO SENZA ROOT (Linux, consigliato)
-------------------------------------
Con start_authbind.sh il server gira come utente normale invece che root
(piu' sicuro: la console web non ha i permessi di root).
Preparazione, una volta sola (NOMEUTENTE = utente che avviera' il server):
  sudo apt-get install authbind
  sudo touch /etc/authbind/byport/53
  sudo chown NOMEUTENTE /etc/authbind/byport/53
  sudo chmod 500 /etc/authbind/byport/53
Poi, SENZA sudo:
  ./start_authbind.sh                  (stessi parametri di start.sh)
  ./stop.sh
La cartella del programma deve appartenere a quell'utente (deve poterci
scrivere): se e' stata copiata da root, sudo chown -R NOMEUTENTE:NOMEUTENTE <cartella>
Non usare insieme start.sh (root) e start_authbind.sh: la porta 53 e'
una sola.

ARRESTO
-------
  Windows: stop.bat
  Linux:   sudo ./stop.sh

CONSOLE DI GESTIONE
-------------------
Con il programma avviato, aprire nel browser:  http://localhost:8080/
(da un altro PC: http://IP-DEL-SERVER:8080/)

La console e' protetta da password. Al primo avvio il programma genera una
password casuale e la scrive nel file password_iniziale.txt nella cartella
del programma (leggibile solo dal proprietario):
  Linux:  cat password_iniziale.txt
Dopo il primo accesso cambiarla dalla scheda Impostazioni (almeno 10
caratteri): il file viene cancellato automaticamente.
Dopo 5 password sbagliate l'accesso da quel PC e' bloccato per 5 minuti.
Dopo 2 ore di inattivita' bisogna rientrare.
Password dimenticata: fermare il server e riavviarlo aggiungendo
--reset-password (es. ./start_authbind.sh --default --reset-password):
viene generata una nuova password_iniziale.txt.

  - Controllo dominio: verifica se un dominio e' bloccato
  - Blacklist: elenco completo con ricerca; cambio file e
    pulsante "Ricarica blacklist da file" (oppure caricamento di un
    file dal proprio PC). La nuova lista vale subito, senza riavvio.
  - Sorgenti: liste online usate dalla blacklist predefinita
  - Laboratori: una scheda per laboratorio con filtro attivo/disattivo,
    blacklist usata, domini visitati/bloccati e pulsante "Azzera";
    sotto, l'editor di laboratori.txt con "Salva e applica"
  - Domini visitati / Domini bloccati: statistiche di tutta la scuola o
    di un singolo laboratorio, con il pulsante "Azzera domini visitati e bloccati"
  - Impostazioni: DNS di inoltro, registro e statistiche (privacy),
    IP da cui si puo' aprire la console, cambio password
  - In alto: il DNS di inoltro in uso, il pulsante per disattivare/riattivare
    il filtraggio di tutta la scuola e "Esci"

DNS DI INOLTRO
--------------
Le richieste non bloccate vengono inoltrate a un DNS esterno, indicato in
alto nella console e modificabile in Impostazioni. Predefinito: DNS4EU
protettivo (86.54.11.1 / 86.54.11.201), iniziativa dell'Unione Europea con
server in Europa e IP anonimizzati, che blocca anche malware e phishing.
Altri preset: DNS4EU protezione minori, DNS4EU senza filtri, Quad9
(fondazione svizzera, non conserva gli IP). Si puo' indicare anche un
server personalizzato (solo indirizzi IP): il pulsante "Prova" verifica che
risponda, e un server che non risponde non viene salvato.
Il DNS esterno vede solo l'IP del server della scuola, mai quello dei PC.

PRIVACY (GDPR)
--------------
Impostazioni predefinite pensate per la minimizzazione dei dati:
  - dnsserver.log (log tecnico) NON contiene i siti visitati ne' gli IP dei PC
  - registro delle richieste SPENTO. Se attivato (Impostazioni), i file sono
    in registro\registro-AAAA-MM-GG.txt, leggibili solo dal proprietario,
    e vengono cancellati automaticamente dopo i giorni impostati (default 7).
    Livelli: "solo bloccati" (data, laboratorio, dominio, senza IP) oppure
    "completo" (con IP: solo se previsto dalla scuola, sentito il DPO)
  - statistiche "Domini visitati/bloccati": aggregate per laboratorio, mai
    per singolo PC, solo in memoria (si azzerano al riavvio), visibili solo
    dopo il login; disattivabili in Impostazioni
  - console protetta da password; si puo' limitare agli IP dei tecnici
La console usa HTTP (non cifrato): per accedere da un altro PC e' preferibile
il tunnel SSH (vedi sopra) oppure limitare gli IP consentiti.
Restano a carico della scuola: informativa a studenti, famiglie e personale,
registro dei trattamenti, regolamento sull'uso della rete, valutazione con
il DPO (vedi la scheda tecnica per il DPO).

LABORATORI
----------
Il server riconosce il laboratorio dall'indirizzo IP del PC che fa la
richiesta. I laboratori si configurano nel file laboratori.txt (nella
cartella dei dati, vedi sotto) oppure dalla scheda "Laboratori" della
console: le modifiche valgono subito, senza riavvio.

Una riga per laboratorio:
  nome ; range IP ; blacklist

  Lab1 ; 172.16.1.10-172.16.1.40 ; generale
  Lab2 ; 172.16.2.10-40, 172.16.2.100 ; generale + ia_blacklist.txt
  Lab3 ; 172.16.3.0/24 ; generale + ia_blacklist.txt + messaggistica_blacklist.txt
  Altri ; ; generale + ia_blacklist.txt

Range IP (piu' range separati da virgola):
  172.16.1.25                  un solo indirizzo
  172.16.1.10-172.16.1.40      intervallo
  172.16.1.10-40               intervallo abbreviato
  172.16.3.0/24                notazione CIDR
Blacklist: una o piu' liste sommate con "+" (quante se ne vuole):
  generale                 la blacklist generale
  ia_blacklist.txt         un file nella cartella dei dati (o un percorso completo)
  vuoto                    solo la generale
I PC che non rientrano in nessun range finiscono nel gruppo "Altri";
le sue liste si impostano con la riga senza range:  Altri ; ; generale + ...
Se un file non esiste la console lo segnala e quella lista viene ignorata.
Quando si modifica il contenuto di una lista (es. ia_blacklist.txt):
scheda Blacklist, scegliere la lista e premere "Ricarica blacklist da file"
(oppure "Salva e applica" nella scheda Laboratori, che le rilegge tutte).

Liste pronte, gia' nella cartella del programma:
  ia_blacklist.txt              intelligenze artificiali (ChatGPT, Gemini...)
  messaggistica_blacklist.txt   WhatsApp, Telegram, Discord, Snapchat...
Nota: l'app Telegram si collega senza DNS; per bloccarla del tutto servono
sul firewall gli indirizzi di https://core.telegram.org/resources/cidr.txt
Se ci sono errori la console non salva e indica la riga da correggere.

IMPORTANTE: i PC dei laboratori devono avere indirizzi fissi o
prenotati nel DHCP dentro il range del proprio laboratorio, altrimenti
finiscono nel laboratorio sbagliato o in "Altri".

FORMATO DEI FILE BLACKLIST
--------------------------
File di testo con, anche mescolati:
  un dominio per riga                esempio.com
  formato hosts                      0.0.0.0 esempio.com
  regole adblock                     ||esempio.com^
Le righe che iniziano con # sono commenti.

FILE DI DATI
------------
Tutti i file stanno nella cartella del programma, accanto a dnsmanager.jar:
  blacklist.txt                 blacklist generale (predefinita)
  sorgenti.txt                  liste online usate per la predefinita
  laboratori.txt                configurazione dei laboratori
  whitelist.txt                 (opzionale) domini mai bloccati, uno per riga
  impostazioni.properties       impostazioni della console (contiene l'hash
                                della password: non condividerlo)
  password_iniziale.txt         solo finche' non si cambia la password
  registro\                     registro delle richieste (se attivato)
  ia_blacklist.txt, messaggistica_blacklist.txt e le altre liste
  upload_*.txt                  file caricati dalla console web
  download\                     copie delle liste scaricate da internet
La cartella deve essere scrivibile da chi avvia il programma (su Windows
non metterla in "Programmi"/"Program Files").
Le versioni precedenti tenevano i dati in .dnsserver\blacklist nella home
dell'utente: al primo avvio vengono copiati qui automaticamente (la vecchia
cartella non viene toccata e si puo' cancellare dopo aver controllato).
Per usare un'altra cartella: variabile d'ambiente DNS_DATA_DIR.

AGGIORNARE IL PROGRAMMA
-----------------------
Fermare il server, poi scompattare il nuovo pacchetto sopra al vecchio.
Le liste del pacchetto (ia_blacklist.txt, messaggistica_blacklist.txt)
verrebbero sovrascritte: se le avete modificate, su Linux escludetele con
  unzip -o dnsmanager.zip -x 'dnsmanager/*_blacklist.txt'
blacklist.txt, laboratori.txt, sorgenti.txt e whitelist.txt non sono nel
pacchetto e non vengono mai toccati.

LOG
---
  dnsserver.log (e dnsserver.log.err su Windows) nella cartella del programma.
