1. Scopo
Lampeggiare OpenWrt significa sostituire il firmware del fornitore originale di un router con il sistema operativo OpenWrt. OpenWrt è un sistema operativo basato su Linux per dispositivi di rete integrati. Fornisce un filesystem scrivibile, gestione dei pacchetti, controllo firewall, supporto VPN, VLAN, modellamento del traffico e amministrazione avanzata del router oltre ciò che consente la maggior parte dei firmware di serie. Il progetto OpenWrt lo descrive come un sistema operativo Linux per dispositivi integrati che sostituisce il firmware statico del fornitore con un file system scrivibile e una gestione dei pacchetti.
Questo documento spiega come prepararsi, scegliere l'immagine firmware corretta, eseguire il flashing di OpenWrt in modo sicuro, eseguire la prima configurazione di avvio e risolvere i problemi comuni.
2. Sicurezza e autorizzazione
Flash OpenWrt solo su un router di tua proprietà o che sei esplicitamente autorizzato a modificare. Non eseguire il flashing dei router di proprietà di un ISP, datore di lavoro, scuola, hotel, proprietario o fornitore di servizi gestiti a meno che tu non abbia il permesso.
Il firmware lampeggiante può danneggiare permanentemente un router se:
- Viene utilizzata l'immagine sbagliata.
- La revisione dell'hardware non corrisponde.
- L'alimentazione viene interrotta durante il lampeggiamento.
- Una procedura di lampeggio specifica del dispositivo viene ignorata.
- Un meccanismo di protezione del firmware del fornitore viene ignorato in modo errato.
- Il router ha troppo poca memoria flash o RAM per il moderno OpenWrt.
OpenWrt distingue tra la prima installazione dal firmware del fornitore e l'aggiornamento del sistema da un'installazione OpenWrt esistente. Un aggiornamento di sistema sostituisce l'attuale installazione di OpenWrt e non equivale a una prima installazione di fabbrica.
3. Concetti chiave
3.1 Immagine di fabbrica
Un'immagine di fabbrica viene normalmente utilizzata quando il router esegue ancora il firmware originale del produttore.
Esempi tipici di nomi di file:
openwrt-...-factory.bin
openwrt-...-factory.img
openwrt-...-factory.trx
Usalo per:
- Firmware del fornitore → OpenWrt
La documentazione di installazione di fabbrica di OpenWrt descrive il primo processo come il download del firmware corretto, la verifica del file scaricato e l'aggiornamento del firmware.
3.2 Immagine di aggiornamento del sistema
Un'immagine sysupgrade viene utilizzata quando OpenWrt è già installato e si sta aggiornando o reinstallando OpenWrt.
Nome file tipico:
openwrt-...-sysupgrade.bin
Usalo per:
- OpenWrt → più recente OpenWrt
- OpenWrt → reinstallazione della stessa versione
- OpenWrt → ripristino pulito con la nuova immagine OpenWrt
La documentazione di sysupgrade di OpenWrt spiega che sysupgrade sostituisce l'intera installazione corrente di OpenWrt, incluse le partizioni del kernel e del filesystem.
3.3 Immagine istantanea
Uno snapshot è una build di sviluppo. Potrebbe supportare l'hardware più recente, ma è meno prevedibile del firmware stabile.
Utilizzare firmware stabile a meno che:
- Il tuo router è supportato solo dallo snapshot.
- Capisci il rischio.
- Sei a tuo agio nel ripristinare il dispositivo.
- Sai come installare manualmente i pacchetti mancanti.
Il selettore firmware OpenWrt consente agli utenti di scegliere una build stabile o una build con snapshot notturno.
3.4 Immagine di ripristino
Alcuni router richiedono un'immagine di ripristino speciale o un metodo di ripristino del bootloader. Ciò può comportare:
- TFTP
- Modalità di salvataggio del venditore
- Consolle seriale
- Server web di ripristino
- Avvio di Initramfs
- Ripristino USB
I metodi di ripristino sono specifici del dispositivo. Non dare per scontato che il processo di ripristino di un router si applichi a un altro.
4. Elenco di controllo pre-flash
Prima di eseguire il flashing di OpenWrt, raccogliere le seguenti informazioni.
4.1 Identificazione del router
Registra:
Brand:
Model:
Hardware revision:
Current firmware version:
Region variant:
Serial number:
MAC address:
La revisione dell'hardware è fondamentale. Ad esempio, un router contrassegnato con v1, v2 e v3 potrebbe richiedere immagini firmware diverse.
4.2 Backup delle impostazioni di rete
Salva o fai uno screenshot:
- Tipo di connessione WAN
- Nome utente/password PPPoE, se utilizzati
- Impostazioni IP statiche, se utilizzate
- Impostazioni VLAN o IPTV
- Sottorete LAN
- Intervallo DHCP
- SSID Wi-Fi
- Password Wi-Fi
- Regole di port forwarding
- Impostazioni DNS
- Impostazioni VPN
- Impostazione clone MAC, se utilizzata
Dopo il lampeggio, OpenWrt non riconoscerà automaticamente la configurazione del firmware del fornitore.
4.3 Preparazione al recupero
Prima di eseguire il flashing, trova il metodo di ripristino per il tuo dispositivo esatto.
Salva:
- File del firmware del fornitore originale
- OpenWrt pagina del dispositivo
- Istruzioni per il ripristino TFTP, se disponibili
- Istruzioni di sicurezza
- Impostazioni IP statiche necessarie per il ripristino
- Sequenza di pulsanti per la modalità di ripristino
La documentazione di ripristino di OpenWrt rileva che alcuni fornitori forniscono funzioni di ripristino integrate nella partizione di avvio della ROM flash che rimangono disponibili anche dopo un aggiornamento del firmware OpenWrt.
4.4 Configurazione fisica
Utilizza questa configurazione fisica:
- Computer collegato tramite Ethernet
- Computer collegato alla porta LAN del router
- Router collegato a un'alimentazione stabile
- Wi-Fi disabilitato sul computer, se necessario
- Nessun dispositivo non necessario collegato
- Nessun firmware flashing tramite Wi-Fi
Non eseguire il flashing del firmware durante un'interruzione di corrente, un temporale, un uso instabile del generatore o quando il router potrebbe essere scollegato accidentalmente.
5. Trovare il firmware OpenWrt corretto
5.1 Utilizzare il selettore firmware
Utilizza il selettore firmware OpenWrt ufficiale per cercare il modello esatto del router e la revisione hardware. Il selettore firmware è progettato per scaricare il firmware OpenWrt per un dispositivo selezionato e scegliere una build stabile o istantanea.
Cerca per:
- Marca del router
- Modello del router
- Revisione dell'hardware
Termini di ricerca di esempio:
TP-Link Archer C7 v5
GL.iNet GL-AR750S
Linksys EA8300
Netgear R7800
5.2 Utilizzare la Tabella dell'Hardware
La documentazione dei download di OpenWrt consiglia di utilizzare la tabella dell'hardware o il selettore del firmware per individuare il firmware ufficiale per un dispositivo specifico.
Controlla:
- Versione supportata
- Metodo di installazione
- Problemi noti
- Immagine richiesta
- Note di recupero
- Dimensione del flash
- Dimensione della RAM
- Supporto Wi-Fi
- Avvertenze speciali
5.3 Scegli firmware stabile
Secondo la documentazione della versione corrente di OpenWrt, la serie stabile OpenWrt è la 25.12, con la 25.12.4 elencata come versione stabile corrente.
Utilizza stabile a meno che la pagina del dispositivo non indichi che hai bisogno di uno snapshot.
6. Verifica del file firmware
Prima di eseguire il flashing, verifica che il file scaricato non sia danneggiato.
Linux
sha256sum openwrt-*.bin
macOS
shasum -a 256 openwrt-*.bin
Windows PowerShell
Get-FileHash .\openwrt-*.bin -Algorithm SHA256
Confronta il risultato con il checksum fornito dalla directory di download di OpenWrt o dal Selettore firmware. Se il checksum non corrisponde, non eseguire il flashing del file.
7. Metodo di flashing A: prima installazione dal firmware del fornitore
Utilizzare questo metodo quando sul router è ancora in esecuzione il firmware originale del produttore.
Passaggio 1: scarica l'immagine di fabbrica
Utilizza un file etichettato in modo simile a:
factory.bin
factory.img
factory.trx
factory.chk
Non utilizzare un'immagine sysupgrade per il primo flashing a meno che la pagina OpenWrt specifica del dispositivo non lo indichi esplicitamente.
Passaggio 2: connessione tramite Ethernet
Connetti:
- Porta Ethernet del computer → Porta LAN del router
Evitare:
- Wi-Fi lampeggiante
- Porta WAN lampeggiante a meno che le istruzioni del dispositivo non lo dicano
- Adattatori Ethernet USB con driver instabili
Passaggio 3: accedere al firmware del fornitore
Gli indirizzi comuni dei router dei fornitori includono:
http://192.168.0.1
http://192.168.1.1
http://192.168.8.1
http://10.0.0.1
Accedi utilizzando il nome utente e la password dell'amministratore del firmware del fornitore.
Passaggio 4: aprire la pagina di aggiornamento del firmware
Nomi di menu comuni:
- Amministrazione → Aggiornamento firmware
- Strumenti di sistema → Aggiornamento firmware
- Avanzate → Aggiornamento firmware
- Manutenzione → Firmware
- Aggiornamento del router
- Caricamento manuale del firmware
La documentazione generica sul flashing di OpenWrt descrive l'utilizzo dell'interfaccia web del firmware OEM e la relativa opzione di aggiornamento del firmware per installare l'immagine di fabbrica corretta di OpenWrt.
Passaggio 5: carica l'immagine di fabbrica OpenWrt
Prima di premere l'aggiornamento, verificare:
- Modello di router corretto
- Revisione hardware corretta
- Regione corretta
- Tipo di file corretto
- Checksum verificato
- Versione stabile selezionata
- Pagina del dispositivo controllata
Quindi carica il firmware.
Passaggio 6: attendere il riavvio
Non:
- Scollegare l'alimentazione
- Premere Ripristina
- Aggiorna ripetutamente
- Chiudere il coperchio del portatile
- Scollegare Ethernet
- Interrompere il processo
Un flash normale potrebbe richiedere diversi minuti a seconda del router.
Passaggio 7: accedi a OpenWrt
Dopo il riavvio, imposta il computer su DHCP e apri:
http://192.168.1.1
La documentazione di accesso OpenWrt afferma che il nome utente amministrativo predefinito è root e il campo password è inizialmente vuoto finché non si imposta una password.
8. Metodo lampeggiante B: aggiornamento dell'esistente OpenWrt utilizzando LuCI
Utilizzare questo metodo quando OpenWrt è già installato e LuCI è disponibile.
Passaggio 1: scarica l'immagine Sysupgrade
Scarica l'immagine di aggiornamento del sistema corretta per il tuo dispositivo esatto.
Esempio:
openwrt-...-sysupgrade.bin
Passaggio 2: accedi a LuCI
Aperto:
http://192.168.1.1
Go to:
System → Backup / Flash Firmware
La documentazione di OpenWrt sysupgrade elenca la pagina Backup/Flash firmware di LuCI come metodo di aggiornamento del firmware standard.
Passaggio 3: crea un backup
Scarica un backup della configurazione prima dell'aggiornamento.
Salvalo in un posto sicuro:
- Calcolatore
- Unità esterna
- Allegato al gestore password
- Cartella della documentazione amministrativa
Passaggio 4: carica l'immagine Sysupgrade
Seleziona:
- Flash nuova immagine firmware
Carica il file di aggiornamento del sistema.
Utilizza le impostazioni di Keep solo se:
- Il percorso di aggiornamento è supportato
- La pagina del dispositivo non mette in guardia contro questo
- Non stai tentando di eseguire un ripristino pulito del router
- La tua configurazione è nota
Utilizza un ripristino pulito se la configurazione è danneggiata o se stai attraversando un percorso di aggiornamento rischioso.
Passaggio 5: eseguire il flashing e riavviare
Conferma l'immagine del firmware e avvia l'aggiornamento.
Non interrompere l'alimentazione.
Dopo il riavvio, torna a:
http://192.168.1.1
9. Metodo lampeggiante C: aggiornamento dell'esistente OpenWrt utilizzando SSH
Utilizza questo metodo se LuCI non è disponibile o preferisci il flashing della riga di comando.
Passaggio 1: copiare il firmware sul router
Dal tuo computer:
scp openwrt-*-sysupgrade.bin root@192.168.1.1:/tmp/
Passaggio 2: SSH nel router
ssh root@192.168.1.1
OpenWrt fornisce l'amministrazione SSH per la gestione del router dalla riga di comando.
Passaggio 3: crea il backup
sysupgrade -b /tmp/openwrt-backup.tar.gz
Copia il backup sul tuo computer:
scp root@192.168.1.1:/tmp/openwrt-backup.tar.gz .
Passaggio 4: eseguire il flash mantenendo le impostazioni
sysupgrade /tmp/openwrt-*-sysupgrade.bin
Passaggio 5: flash e ripristina le impostazioni
Usa questo quando vuoi un'installazione pulita:
sysupgrade -n /tmp/openwrt-*-sysupgrade.bin
L'opzione -n evita di ripristinare le impostazioni precedenti.
10. Configurazione del primo avvio
Dopo il flashing, connettiti a:
http://192.168.1.1
Accesso:
Username: root
Password: empty on first login
Le domande frequenti iniziali di OpenWrt confermano che non è stata impostata alcuna password iniziale per root.
Imposta immediatamente una password.
10.1 Imposta la password di root
Nel LuCI:
- Sistema → Amministrazione → Password del router
Utilizzando SSH:
passwd
Utilizza una password complessa.
10.2 Configurare la WAN
Tipi WAN comuni:
- Cliente DHCP
- IP statico
- PPPoE
- WAN con tag VLAN
- Modem LTE/5G
- Collegamento USB
Se il tuo ISP utilizza PPPoE, inserisci il nome utente e la password della configurazione precedente del router.
10.3 Configurare la LAN
La LAN OpenWrt predefinita è solitamente:
192.168.1.1/24
Cambialo se anche il tuo modem upstream o la rete esistente utilizza 192.168.1.0/24.
Esempio LAN alternativa:
192.168.10.1
10.4 Configurare Wi-Fi
OpenWrt disabilita comunemente il Wi-Fi per impostazione predefinita sui dispositivi con porte Ethernet per motivi di sicurezza.
Imposta:
- Codice paese
- SSID
- Crittografia: WPA2/WPA3 se supportata
- Passphrase forte
Non lasciare il Wi-Fi aperto.
10.5 Conferma delle impostazioni predefinite del firewall
OpenWrt normalmente consente il traffico da LAN a WAN e blocca il traffico da WAN a LAN non richiesto per impostazione predefinita.
Non esporre:
- LuCI
- SSH
- Porte di amministrazione del router
a Internet a meno che non si utilizzi un progetto di gestione sicuro basato su VPN.
11. Rafforzamento post-installazione
Lista di controllo consigliata per l'indurimento:
- Imposta la password di root
- Disabilita l'accesso SSH con password se si utilizzano chiavi SSH
- Non esporre LuCI alla WAN
- Non esporre SSH alla WAN
- Utilizza WPA2/WPA3
- Disabilita WPS se presente
- Mantieni aggiornato il firmware
- Rimuovere i pacchetti non utilizzati
- Crea una rete ospite per i visitatori
- Crea una rete IoT separata, se necessario
- Eseguire il backup della configurazione dopo l'installazione
- Metodo di recupero dei documenti
12. Problemi comuni e soluzioni
12.1 Impossibile raggiungere il router dopo il flash
Prova:
- Imposta il computer su DHCP
- Prova http://192.168.1.1
- Prova un'altra porta LAN
- Aspetta ancora qualche minuto
- Spegnere e riaccendere una volta dopo l'attesa
- Usa Ethernet, non Wi-Fi
Se il DHCP fallisce, imposta un IP statico:
Computer IP: 192.168.1.2
Subnet mask: 255.255.255.0
Gateway: 192.168.1.1
DNS: 192.168.1.1
Quindi apri:
http://192.168.1.1
12.2 Il firmware del fornitore rifiuta il file OpenWrt
Probabili cause:
- Tipo di immagine sbagliato
- Revisione hardware errata
- Regione sbagliata
- File firmware troppo grande
- Il fornitore blocca il firmware di terze parti
- È richiesto un metodo di installazione speciale
- Limitazione del firmware firmato
Non forzare il file. Ritorna alla pagina OpenWrt specifica del dispositivo.
12.3 LuCI Mancante dopo il flash
Alcune immagini non includono LuCI, in particolare istantanee o build personalizzate.
Per OpenWrt 25.12 e versioni successive:
apk update
apk add luci
Per OpenWrt 24.10 e versioni precedenti:
opkg update
opkg install luci
La documentazione del pacchetto OpenWrt afferma che OpenWrt 25.12 e versioni successive utilizzano apk, mentre 24.10 e versioni precedenti utilizzano opkg.
12.4 Impostazioni errate ti hanno bloccato
Utilizzare la modalità failsafe. La documentazione failsafe di OpenWrt spiega che la modalità failsafe e il ripristino delle impostazioni di fabbrica vengono utilizzati quando i problemi di configurazione rendono il dispositivo inaccessibile.
Sequenza comune di ripristino failsafe:
mount_root
firstboot
reboot -f
Ciò cancella la configurazione e riporta OpenWrt al suo stato predefinito.
12.5 Aggiornamento firmware non riuscito
Se non è possibile raggiungere LuCI o SSH, provare:
- Modalità di sicurezza
- Ripristino delle impostazioni di fabbrica
- Modalità di ripristino del fornitore
- Ripristino TFTP
- Consolle seriale
OpenWrt consiglia di provare prima la modalità failsafe e il ripristino delle impostazioni di fabbrica quando l'interfaccia non è raggiungibile dopo problemi di configurazione o aggiornamento.
13. Panoramica sul ripristino TFTP
Alcuni router possono ripristinare il firmware tramite TFTP.
Un tipico processo di ripristino TFTP prevede:
- Imposta il computer su un IP statico specifico
- Rinominare il file del firmware con il nome richiesto
- Avvia il server o il client TFTP
- Tieni premuto il pulsante reset/WPS
- Accendi il router
- Attendi che il bootloader richieda il firmware
- Trasferisci firmware
- Attendi il flashing automatico e riavvia
La documentazione di ripristino TFTP di OpenWrt descrive l'utilizzo di Ethernet, l'alimentazione del router e l'utilizzo di una sequenza di pulsanti specifica del dispositivo per avviare il ripristino del firmware.
Importante: i dettagli TFTP variano in base al router. Controlla sempre:
- IP di ripristino del router
- IP del computer
- Nome file obbligatorio
- Porta Ethernet richiesta
- Temporizzazione dei pulsanti
- Indica se il router funge da client o server TFTP
14. Quando non eseguire il flashing OpenWrt
Non lampeggiare OpenWrt se:
- Il router non è tuo
- Il modello non è supportato
- La revisione dell'hardware non è chiara
- Non riesci a trovare le istruzioni per il ripristino
- Il router è il tuo unico accesso a Internet e non hai un piano di backup
- Il dispositivo ha memoria flash/RAM insufficiente per pacchetti e overlay OpenWrt
- Sono necessarie funzionalità riservate al fornitore che OpenWrt non supporta
- Non sei pronto per reimpostare o ripristinare il dispositivo
15. Flusso di lavoro lampeggiante consigliato
Utilizza questo flusso di lavoro esatto per la maggior parte dei router:
- Conferma di essere il proprietario del router.
- Identificare il modello esatto e la revisione dell'hardware.
- Controlla il supporto del dispositivo OpenWrt.
- Leggi la pagina di installazione specifica del dispositivo.
- Scarica l'immagine di fabbrica stabile per la prima installazione.
- Scarica l'immagine sysupgrade stabile solo se OpenWrt è già installato.
- Verifica il checksum.
- Salva le impostazioni correnti del router.
- Scarica il firmware del fornitore per il ripristino.
- Connetti tramite Ethernet.
- Flash attraverso il metodo corretto.
- Attendi il riavvio senza interrompere l'alimentazione.
- Apri http://192.168.1.1.
- Accedi come root con password vuota.
- Imposta immediatamente la password di root.
- Configura WAN, LAN, Wi-Fi e firewall.
- Eseguire il backup della configurazione OpenWrt completata.
- Passaggi di recupero dei documenti.
16. Conclusione
Il flashing OpenWrt è il processo di sostituzione del firmware originale di un router con un sistema operativo router flessibile basato su Linux. Le parti più importanti non sono comandi complicati; sono preparazione e accuratezza.
L'installazione più sicura dipende da:
- Modello dispositivo corretto
- Revisione hardware corretta
- Tipo di firmware corretto
- Potenza stabile
- Connessione Ethernet
- Checksum verificato
- Metodo di recupero noto
Utilizza un'immagine di fabbrica durante l'installazione dal firmware del fornitore. Utilizza un'immagine sysupgrade quando aggiorni un'installazione OpenWrt esistente. Dopo il flashing, imposta immediatamente la password di root, configura WAN e Wi-Fi, evita di esporre servizi di gestione a Internet e salva un backup funzionante.