Documentação do LGM-OS
9 min · 6 secções
Toda a documentação do NAS, ordenada pelo momento em que vais precisar dela. Se acabaste de instalar, começa pelo guia de administração; os restantes são guias temáticos que só fazem falta quando enfrentas esse assunto concreto.
Começar
| Guia | Para que serve |
|---|---|
| Instalar o NAS do zero | O primeiro passo de todos, com capturas de cada ecrã: transferir a imagem, gravar a pen USB no Windows, no Mac ou no Linux, arrancar o dispositivo a partir dela e a instalação —que não pergunta nada—. E o que fazer se o dispositivo não arrancar a partir da pen ou se algo encravar. |
| Guia de administração | Começa por «Os primeiros dez minutos»: o caminho completo desde que ligas o dispositivo até teres discos, pastas, contas e uma cópia de segurança que sirva mesmo. Depois, o manual do dia a dia, tema a tema. Se só fores ler um, é este. |
| Ter o painel como aplicação | O painel no telemóvel, no tablet ou no computador com o seu ícone e sem a barra do navegador: o certificado do teu NAS —que é o que quase toda a gente salta— e os dois passos, dispositivo a dispositivo (iPhone, Android, Windows, Mac e Linux). E o que significa cada coisa estranha: o atalho sem logótipo, o que abre em branco. |
| LGM Connect, a aplicação | O NAS numa janela do teu computador: o painel inteiro —as mesmas apps, as tuas permissões— mais o que uma página web não consegue fazer. As tuas pastas como mais uma unidade (também sem ligação), os avisos do NAS no centro de notificações e as câmaras na sua própria janela. Instalá-la, encontrar o teu NAS de quatro formas e o que fazer quando algo não liga. |
| Instalar o LGM Connect no iPhone | A aplicação no iPhone sem passar pela App Store: o ficheiro .ipa assinado por ti com o teu próprio ID Apple e o Sideloadly. A palavra-passe para aplicações, o «Confiar» em que toda a gente encrava, porque é que a assinatura dura 7 dias e como a renovar num minuto. E o que este caminho não dá: os avisos. |
| Se o LGM-OS desaparecer | A pergunta que tens de fazer antes de confiar as fotos da tua família a um produto pago feito por uma pessoa: se o projeto parar, o código é publicado e deixa de ser pedida licença. E o que acontece hoje se o servidor cair, em que formato estão os teus dados e o que o teu NAS conta ao lgm-os.com. Com os comandos para o confirmares tu. |
| Ligar os teus dispositivos | Que o NAS apareça como mais uma pasta no Windows, no Mac, no Linux, no iPhone e no Android: o que escrever em cada um, que protocolo usar para quê, e porque é que o SMB nunca se publica na internet. |
| Utilizadores e permissões | Quem vê o quê: as quatro camadas (a conta, as aplicações, as pastas e os protocolos), os três níveis de cada app, o Painel de controlo ecrã a ecrã, os grupos e o que acontece exatamente ao remover alguém. |
| README do projeto | O que é o LGM-OS, como se instala a partir da ISO ou sobre um Debian existente, como se atualiza (sem precisar de acesso ao código) e que limitações tem hoje. |
Guias por tema
| Guia | Para que serve |
|---|---|
| Cópias de segurança | Tirar os teus dados do NAS antes que aconteça alguma coisa: que pastas copiar, para onde (disco, outro servidor por SSH ou a nuvem) e com que frequência, como autorizar passo a passo a chave SSH do destino remoto e —a única coisa que não é opcional— como confirmar, com um restauro a sério, que a cópia serve. |
| Proteção contra ransomware | Que as cópias continuem lá quando alguém encriptar o NAS: o que protege de verdade e o que não protege, o cadeado dos instantâneos (a única coisa que impede eliminá-los, mesmo ao root) e o que fazer nos primeiros dez minutos se já tiver acontecido. |
| Câmaras | Videovigilância no próprio NAS: encontrar as câmaras da rede por ONVIF, adicioná-las quando não o têm, quanto disco gasta cada uma e porque é que não se deve abrir a porta delas no router. |
| Acesso a partir da internet | Chegar ao NAS fora de casa ao publicá-lo com um domínio próprio: DDNS com o DuckDNS, certificado da Let's Encrypt, proxy inverso por subdomínio e a lista de segurança que é preciso cumprir antes de mexer no router. |
| Serviços de rede | Transformar o NAS no centro da rede: VPN WireGuard (a forma mais segura de entrar de fora, sem expor nada), Tailscale e NetBird para quando não consegues abrir portas, servidor DNS com nomes locais e servidor DHCP. Inclui como recuperar a rede se o DHCP te deixar sem ligação: lê-o antes de o ativar e guarda-o no telemóvel. |
| Discos, reservas e replicações | Tirar partido dos discos depois de criado o volume: cache de leitura, disco de reserva que entra sozinho quando outro avaria, replicação do volume inteiro para outro NAS, discos em rede (iSCSI) para Windows, Proxmox ou VMware e os discos USB que ligas por uns tempos. |
| Ficheiros | O gestor de ficheiros completo: pré-visualização de documentos, fotos e notas sem transferir nada, pesquisa instantânea (também dentro dos ficheiros), ligações de transferência com validade e palavra-passe, pedir ficheiros a quem não tem conta, a reciclagem partilhada com o PC e as versões que os instantâneos guardam. |
| Galeria | Fotos e vídeos em cronologia e álbuns sem mudar nada de sítio: favoritas, Live Photos, HEIC e RAW, duplicados, e cada conta só vê o que é seu. |
| IA local | Perguntar ao NAS como a uma pessoa: o que verifica antes de responder, os três modos (só conversar, copiloto e autónomo), o que nunca faz sem perguntar, pô-la a programar nos teus projetos sem sair da pasta, a IA de cada conta e ligar outras apps. |
| Chat | Falar com as pessoas de casa, a dois ou em grupo: passar um ficheiro sem dar a pasta, mensagens que expiram e o que o chat não é (não é cifragem ponto a ponto). |
| Documentos | Ver qualquer documento de escritório convertido em PDF sem instalar nada, e editá-lo no navegador com o editor que se instala sozinho da primeira vez — e que nunca vê os teus discos. |
| Centro de pacotes e contentores | Instalar aplicações com um clique e tudo o que está por baixo: 31 apps próprias e mais de 3.000 da comunidade, portas e pastas de cada uma, a edição avançada com reversão automática, desinstalar a saber o que acontece aos dados, registos, consola e limpeza. |
| Máquinas virtuais | Outro computador dentro do NAS, a partir do navegador: instalá-lo a partir da sua ISO, o seu ecrã, dar-lhe um IP próprio com uma ponte, instantâneos com memória, aumentar o disco, entregar-lhe um dispositivo USB do NAS, levá-la para outro NAS e as três condições do Windows 11. |
| Serviços da casa | O que quase toda a gente tem contratado fora e cabe no dispositivo que já está ligado: transferências (ligações, magnet e .torrent), a televisão por DLNA, calendário e contactos no NAS, impressora em rede e sincronização com a nuvem. |
| Bloco de notas | Escrever NO NAS, não só guardar: editar qualquer ficheiro de texto, o caderno de notas ligadas (com [[ligações]], grafo, etiquetas e tarefas) e o editor de código com realce de sintaxe para dezenas de linguagens. |
| Vigiar e defender os dados | As seis peças que cuidam do que está guardado: versões anteriores no próprio Windows, quem mexeu em quê, antivírus, armadilha para ransomware, bloqueio por país e relatório semanal. |
| Energia | Desligar o NAS à noite e que volte a ligar sozinho de manhã, Wake-on-LAN, pôr os discos a dormir e a UPS — a dele, a que partilha com o resto da casa ou a de outro dispositivo. |
Quando algo corre mal
| Guia | Para que serve |
|---|---|
| Quando algo não funciona | Ordenado pelo que vês, não pelo que falha: o painel não abre, não vejo o NAS na rede, está lento, um disco dá erros, atualizei e algo deixou de funcionar, o disco encheu, «A definição … estava danificada» (e como a recuperar se ninguém conseguir entrar). E que dados fazem falta para te poderem ajudar. |
| Recuperação de desastres | Quando já aconteceu: disco avariado, reinstalar conservando os dados, restaurar a partir de um instantâneo ou da cópia externa. |
Referência
| Documento | Para que serve |
|---|---|
| Referência de portas | O que escuta em cada porta, quem a abre e —o que importa de verdade— qual se pode abrir no router e qual nunca se abre. |
| Glossário | Cada palavra estranha que aparece no painel e nestes guias, numa frase: RAID, instantâneo, scrub, SMART, ACL, DDNS, Object Lock, token, WOL… |
| CHANGELOG | O que mudou em cada versão, com os avisos das que exigem atenção ao atualizar. |
| allowlist.py | A lista fechada de comandos e caminhos que o processo privilegiado aceita. É a fonte da verdade sobre o que o painel pode e não pode fazer no sistema. |
Como escolher a via de acesso remoto
É a decisão que gera mais dúvidas, e os dois guias envolvidos leem-se melhor quando se sabe isto:
- Só tu e os teus dispositivos → VPN do guia de serviços de rede. Não publica nada na internet: abres uma porta UDP no router e, a partir do telemóvel ou do portátil, entras em toda a rede local, não só no painel. É a opção mais segura e a recomendada. Se não conseguires abrir portas, o Tailscale ou o NetBird fazem o mesmo sem abrir nenhuma.
- Partilhar com terceiros (família, convidados, uma app que tem de estar acessível sem instalar nada) → Acesso a partir da internet. Publica o NAS com um certificado válido e o Apache como único serviço exposto, e exige cumprir antes a lista de segurança desse guia.
As duas podem coexistir e não se atrapalham.
Convenções
- Os comandos que começam por
sudoexecutam-se na consola do NAS (fisicamente, por SSH ou a partir do terminal web do painel). - Os caminhos do painel escrevem-se
App → Secção → Separador, por exemploPainel de controlo → VPN. - Os blocos marcados com ⚠️ descrevem operações que te podem deixar sem acesso ao NAS ou sem rede. Lê-os por inteiro antes de os executares.