Soluzione della community

ZimaOS btop mostra «Istruzione non valida» su ZimaBoard: il bug della build della CPU 1.3.3 e la correzione nella 1.4.0

A 2024 CasaOS tutorial thread that later became a detailed ZimaOS 1.3.3 btop bug report. ZimaBoard and ZimaBlade users with Intel N3450 CPUs saw Press Enter to reconnect and Illegal instruction errors. After browser testing ruled out the frontend, Zima-Giorgio said the binary had been compiled without accounting for the ZimaBoard CPU and that ZimaOS 1.4.0 fixed it.

Questa discussione ha cambiato argomento nel tempo. È iniziata come un tutorial del 2024 sull'installazione di BTOP su CasaOS, poi è diventata molto più utile nel marzo 2025, quando ZimaOS 1.3.3 ha aggiunto un pannello integrato per il monitoraggio delle prestazioni con btop e diversi utenti di ZimaBoard/ZimaBlade hanno scoperto che il nuovo binario si arrestava con Istruzione non valida (core scaricato).

La diagnosi finale è arrivata da IceWhale, non da speculazioni della community: Zima-Giorgio ha dichiarato che il team non aveva tenuto conto della CPU di ZimaBoard durante la compilazione di btop e che il problema sarebbe stato risolto in ZimaOS 1.4.0. Si tratta quindi di un bug storico di compatibilità della CPU con un chiaro limite di versione.

ZimaOS 1.3.3 ha introdotto il pannello btop integrato

Le note di rilascio di ZimaOS 1.3.3 di IceWhale introducevano btop come nuovo pannello di monitoraggio delle prestazioni nella dashboard di ZimaOS. L'obiettivo era fornire visibilità su CPU, memoria, processi e attività del sistema senza richiedere agli utenti di installare una piattaforma di monitoraggio separata.

Usa il confine funzionale di ZimaOS 1.3.3 durante la lettura della discussione originale.

Il collegamento della dashboard apriva una schermata di riconnessione

Dashboard di ZimaOS con widget di sistema e archiviazione e collegamenti per il monitoraggio delle risorse e della rete evidenziati
La nuova dashboard mostrava collegamenti diretti agli strumenti di monitoraggio delle risorse e della rete.

Nei sistemi interessati, facendo clic sul collegamento si apriva una porta temporanea con numero elevato e veniva visualizzato solo un messaggio per riconnettersi.

Finestra del browser di btop su ZimaOS che mostra «Premi Invio per riconnetterti» invece dell'interfaccia delle prestazioni
Il sintomo nel browser sembrava un problema di ttyd/WebSocket, ma l'errore del terminale ha rivelato un problema più profondo di compatibilità del binario.

L'esecuzione diretta di btop ha prodotto un'istruzione non valida

La riga diagnostica chiave era:

btop
Istruzione non valida (core scaricato)

Quel messaggio indica che la CPU ha tentato di eseguire un'istruzione per la quale il binario era stato compilato, ma che l'hardware non supportava. È molto diverso da un problema di cache del browser o da un timeout WebSocket.

Più browser hanno escluso un bug specifico del browser

Gli utenti hanno provato Firefox, Chrome/Chromium, Safari, Brave, Opera ed Edge, in finestre normali e in modalità privata/in incognito. Il comportamento è rimasto invariato.

Questo test negativo è stato utile perché la prima domanda di IceWhale durante la risoluzione dei problemi era se il problema potesse dipendere dal browser.

DevTools ha mostrato un errore WebSocket dopo l'arresto del backend

Chrome DevTools mostrava frame di chiusura WebSocket non corretti di btop ttyd, rifiuti della connessione e errori nel recupero del token
Il frontend ha perso il WebSocket perché il backend btop/ttyd non rimaneva operativo correttamente; pertanto, gli errori del browser erano segnali a valle e non la causa principale.

Gli utenti interessati utilizzavano CPU della generazione Intel Celeron N3450

Un utente di ZimaBoard 832 e uno di ZimaBlade hanno confrontato l'hardware e notato che condividevano CPU della classe Intel Celeron N3450. Hanno chiesto se il binario di btop fosse stato compilato per un set di istruzioni della CPU più recente, quello dello ZimaCube.

