CLI RouterOS: navigazione, print, find e Safe Mode
Padroneggia la riga di comando di RouterOS v7: struttura gerarchica dei menu, comandi essenziali, find, print, comment e Safe Mode per modifiche sicure.
Struttura gerarchica
La CLI di RouterOS è organizzata in un albero di menu che ricalca un file system. Ogni voce corrisponde a un percorso: /ip/firewall/filter, /interface/bridge, /system/user. Puoi inserire il percorso completo (con lo slash iniziale, esegui e torni dove eri) oppure spostarti dentro un menu e restare lì. Il prompt mostra sempre la posizione corrente, per esempio [admin@AP-Zona1] /ip/firewall/filter>.
# Vai alla radice / # Entra in un sotto-menu (e ci resti) /ip/address # Torna su di un livello / di due livelli .. ../.. # Esegui un comando da un altro menu SENZA cambiare posizione # (lo slash iniziale = "vai, esegui, torna qui") /ip/route/print
Comandi fondamentali: print, add, set, remove
# Elenca tutti gli indirizzi IP (output tabulare) /ip/address/print # Output dettagliato property=value (utile per copiare config) /ip/address/print detail # Conta gli elementi senza stamparli /ip/address/print count-only # Stampa solo alcune colonne /ip/address/print where interface=ether1 # Aggiunge un indirizzo IP con commento (documenta SEMPRE) /ip/address/add address=10.10.10.1/24 interface=ether2 comment="LAN gestione" # Modifica per numero riga o per find /ip/address/set 0 comment="LAN primaria" /ip/address/set [find interface=ether2] comment="LAN ether2" # Rimuove per numero /ip/address/remove 0 # Disabilita/abilita invece di rimuovere (reversibile) /ip/firewall/filter/disable [find comment="test"] /ip/firewall/filter/enable [find comment="test"]
print sono temporanei: cambiano dopo add/remove e non sono identificatori stabili. Per gli script usa sempre [find ...] o gli internal-id *N (visibili con print where ... e usati dalla REST API), MAI il numero di riga: uno script che fa set 3 ... può colpire la regola sbagliata.Find e where: filtrare e selezionare elementi
# Trova tutti gli indirizzi disabilitati /ip/address/print where disabled=yes # Seleziona e modifica con find inline /ip/address/set [find interface=ether1] comment="WAN" # Conta le regole firewall con action=drop /ip/firewall/filter/print count-only where action=drop # Trova interfacce offline (link giù) /interface/print where running=no # Operatori: ! (negazione), && (and), || (or) /ip/firewall/connection/print where protocol=tcp && dst-port=80 # find restituisce una lista: la puoi passare a remove/disable in blocco /ip/firewall/filter/remove [find comment~"OLD"]
L'operatore ~ fa il match con espressione regolare sul valore (comment~"OLD" = commento che contiene OLD). È utile per pulizie di massa, ma proprio per questo va usato con cautela: prima fai un print where ... per vedere COSA verrà colpito, poi sostituisci print con remove.
Safe Mode: modifiche reversibili
Safe Mode (attivabile con Ctrl+X in SSH/console, o dal pulsante in WinBox) è una delle funzioni più importanti per lavorare in sicurezza da remoto. Mentre è attivo, compare <SAFE> nel prompt. Se la sessione si interrompe — cade la VPN, sbagli una regola e ti tagli fuori, timeout — RouterOS annulla automaticamente tutte le modifiche fatte in Safe Mode e ripristina lo stato precedente. È la rete di protezione classica per chi lavora sul firewall o sull'indirizzamento di un apparato lontano.
# Attiva Safe Mode (sessione SSH/console): premi Ctrl+X # Il prompt diventa: [admin@AP-Zona1] /ip/firewall/filter <SAFE> # Fai le modifiche rischiose, es. una nuova regola di input /ip/firewall/filter/add chain=input action=drop in-interface=ether1 \ comment="TEST drop WAN" # Se TUTTO funziona e sei ancora connesso: # premi Ctrl+X di nuovo -> conferma le modifiche ed esce da Safe Mode # Se ti sei tagliato fuori: # la sessione cade -> RouterOS annulla tutto da solo, riprovi
Autocompletamento e abbreviazioni
- Tab: completa il comando o il parametro corrente
- Tab doppio: mostra tutte le opzioni disponibili
- ?: help contestuale sul comando/parametro corrente
- Frecce su/giù: cronologia comandi della sessione
- Ctrl+C: interrompe un comando in esecuzione (es. ping continuo)
- Abbreviazioni: ogni parola si può accorciare se resta univoca —
/ip ad pr≈/ip/address/print,pi 8.8.8.8 c 4≈ping 8.8.8.8 count=4
comment per documentare regole firewall, indirizzi, interfacce e queue. Un commento come WAN ISP principale o Cliente Mario Rossi - PtMP settore A fa risparmiare ore di debug e rende leggibile l'export .rsc. I commenti sono visibili in WinBox, WebFig e negli export — sono parte integrante di una configurazione professionale.Continua con
Configura senza fatica con l'AI
In WispOS l'agente AI genera la configurazione RouterOS dalle tue parole e un tutor ti guida passo passo.
Prova WispOS