Client Linux ZimaOS v2.0.0: installazione e risoluzione dei problemi

In sintesi: Linux v2.0.0 è un client della community, non la build ufficiale di ZimaClient

La distinzione più importante riguarda la distribuzione. Le attuali pagine ufficiali di download e configurazione di ZimaSpace elencano ZimaClient desktop ufficiale per Windows e macOS. Il pacchetto Linux v2.0.0 in questa discussione proviene dal progetto gestito dalla community chicohaager/zima-linux-client. Può essere davvero utile, ma gli utenti dovrebbero valutarlo come software della community, senza presumere che abbia lo stesso livello di supporto del client ufficiale.

La pagina dei download ufficiali di Zima mostra l'elenco delle piattaforme ufficiali. Il codice sorgente del client Linux del progetto della community è la fonte di riferimento per i pacchetti Linux.

Cosa aggiunge effettivamente Linux v2.0.0

La riscrittura include il rilevamento dei dispositivi locali, il montaggio SMB, la navigazione in File e Foto/cartelle, l'accesso alle app, le attività di backup, i controlli per il riavvio e lo spegnimento e Remote ID tramite un percorso ZeroTier incluso. La release risolve inoltre un fastidioso problema della finestra bianca: se l'interfaccia web di un'app rifiuta la connessione, ora il client indica l'app, l'indirizzo di destinazione e l'errore del browser invece di lasciare per sempre una finestra vuota.

Questo è importante dal punto di vista operativo. In precedenza, una finestra Electron vuota non permetteva di capire se l'app fosse arrestata, se la porta fosse irraggiungibile o se l'endpoint web restituisse un errore. La visualizzazione di ERR_CONNECTION_REFUSED sposta il controllo successivo sull'app e sulla porta di ZimaOS, invece di reinstallare il client Linux.

Scegli il pacchetto nativo quando ti serve Remote ID

Il progetto pubblica pacchetti DEB, RPM e Pacman, oltre a un AppImage. I pacchetti nativi eseguono la logica di installazione che verifica le dipendenze e configura la funzionalità ZeroTier inclusa. Le note della release del progetto avvertono che AppImage non offre la stessa integrazione di sistema; pertanto non si deve presumere che Remote ID funzioni in questo formato.

# dopo aver scaricato install.sh, i checksum e un pacchetto compatibile
chmod +x install.sh
sudo ./install.sh

# controlla un'installazione esistente
./install.sh --check

# ripara i problemi supportati dell'installazione
sudo ./install.sh --repair

Prima di eseguire come root un installer scaricato, esamina lo script e verifica il checksum pubblicato. GitHub spiega i concetti di integrità degli asset delle release nella sua sicurezza della supply chain del software.

Conosci i limiti delle piattaforme testate

La discussione riporta controlli di pacchetti e avvio su famiglie Ubuntu, Debian, Fedora, Arch e openSUSE, ma il maintainer chiarisce che i controlli automatizzati e in container non equivalgono a un'ampia validazione su hardware reale. La v2.0.0 pubblicata è ancora esclusivamente x86_64. ARM64 non viene pubblicato intenzionalmente perché l'avvio dell'app su hardware ARM reale non era stato dimostrato.

Se utilizzi Wayland, SELinux, un portachiavi non comune o una distribuzione derivata, indica questi dettagli quando segnali un bug. “Linux non funziona” è troppo generico per una diagnosi; distribuzione, versione, X11/Wayland e formato del pacchetto sono le dimensioni utili.

Come diagnosticare un'app che non si apre

1. Conferma che la stessa app si apra direttamente dalla dashboard di ZimaOS.
2. Controlla l'URL e la porta mostrati nel messaggio di errore del client Linux.
3. Verifica che l'app sia in esecuzione e che la porta sia raggiungibile dal computer Linux.
4. Se l'accesso alla LAN funziona ma Remote ID no, esegui la diagnostica ZeroTier del client.
5. Prova separatamente l'accesso diretto SMB/File rispetto alla vista web incorporata dell'app.

Accesso ai dispositivi tramite ZimaClient e accesso remoto tramite Tailscale offrono due percorsi di confronto supportati dal lato ZimaOS.

Quando preferire gli strumenti Linux standard

Se ti serve soltanto l'accesso ai file, Linux dispone già di strumenti maturi per il montaggio SMB/CIFS e di client Tailscale/WireGuard. Il client desktop della community diventa più utile quando vuoi l'esperienza ZimaOS completa—rilevamento dei dispositivi, app, backup e identità remota—in un'unica interfaccia. Per un server o una workstation headless, i protocolli standard possono essere più semplici e facili da automatizzare.

L'autenticazione SMB di ZimaOS è il percorso più semplice quando il requisito è esclusivamente lo spazio di archiviazione condiviso.

Non confondere i bug del client Linux con i bug dei servizi ZimaOS

Prova sempre la stessa operazione dall'interfaccia web di ZimaOS o tramite un protocollo standard. Se la dashboard web permette di esplorare i file e SMB funziona, ma il client Linux non funziona, segnala il problema al livello del client. Se anche l'app o la condivisione sottostante di ZimaOS non funziona, risolvi prima il problema del servizio. Questa separazione impedisce che un client della community diventi la spiegazione di ogni problema NAS non correlato.

FAQ

ZimaClient è ufficialmente disponibile per Linux?

Attualmente il flusso di download ufficiale di ZimaSpace elenca ZimaClient desktop per Windows e macOS. L'app Linux v2.0.0 di questa discussione della community è gestita in un repository GitHub separato della community.

Linux v2.0.0 supporta ARM64?

No, nella discussione sulla v2.0.0 non viene fornita alcuna build ARM64 pubblicata perché l'avvio dell'app su hardware reale non era stato verificato.

Devo usare AppImage o DEB/RPM?

Usa un pacchetto nativo quando ti servono l'integrazione di sistema del progetto e il percorso Remote ID tramite ZeroTier incluso. AppImage è più portabile, ma non offre tutte le funzionalità post-installazione.

Perché un'app mostra ERR_CONNECTION_REFUSED?

Il browser incorporato ha raggiunto un indirizzo presso il quale l'app non ha accettato la connessione. Controlla lo stato dell'app, la porta di destinazione, l'indirizzo host e il firewall prima di reinstallare il client.

Posso semplicemente montare le condivisioni ZimaOS con SMB su Linux?

Sì. Se il tuo obiettivo è solo l'accesso ai file, gli strumenti CIFS/SMB standard sono una valida alternativa al client desktop della community.