Risolvi Errori di Adozione MikroTik

Sommario Questa guida elenca i 5 errori più comuni che impediscono l’adozione di dispositivi MikroTik in MKController e spiega come diagnosticare e risolvere ciascuno. Problemi trattati: versione RouterOS obsoleta, Device Mode che blocca fetch, pacchetto PPP mancante, nessun accesso internet o DNS sul dispositivo, spazio disco insufficiente. Ogni problema include i comandi RouterOS esatti per la diagnosi e la risoluzione.

Gli errori di adozione MikroTik in MKController si riducono a un piccolo set di cause prevedibili. La tabella seguente mappa ogni errore alla sua causa e alla sezione dove trovare la soluzione.

L’adozione non si completa. Il processo si blocca per diversi minuti nella fase “creating VPN”.

Il dispositivo potrebbe usare una versione RouterOS incompatibile con le funzioni richieste da MKController. Controlla prima la lista delle versioni RouterOS supportate.

1. Controlla la versione installata e quella disponibile nel canale di aggiornamento configurato:

   /system package update check-for-updates

   L’output sarà simile a:

   installed-version: 6.49.10
   latest-version: 6.49.12
   status: New version is available

2. Se è disponibile un aggiornamento nella lista delle versioni supportate, installalo:

   /system package update install

3. Riavvia il dispositivo:

   /system reboot

4. Dopo il riavvio, riprova il processo di adozione.

L’esecuzione dello script di adozione tramite Winbox restituisce:

executing script script1 from winbox failed, please check it manually
failure: not allowed by device-mode (/tool/fetch line 1)

L’esecuzione tramite terminale restituisce:

failure: not allowed by device-mode

Il Device Mode di MikroTik sta bloccando le funzioni fetch, hotspot e scheduler. Questo interessa alcuni modelli con RouterOS 7.17 e successivi.

1. Controlla la configurazione attuale del Device Mode. Se fetch mostra no, è bloccato:

   /system device-mode print

   

2. Abilita Device Mode Advanced:

   /system device-mode update mode=advanced

3. Esegui un hard reboot — scollega fisicamente il MikroTik dalla corrente per un momento. Un semplice riavvio software non è sufficiente; la modifica del Device Mode si applica solo dopo un ciclo di spegnimento completo.

4. Dopo l’hard reboot, verifica la modifica:

   /system device-mode print

   Conferma che fetch ora mostri yes, poi riprova l’adozione.

L’esecuzione dello script di adozione restituisce:

expected end of command (line 6 column 33)

Il pacchetto PPP non è installato sul dispositivo. Lo script di adozione di MKController richiede PPP per creare il tunnel VPN.

1. Vai sulla pagina di download dell’archivio MikroTik e scarica il pacchetto Extra Packages .zip per la versione RouterOS e l’architettura del dispositivo (mipsbe, arm, smips, ecc.) che corrisponde al tuo dispositivo.

2. Estrai il .zip e individua ppp.npk.

3. Carica ppp.npk sul router:

   • In Winbox → scheda Files, oppure
   • Tramite FTP o SCP

4. Riavvia il router:

   /system reboot

5. Dopo il riavvio, il menu PPP dovrebbe apparire in WebFig e Winbox. Riprova lo script di adozione.

• failure: could not resolve host name
• status: failed / reason: timeout

Il dispositivo MikroTik non ha accesso a internet o non riesce a risolvere il DNS. Entrambi sono necessari perché il dispositivo raggiunga i server MKController.

1. Testa la connettività internet di base:

   ping 8.8.8.8

   Se non c’è risposta, verifica:

   • Route predefinita mancante: /ip route print
   • Regole NAT o firewall che bloccano il traffico in uscita
   • Connessione fisica al provider upstream

2. Una volta che ping 8.8.8.8 ha successo, testa la risoluzione DNS:

   

   ping app.mkcontroller.com

   Se fallisce, imposta server DNS affidabili:

   

   /ip dns set servers=8.8.8.8,1.1.1.1

3. Riavvia:

   /system reboot

4. Riprova lo script di adozione.

Errori durante l’esecuzione di fetch o l’installazione dei pacchetti, indicanti un problema di archiviazione.

MikroTik richiede almeno 2 MB di spazio disco libero per eseguire lo script di adozione e scaricare il pacchetto VPN.

1. Controlla lo spazio disco disponibile:

   /system resource print

2. Se free-hdd-space è inferiore a 2 MB, elenca i file attualmente memorizzati sul dispositivo:

   /file print

3. Rimuovi file non necessari o vecchi file di backup:

   /file remove <id>

4. Riprova il processo di adozione dopo aver liberato spazio sufficiente.

Seguire questi cinque passaggi risolve la maggior parte dei fallimenti di adozione MikroTik in MKController.

Se il problema persiste dopo aver seguito tutte le sezioni, contatta il nostro team di supporto su WhatsApp. Possiamo esaminare i log di adozione, ispezionare l’esecuzione dello script e aiutare a diagnosticare casi particolari specifici della tua versione RouterOS o del modello hardware.