AdGuard Home

Centro di protezione della privacy per te e i tuoi dispositivi

Server DNS gratuito e open source, potente, per bloccare annunci e tracker su tutta la rete.

AdGuard.com | Wiki | Reddit | Twitter | Telegram

AdGuard Home è un software a livello di rete per bloccare annunci e tracciamento. Dopo averlo configurato, coprirà TUTTI i tuoi dispositivi di casa e non ti servirà alcun software lato client.

Funziona come un server DNS che reindirizza i domini di tracciamento verso un “buco nero”, impedendo così ai tuoi dispositivi di connettersi a quei server. Si basa sul software che usiamo per i nostri server AdGuard DNS pubblici, ed entrambi condividono gran parte del codice.

Per Iniziare
Confronto tra AdGuard Home e altre soluzioni
Come compilare dai sorgenti
- Prerequisiti
- Compilazione
Contribuire
Progetti che usano AdGuard Home
Riconoscimenti
Privacy

Per Iniziare

Installazione automatica (Linux/Unix/MacOS/FreeBSD/OpenBSD)

Per installare con curl esegui il seguente comando:```sh curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v

Per installare con `wget` esegui il seguente comando:```sh
wget --no-verbose -O - https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v

Per installare con fetch esegui il seguente comando:```sh fetch -o - https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v

Lo script accetta anche alcune opzioni:

- `-c <channel>` per usare il canale specificato;
- `-r` per reinstallare AdGuard Home;
- `-u` per disinstallare AdGuard Home;
- `-v` per un output dettagliato.

Nota che le opzioni `-r` e `-u` sono mutuamente esclusive.

### <a href="#alternative-methods" id="alternative-methods" name="alternative-methods">Metodi alternativi</a>

#### <a href="#manual-installation" id="manual-installation" name="manual-installation">Installazione manuale</a>

Leggi l'articolo **[Guida introduttiva][wiki-start]** sulla nostra Wiki per scoprire come installare AdGuard Home manualmente e come configurare i tuoi dispositivi per usarlo.

#### <a href="#docker" id="docker" name="docker">Docker</a>

Puoi usare la nostra immagine Docker ufficiale su [Docker Hub].

#### <a href="#snap-store" id="snap-store" name="snap-store">Snap Store</a>

Se utilizzi **Linux,** esiste un modo sicuro e semplice per installare AdGuard Home: scaricalo dal [Snap Store].

[Docker Hub]: https://hub.docker.com/r/adguard/adguardhome
[Snap Store]: https://snapcraft.io/adguard-home
[wiki-start]: https://adguard-dns.io/kb/adguard-home/getting-started/

### <a href="#guides" id="guides" name="guides">Guide</a>

Consulta la nostra [Wiki][wiki].

[wiki]: https://github.com/AdguardTeam/AdGuardHome/wiki

### <a href="#api" id="api" name="api">API</a>

Se vuoi integrare AdGuard Home, puoi usare la nostra [API REST][openapi]. In alternativa, puoi utilizzare questo [client python][pyclient], che può essere usato per creare l'[integrazione di AdGuard Home Assistant][assistant-integration].

[assistant-integration]:   https://www.home-assistant.io/integrations/adguard/
[openapi]:  https://github.com/AdguardTeam/AdGuardHome/tree/master/openapi
[pyclient]: https://pypi.org/project/adguardhome/

## <a href="#comparison" id="comparison" name="comparison">Confronto tra AdGuard Home e altre soluzioni</a>

### <a href="#comparison-adguard-dns" id="comparison-adguard-dns" name="comparison-adguard-dns">In cosa è diverso dai server DNS pubblici di AdGuard?</a>

Gestire il proprio server AdGuard Home consente di fare molto più che usare un server DNS pubblico. È un livello completamente diverso. Verifica di persona:

- Scegli esattamente cosa il server blocca e consente.

- Monitora l'attività della tua rete.

- Aggiungi le tue regole di filtraggio personalizzate.

- **La cosa più importante: è il tuo server e sei l'unico ad avere il controllo.**

### <a href="#comparison-pi-hole" id="comparison-pi-hole" name="comparison-pi-hole">Come si confronta AdGuard Home con Pi-Hole</a>

A questo punto, AdGuard Home ha molto in comune con Pi-Hole. Entrambi bloccano annunci e tracker utilizzando il cosiddetto metodo “DNS sinkholing” ed entrambi consentono di personalizzare ciò che viene bloccato.

> [!NOTE]
> Non ci fermeremo qui. Il DNS sinkholing non è un brutto punto di partenza, ma questo è solo l'inizio.

AdGuard Home offre molte funzionalità pronte all'uso, senza la necessità di installare e configurare software aggiuntivi. Vogliamo che sia semplice al punto che anche gli utenti occasionali possano configurarlo con il minimo sforzo.

> [!NOTE]
> Alcune delle funzionalità elencate possono essere aggiunte a Pi-Hole installando software aggiuntivi o utilizzando manualmente il terminale SSH e riconfigurando una delle utilità di cui Pi-Hole è composto. Tuttavia, a nostro parere, questo non può essere legittimamente considerato una funzionalità di Pi-Hole.

| Funzionalità                                                           | AdGuard&nbsp;Home | Pi-Hole                                                   |
|-------------------------------------------------------------------------|-------------------|-----------------------------------------------------------|
| Blocco di annunci e tracker                                             | ✅                | ✅                                                        |
| Personalizzazione delle blocklist                                       | ✅                | ✅                                                        |
| Server DHCP integrato                                                    | ✅                | ✅                                                        |
| HTTPS per l'interfaccia di amministrazione                              | ✅                | Più o meno, ma dovrai configurare manualmente lighttpd    |
| Server DNS upstream crittografati (DNS-over-HTTPS, DNS-over-TLS, DNSCrypt) | ✅                | ❌ (richiede software aggiuntivo)                         |
| Multipiattaforma                                                        | ✅                | ❌ (non nativamente, solo tramite Docker)                 |
| Funzionamento come server DNS-over-HTTPS o DNS-over-TLS                 | ✅                | ❌ (richiede software aggiuntivo)                         |
| Blocco di domini di phishing e malware                                   | ✅                | ❌ (richiede blocklist non predefinite)                   |
| Controllo parentale (blocco dei domini per adulti)                      | ✅                | ❌ (richiede blocklist non predefinite)                   |
| Imposizione della ricerca sicura sui motori di ricerca                  | ✅                | ❌                                                        |
| Configurazione per client (dispositivo)                                 | ✅                | ✅                                                        |
| Impostazioni di accesso (scegli chi può usare il DNS di AGH)            | ✅                | ❌                                                        |
| Esecuzione [senza privilegi di root][wiki-noroot]                       | ✅                | ❌                                                        |

[wiki-noroot]: https://adguard-dns.io/kb/adguard-home/getting-started/

### <a href="#comparison-adblock" id="comparison-adblock" name="comparison-adblock">Come si confronta AdGuard Home con i tradizionali ad blocker</a>

Dipende.

Il DNS sinkholing è in grado di bloccare una grande percentuale di annunci, ma non ha la flessibilità e la potenza dei tradizionali ad blocker. Puoi farti una buona idea della differenza tra questi metodi leggendo [questo articolo][blog-adaway], che confronta AdGuard per Android (un tradizionale ad blocker) con gli ad blocker a livello di hosts (che sono quasi identici ai bloccanti basati su DNS nelle loro capacità). Questo livello di protezione è sufficiente per alcuni utenti.

Inoltre, l'uso di un bloccante basato su DNS può aiutare a bloccare annunci, richieste di tracciamento e analytics su altri tipi di dispositivi, come Smart TV, smart speaker o altri tipi di dispositivi IoT (sui quali non è possibile installare i tradizionali ad blocker).

### <a href="#comparison-limitations" id="comparison-limitations" name="comparison-limitations">Limitazioni note</a>

Ecco alcuni esempi di ciò che non può essere bloccato da un bloccante a livello DNS:

- Annunci di YouTube e Twitch;

- Post sponsorizzati di Facebook, Twitter e Instagram.

In sostanza, qualsiasi pubblicità che condivide un dominio con i contenuti non può essere bloccata da un bloccante a livello DNS.

C'è la possibilità di gestire questo in futuro?  Il DNS non basterà mai a farlo. La nostra unica opzione è usare un proxy per il blocco dei contenuti, come facciamo nelle applicazioni AdGuard standalone. Abbiamo in programma di [portare][issue-1228] il supporto a questa funzionalità in AdGuard Home in futuro. Purtroppo, anche in questo caso, ci saranno ancora casi in cui non sarà sufficiente o richiederà una configurazione piuttosto complicata.

[blog-adaway]: https://adguard.com/blog/adguard-vs-adaway-dns66.html
[issue-1228]:  https://github.com/AdguardTeam/AdGuardHome/issues/1228

## <a href="#how-to-build" id="how-to-build" name="how-to-build">Come compilare dal sorgente</a>

### <a href="#prerequisites" id="prerequisites" name="prerequisites">Prerequisiti</a>

Esegui `make init` per preparare l'ambiente di sviluppo.

Ti servirà questo per compilare AdGuard Home:

- [Go](https://golang.org/dl/) v1.25 o successivo;
- [Node.js](https://nodejs.org/en/download/) v24.10.0 o successivo;
- [npm](https://www.npmjs.com/) v10.8 o successivo;

### <a href="#building" id="building" name="building">Compilazione</a>

Apri il terminale ed esegui questi comandi:```sh
git clone https://github.com/AdguardTeam/AdGuardHome
cd AdGuardHome
make

