L'attuale ZimaOS consente di abilitare SSH direttamente dall'interfaccia web. Il tutorial della community era stato originariamente creato per una procedura precedente che richiedeva un display e una tastiera collegati, ma in seguito è stato aggiornato per ZimaOS 1.2.5 e indica esplicitamente che il flusso originale è obsoleto.
In un sistema aggiornato, il percorso normale è Impostazioni > Modalità sviluppatore > Accesso SSH. ZimaOS offre anche un Terminale basato sul Web nella stessa area dedicata agli sviluppatori, quindi molte attività dalla riga di comando non richiedono più un monitor esterno o un client SSH separato.
Come abilitare SSH nell'attuale ZimaOS
Il tutorial aggiornato di IceWhale fornisce tre passaggi:
- Apri Impostazioni.
- Vai a Modalità sviluppatore.
- Imposta Accesso SSH su Attivato.
L'attuale guida SSH di ZimaOS documenta lo stesso flusso della Modalità sviluppatore ed è stata aggiornata ad agosto 2026.
Come connettersi dopo aver abilitato SSH
Da un altro computer sulla stessa rete attendibile, usa un client SSH e l'indirizzo IP LAN del server ZimaOS:
ssh USERNAME@ZIMAOS_LAN_IPIl nome utente esatto e il metodo di autenticazione dipendono dall'account che intendi utilizzare. La documentazione SSH aggiornata di ZimaOS indica che gli account utente di ZimaOS possono essere utilizzati per l'accesso, mentre l'accesso root prevede una configurazione separata della password. Non dare per scontato che esista un'unica password root predefinita universale.
Mantieni SSH limitato alle reti attendibili, a meno che tu non configuri intenzionalmente un livello di accesso remoto sicuro. Abilitare SSH nell'interfaccia non significa che dovresti inoltrare direttamente la porta 22 dal router verso Internet pubblico.
Usare il terminale Web integrato senza un client SSH separato
Anche il tutorial aggiornato della community mostra un'interruttore Terminale basato sul Web. Questo consente agli amministratori di accedere a una shell dall'interfaccia del browser di ZimaOS senza aprire un'applicazione terminale separata su un altro computer.
La password di root e l'accesso SSH sono correlati, ma non identici
Un riferimento SSH aggiornato di ZimaSpace afferma che la password root deve essere creata tramite il percorso di configurazione della console locale quando è necessaria l’autenticazione root, mentre gli account utente di ZimaOS possono essere utilizzati anche per accedere tramite SSH. Ciò significa che attivare l’interruttore Accesso SSH non crea automaticamente credenziali root universali.
Se il tuo obiettivo è l’amministrazione ordinaria, usa l’account con i privilegi minimi che consente di eseguire l’attività ed eleva i privilegi solo quando necessario. Evita di abilitare l’accesso remoto root solo per comodità.
Per informazioni aggiornate sul comportamento delle credenziali e sulle opzioni del terminale, consulta la documentazione sulle impostazioni SSH di ZimaOS.
Il metodo obsoleto del monitor, Alt+F2 e passwd-root
Il post della community conserva una procedura precedente, ma la colloca sotto un avviso chiaro “Quanto segue è obsoleto”. Questo flusso di lavoro storico richiedeva:
- collegare un monitor e una tastiera;
- passare a una console con
Alt + F2; - accedere come
root; - eseguire lo storico
passwd-roothelper; - quindi abilitare SSH.
Non presentare questa sequenza come procedura principale per un’installazione attuale di ZimaOS. L’interruttore aggiunto in ZimaOS 1.2.5 è stato creato specificamente per eliminare questo inconveniente per la maggior parte degli utenti.
Perché ZimaOS ha spostato SSH nell’interfaccia Web
Le risposte documentano chiaramente la decisione relativa al prodotto. Gli utenti si lamentavano del fatto che configurare l’accesso root tramite un monitor locale fosse scomodo, soprattutto sui dispositivi NAS headless. Inizialmente IceWhale spiegò che questo attrito aggiuntivo era pensato per proteggere la sicurezza di SSH, poi dichiarò che il team stava lavorando a un approccio più pratico.
Quando un altro utente suggerì di aggiungere direttamente all’interfaccia Web i controlli per abilitare o disabilitare SSH, l’autore di IceWhale rispose che la funzione sarebbe arrivata nella versione successiva. Il post originale fu poi aggiornato con la procedura della Modalità sviluppatore di ZimaOS 1.2.5.
Cosa fare se non hai un monitor?
Prima che esistesse il terminale della Modalità sviluppatore integrato, la community suggeriva di installare ttydBridge dall’App Store di ZimaOS quando l’interfaccia Web era già accessibile. L’attuale documentazione di ZimaOS elenca ancora ttydBridge come ulteriore opzione per accedere al terminale, ma il Terminale Web integrato è ora più semplice per molti utenti.
Se l’interruttore del terminale nativo è disponibile nella versione di ZimaOS in uso, utilizzalo prima di aggiungere un’altra applicazione solo per accedere a una shell.
Esiste una password root predefinita di ZimaOS?
La community ha ricevuto in seguito una domanda da parte di un utente che non riusciva ad autenticarsi nel Terminale basato sul Web e chiedeva una password root predefinita. La discussione non fornisce credenziali root predefinite universali. L’attuale documentazione di ZimaOS descrive invece una configurazione esplicita di account e password.
Non copiare vecchie credenziali di CasaOS o dell'appliance in ZimaOS dando per scontato che funzionino. Un accesso SSH non riuscito può dipendere dal nome utente errato, da una password root che non è mai stata creata, dall'accesso SSH disabilitato o da un account non autorizzato all'autenticazione remota.
SSH non sostituisce ogni procedura di ripristino alle impostazioni di fabbrica
Una risposta del 2025 chiedeva come ripristinare alle impostazioni di fabbrica uno ZimaBoard legacy senza display, quando l'autenticazione SSH non era disponibile. Un membro del team IceWhale ha indicato la documentazione sul ripristino e ha dichiarato che quella specifica procedura richiedeva ancora un display.
Quando uno ZimaBoard legacy compare nei contenuti attuali dello Shop, il percorso di migrazione del prodotto è il server single-board ZimaBoard 2 attuale. Il link al prodotto non implica che le istruzioni di ripristino per il vecchio hardware e per il prodotto attuale siano identiche.
Checklist di sicurezza SSH per ZimaOS
- Abilita SSH solo quando ti serve l'accesso remoto alla shell.
- Usa una password complessa e univoca oppure un'autenticazione tramite chiavi supportata per l'account.
- Non dare per scontato che root disponga di una password predefinita.
- Quando supportato, preferisci un normale account utente ZimaOS per le attività di routine.
- Non esporre direttamente la porta 22 a Internet pubblico senza un'attenta progettazione della sicurezza.
- Disabilita nuovamente SSH se il servizio non è più necessario.
- Mantieni ZimaOS aggiornato, così la Modalità sviluppatore e il comportamento dell'autenticazione corrisponderanno alla documentazione attuale.
Domande frequenti su SSH in ZimaOS
Dove abilito SSH in ZimaOS?
Nelle build attuali di ZimaOS, apri Impostazioni > Modalità sviluppatore e attiva Accesso SSH. Questa è la procedura attuale introdotta con ZimaOS 1.2.5.
Ho ancora bisogno di un monitor per abilitare SSH?
Non per il normale interruttore Accesso SSH attuale, quando l'interfaccia Web di ZimaOS è disponibile. La procedura obsoleta di attivazione tramite monitor e tastiera descritta nel post originale della community è esplicitamente contrassegnata come obsoleta. Alcuni scenari relativi alla password root o al ripristino possono comunque richiedere separatamente una console locale.
Qual è la differenza tra il Terminale Web e SSH?
Il Terminale Web fornisce accesso alla shell all'interno dell'interfaccia del browser di ZimaOS. SSH consente a un altro client SSH di connettersi tramite la rete. Entrambi offrono accesso alla riga di comando, ma utilizzano percorsi di accesso diversi e possono avere contesti di autenticazione differenti.
Qual è la password root predefinita?
La fonte non indica una password root predefinita universale e la documentazione attuale di ZimaOS descrive invece una configurazione esplicita dell'account. Non fare affidamento su credenziali predefinite ipotizzate.
Ho ancora bisogno di ttydBridge?
Di solito no, se la tua build attuale di ZimaOS offre il Terminale Web integrato e soddisfa le tue esigenze. ttydBridge rimane un'opzione alternativa per accedere al terminale, documentata da ZimaSpace.
