Documentazione di LGM-OS
9 min · 6 sezioni
Tutta la documentazione del NAS, ordinata per il momento in cui ti servirà. Se hai appena installato, comincia dalla guida all'amministrazione; il resto sono guide monografiche che servono solo quando affronti quell'argomento preciso.
Per cominciare
| Guida | A cosa serve |
|---|---|
| Installare il NAS da zero | La prima cosa di tutte, con le schermate di ogni passaggio: scaricare l'immagine, scrivere la chiavetta USB su Windows, Mac o Linux, avviare il dispositivo da lì e l'installazione —che non chiede nulla—. E cosa fare se il dispositivo non si avvia dalla chiavetta o qualcosa si blocca. |
| Guida all'amministrazione | Comincia da «I primi dieci minuti»: il percorso continuo da quando accendi il dispositivo fino ad avere dischi, cartelle, account e un backup che serve davvero. Poi, il manuale di tutti i giorni argomento per argomento. Se ne leggi solo una, è questa. |
| Avere il pannello come applicazione | Il pannello sul telefono, sul tablet o sul computer con la sua icona e senza la barra del browser: il certificato del tuo NAS —che è ciò che quasi tutti saltano— e i due passaggi, dispositivo per dispositivo (iPhone, Android, Windows, Mac e Linux). E cosa significa ogni cosa strana: il collegamento senza logo, quello che si apre vuoto. |
| LGM Connect, l'applicazione | Il NAS in una finestra del tuo computer: il pannello intero —le stesse app, i tuoi permessi— più ciò che una pagina web non può fare. Le tue cartelle come un'unità in più (anche offline), gli avvisi del NAS nel centro notifiche e le telecamere nella loro finestra. Installarla, trovare il tuo NAS in quattro modi e cosa fare quando qualcosa non si collega. |
| Installare LGM Connect sull'iPhone | L'applicazione sull'iPhone senza passare dall'App Store: il file .ipa firmato da te con il tuo Apple ID e Sideloadly. La password per le app, l'«Autorizza» su cui si bloccano tutti, perché la firma dura 7 giorni e come rinnovarla in un minuto. E cosa non dà questa strada: gli avvisi. |
| Se LGM-OS sparisce | La domanda da farsi prima di affidare le foto della tua famiglia a un prodotto a pagamento fatto da una persona: se il progetto si ferma, il codice viene pubblicato e la licenza non viene più chiesta. E cosa succede oggi se il server cade, in che formato sono i tuoi dati e cosa racconta il tuo NAS a lgm-os.com. Con i comandi per verificarlo tu. |
| Collegare i tuoi dispositivi | Che il NAS compaia come una cartella in più su Windows, Mac, Linux, iPhone e Android: cosa scrivere su ciascuno, quale protocollo usare per cosa, e perché SMB non si pubblica mai su internet. |
| Utenti e permessi | Chi vede cosa: i quattro strati (l'account, le applicazioni, le cartelle e i protocolli), i tre livelli di ogni app, il Pannello di controllo schermata per schermata, i gruppi e cosa succede esattamente quando si toglie qualcuno. |
| README del progetto | Cos'è LGM-OS, come si installa dalla ISO o su un Debian esistente, come si aggiorna (senza bisogno di accedere al codice) e quali limiti ha oggi. |
Guide per argomento
| Guida | A cosa serve |
|---|---|
| Backup | Portare i tuoi dati fuori dal NAS prima che succeda qualcosa: quali cartelle copiare, dove (disco, un altro server via SSH o il cloud) e ogni quanto, come autorizzare passo passo la chiave SSH della destinazione remota e —l'unica cosa non facoltativa— come verificare ripristinando davvero che il backup serve. |
| Protezione contro il ransomware | Che i backup siano ancora lì quando qualcuno cifra il NAS: cosa protegge davvero e cosa no, il lucchetto delle istantanee (l'unica cosa che impedisce di eliminarle, perfino a root) e cosa fare nei primi dieci minuti se è già successo. |
| Telecamere | Videosorveglianza nel NAS stesso: trovare le telecamere della rete tramite ONVIF, aggiungerle quando non ce l'hanno, quanto disco si mangia ciascuna e perché non bisogna aprire la loro porta nel router. |
| Accesso da internet | Arrivare al NAS da fuori casa pubblicandolo con un tuo dominio: DDNS con DuckDNS, certificato Let's Encrypt, proxy inverso per sottodominio e l'elenco di sicurezza da rispettare prima di toccare il router. |
| Servizi di rete | Trasformare il NAS nel centro della rete: VPN WireGuard (il modo più sicuro di entrare da fuori, senza esporre nulla), Tailscale e NetBird per quando non puoi aprire porte, server DNS con nomi locali e server DHCP. Include come recuperare la rete se il DHCP ti lascia senza connessione: leggila prima di attivarlo e salvala sul telefono. |
| Dischi, ricambi e repliche | Sfruttare i dischi una volta creato il volume: cache di lettura, disco di riserva che entra da solo quando un altro si guasta, replica dell'intero volume su un altro NAS, dischi in rete (iSCSI) per Windows, Proxmox o VMware e i dischi USB che colleghi per un po'. |
| File | Il gestore di file intero: anteprima di documenti, foto e note senza scaricare nulla, ricerca istantanea (anche dentro i file), link di download con scadenza e password, chiedere file a chi non ha un account, il cestino condiviso con il PC e le versioni che conservano le istantanee. |
| Galleria | Foto e video in una linea del tempo e in album senza spostare nulla dal suo posto: preferite, Live Photo, HEIC e RAW, duplicati, e ogni account vede solo le sue. |
| IA locale | Chiedere al NAS come a una persona: cosa controlla prima di rispondere, le tre modalità (solo conversare, copilota e autonoma), cosa non fa mai senza chiedere, farla programmare nei tuoi progetti senza uscire dalla cartella, l’IA di ogni account e collegare altre app. |
| Chat | Parlare con le persone di casa, a due a due o in gruppo: passare un file senza dare la cartella, messaggi che scadono e cosa non è la chat (non è una cifratura end-to-end). |
| Documenti | Guardare qualsiasi documento d'ufficio convertito in PDF senza installare nulla, e modificarlo nel browser con l'editor che si installa solo la prima volta — e che non vede mai i tuoi dischi. |
| Centro pacchetti e container | Installare applicazioni con un clic e tutto ciò che c'è sotto: 31 app proprie e più di 3.000 della comunità, porte e cartelle di ciascuna, la modifica avanzata con ritorno indietro automatico, disinstallare sapendo cosa succede ai dati, registri, console e pulizia. |
| Macchine virtuali | Un altro computer dentro il NAS, dal browser: installarlo dalla sua ISO, il suo schermo, dargli un IP proprio con un bridge, istantanee con memoria, ingrandire il disco, consegnargli un dispositivo USB del NAS, portarla su un altro NAS e le tre condizioni di Windows 11. |
| Servizi di casa | Ciò che quasi tutti hanno in abbonamento fuori e sta nel dispositivo già acceso: download (link, magnet e .torrent), la TV via DLNA, calendario e contatti con il NAS, stampante in rete e sincronizzazione con il cloud. |
| Blocco note | Scrivere NEL NAS, non solo salvare: modificare qualsiasi file di testo, il quaderno di note collegate (con [[link]], grafo, etichette e attività) e l'editor di codice con evidenziazione della sintassi per decine di linguaggi. |
| Sorvegliare e difendere i dati | I sei pezzi che curano ciò che è conservato: versioni precedenti in Windows stesso, chi ha toccato cosa, antivirus, trappola per ransomware, blocco per paese e rapporto settimanale. |
| Energia | Spegnere il NAS di notte e farlo tornare da solo al mattino, Wake-on-LAN, mettere a riposo i dischi e l'UPS — il suo, quello che condivide con il resto della casa o quello di un altro dispositivo. |
Quando qualcosa va male
| Guida | A cosa serve |
|---|---|
| Quando qualcosa non va | Ordinata per ciò che vedi, non per ciò che si guasta: il pannello non si apre, non vedo il NAS in rete, va lento, un disco dà errori, ho aggiornato e qualcosa si è rotto, il disco si è riempito, «L'impostazione … era danneggiata» (e come recuperarla se non entra nessuno). E quali dati servono perché ti possano aiutare. |
| Ripristino di emergenza | Quando è già successo: disco guasto, reinstallare conservando i dati, ripristinare da un'istantanea o dal backup esterno. |
Riferimento
| Documento | A cosa serve |
|---|---|
| Riferimento delle porte | Cosa ascolta su ogni porta, chi la apre e —ciò che conta davvero— quale si può aprire nel router e quale non si apre mai. |
| Glossario | Ogni parola strana che compare nel pannello e in queste guide, in una frase: RAID, istantanea, scrub, SMART, ACL, DDNS, Object Lock, token, WOL… |
| CHANGELOG | Cosa è cambiato in ogni versione, con gli avvisi di quelle che richiedono attenzione quando si aggiorna. |
| allowlist.py | L'elenco chiuso di comandi e percorsi che il processo privilegiato accetta. È la fonte di verità su ciò che il pannello può e non può fare nel sistema. |
Come scegliere la strada di accesso remoto
È la decisione che genera più dubbi, e le due guide coinvolte si leggono meglio sapendo questo:
- Solo tu e i tuoi dispositivi → VPN della guida ai servizi di rete. Non pubblica nulla su internet: apri una porta UDP nel router e dal telefono o dal portatile entri in tutta la rete locale, non solo nel pannello. È l'opzione più sicura e quella consigliata. Se non puoi aprire porte, Tailscale o NetBird fanno lo stesso senza aprirne nessuna.
- Condividere con terzi (famiglia, ospiti, un'app che deve essere accessibile senza installare nulla) → Accesso da internet. Pubblica il NAS con un certificato valido e Apache come unico servizio esposto, e richiede di rispettare prima l'elenco di sicurezza di quella guida.
Le due si possono avere insieme e non si intralciano.
Convenzioni
- I comandi che cominciano con
sudosi eseguono nella console del NAS (fisicamente, via SSH o dal terminale web del pannello). - I percorsi del pannello si scrivono
App → Sezione → Scheda, per esempioPannello di controllo → VPN. - I blocchi segnati con ⚠️ descrivono operazioni che possono lasciarti senza accesso al NAS o senza rete. Leggili per intero prima di eseguirli.