[!WARNING] Il flag non standard -j non è attualmente supportato, quindi compilare con make -j 4 o impostare la variabile MAKEFLAGS per includere, ad esempio, -j 4 potrebbe rompere la compilazione. Se hai MAKEFLAGS impostato in quel modo e non vuoi cambiarlo, puoi sovrascriverlo eseguendo make -j 1.

Consulta il Makefile per scoprire altri comandi.

Compilazione per una piattaforma diversa

Puoi compilare AdGuard Home per qualsiasi OS/ARCH supportato da Go. Per fare ciò, specifica le variabili d'ambiente GOOS e GOARCH come macro quando esegui make.

Per esempio:```sh env GOOS='linux' GOARCH='arm64' make

oppure:```sh
make GOOS='linux' GOARCH='arm64'

Preparazione delle release

Avrai bisogno di snapcraft per preparare una build di rilascio. Una volta installato, esegui il seguente comando:```sh make build-release CHANNEL='...' VERSION='...'

See the [`build-release` target documentation][targ-release].

#### <a href="#docker-image" id="docker-image" name="docker-image">Immagine Docker</a>

Esegui `make build-docker` per creare l'immagine Docker localmente (quella che pubblichiamo su DockerHub). Nota che stiamo usando [Docker Buildx][buildx] per creare la nostra immagine ufficiale.

Potrebbe essere necessario prepararsi prima di usare queste build:

- (Solo Linux) Installa Qemu:  ```sh
  docker run --rm --privileged multiarch/qemu-user-static --reset -p yes --credential yes

