Router ASUS con Asuswrt-Merlin e AdGuard Home: guida pratica dal GT-AX6000
Come passare un ASUS GT-AX6000 ad Asuswrt-Merlin, installare AdGuard Home sul router, aggiungere WireGuard e ricevere gli avvisi di caduta su Home Assistant.
Pubblicata il 11 min di lettura
Il router è il punto da cui passa tutto: Internet, DNS, Wi-Fi, domotica. Per questo ho voluto un firmware che mi lasciasse vedere e controllare cosa succede, e un filtro DNS che non dipendesse da un altro apparecchio da tenere acceso. Questa guida racconta come ho preparato e configurato un ASUS GT-AX6000 con Asuswrt-Merlin e AdGuard Home, e come tengo d'occhio uptime e cadute con Home Assistant.
Una premessa onesta: le versioni e i comandi sono quelli che ho usato io (Merlin 3006.102.9, AdGuard Home 0.107.x). Se leggi questa guida più avanti, controlla le versioni correnti.
Cos'è Asuswrt-Merlin e perché metterlo
Asuswrt-Merlin è una versione modificata del firmware ASUS, mantenuta da un singolo sviluppatore. L'obiettivo dichiarato nel suo stesso README è correggere bug e aggiungere piccole funzioni, senza stravolgere il firmware originale: l'interfaccia resta quella e la priorità va alla stabilità, poi alle prestazioni, poi alle funzioni. Non è un DD-WRT o un Tomato: è lo stock "con più possibilità".
Cosa mi interessava:
- Script personalizzati in
/jffs(partizione che sopravvive ai riavvii), per far partire i miei servizi all'accensione. - Add-on installabili sulla chiavetta USB tramite Entware.
- WireGuard integrato nell'interfaccia.
- DNS Director, per forzare certi dispositivi a usare il DNS del router.
Cosa si perde: su Merlin non c'è AiCloud (l'accesso remoto alle cartelle USB), e funzioni come Instant Guard non sono garantite. Gli aggiornamenti non si installano da soli: la pagina del firmware avvisa e il flash si rifà allo stesso modo.
| Firmware ASUS originale | Asuswrt-Merlin | |
|---|---|---|
| Interfaccia | ASUS | quasi identica |
Script di avvio in /jffs |
no | sì |
| Add-on (Entware, Skynet, ecc.) | no | sì |
| AiCloud | sì | no |
| Aggiornamenti | dal router | manuali, dalla stessa pagina |
Cosa serve prima del flash
- Una chiavetta USB da almeno 4 GB, anche vecchia. Serve per Entware e per AdGuard Home, che senza non si installa. Il contenuto viene cancellato: la chiavetta va formattata in ext4.
- Il file giusto: ho scaricato il firmware dal sito del progetto e ho confrontato lo SHA256 con il file di somme fornito. Se non coincide, non si flasha.
- Un backup dall'interfaccia web: Amministrazione, Ripristina/Salva/Carica impostazioni, Salva impostazioni. È il file
.CFG"ufficiale" e si può ricaricare anche sul firmware originale. - Un backup più completo via SSH: ho salvato le variabili nvram e l'intera cartella
/jffs. Attenzione: contengono password e chiavi, quindi vanno tenuti con permessi ristretti e mai condivisi. - Il momento giusto: scegli un'ora in cui 10 minuti senza rete non danno fastidio, e collega il computer al router via cavo.
Il flash, passo per passo
- Apri l'interfaccia web del router (di solito
http://192.168.1.1), poi Amministrazione, Aggiornamento firmware, Carica firmware manualmente, e scegli il file.pkgtbdi Merlin per il tuo modello. - Aspetta che finisca e che il router si riavvii: 3-5 minuti. Non spegnere niente.
- Il passaggio dal firmware originale a Merlin della stessa famiglia (nel mio caso la 3006.102) non richiede il reset di fabbrica. Se dopo compaiono stranezze, il reset si fa e si riconfigura a mano, senza ricaricare il
.CFG. - Attiva Amministrazione, Sistema, Enable JFFS custom scripts and configs: senza questa opzione gli script non partono.
Se qualcosa va storto: ASUS ha una modalità di ripristino (router spento, tieni premuto Reset, accendi, rilascia quando il LED lampeggia lento) e il programma Firmware Restoration. Per tornare al firmware originale basta caricarlo dalla stessa pagina.
Dopo il flash controllo sempre cinque cose: versione del firmware (nvram get buildno), Internet, Wi-Fi a 2,4 e 5 GHz, le riserve DHCP e l'accesso SSH con chiave.
Entware e add-on
Sulla chiavetta ho installato Entware con l'installatore ufficiale per l'architettura del router (aarch64-k3.10). Il router rifà il collegamento a /opt e avvia i servizi Entware tramite lo script post-mount, che parte quando la chiavetta viene montata.
Gli add-on che ho installato, uno alla volta e valutando ciascuno:
- connmon: ping ogni 5 minuti con latenza, jitter e perdita di pacchetti. È lo storico della linea, utile per dimostrare i problemi al provider.
- spdMerlin: test di velocità periodici. Ho ridotto la programmazione da ogni 30 minuti a 4 al giorno, per non consumare banda inutilmente.
- Skynet: firewall con liste di indirizzi malevoli, aggiornate ogni giorno. Ha creato da solo una swap da 2 GB sulla chiavetta, obbligatoria sui router con 1 GB di RAM. Se un servizio legittimo smette di funzionare, si aggiunge l'IP alla whitelist da riga di comando o dalla pagina web.
Una nota pratica: gli installatori di connmon e spdMerlin finiscono in un menu interattivo, quindi se li lanci via SSH senza terminale poi li devi chiudere a mano.
AdGuard Home sul router
AdGuard Home è un server DNS che blocca pubblicità, tracker e domini pericolosi per tutti i dispositivi della rete, senza installare nulla sui singoli apparecchi.
Perché sul router
Un Pi-hole o un AdGuard su un altro dispositivo funziona, ma se quel dispositivo si spegne o si blocca, nessuno in casa risolve più i nomi. Sul router il filtro sta dove passa già tutto il traffico e ha un solo punto di guasto, che c'è già. Il prezzo è che il router ha poca RAM e dipende da una chiavetta USB.
Come l'ho installato
Ho scelto l'installazione a mano, senza passare da amtm: AdGuard Home è un solo binario (build linux_arm64) che copio nella chiavetta ext4, insieme alla sua configurazione e ai dati (registro e statistiche). Prima di usarlo ho verificato lo SHA256 dal file checksums.txt della release.
La parte delicata è la porta 53:
- AdGuard Home ascolta sulla porta 53 dell'indirizzo del router.
- dnsmasq (il DNS e DHCP del firmware) viene spostato sulla porta 553 e resta in funzione per il DHCP e per i nomi locali.
- Il DHCP continua ad annunciare l'indirizzo del router come DNS, quindi ai dispositivi non cambia nulla.
Tre piccoli script in /jffs/scripts/ tengono tutto in piedi:
| Script | Cosa fa |
|---|---|
post-mount |
avvia AdGuard Home quando si monta la chiavetta |
services-start |
aggiunge un controllo ogni minuto (cru) |
dnsmasq.postconf |
sposta dnsmasq su 553 solo se AdGuard Home è utilizzabile |
Il ripiego automatico
È la parte di cui vado più fiero. Se la chiavetta manca, se AdGuard Home non parte o se lo disattivo di proposito, dnsmasq torna sulla porta 53 con la catena DNS precedente (DoT), senza filtro. Internet continua a funzionare, solo senza blocchi. Ho provato sia il ripiego sia il riavvio automatico prima di fidarmene. Si riattiva con un comando.
Cosa ho configurato
- Upstream cifrati (DNS su TLS) verso due resolver pubblici affidabili.
- Liste: AdGuard DNS filter e OISD small. Partire con poche liste evita falsi positivi.
- DNSSEC e cache ottimistica attivi.
- Nomi locali: il dominio
home.arpae i nomi senza dominio vengono girati a dnsmasq, cosìnomedispositivocontinua a funzionare in rete. - Un client dedicato per la TV: la smart TV usava un DNS fisso pubblico e scavalcava il filtro. Con una regola del DNS Director l'ho fatta passare da AdGuard Home e ho bloccato per quel solo client i domini pubblicitari e di telemetria del produttore. Attenzione: uno di quei domini serve anche agli aggiornamenti firmware del TV, quindi per aggiornarlo si toglie la regola.
Aggiornare AdGuard Home
Scarico binario e checksums.txt dalla release, confronto lo SHA256, carico il nuovo binario con un altro nome, controllo --version, lo scambio con il vecchio e termino il processo: lo riavvia il controllo ogni minuto.
WireGuard per l'accesso da fuori casa
Merlin ha un server WireGuard nell'interfaccia. Il mio schema:
- una rete dedicata ai tunnel, separata dalla LAN, con accesso alla LAN attivo;
- un client per lo smartphone, con tutto il traffico nel tunnel e come DNS quello del router, quindi anche fuori casa passo da AdGuard Home;
- un nome DDNS gratuito fornito da ASUS, per raggiungere il router senza IP fisso.
Un dettaglio che mi ha fatto perdere tempo: nel firmware le voci aips e caips sono gli IP consentiti rispettivamente lato server e lato client, ed è facile confonderle. La configurazione e il QR del client contengono chiavi private: vanno tenuti in cartelle con permessi stretti.
Una rete ordinata: IP fissi e nomi
Con DNS e DHCP sotto controllo ho sistemato anche gli indirizzi, a fasce:
| Fascia | Uso |
|---|---|
| .1 | router |
| .2-.9 | server e servizi |
| .10-.19 | apparati di rete |
| .20-.39 | computer |
| .40-.59 | telefoni e tablet |
| .60-.79 | TV e media |
| .80-.99 | audio |
| .100-.149 | domotica |
| .150-.199 | stampanti e altro |
| .200-.254 | DHCP dinamico |
Il dominio locale è home.arpa (quello riservato allo scopo). La sorgente dei nomi è l'elenco DHCP del router: il firmware lo scrive in /etc/hosts, quindi i nomi funzionano anche a dispositivo spento. Un piccolo script confronta lease e tabella ARP con il mio elenco di partenza, per accorgermi di dispositivi fuori posto.
Ho anche separato una rete Wi-Fi solo per domotica e assistenti vocali (WPA2), distinta da quella di telefoni e computer. Così persone e media restano su una rete, domotica ed Echo su un'altra.
Monitorare uptime e cadute con Home Assistant
Un router che cade di notte non lo vedi. Per questo ho scritto un piccolo script (Python, solo libreria standard) che gira sul Mac mini e controlla il router ogni minuto:
- legge lo stato del router via SSH, con una chiave dedicata autorizzata con un comando forzato: può solo eseguire uno script di sola lettura, niente shell né port forwarding;
- fa ping verso due DNS pubblici e una query DNS al router, per distinguere "Internet è giù" da "il DNS del router è giù";
- manda lo stato a un webhook di Home Assistant, che aggiorna i sensori e una dashboard con grafici delle 24 ore e disponibilità degli ultimi 7 giorni.
Gli avvisi li decide lo script e li inoltra Home Assistant alla notifica push. Quelli che servono davvero:
| Avviso | Quando |
|---|---|
| Internet tornato | la linea è mancata per almeno 2 controlli; arriva al ritorno, con la durata |
| Il router si è riavviato | l'ora di accensione è cambiata |
| DNS del router fuori uso | Internet va ma il DNS del router no |
| AdGuard Home fermo | non attivo da 5 minuti, salvo disattivazione voluta |
| Accesso SSH o al pannello | login o tentativo fallito |
| Configurazione cambiata | una delle impostazioni di sicurezza è diversa dall'ultima fotografia (controllo ogni ora) |
| Router molto caldo | CPU a 90 °C o più per 5 minuti |
Due scelte che consiglio:
- L'avviso di caduta parte al ritorno, non durante: con la linea giù la push non può arrivare. Se Home Assistant è giù, gli avvisi restano in coda.
- Un watchdog del monitor: se lo script si ferma, un'automazione di Home Assistant avvisa dopo circa 12 minuti. Sennò un monitor morto sembra un router sano.
Lo script scrive anche un file CSV delle cadute (inizio, fine, minuti), che è proprio quello che serve quando devi dimostrare al provider che la linea cade.
Errori e lezioni imparate
- Il firmware originale non ha script di avvio. Il mio script di raccolta stava in
/jffs, che sopravvive ai riavvii ma non al reset di fabbrica: dopo un reset va ricopiato, insieme alla chiave. - Il processo lanciato da SSH muore con la sessione. Ho avviato AdGuard Home a mano da SSH e si è fermato alla chiusura del terminale. Si fa riavviare dal controllo ogni minuto, non a mano.
- I dispositivi con DNS fisso scavalcano il filtro. Quelli impostati a mano su un DNS pubblico non passano da AdGuard Home: vanno rimessi in automatico o forzati con DNS Director.
- Il router non passa da AdGuard Home. Risolve con i DNS della WAN: è normale, ma sappilo quando provi.
- Le liste di sicurezza possono bloccare cose utili, come l'aggiornamento firmware della TV. Quando qualcosa "non funziona più", guarda per primo il registro di AdGuard Home.
- Gli installatori interattivi di alcuni add-on vanno chiusi a mano se li lanci senza terminale.
- Le password Wi-Fi restano in chiaro in alcuni elenchi del firmware o dei modem: mascherale sempre prima di condividere un output.
Domande frequenti
Il flash fa decadere la garanzia?
Non l'ho verificato per questo modello e non voglio affermare cose che non so. Il ritorno al firmware originale è comunque possibile caricando quello ufficiale dalla stessa pagina.
Serve per forza la chiavetta USB?
Per Entware e per AdGuard Home nel modo in cui l'ho fatto io, sì. Il router da solo ha una memoria interna ridotta, adatta agli script e alla configurazione ma non ai dati di un filtro DNS.
Devo fare il reset di fabbrica dopo il flash?
Nel mio caso, passando dal firmware originale a Merlin della stessa famiglia, la procedura che ho seguito diceva di no. Si fa solo se compaiono stranezze, riconfigurando a mano senza ricaricare il .CFG di backup.
Cosa succede se AdGuard Home si ferma?
Nel mio schema dnsmasq torna sulla porta 53 e Internet continua a funzionare, solo senza filtro. Il monitor mi manda un avviso dopo 5 minuti.
AdGuard Home o Pi-hole?
Fanno lo stesso mestiere. Il vantaggio di averlo sul router è non dipendere da un secondo dispositivo; lo svantaggio è che dipende dalle risorse del router e dalla chiavetta. Io non ho fatto un confronto diretto con Pi-hole, quindi non ti do numeri.
Posso fare il monitoraggio senza Home Assistant?
Lo script non dipende da Home Assistant in sé: manda dati e avvisi a due webhook. Basta un servizio che li riceva e inoltri una notifica.
I prezzi cambiano spesso: controlla sempre quello attuale.