Errors d’adopció - Com solucionar-los

Resum Aquesta guia llista els 5 errors més comuns que impedeixen que els dispositius MikroTik siguin adoptats a MKController i explica com diagnosticar i solucionar cadascun. Problemes coberts: versió de RouterOS obsoleta, Mode de Dispositiu bloquejant fetch, paquet PPP absent, sense Internet o DNS al dispositiu, i espai de disc insuficient. Cada problema inclou ordres exactes de RouterOS per al diagnòstic i la resolució.

Quins són els errors d’adopció de MikroTik més comuns?

L’adopció de MikroTik a MKController falla per un petit conjunt de raons previsibles. La taula a continuació relaciona cada error amb la seva causa i la secció on trobaràs la solució.

Símptoma d’error	Causa principal	Solució
L’adopció s’atura a “creant VPN” durant diversos minuts	Versió de RouterOS massa antiga o incompatible	Secció 1
`failure: not allowed by device-mode`	El Mode de Dispositiu no permet `fetch`	Secció 2
`expected end of command (line 6 column 33)`	El paquet PPP no està instal·lat	Secció 3
`could not resolve host name` o `status: failed / reason: timeout`	Sense accés a Internet o error de DNS	Secció 4
`fetch` falla amb un error d’emmagatzematge	Menys de 2 MB d’espai de disc lliure	Secció 5

1. Check RouterOS Version

Symptom

L’adopció no es completa. El procés s’atura durant diversos minuts a l’etapa “creant VPN”.

Diagnosis

El dispositiu pot estar executant una versió de RouterOS incompatible amb les funcions requerides de MKController. Comprova primer la llista de versions de RouterOS compatibles.

Steps to Resolve

Comprova la versió instal·lada i la més recent disponible al canal d’actualització configurat:
Terminal window
```
/system package update check-for-updates
```
La sortida s’assemblarà a:
```
installed-version: 6.49.10
latest-version: 6.49.12
status: New version is available
```
Si hi ha una actualització disponible i és a la llista de compatibles, instal·la-la:
Terminal window
```
/system package update install
```
Reinicia el dispositiu:
Terminal window
```
/system reboot
```
Després del reinici, torna a intentar el procés d’adopció.

2. Device Mode Advanced Disabled

Symptom

Executar l’script d’adopció via Winbox retorna:

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

Executar via terminal retorna:

failure: not allowed by device-mode

Error de terminal del Mode de Dispositiu durant l'adopció de MikroTik

Diagnosis

El Mode de Dispositiu de MikroTik està bloquejant les funcions fetch, hotspot i scheduler. Això afecta alguns models que executen RouterOS 7.17 i posteriors.

Steps to Resolve

Comprova la configuració actual del Mode de Dispositiu. Si fetch mostra no, està bloquejat:
Terminal window
```
/system device-mode print
```
Activa el Mode de Dispositiu Avançat:
Terminal window
```
/system device-mode update mode=advanced
```
Realitza un reinici dur — desconnecta físicament el MikroTik de l’alimentació elèctrica durant un moment. Un reinici per programari estàndard no és suficient; el canvi del Mode de Dispositiu només s’aplica després d’un cicle d’alimentació complet.
Després del reinici dur, verifica el canvi:
Terminal window
```
/system device-mode print
```
Confirma que fetch ara mostra yes i, a continuació, torna a intentar l’adopció.

3. Missing PPP Package

Symptom

Executar l’script d’adopció retorna:

expected end of command (line 6 column 33)

Diagnosis

El paquet PPP no està instal·lat al dispositiu. L’script d’adopció de MKController requereix PPP per crear el túnel VPN.

Error de paquet PPP absent al MikroTik

Steps to Resolve

Ves a la pàgina de descàrrega d’arxius de MikroTik i descarrega els Paquets Extra .zip per a la versió de RouterOS i l’arquitectura del dispositiu (mipsbe, arm, smips, etc.) que coincideixi amb el teu dispositiu.
Extreu el .zip i localitza ppp.npk.
Carrega ppp.npk al router:
- A Winbox → pestanya Fitxers, o
- Via FTP o SCP
Reinicia el router:
Terminal window
```
/system reboot
```
Després del reinici, el menú PPP hauria d’aparèixer a WebFig i Winbox. Torna a intentar l’script d’adopció.

4. Issues When Running the Script

Symptoms

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

Diagnosis

El dispositiu MikroTik no té accés a Internet o no pot resoldre DNS. Tots dos són necessaris perquè el dispositiu arribi als servidors de MKController.

Steps to Resolve

Prova la connectivitat bàsica a Internet:
Terminal window
```
ping 8.8.8.8
```
Si no hi ha resposta, investiga:
- Ruta per defecte absent: /ip route print
- Regles NAT o de tallafocs que bloquegen el trànsit de sortida
- Connexió física al proveïdor amunt
Un cop ping 8.8.8.8 tingui èxit, prova la resolució DNS:
Terminal window
```
ping app.mkcontroller.com
```
Si falla, configura servidors DNS fiables:
Terminal window
```
/ip dns set servers=8.8.8.8,1.1.1.1
```
Reinicia:
Terminal window
```
/system reboot
```
Torna a intentar l’script d’adopció.

5. Insufficient Disk Space

Symptom

Errors en executar fetch o instal·lar paquets, que indiquen un problema d’emmagatzematge.

Diagnosis

MikroTik requereix almenys 2 MB d’espai de disc lliure per executar l’script d’adopció i descarregar el paquet VPN.

Steps to Resolve

Comprova l’espai de disc disponible:
Terminal window
```
/system resource print
```
Si free-hdd-space és inferior a 2 MB, llista els fitxers emmagatzemats actualment al dispositiu:
Terminal window
```
/file print
```
Elimina fitxers innecessaris o còpies de seguretat antigues:
Terminal window
```
/file remove <id>
```

Torna a intentar el procés d’adopció després d’alliberar espai suficient.

Still Experiencing Issues?

Seguir aquests cinc passos resol la majoria dels errors d’adopció de MikroTik a MKController.

Si el problema persisteix després de treballar totes les seccions, contacta amb el nostre equip de suport a WhatsApp. Podem revisar els registres d’adopció, inspeccionar l’execució de l’script i ajudar a diagnosticar casos límit específics de la teva versió de RouterOS o model de maquinari.