Prepara il builder: ```sh docker buildx create --name buildx-builder --driver docker-container --use

See the build-docker target documentation.

Debug del frontend

Quando hai bisogno di eseguire il debug del frontend senza ricompilare ogni volta la versione di produzione, ad esempio per verificare come apparirebbero le tue etichette in un modulo, puoi eseguire la build del frontend in un ambiente di sviluppo.

In un terminale separato, esegui: ```sh ( cd ./client/ && env NODE_ENV='development' npm run watch )
Esegui il binario AdGuardHome con il flag --local-frontend, che istruisce AdGuard Home a ignorare i file frontend integrati e a utilizzare quelli dalla directory ./build/.
Ora qualsiasi modifica apportata nella directory ./client/ dovrebbe essere ricompilata e diventare disponibile nell'interfaccia web. Assicurati di disabilitare la cache del browser per essere certo di ottenere effettivamente la versione ricompilata.

Test end-to-end (E2E) del frontend

AdGuard Home usa Playwright per i test E2E. I test si trovano in tests/e2e.

Esecuzione dei test:

npm run test:e2e – esegue tutti i test (in modalità headless).
npm run test:e2e:interactive – esegue i test in modalità interattiva.
npm run test:e2e:debug – esegue i test in modalità debug.
npm run test:e2e:codegen – genera nuovo codice di test.

