Documentação do LGM-OS
9 min · 6 seções
Toda a documentação do NAS, organizada pelo momento em que você vai precisar dela. Se você acabou de instalar, comece pelo guia de administração; os outros são guias temáticos, necessários só quando você enfrentar aquele assunto específico.
Começar
| Guia | Para que serve |
|---|---|
| Instalar o NAS do zero | O começo de tudo, com capturas de cada tela: baixar a imagem, gravar o pendrive no Windows, no Mac ou no Linux, dar boot no computador por ele e a instalação —que não pergunta nada—. E o que fazer se o computador não der boot pelo pendrive ou algo travar. |
| Guia de administração | Comece por “Os primeiros dez minutos”: o caminho completo desde que você liga o computador até ter discos, pastas, contas e um backup que realmente funciona. Depois, o manual do dia a dia, assunto por assunto. Se for ler só um, é este. |
| Ter o painel como aplicativo | O painel no celular, no tablet ou no computador com seu ícone e sem a barra do navegador: o certificado do seu NAS —que é o que quase todo mundo pula— e os dois passos, dispositivo por dispositivo (iPhone, Android, Windows, Mac e Linux). E o que significa cada coisa estranha: o atalho sem logo, o que abre em branco. |
| LGM Connect, o aplicativo | O NAS numa janela do seu computador: o painel inteiro —os mesmos apps, suas permissões— mais o que uma página web não consegue fazer. Suas pastas como mais uma unidade (também sem conexão), os avisos do NAS na central de notificações e as câmeras em sua própria janela. Instalá-lo, encontrar seu NAS de quatro formas e o que fazer quando algo não conecta. |
| Instalar o LGM Connect no iPhone | O aplicativo no iPhone sem passar pela App Store: o arquivo .ipa assinado por você com seu próprio Apple ID e o Sideloadly. A senha de app, o “Confiar” que trava todo mundo, por que a assinatura dura 7 dias e como renová-la em um minuto. E o que este caminho não dá: os avisos. |
| Se o LGM-OS desaparecer | A pergunta que você deve se fazer antes de confiar as fotos da sua família a um produto pago feito por uma pessoa: se o projeto parar, o código é publicado e a licença deixa de ser exigida. E o que acontece hoje se o servidor cair, em que formato estão seus dados e o que o seu NAS conta para lgm-os.com. Com os comandos para você mesmo conferir. |
| Conectar seus dispositivos | Para o NAS aparecer como mais uma pasta no Windows, no Mac, no Linux, no iPhone e no Android: o que digitar em cada um, qual protocolo usar para quê, e por que o SMB nunca é publicado na internet. |
| Usuários e permissões | Quem vê o quê: as quatro camadas (a conta, os aplicativos, as pastas e os protocolos), os três níveis de cada app, o Painel de controle tela por tela, os grupos e o que acontece exatamente ao remover alguém. |
| README do projeto | O que é o LGM-OS, como é instalado pela ISO ou sobre um Debian existente, como é atualizado (sem precisar de acesso ao código) e que limitações tem hoje. |
Guias por assunto
| Guia | Para que serve |
|---|---|
| Backups | Tirar seus dados do NAS antes que algo aconteça: quais pastas copiar, para onde (disco, outro servidor por SSH ou a nuvem) e com que frequência, como autorizar a chave SSH do destino remoto passo a passo e —a única coisa que não é opcional— como conferir, restaurando de verdade, que o backup funciona. |
| Proteção contra ransomware | Que os backups continuem lá quando alguém criptografar o NAS: o que protege de verdade e o que não, a trava dos snapshots (a única coisa que impede excluí-los, até para o root) e o que fazer nos primeiros dez minutos se já tiver acontecido. |
| Câmeras | Videovigilância no próprio NAS: encontrar as câmeras da rede por ONVIF, cadastrá-las quando não têm ONVIF, quanto disco cada uma consome e por que não se deve abrir a porta delas no roteador. |
| Acesso pela internet | Chegar ao NAS de fora de casa publicando-o com um domínio próprio: DDNS com DuckDNS, certificado do Let's Encrypt, proxy reverso por subdomínio e a lista de segurança que é preciso cumprir antes de mexer no roteador. |
| 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 você não pode abrir portas, servidor DNS com nomes locais e servidor DHCP. Inclui como recuperar a rede se o DHCP deixar você sem conexão: leia antes de ativá-lo e salve no celular. |
| Discos, reservas e replicações | Aproveitar os discos depois de criado o volume: cache de leitura, disco reserva que entra sozinho quando outro falha, replicação do volume inteiro para outro NAS, discos em rede (iSCSI) para Windows, Proxmox ou VMware e os discos USB que você conecta por um tempo. |
| Arquivos | O gerenciador de arquivos inteiro: pré-visualização de documentos, fotos e notas sem baixar nada, busca instantânea (também dentro dos arquivos), links de download com validade e senha, pedir arquivos a quem não tem conta, a lixeira compartilhada com o PC e as versões que os snapshots guardam. |
| Galeria | Fotos e vídeos em linha do tempo e álbuns sem tirar nada do lugar: favoritas, Live Photos, HEIC e RAW, duplicadas, e cada conta vê só o que é seu. |
| IA local | Perguntar ao NAS como a uma pessoa: o que ela verifica antes de responder, os três modos (só conversar, copiloto e autônomo), o que ela nunca faz sem perguntar, colocá-la para programar nos seus projetos sem sair da pasta, a IA de cada conta e conectar outros apps. |
| Chat | Conversar com as pessoas da casa, a dois ou em grupo: passar um arquivo sem dar a pasta, mensagens que expiram e o que o chat não é (não é criptografia de ponta a ponta). |
| 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 na primeira vez — e que nunca vê seus discos. |
| Central de pacotes e contêineres | Instalar aplicativos com um clique e tudo o que há por baixo: 31 apps próprios e mais de 3.000 da comunidade, portas e pastas de cada um, a edição avançada com reversão automática, desinstalar sabendo o que acontece com os dados, registros, console e limpeza. |
| Máquinas virtuais | Outro computador dentro do NAS, pelo navegador: instalá-lo pela ISO, sua tela, dar a ele um IP próprio com uma ponte, snapshots com memória, aumentar o disco, entregar a ele 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 todo mundo contrata fora e cabe no computador que já está ligado: downloads (links, magnet e .torrent), a TV por DLNA, agenda e contatos no NAS, impressora em rede e sincronização com a nuvem. |
| Bloco de notas | Escrever NO NAS, e não só guardar: editar qualquer arquivo de texto, o caderno de notas ligadas (com [[links]], 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 fazê-lo ligar sozinho de manhã, Wake-on-LAN, pôr os discos para dormir e o nobreak — o dele, o que ele divide com o resto da casa ou o de outro dispositivo. |
Quando algo dá errado
| Guia | Para que serve |
|---|---|
| Quando algo não funciona | Organizado pelo que você vê, e 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 quebrou, o disco encheu, “A configuração … estava danificada” (e como recuperá-la se ninguém consegue entrar). E quais dados são necessários para que possam ajudar você. |
| Recuperação de desastres | Quando já aconteceu: disco com defeito, reinstalar mantendo os dados, restaurar a partir de um snapshot ou do backup externo. |
Referência
| Documento | Para que serve |
|---|---|
| Referência de portas | O que escuta em cada porta, quem a abre e —o que realmente importa— qual pode ser aberta no roteador e qual nunca deve ser aberta. |
| Glossário | Cada palavra estranha que aparece no painel e nestes guias, em uma frase: RAID, snapshot, scrub, SMART, ACL, DDNS, Object Lock, voucher, 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 o caminho de acesso remoto
É a decisão que mais gera dúvidas, e os dois guias envolvidos são mais fáceis de ler sabendo disto:
- Só você e seus dispositivos → VPN do guia de serviços de rede. Não publica nada na internet: você abre uma porta UDP no roteador e, do celular ou do notebook, entra em toda a rede local, e não só no painel. É a opção mais segura e a recomendada. Se você não puder abrir portas, o Tailscale ou o NetBird fazem o mesmo sem abrir nenhuma.
- Compartilhar com outras pessoas (família, convidados, um app que precisa estar acessível sem instalar nada) → Acesso pela internet. Publica o NAS com certificado válido e o Apache como único serviço exposto, e exige cumprir antes a lista de segurança desse guia.
Dá para ter os dois ao mesmo tempo, e um não atrapalha o outro.
Convenções
- Os comandos que começam com
sudosão executados no console do NAS (fisicamente, por SSH ou pelo terminal web do painel). - Os caminhos do painel são escritos
App → Seção → Aba, por exemploPainel de controle → VPN. - Os blocos marcados com ⚠️ descrevem operações que podem deixar você sem acesso ao NAS ou sem rede. Leia-os por inteiro antes de executá-los.