Soluzione della community

Tailscale su ZimaOS: aggiorna la vecchia configurazione della chiave di autenticazione per l’accesso attuale e le autorizzazioni SMB

A November 2024 ZimaOS 1.2.5 thread where the BigBear Tailscale app opened incorrectly until a community reply suggested using TS_AUTHKEY based on an older CasaOS tutorial. The reply also claimed SMB had to be shared as guest over Tailscale. Current IceWhale documentation now provides an official Tailscale App Store flow with normal sign-in and does not require guest SMB.

La soluzione alternativa originale appartiene alle prime versioni di ZimaOS 1.2.5. L’utente aveva trovato un pacchetto Tailscale di BigBear nell’App Store, ma aprendolo veniva semplicemente reindirizzato alla dashboard di ZimaOS. Una risposta della community suggeriva di seguire un vecchio tutorial di CasaOS e incollare una chiave di autenticazione in TS_AUTHKEY.

Le versioni attuali di ZimaOS offrono un percorso supportato molto più chiaro: installare Tailscale dall’App Store ufficiale, aprirlo, effettuare l’accesso tramite il flusso di autorizzazione del browser e usare l’indirizzo 100.x assegnato dagli altri dispositivi nella stessa tailnet. La vecchia affermazione secondo cui SMB debba essere condiviso come Guest non è un requisito di Tailscale; l’autenticazione SMB resta una decisione relativa alla condivisione e ai permessi di utenti di ZimaOS.

La fonte del 2024 utilizzava un pacchetto Tailscale di BigBear

Primo App Store di ZimaOS con l’app Tailscale di BigBear durante la discussione sulla risoluzione dei problemi della versione 1.2.5
La fonte è precedente all’attuale flusso ufficiale di Tailscale in ZimaOS.

La community suggeriva TS_AUTHKEY per la prima registrazione

Impostazioni storiche del contenitore Tailscale che mostrano lo stato persistente, /dev/net/tun e TS_AUTHKEY su ZimaOS
Il pacchetto iniziale esponeva direttamente le variabili d’ambiente di basso livello di Tailscale.

Una chiave di autenticazione è ancora un meccanismo di registrazione Tailscale valido per le distribuzioni automatizzate o senza interfaccia grafica, ma non è più il percorso ordinario documentato da IceWhale per gli utenti attuali di ZimaOS.

Le versioni attuali di ZimaOS offrono un flusso Tailscale nativo dall’App Store

La documentazione attuale di IceWhale indica di installare Tailscale, avviarlo, autorizzare il dispositivo ZimaOS con l’account Tailscale dell’utente e quindi individuare il server nella console di amministrazione Tailscale tramite il suo indirizzo 100.x.

Usa il flusso Tailscale attuale di ZimaOS.

Lo stato di Tailscale dovrebbe sopravvivere alla ricreazione del contenitore

Il vecchio pacchetto mappava lo stato persistente in AppData. Questo principio rimane importante: se lo stato del nodo viene perso, il server potrebbe apparire come un nuovo dispositivo e richiedere una nuova autorizzazione.

Tailscale non richiede la condivisione SMB come Guest

Tailscale trasporta traffico IP crittografato tra i dispositivi. SMB continua ad autenticarsi a livello Samba/ZimaOS. Una condivisione può rimanere protetta da nome utente e password di ZimaOS ed essere raggiunta tramite l’indirizzo Tailscale, proprio come tramite un indirizzo LAN.

Non rendere vulnerabile una condivisione privata impostandola su Guest solo perché lo suggeriva una vecchia risposta del forum.

La stessa tailnet funziona con client Linux, Windows, macOS, iOS e Android

Installa il client Tailscale ufficiale sul dispositivo remoto, accedi alla stessa tailnet, quindi apri la WebUI di ZimaOS o la condivisione SMB usando l’IP o il nome Tailscale.

Tailscale non sostituisce le funzionalità di ZimaClient

La documentazione attuale di IceWhale distingue esplicitamente il tunnel di rete dalle funzionalità esclusive di ZimaClient, come Backup del telefono, Backup del computer e alcune integrazioni desktop. Usa Tailscale quando vuoi una raggiungibilità di rete sotto il tuo controllo; usa ZimaClient quando vuoi un’esperienza Zima più completa.

Mantieni private le chiavi di autenticazione e l’amministrazione della tailnet

Se automatizzi la registrazione con una chiave di autenticazione, trattala come un segreto. Quando opportuno, usa una chiave temporanea o con durata limitata e revoca qualsiasi chiave pubblicata accidentalmente in uno screenshot o su un forum.

Usa l’indirizzo Tailscale per i servizi remoti

Dopo l’autorizzazione, il dispositivo ZimaOS riceve un indirizzo Tailscale 100.x e potrebbe avere anche un nome DNS della tailnet. Usa quell’indirizzo o nome privato per la dashboard o l’endpoint SMB dal client remoto.

In questo modo eviti di esporre l’indirizzo LAN di ZimaOS o di inoltrare le porte SMB tramite il router pubblico.

L’accesso diretto all’host non richiede un router subnet

Se Tailscale è in esecuzione direttamente sull’host ZimaOS, gli altri dispositivi della tailnet possono raggiungere direttamente quell’host. Il routing subnet è necessario solo quando il nodo Tailscale di ZimaOS deve instradare il traffico anche verso altri dispositivi LAN su cui Tailscale non è in esecuzione.

Verifica separatamente la WebUI e SMB

Apri innanzitutto la WebUI di ZimaOS tramite l’indirizzo Tailscale. Poi testa la condivisione SMB con il nome utente e la password di ZimaOS previsti. Se la WebUI funziona ma SMB non funziona, esamina i permessi Samba anziché il tunnel Tailscale.

Non copiare alla cieca il vecchio tag BigBear e l’elenco delle variabili d’ambiente

Lo screenshot mostra un’immagine o un tag Tailscale storico e diverse variabili d’ambiente del 2024. Il pacchetto attuale dell’App Store, le versioni di Tailscale, la gestione DNS, i percorsi dello stato e il comportamento di autenticazione sono cambiati. Usa le impostazioni predefinite del pacchetto attuale, a meno che una funzionalità avanzata di Tailscale non richieda un’impostazione esplicita.

Domande frequenti su Tailscale in ZimaOS

Gli utenti attuali devono incollare TS_AUTHKEY solo per installare Tailscale?

No. La documentazione attuale di ZimaOS utilizza un flusso interattivo di accesso a Tailscale.

SMB richiede i permessi Guest tramite Tailscale?

No. Tailscale fornisce il percorso di rete; i permessi SMB restano controllati dalla condivisione e dall’account ZimaOS.

Tailscale può fornire l’accesso remoto a ZimaOS da Linux?

Sì. Installa il client Tailscale ufficiale per Linux e connettiti all’indirizzo Tailscale di ZimaOS.