Configurazione:

Esegui npm install per installare le dipendenze.
Esegui npx playwright install per configurare i browser necessari.

Attenzione: Playwright scaricherà e installerà i propri binari del browser per i test, che potrebbero differire dai browser installati sul tuo sistema.

Contribuire

Ti invitiamo a fare il fork di questo repository, apportare le tue modifiche e inviare una pull request. Tuttavia, assicurati di seguire le nostre linee guida del codice.

Tieni presente che non ci aspettiamo che le persone contribuiscano contemporaneamente alle parti UI e backend del programma. Idealmente, la parte backend viene implementata per prima, cioè configurazione, API e la funzionalità stessa. La parte UI può essere implementata successivamente in una pull request diversa da una persona diversa.

Testare le versioni instabili

Ci sono due canali di aggiornamento che puoi utilizzare:

beta: versioni beta di AdGuard Home. Versioni più o meno stabili, di solito rilasciate ogni due settimane o più spesso.
edge: la versione più recente di AdGuard Home dal ramo di sviluppo. I nuovi aggiornamenti vengono pubblicati su questo canale quotidianamente.

Ci sono tre opzioni per installare una versione instabile:

[Snap Store]: cerca i canali beta e edge.
[Docker Hub]: cerca i tag beta e edge.
Build standalone. Usa lo script di installazione automatizzato o cerca le build disponibili [sul Wiki][wiki-platf].

Script per installare una versione beta: ```sh curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -c beta

Script per installare una versione edge: ```sh curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -c edge

[wiki-platf]: https://github.com/AdguardTeam/AdGuardHome/wiki/Platforms

### <a href="#reporting-issues" id="reporting-issues" name="reporting-issues">Segnala problemi</a>

Se riscontri un problema o hai un suggerimento, vai a [questa pagina][iss] e fai clic sul pulsante "New issue". Segui attentamente le istruzioni nel modulo di segnalazione e non dimenticare di iniziare cercando eventuali duplicati.

[iss]: https://github.com/AdguardTeam/AdGuardHome/issues

### <a href="#translate" id="translate" name="translate">Collabora alle traduzioni</a>

Se vuoi aiutare con le traduzioni di AdGuard Home, scopri di più su come tradurre i prodotti AdGuard [nella nostra Knowledge Base][kb-trans]. Puoi contribuire al [progetto AdGuardHome su CrowdIn][crowdin].

[crowdin]:  https://crowdin.com/project/adguard-applications/en#/adguard-home
[kb-trans]: https://kb.adguard.com/en/general/adguard-translations

### <a href="#help-other" id="help-other" name="help-other">Altro</a>

Un altro modo per contribuire è [cercare issue][iss-help] contrassegnate come `help wanted`, chiedere se la issue è disponibile e inviare una PR che corregga il bug o implementi la funzionalità.

[iss-help]: https://github.com/AdguardTeam/AdGuardHome/issues?q=is:issue+is:open+label:%22help+wanted%22

## <a href="#uses" id="uses" name="uses">Progetti che usano AdGuard Home</a>

Nota: questi progetti non sono affiliati ad AdGuard, ma sono realizzati da sviluppatori e fan di terze parti.