Questa ipotesi è stata successivamente confermata da IceWhale.

IceWhale ha confermato che il target di compilazione era errato

Il 27 marzo, Zima-Giorgio ha scritto che il problema era stato individuato e sarebbe stato risolto in ZimaOS 1.4.0, perché la build originale di btop non teneva conto della CPU dello ZimaBoard.

Questa è la conclusione più solida della fonte e dovrebbe sostituire soluzioni speculative come reinstallare i browser o installare manualmente un altro binario di btop sull'host ZimaOS immutabile.

Il cambio della porta alta era intenzionale

CorrectRoadH di IceWhale ha affermato che l'apertura di btop ogni volta su una porta alta diversa era una funzionalità di sicurezza, pensata per rendere più difficile il riutilizzo diretto della sessione temporanea di monitoraggio.

Pertanto, il cambio di porta non costituiva di per sé una prova del problema.

Non diagnosticare l'attuale problema di btop basandoti soltanto sul bug della versione 1.3.3

L'attuale ZimaOS è molto più recente delle versioni 1.3.3/1.4.0. Se btop oggi non funziona, annota la versione corrente di ZimaOS, il modello della CPU, l'errore esatto del terminale e se il problema riguarda il collegamento rapido del dashboard o solo la CLI.

Un Istruzione illegale su una build moderna potrebbe comunque indicare un problema di compatibilità della CPU, ma dovrebbe essere analizzato come una nuova regressione anziché essere attribuito automaticamente al vecchio pacchetto del 2025.

Perché è comparso l'errore WebSocket dopo l'errore della CPU

Il pannello di controllo avvia una sessione interattiva simile a un terminale per btop. Se il processo btop termina immediatamente a causa di un'istruzione CPU illegale, il frontend perde il backend con cui si aspetta di comunicare. I messaggi di chiusura del WebSocket e di connessione rifiutata possono quindi essere effetti secondari del processo arrestato.

Questa è una lezione generale utile per la risoluzione dei problemi: il primo errore nella console del browser non è sempre la causa principale. Confrontalo con ciò che accade quando il comando sottostante viene eseguito direttamente.

Il malfunzionamento anche del collegamento di Gestione rete ha fornito un ulteriore indizio

Un utente interessato ha detto che sia i collegamenti di Gestione risorse sia quelli di Gestione rete producevano lo stesso comportamento di riconnessione, mentre il normale terminale web funzionava. Ciò suggeriva che il problema fosse legato all'ambiente dello strumento avviato dal collegamento, anziché a un'interruzione completa di ttyd.

IceWhale doveva ancora fornire direttamente btop Il crash e le informazioni condivise sull'hardware N3450 hanno permesso di identificare il reale problema legato alla destinazione di compilazione.

Reinstallare la stessa build 1.3.3 non avrebbe modificato le istruzioni della CPU

Una volta che IceWhale ha confermato che il binario stesso era stato compilato senza tenere conto della CPU dello ZimaBoard, reinstallare i browser, svuotare la cache e reinstallare la stessa versione del sistema non potevano correggere il set di istruzioni dell'eseguibile.

La soluzione definitiva richiedeva un binario ricompilato, distribuito nella versione successiva di ZimaOS.

La compatibilità hardware include i binari dello spazio utente, non solo i driver del kernel

Le discussioni sulla compatibilità si concentrano spesso sui driver di rete, GPU o archiviazione. Questo incidente dimostra che anche un sistema operativo x86 generico può non funzionare sulle CPU più vecchie se un'applicazione inclusa viene compilata con istruzioni che l'hardware non implementa.

Per le macchine x86 di terze parti, un Istruzione illegale Il messaggio è quindi una prova preziosa e dovrebbe essere incluso testualmente in un rapporto di assistenza.

Domande frequenti sulla compatibilità di btop

Il problema di origine era causato da Firefox o Chrome?

No. Gli utenti lo hanno riprodotto con molti browser e in modalità privata.

Quale ha detto IceWhale essere la causa principale?

Il binario btop era stato compilato senza tenere conto del set di istruzioni della CPU dello ZimaBoard.

Quale versione avrebbe dovuto risolvere il problema?

Zima-Giorgio ha detto che la versione corretta di btop sarebbe arrivata in ZimaOS 1.4.0.