- [AdGuard Home Remote](https://apps.apple.com/app/apple-store/id1543143740): app iOS di [Joost](https://rocketscience-it.nl/).

- [Libreria Python](https://github.com/frenck/python-adguardhome) di [@frenck](https://github.com/frenck).

- [Add-on Home Assistant](https://github.com/hassio-addons/addon-adguard-home) di [@frenck](https://github.com/frenck).

- [App LUCI per OpenWrt](https://github.com/kongfl888/luci-app-adguardhome) di [@kongfl888](https://github.com/kongfl888) (originariamente di [@rufengsuixing](https://github.com/rufengsuixing)).

- [AdGuardHome sync](https://github.com/bakito/adguardhome-sync) di [@bakito](https://github.com/bakito).

- [Monitoraggio e statistiche del traffico in tempo reale basati su terminale per la tua istanza di AdGuard Home](https://github.com/Lissy93/AdGuardian-Term) di [@Lissy93](https://github.com/Lissy93)

- [AdGuard Home sui router GLInet](https://forum.gl-inet.com/t/adguardhome-on-gl-routers/10664) di [Gl-Inet](https://gl-inet.com/).

- [App Cloudron](https://git.cloudron.io/cloudron/adguard-home-app) di [@gramakri](https://github.com/gramakri).

- [Asuswrt-Merlin-AdGuardHome-Installer](https://github.com/jumpsmm7/Asuswrt-Merlin-AdGuardHome-Installer) di [@jumpsmm7](https://github.com/jumpsmm7) alias [@SomeWhereOverTheRainBow](https://www.snbforums.com/members/somewhereovertherainbow.64179/).

- [Libreria Node.js](https://github.com/Andrea055/AdguardHomeAPI) di [@Andrea055](https://github.com/Andrea055/).

- [Estensione per browser](https://github.com/satheshshiva/Adguard-Home-Browser-Ext) di [@satheshshiva](https://github.com/satheshshiva/).

- [Template Zabbix per AdGuard Home](https://github.com/diasdmhub/AdGuard_Home_Zabbix_Template) di [@diasdmhub](https://github.com/diasdmhub).

- [Pacchetto Chocolatey](https://community.chocolatey.org/packages/adguardhome/) di [niks255](https://community.chocolatey.org/profiles/niks255).

- [Scheda su ZimaOS App Store](https://www.zimaspace.com/zimaos/app-store/app/org.icewhale.adguardhome) di [CasaOS Team](https://casaos.zimaspace.com/).

## <a href="#acknowledgments" id="acknowledgments" name="acknowledgments">Riconoscimenti</a>

Questo software non sarebbe stato possibile senza:

- [Go](https://golang.org/dl/) e le sue librerie:
 - [gcache](https://github.com/bluele/gcache)
 - [miekg's dns](https://github.com/miekg/dns)
 - [go-yaml](https://github.com/go-yaml/yaml)
 - [service](https://godoc.org/github.com/kardianos/service)
 - [dnsproxy](https://github.com/AdguardTeam/dnsproxy)
 - [urlfilter](https://github.com/AdguardTeam/urlfilter)
- [Node.js](https://nodejs.org/) e le sue librerie:
 - [React.js](https://reactjs.org)
 - [Tabler](https://github.com/tabler/tabler)
 - E molti altri pacchetti Node.js.
- [dati di whotracks.me](https://github.com/cliqz-oss/whotracks.me)

Potresti aver visto che [CoreDNS] è stato menzionato qui in precedenza, ma abbiamo smesso di usarlo in AdGuard Home.

Per l'elenco completo di tutti i pacchetti Node.js in uso, dai un'occhiata al file [`client/package.json`][src-packagejson].

[CoreDNS]:         https://coredns.io
[src-packagejson]: https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/client/package.json

## <a href="#privacy" id="privacy" name="privacy">Privacy</a>

La nostra idea principale è che sei tu a dover avere il controllo dei tuoi dati. È quindi naturale che AdGuard Home non raccolga statistiche di utilizzo e non utilizzi alcun servizio web a meno che tu non lo configuri per farlo. Vedi anche l'[informativa sulla privacy completa][privacy], dove è disponibile ogni singolo dato che *potrebbe in teoria essere inviato* da AdGuard Home.

[privacy]: https://adguard.com/en/privacy/home.html

AdGuardHome

Più Popolari

Centro di protezione della privacy per te e i tuoi dispositivi