Guia de administração do LGM-OS

57 min · 22 seções

Este documento é o manual do dia a dia: cobre do começo ao fim o que se faz pelo painel. Quando um assunto precisa de mais detalhes do que cabe aqui, ele tem guia próprio:

Índice completo da documentação: index.md.

Os primeiros dez minutos

Este é o caminho completo desde que você liga o dispositivo até ter o NAS fazendo algo útil. Foi pensado para ser feito de uma vez, em ordem, e cada passo diz por que importa —os que são pulados por não serem entendidos são justamente os que fazem falta no dia ruim—.

1. Entrar (1 min)

Abra https://<ip-del-nas>:5001. O IP aparece no próprio console do dispositivo ao iniciar.

O certificado é autoassinado e o navegador avisa: é normal numa máquina da sua casa —aceite—. Se isso incomodar, ele pode ser substituído por um de verdade mais adiante (veja Acesso pela internet).

O assistente de primeiro acesso pede para você criar o administrador: nome em minúsculas e senha de pelo menos 8 caracteres. Não existe usuário nem senha de fábrica, então ninguém pode entrar antes de você.

2. Preparar os discos (2 min)

Armazenamento → Criar volume. Só são oferecidos discos que podem ser usados: o do sistema nunca aparece, e um com dados dentro fica marcado para você não formatá-lo sem querer.

• Um disco só: serve, mas não protege de nada. Dá para começar.
• Dois ou mais: escolha espelho. Se um morrer, nada se perde e ele é trocado pelo painel. É a diferença entre um susto e uma perda.
• Btrfs ou ZFS: Btrfs se você não tiver certeza de qual (é o que pede menos memória); ZFS se for colocar muita RAM e quiser o máximo em integridade.

Ao terminar, o NAS cria sozinho as pastas do sistema (docker, vm) e três compartilhadas: Galeria para as fotos, Musica para as músicas e Peliculas para a videoteca.

3. Uma pasta e uma conta por pessoa (3 min)

Painel de controle → Pastas da casa → “Criar”. Dê um nome curto e sem acentos (ele viaja para o Windows, o Mac e o celular).

Painel de controle → Usuários e grupos → uma conta por pessoa, não uma compartilhada. É o que permite dar permissões diferentes, ver quem entrou e tirar o acesso de uma pessoa só sem trocar a senha da casa inteira.

Em cada pasta, o interruptor SMB a publica na rede. No Windows ela se abre com \\<ip-del-nas>; num Mac, com Cmd+K → smb://<ip-del-nas>.

4. O backup (3 min)

Este é o passo que ninguém faz e todo mundo lamenta. Um NAS com espelho protege contra a quebra de um disco; não protege de uma exclusão por engano, de um ransomware nem de um incêndio na casa. Para isso é preciso um backup FORA.

Backups → “Novo” → escolha quais pastas e para onde (um disco USB, outro dispositivo por SSH ou a sua nuvem). Guia completo: Backups.

E a única coisa que não é opcional: restaure um arquivo qualquer para verificar que o backup serve. Um backup nunca restaurado não é um backup, é uma pasta grande.

5. Fechar a porta (1 min)

• Painel de controle → Segurança → ative a verificação em duas etapas.
• Painel de controle → Firewall → ative-o. O painel e o SSH ficam sempre permitidos, então você não tem como ficar trancado do lado de fora.
• Painel de controle → Alertas → configure o e-mail ou o webhook e clique em “Enviar teste”. Sem isso, o NAS não tem como avisar que um disco está falhando.

E pronto

Daqui em diante, o resto se acrescenta quando for preciso: aplicativos, câmeras, acesso de fora ou VPN. O resto deste guia é a referência, assunto por assunto.

Armazenamento

• Criar volume: Armazenamento → “Criar volume”. O assistente só oferece discos elegíveis (nunca o disco do sistema). ZFS para máxima integridade (RAID-Z1/Z2), Btrfs para flexibilidade (RAID1/10). Formatar destrói os dados dos discos.
• Datasets: subdivisões com cota e compressão próprias (Volumes → Pastas do volume).
• Snapshots: aba Snapshots para os manuais; Painel de controle → Tarefas agendadas para os automáticos com retenção. A restauração ZFS usa rollback (elimina os snapshots posteriores); a do Btrfs cria uma cópia gravável restaurado-<data> para revisar antes.
• Saúde: a aba Saúde mostra o SMART e permite iniciar scrubs. Agende um scrub mensal com uma tarefa. Um disco com SMART “FALHANDO” deve ser substituído já: em “Discos dos pools” dessa mesma aba se troca o disco com defeito pelo novo (e se amplia o pool com discos adicionais) sem descer ao console.

Backups

Snapshots e RAID ficam dentro do dispositivo: não protegem de um incêndio, de um roubo nem de um ransomware. Para isso existe o app Backups, que tira os dados do NAS.

• Destinos: local (um disco USB conectado ao NAS ou outro pool) ou remoto por **rsync sobre SSH** (outro NAS ou servidor: a casa de um parente, o escritório, uma VPS). O NAS gera a sua própria chave SSH e basta autorizar a parte pública no dispositivo de destino. Cada destino é testado gravando de verdade nele antes de lhe confiar qualquer coisa. O painel lista também o S3 como indisponível, com o motivo: enviar para o S3 exige assinar cada requisição a partir do processo privilegiado, e esse processo só executa binários da allowlist. Ele está declarado no contrato da API para não quebrá-lo no dia em que for implementado, mas hoje a API recusa um destino S3 em vez de fingir que funciona.
• Tarefas: pastas de origem, destino, horário e quantas versões (ou quantos dias) são mantidas. Cada backup é incremental: só viaja o que mudou, e as versões anteriores se mantêm completas por meio de links físicos (rsync --link-dest), então ocupam pouco. Elas rodam com progresso como as outras tarefas longas e avisam pelos alertas se falharem (configure Painel de controle → Alertas: um backup que falha em silêncio não é um backup). A criptografia do destino ainda não está disponível e a API a recusa explicitamente: se o destino for um disco que sai de casa, criptografe-o você mesmo no dispositivo de destino (LUKS) ou guarde-o num lugar de confiança.
• Restauração pelo próprio app: você escolhe a versão e a pasta de destino. O histórico guarda cada execução com seu tamanho e seu erro exato.

O que copiar, com que frequência, como autorizar a chave passo a passo e —o mais importante— como verificar que o backup serve restaurando-o de verdade: backups.md.

Compartilhamento de arquivos

As pastas são compartilhadas em Pastas da casa, e os selos SMB, NFS e WebDAV de cada uma são clicáveis para ligar ou desligar esse protocolo sem abrir o editor.

O NAS aparece sozinho na rede. Com o SMB ligado não é preciso saber o IP nem configurar nada nos dispositivos: ele aparece em “Rede” do Windows, na barra lateral do Finder do macOS e no gerenciador de arquivos do Linux. Compartilhar e se anunciar são coisas diferentes, e por isso o firewall abre cinco portas, não duas:

As três últimas só anunciam que este dispositivo existe; não dão acesso a nada. Elas se abrem e se fecham com o interruptor do SMB, então desligá-lo retira todas.

Sobre o protocolo: é negociado o mais alto que os dois lados aceitarem, e com Windows 10/11, macOS e Linux modernos isso é o SMB 3.1.1 com criptografia. O mínimo fica no SMB2 de propósito, para não deixar de fora uma TV ou um scanner que só falem essa versão.

Quem vê o quê

Nega-se por padrão, e isso vale para todas as portas. Uma pasta da casa sem lista de permissões é dos administradores e de mais ninguém: não aparece ao conectar a \NAS, não se abre, e também não se chega a ela por NFS nem pelo console. Para alguém entrar, é preciso dar o acesso na aba Pastas da ficha dessa pessoa.

Os administradores entram sempre em todas, além do que disser cada lista. É a segunda volta da chave: se alguma verificação do painel falhar, continua sendo preciso ser administrador. A exceção é um “sem acesso” colocado de propósito sobre uma pessoa específica, que manda sobre todo o resto — inclusive se essa pessoa for administradora.

Minha unidade. Cada conta tem a sua pasta privada, em <volume>/homes/<conta>/archivos. Ela aparece em Arquivos e é também onde entra o SFTP da conta. É onde se guarda o que é de cada um sem montar uma pasta da casa, e já vem com as pastas Fotos, Música, Vídeos, Documentos e Downloads. Ninguém mais entra — nem as outras contas pela rede, nem digitando o caminho no painel — a não ser no que o dono compartilhar com o botão “Compartilhar” (Usuários e permissões). Nem quem administra, enquanto não ligar “Ver o conteúdo de todas as contas”.

Pela rede ela aparece como mais uma pasta da casa. Em Pastas da casa ela tem a sua linha, acima das outras, com um interruptor geral e os selos SMB, NFS e WebDAV; cada pessoa entra na sua e só na sua por qualquer um deles, sem permissões para distribuir:

• SMB, ligado de fábrica: ao conectar a \\NAS, como home ou com o nome da conta.
• NFS não pede senha, então só se liga com a lista de dispositivos que podem montá-la (o IP ou a rede deles), e só esses a montam.
• WebDAV a deixa em https://<NAS>:8081/~<conta> (ou na porta que o WebDAV tiver), para as contas com “Acesso web aos arquivos” na ficha. É também o caminho pelo qual o LGM Connect a abre de fora de casa.

Desligada, a “Minha unidade” não aparece por nenhum dos três, mas os arquivos não são tocados e ela continua visível em Arquivos. O SFTP é à parte: é dado na ficha de cada conta e sempre entra na “Minha unidade” dela, esteja o interruptor como estiver.

O que não é seu, não se vê. Nem no painel nem na lista de pastas do Windows: só são mostradas as pastas que essa conta pode abrir, então nem os nomes dá para ler. Um administrador entra em todas as pastas da casa, como sempre; as unidades dos outros ele só vê com “Ver o conteúdo de todas as contas” ligado, e só para olhar.

O Painel de controle, por função. Uma conta comum encontra ali três coisas: as informações do dispositivo, a sua senha e o seu segundo fator, e a região e a aparência. O resto são telas de administração e não são oferecidas a ela; se chegar a uma por um link direto, o painel avisa.

Uma pessoa, uma conta

Tudo é gerenciado em Usuários e grupos. Cada pessoa tem uma senha e quatro capacidades que são marcadas na ficha dela:

Desmarcar uma capacidade a retira de verdade (antes só se davam permissões, e desmarcar não fazia nada). A aba Pastas da ficha distribui o acesso pasta por pasta: sem acesso, leitura e gravação, ou só leitura, e mostra também o que a pessoa herda dos seus grupos. Ao salvar sem digitar senha, a que ela já tinha é mantida; só é preciso uma nova para cadastrá-la num serviço que ela ainda não tinha.

Na mesma ficha, “Conta infantil” (só para quem entra no painel, e só quem administra pode marcá-la): essa pessoa verá em Filmes e séries apenas o que estiver classificado como adequado até 12 anos, e nada do que não tiver classificação. O corte é feito pelo NAS e não pela tela, então não dá para contorná-lo colando o endereço de um filme. Veja “Filmes e séries”.

O painel não deixa ficar sem administrador: nem tirando o próprio acesso, nem rebaixando ou excluindo o último que restar.

Relatório de arquivos

Edição Empresarial. No “⋯” de cada pasta da casa, Relatório de arquivos mostra o maior, o que ninguém mexe há os meses que você escolher e quanto ocupa cada pessoa. É feito pelo mesmo medidor que mostra os tamanhos no Arquivos, pasta por pasta e sem pressa, então não deixa o NAS lento; numa pasta enorme pode demorar, e você pode fechar a janela enquanto isso. Se o volume não registra quando um arquivo é aberto, “sem mexer” quer dizer “sem alterar”, e o relatório avisa.

Um só caminho para toda a empresa

Edição Empresarial. Em Serviços de arquivos → SMB você pode criar uma pasta de rede —\\<NAS>\datos, com o nome que escolher— que reúne pastas deste NAS e de outros servidores. Quem a abre vê todas juntas e, ao entrar numa, o dispositivo vai ao servidor onde ela está, com as permissões de sempre.

• As deste NAS são escolhidas na lista; para outro servidor, digite o nome (nas2 ou nas2.empresa.local) e a pasta compartilhada.
• Ao adicionar uma, o painel verifica se esse servidor responde; se não, nada é salvo.
• Tirá-la do caminho não mexe na pasta de destino.

NFS com as contas do domínio

Edição Empresarial. Por NFS o NAS confia no dispositivo do outro lado, então a lista de dispositivos é a única barreira. Com o NAS ingressado num domínio (Serviço de diretório), a ficha de uma pasta com NFS deixa escolher Quem pode montá-la: os dispositivos da lista, como sempre, ou cada pessoa com a sua conta do domínio (Kerberos), com tudo assinado ou tudo criptografado. Assinado e criptografado são um pouco mais lentos, e o dispositivo precisa estar ingressado no mesmo domínio. Na primeira vez numa pasta, o NAS verifica se tem a sua chave de NFS no domínio; se não, nada é salvo e ele diz o que fazer.

Buscar arquivos

• A busca de Arquivos se apoia num índice de nomes que o NAS mantém sozinho: uma passada a cada dois minutos que só olha as pastas cuja data mudou, então não relê o disco inteiro nem se nota. Buscar passa a ser instantâneo e, sobretudo, completo: a varredura ao vivo desistia nas 60 000 entradas e respondia “há mais do que é mostrado”.
• O índice fica no estado do sistema (/var/nas/state/indice.db), não junto dos seus dados, e só guarda caminhos: quem pode ver o quê continua sendo decidido pela pasta da casa em cada busca. Ocupa pouco —uns 20 MB a cada 150 000 arquivos— e, se for apagado, é reconstruído sozinho.
• Da primeira vez demora o que levar para ler a árvore —de alguns segundos a uma noite, conforme quantos arquivos houver—, e enquanto isso a busca funciona como antes, varrendo.
• O que você cria, envia, move ou exclui pelo painel é registrado na hora; o que chegar por SMB ou NFS aparece na passada seguinte.
• Refinar a busca não exige apertar Enter de novo: uma vez dentro dos resultados, mudar a palavra os refaz sozinha. Só quando o índice está pronto; senão, a busca continua sendo feita ao apertar Enter, para não mandar o NAS varrer o disco a cada tecla.
• Buscar dentro do conteúdo (a caixa de seleção da busca) também se apoia no índice —pergunta a ele quais documentos existem e em que ordem, do mais recente ao mais antigo— mas os abre e os lê naquele momento, com seus limites: indexar o texto de tudo custaria disco e CPU de verdade.

As pastas do sistema

Em “Pastas da casa” aparecem também as que o próprio NAS cria: docker (os dados dos aplicativos), vm (os discos das máquinas virtuais), camaras (as gravações), Galeria (as fotos e os vídeos), Musica (as músicas) e Peliculas (a videoteca). Elas podem ser compartilhadas pela rede, ter lixeira e permissões, mas não são renomeadas, nem movidas, nem excluídas: tirá-las de baixo deixa as câmeras, a Galeria, a Música e os Filmes apontando para uma pasta que não existe mais. Elas têm o selo SISTEMA na lista, e as que já existiam no seu NAS o recebem ao atualizar. Dentro da sua “Minha unidade” você pode criar pastas com esses mesmos nomes: ali elas não reservam nada. Elas só aparecem quando o volume está preparado —tem as suas pastas docker, vm e appstore—, coisa que até agora só acontecia nos volumes criados pelo painel: um adotado ou vindo de uma reinstalação ficava sem elas. Agora o NAS confere isso a cada dez minutos e as cria se faltarem.

Fotos e vídeos (Galeria)

• O NAS cria uma pasta da casa “Galeria” na primeira vez que existe um volume: é o lugar óbvio para deixar as fotos (aparece em Arquivos, é compartilhada pela rede e o celular pode copiar o rolo da câmera para lá), e a Galeria sempre a indexa. É uma pasta do sistema, então não é renomeada nem excluída pelo painel. Sem acento porque o nome de uma pasta da casa viaja para o SMB, para o NFS e para um caminho do disco.
• A Galeria não copia nem move nada: lê as fotos e os vídeos que já estão nas suas pastas da casa e os organiza numa linha do tempo por meses.
• Ela se atualiza sozinha, a cada meia hora. O que chega por SMB —o backup do rolo da câmera do celular, que é como quase tudo chega— aparece sem ninguém clicar em nada; “Procurar fotos novas” continua existindo para quando você não quer esperar. Se você não escolher pastas, ela indexa “Galeria” e as compartilhadas cujo nome lembre fotos ou vídeos (Fotos, Photos, Imágenes, DCIM, Vídeos); pelo próprio app é possível escolhê-las à mão. Não entram nem a pasta das câmeras de vigilância nem uma videoteca de filmes: isso não são lembranças.
• O índice é um SQLite à parte e é preenchido em segundo plano: a primeira passada numa pasta grande demora, e o app avisa que está escaneando enquanto isso. Deixar de compartilhar uma pasta a tira do índice na passada seguinte.
• Os álbuns são listas, não pastas: uma foto pode estar em vários, e criar, renomear ou excluir um álbum não toca em um único arquivo do disco. Baixar um álbum gera um zip.
• Os vídeos são servidos por intervalos, então dá para pular para um minuto específico sem baixar o arquivo inteiro, e a miniatura deles é um quadro do segundo 1.
• Quais formatos entram: JPEG (incluindo .jfif), PNG, WebP, AVIF, GIF, BMP, TIFF, HEIC/HEIF (iPhone) e RAW de câmera —.cr2, .cr3, .nef, .nrw, .arw, .sr2, .rw2, .orf, .raf, .pef, .srw, .rwl, .3fr, .erf— incluindo o ProRAW do iPhone, que é um .dng. Em vídeo: .mp4, .mov, .m4v, .mkv, .webm, .avi, .3gp, .mts e .m2ts.
• O RAW não é revelado (isso exige um processador de imagem inteiro e segundos por foto): é mostrada a prévia que a câmera deixou dentro do arquivo, que é um JPEG quase em tamanho completo e é o que todas as galerias fazem. Quem a extrai é o exiftool; os HEIC são abertos pelo heif-convert. O LGM-OS os instala; se faltarem, essas fotos são indexadas do mesmo jeito, mas ficam sem miniatura e o painel avisa.
• Live Photos: o iPhone salva cada uma como dois arquivos (IMG_0042.HEIC e IMG_0042.MOV). A Galeria os reconhece pelo nome e mostra um único item, com a etiqueta “Live” e um botão no visualizador para ver o movimento. Antes apareciam as duas coisas e baixar uma pasta do celular duplicava a grade.
• Excluir pela Galeria manda para a lixeira do NAS: dá para recuperar pelo Arquivos.
• O localizador de duplicados agrupa por tamanho e pelo começo do arquivo, e nunca deixa excluir a última cópia que resta de uma foto.

Música

• O NAS cria uma pasta da casa “Musica” na primeira vez que existe um volume: é o lugar óbvio para deixar as músicas —aparece em Arquivos e é compartilhada pela rede, então a discoteca é arrastada do computador—, e a Música sempre olha para ela. É uma pasta do sistema: não é renomeada nem excluída pelo painel. Sem acento porque o nome de uma pasta da casa viaja para o SMB, para o NFS e para um caminho do disco.
• Não copia nem move nada: lê os arquivos de áudio que já estão nas suas pastas da casa e os organiza por artista, por álbum e por pasta. O índice é um SQLite à parte; apagá-lo não toca em nenhuma música, e a próxima varredura o refaz.
• Ela se atualiza sozinha. Verifica se algo mudou a cada dez minutos e faz uma passada completa a cada hora; “Buscar músicas” continua existindo para quando você não quer esperar.
• Se você não escolher pastas, ela olha em todas as compartilhadas. A música de uma casa está em “Música”, em “Discos”, em “CDs” e na pasta de cada um, então adivinhar pelo nome deixaria o app vazio sem dizer por quê; filtrar pela extensão não custa nada. Na própria tela dá para limitá-las (quem decide é quem administra: vale para a casa toda).
• Formatos: .mp3, .flac, .m4a, .aac, .ogg, .opus e .wav.
• Os títulos aparecem antes dos dados. Ao indexar, o nome do arquivo faz as vezes de título e o da pasta, de álbum, então dá para ouvir desde o primeiro momento; o artista, o ano, a faixa e a duração são lidos depois, em lotes e em segundo plano. Num dispositivo sem ffmpeg fica só no primeiro passo, e a tela diz isso numa linha.
• Capas: o cover.jpg (ou folder.jpg, ou front.jpg) da pasta do disco. Se não houver, é usada a que vem dentro do próprio arquivo, copiada sem recodificar. Um álbum sem nenhuma das duas aparece com a sua inicial: não é um erro.
• Completar pela internet (desligado de fábrica, quem administra o liga). O NAS envia os nomes dos seus artistas, discos e músicas para sete catálogos livres e sem chave —MusicBrainz, Cover Art Archive, Deezer, iTunes, TheAudioDB, Wikipedia e LRCLIB— e traz capa, data de lançamento, gêneros, nome correto do artista, a foto dele, a biografia e a letra das músicas. Nenhum arquivo nem dado seu é enviado, e nenhuma música é tocada. O que é da casa manda sempre: o ano das suas tags vence o do catálogo, e o cover.jpg e a capa embutida vencem a da internet. Completa-se aos poucos em segundo plano —os catálogos aceitam poucas requisições por segundo e o NAS respeita isso—; “Completar agora” faz um lote grande sem esperar.
• Corrigir à mão (com “Completar pela internet” ligado, e só quem administra). O emparelhamento automático prefere deixar um disco sem capa a colocar a de outro, então com uma pasta chamada “Disco 1” ele não reconhece nada. O botão Corrigir do cabeçalho de um disco, do de um artista e do menu de cada música procura esse nome no catálogo e mostra os candidatos com a capa: ao escolher um, a ficha dele é aplicada, e **o artista do disco vai para todas as músicas dele que não tiverem nenhum** —que é o que tira o “Sem artista” de meia discoteca ripada—. O que foi escolhido à mão não volta a ser emparelhado sozinho, e numa música dá para desfazer e voltar ao que dizia o arquivo.
• Reconhecer músicas sem tags (desligado de fábrica, quem administra o liga). As músicas que chegaram como Track01.mp3 —de um CD ripado sem consultar nada— são identificadas pelo som: o NAS calcula um resumo acústico dos dois primeiros minutos, pergunta ao catálogo livre AcoustID e coloca título, artista e disco. Nenhum arquivo é enviado, só esse resumo, e nenhuma música é tocada: o que foi reconhecido é gravado na biblioteca. Na linha de cada música há um botão para reconhecê-la na hora e, nas já reconhecidas, para voltar ao que dizia o arquivo. Só se olha o que parece sem tags (sem artista, ou com títulos como “Pista 3” ou “AudioTrack 07”); o que já está certo não é tocado. O que foi reconhecido entra depois em “Completar pela internet” como qualquer outra música, e assim recebe capa e data.
• É preciso uma chave gratuita: cadastre-se em acoustid.org/new-application e cole-a nas configurações da Música. Sem chave, a função se explica e não é ativada; a chave é verificada no AcoustID antes de ser salva e não viaja no backup.
• Letras: são pedidas ao abrir uma música, não ao indexar, e ficam salvas. Se a letra vier sincronizada, a linha que está tocando é destacada e tocar numa linha pula para aquele momento. Um arquivo .lrc ou .txt com o mesmo nome ao lado da música manda sobre a internet e funciona mesmo com “Completar pela internet” desligado.
• A música é servida por intervalos, então dá para pular para um minuto específico sem baixar a música inteira. Ela continua tocando ao trocar de aba e com a janela minimizada.
• As playlists e as favoritas são de cada um: mais ninguém as vê, e excluir uma playlist não toca em nenhum arquivo do disco.
• A fronteira é a de sempre: o que você não pode abrir em Arquivos não aparece aqui, nem o nome nem a capa.

Rádio

• Milhares de rádios da internet, na aba “Rádio”. Elas vêm do catálogo livre radio-browser.info: não é preciso criar nenhuma conta nem colar nenhuma chave.
• Dá para buscar por nome, por país (o seu já vem selecionado) e por tema. Sem buscar nada, são mostradas as mais ouvidas do seu país.
• O som passa pelo NAS, não pelo seu navegador. É isso que faz tocarem também as rádios que ainda transmitem sem criptografia —um navegador as bloqueia dentro de uma página segura, sem dizer nada— e, de quebra, a rádio vê uma única conexão em vez da de cada celular e cada computador da casa.
• Antes de tocar, verifica-se que a rádio está no ar. Um catálogo aberto tem rádios desligadas há anos: por isso o clique demora um segundo a mais e, quando algo não funciona, o painel diz o que aconteceu (“não começou a tocar em 10 segundos”) em vez de deixar o player mudo.
• Suas rádios são suas: as salvas e as últimas ouvidas mais ninguém vê, nem quem administra. Elas viajam no backup da configuração.
• Toca no player de sempre: continua tocando ao trocar de aba e é controlada pelas teclas de música do teclado e pela tela de bloqueio do celular.

Podcasts

• Assine pelo nome ou colando o endereço do RSS, na mesma caixa. Os nomes são buscados no catálogo público do iTunes; a partir daí o NAS fala diretamente com quem publica o podcast.
• Cada um segue os seus. Ninguém vê o que você assina nem onde você parou, nem quem administra. O programa é baixado UMA vez, mesmo que três pessoas da casa o sigam.
• Atualiza-se sozinho a cada seis horas, e “Atualizar” faz isso na hora. Se um programa deixar de responder, a ficha dele avisa e os episódios continuam lá.
• Avise-me sobre episódios novos: um interruptor por pessoa. Chega um aviso por programa e por passada, nunca um por episódio.
• Fica lembrado onde você parou em cada episódio, como em Filmes e séries, e dá para marcar como ouvido à mão. Aqui também o áudio passa pelo NAS, e pular para um minuto específico continua funcionando.
• O que é baixado é a lista de episódios, não o áudio: **os episódios não ocupam espaço no NAS**.

Filmes e séries

• O NAS cria uma pasta da casa “Peliculas” na primeira vez que existe um volume: é o lugar óbvio para deixar os filmes e as séries —aparece em Arquivos e é compartilhada pela rede, então eles são arrastados do computador—, e o aplicativo sempre olha para ela. É uma pasta do sistema: não é renomeada nem excluída pelo painel. Sem acento nem espaços porque o nome de uma pasta da casa viaja para o SMB, para o NFS e para um caminho do disco.
• Não copia nem move nada: lê os vídeos que já estão nas suas pastas da casa e os organiza em filmes e séries. O índice é um SQLite à parte; apagá-lo não toca em nenhum arquivo.
• Escolha as pastas (quem decide é quem administra: vale para a casa toda). Se você não escolher nenhuma, ele olha em “Peliculas” e nas compartilhadas cujo nome lembre uma videoteca (“Series”, “Cine”). As gravações das câmeras nunca entram.
• O nome do arquivo é a ficha. De “Origen (2010).mkv” ele tira o título e o ano; de “Serie.S01E02.mkv” ou “Serie - 1x02.mkv”, a série, a temporada e o episódio, e os agrupa. De fábrica nada é consultado fora, então o que se vê é o que está no arquivo: um nome bem dado faz toda a diferença.
• Completar pela internet (Configurações, e quem decide é quem administra). **Desligado de fábrica**, e desligado o NAS não conta a ninguém quais filmes você tem. Ligado, ele envia o título e o ano de cada filme e de cada série para o Wikidata, a Wikipedia e o TVmaze, e traz capa, sinopse, gêneros, data de estreia e os títulos dos episódios. Nada mais sai: nem caminhos, nem nomes de arquivo, nem quem assiste ao quê.
• Duas chaves opcionais e gratuitas. Com a do themoviedb.org (serve a “API Key (v3)” ou o token v4) as capas ficam melhores e chegam também o trailer, o elenco e a saga; com a do omdbapi.com, a nota do IMDb. Sem nenhuma funciona do mesmo jeito, com o que a Wikipedia e o TVmaze fornecem. Cada chave é testada ao ser salva: se o catálogo não a reconhecer, ela não é salva e o painel diz por quê. As chaves nunca saem do NAS e não viajam no backup da configuração.
• O que é da casa manda. Se ao lado do filme houver um .nfo (o que o Kodi, o Jellyfin e os organizadores de videoteca deixam), é dali que saem o título e a sinopse; e se o nome do arquivo ou da pasta tiver um identificador do IMDb (tt1375666), a ficha é pedida exata em vez de ser buscada pelo título.
• Completa-se sozinho, aos poucos, depois de cada busca de filmes; “Completar agora” faz um lote grande sem esperar. O que nenhum catálogo reconhece fica como está e não volta a ser perguntado; o que falhou pela rede é tentado de novo depois de algumas horas.
• “Corrigir”, na ficha, emparelha à mão: busca por título e ano e mostra as fichas candidatas com a capa para você escolher a certa.
• O trailer se abre fora, numa aba nova: dentro do painel não é incorporado nenhum player de terceiros.
• “Você pode gostar” e “Para você”. Na ficha de um filme ou de uma série aparece uma fileira com até oito títulos parecidos, e na tela inicial outra a partir do que você assistiu por último (ninguém vê a de outra pessoa). Só é recomendado o que ESTÁ no NAS e dentro das suas pastas: não há nada para ir buscar em lugar nenhum. Com chave do themoviedb.org são usadas as recomendações dele, cruzadas com a sua videoteca; sem chave, a comparação é por saga, gêneros e década, que é o que traz o “Completar pela internet”. Com essa função desligada não há com o que comparar e as fileiras não aparecem. O que foi calculado fica guardado uma semana; corrigir uma ficha à mão o refaz.
• Avisar sobre episódios novos (Configurações, abaixo de “Completar pela internet” e dependente dele: com aquele desligado, isto não pergunta nada). Uma vez por dia o catálogo é consultado, para cada série do NAS, sobre qual foi o seu último episódio exibido; se ele não estiver aqui, chega um aviso do painel com a temporada, o número, o título e a data em que foi exibido. Cada episódio é avisado uma única vez, mesmo que continue faltando. Com chave do themoviedb.org a pergunta é feita lá; sem nenhuma, ao TVmaze. Uma série emparelhada com o Wikidata ou com o OMDb não dá esse aviso: esses catálogos não listam os episódios com a data.
• Capas: manda sempre a imagem que estiver ao lado (Origen (2010).jpg, poster.jpg, folder.jpg); depois, a que tiver sido baixada do catálogo; e, se não houver nenhuma, o NAS tira um quadro dos 10 % do filme. Um filme sem nenhuma das três aparece com a sua inicial: não é um erro.
• Ele se atualiza sozinho. Verifica se algo mudou a cada dez minutos e faz uma passada completa a cada hora; “Procurar filmes” continua existindo para quando você não quer esperar.
• Reproduz no painel. O que o navegador abre do jeito que está é servido por intervalos (com os seus próprios saltos); o que não —um filme com som Dolby Digital, um MKV num iPhone— o NAS converte na hora, copiando o vídeo quando basta trocar o som. A tela diz quando está convertendo e por quê.
• Qualidade: ao lado das legendas, enquanto você assiste a algo. “Original” é o normal; 1080p, 720p e 480p pedem ao NAS que reduza a imagem, que é o necessário quando você assiste fora de casa ou num celular e o vídeo trava. Só aparecem as qualidades menores que a do filme. Muda-se sem perder o minuto, e a escolha fica nesse dispositivo para as próximas.
• Legendas: os .srt ou .vtt que estiverem ao lado do arquivo, com o idioma no nome se tiver (Origen (2010).en.srt). São convertidas na hora para o que o navegador entende.
• Trazê-las da internet. Na ficha de qualquer filme há um botão **“Procurar legendas”**: mostra o que há no catálogo para esse título no idioma do painel e baixa a que você escolher. O arquivo fica junto do filme (Origen (2010).es.srt), então a partir daí a casa toda o tem; se não for possível gravar nessa pasta, ele fica no NAS e funciona do mesmo jeito.
• As marcadas “Para este arquivo” são as sincronizadas com a sua cópia exata: o catálogo as emparelhou por uma impressão digital do arquivo, não pelo título. As outras podem estar adiantadas ou atrasadas em relação à sua versão.
• “Legendas automáticas” (Configurações, abaixo de “Completar pela internet” e desligado de fábrica): com ele ligado, ao abrir um filme que não traz legendas no seu idioma o NAS as procura uma vez e as deixa ativadas. O que ele não encontra não volta a ser perguntado sozinho; o botão de procurar à mão tenta de novo sempre que você clicar.
• Saem de casa o título, o ano e essa impressão digital do arquivo; nunca o caminho dele nem quem assiste. A fonte é o opensubtitles.org, e funciona sem se cadastrar em nada.
• Conta do opensubtitles.com, opcional. Sem ela, a busca e o download funcionam do mesmo jeito, com a cota diária compartilhada por todo mundo; com uma conta gratuita própria (chave, usuário e senha) a cota é sua. Ela é testada ao ser salva: se não for reconhecida, não é salva e o painel diz por quê. Nunca sai do NAS e não viaja no backup da configuração.
• Continue de onde parou. Cada conta guarda o seu próprio minuto e ninguém vê o dos outros; aos 95 % o filme é dado como terminado e sai de “Continuar assistindo”. Numa série, é oferecido o episódio seguinte.
• “Continuar assistindo” também na área de trabalho. Com o botão “+” do painel de widgets (no canto superior direito) se liga o widget “Continuar assistindo”: até seis filmes ou episódios pela metade com a capa e onde pararam, e um clique abre o aplicativo nesse filme. Só é oferecido a quem tem Filmes e séries.
• Contas infantis. Marcando “Conta infantil” na ficha de uma pessoa (Painel de controle → Usuários e grupos), essa conta só vê aqui o que estiver classificado como adequado até 12 anos: o catálogo, as séries, a busca, “Continuar assistindo” e o player. O corte é feito pelo NAS, não pela tela, então colar o endereço de um filme não adequado também não o abre. O que não tem classificação também não aparece, então ligue o “Completar pela internet” —é de lá que ela vem— ou a videoteca dessa conta ficará quase vazia. O aplicativo diz isso numa linha, para não parecer quebrado.
• A fronteira é a de sempre: o que você não pode abrir em Arquivos não aparece aqui, nem o nome nem a capa.

Aplicativos (Docker)

• Central de pacotes: instala as receitas da casa (/var/nas/appstore/templates/), que chegam com cada versão do NAS: 1058 aplicativos de outros desenvolvedores, selecionados e testados por nós, cada um com a sua versão fixa. Nenhum catálogo de terceiros é baixado.
• Busca, chips de categoria com contadores e filtro “Instalados” para navegar pelo catálogo.
• O botão “⟳” de um app instalado baixa a imagem nova e recria os contêineres.
• O app Docker mostra os logs ao vivo, CPU/RAM e controla contêineres individuais. Um contêiner criado à mão (pelo terminal, por exemplo) que publique uma porta TCP tem o seu botão “Abrir” e aparece no Launchpad como mais um aplicativo.

Atualizar o LGM-OS sem reinstalar

Pelo painel: Painel de controle → Atualizar o LGM-OS → “Atualizar agora”. Só isso. Não é preciso passar a ISO de novo a cada versão, nem ter acesso ao código, nem configurar um repositório: o NAS pergunta ao servidor do fabricante qual é a última versão, baixa e a instala.

O que acontece por dentro, caso algum dia seja preciso olhar:

1. O NAS pede a última versão publicada e a compara com a sua. Ele compara números, não texto: a 1.10.0 é posterior à 1.9.0.
2. Baixa o pacote e verifica o SHA-256 dele contra o que o servidor anunciou. Se não bater, não instala nada e diz isso com essas palavras: o que chegou não é o que o servidor disse que ia chegar, o que é muito diferente de “o download falhou”.
3. Aplica a atualização com o mesmo procedimento de sempre: compila, valida e só então promove. Se depois o painel não responder, reverte sozinho para a versão anterior.

Pelo console: sudo lgm update.

Opções

• Automático: “Procurar atualizações automaticamente” avisa em Notificações quando há uma versão nova; “Instalá-las sem perguntar” as aplica sozinho a cada 6/12/24 horas ou a cada 7 dias, e só dentro do horário que você escolher (de fábrica, das 03:00 às 06:00): a atualização reinicia os serviços e os gravadores das câmeras, e de madrugada não incomoda ninguém. Fora do horário, o aviso chega do mesmo jeito.
• A partir do seu próprio código (só se você clonou o repositório): se o dispositivo tiver um checkout do git com remoto, o painel o usa em vez do servidor de versões. É o caminho de quem desenvolve; para um NAS instalado pela ISO nada disso é necessário.

O que o NAS conta para o site

A cada doze horas o NAS pergunta ao servidor de versões se a licença —ou o período de teste— continua valendo, e na mesma chamada conta como ele se chama, que versão tem, quanto espaço resta e se há avisos pendentes: é o que você vê na ficha do seu NAS na sua conta do site. Viajam também a impressão digital do certificado do painel e os endereços dele dentro da sua rede de casa, que é como o app LGM Connect encontra o NAS sem sair para a internet.

Com esse mesmo aviso viajam os dados técnicos do dispositivo, para podermos ajudar você se algo falhar: fabricante e modelo da placa, processador, memória, os discos (modelo, tamanho, tipo e estado de saúde), como os volumes estão montados, o tipo de placas de rede e de vídeo, e quantos apps, máquinas virtuais e câmeras existem. Sem números de série, sem endereços de rede e sem nada seu dentro (nem nomes de arquivos, nem contas). Eles são desligados em Painel de controle → Licença → Dados técnicos e suporte, e Ver o que é enviado —em “Algo deu errado?”— mostra exatamente o que sai. As versões novas chegam em ondas: cada dispositivo recebe num dia diferente dos primeiros, e “Instalar mesmo assim” a instala antes da vez dele.

Durante a atualização

Você verá uma barra com a fase e uma porcentagem aproximada —backup, pacotes do sistema, preparar a interface, backend, reiniciar serviços—. O passo longo é instalar os pacotes do sistema: pode demorar vários minutos sem dar sinais, e isso é normal. A interface já chega pronta e é colocada em segundos. O painel reinicia no meio: a barra avisa e continua contando assim que ele volta.

Ao terminar, o atualizador verifica se tudo o que estava ligado continua ligado (Docker, Samba, libvirt, NFS…) e, se algo ficou parado, o inicia e diz o nome. Também se a atualização falhar: uma versão que desiste no meio não pode deixar você sem contêineres nem sem pastas da casa.

Se falhar

O aviso vermelho traz as últimas linhas do registro —que é onde está o erro— e uma lista suspensa com o registro completo. Pelo console:

sudo tail -n 40 /var/log/lgm-update.log

Como a atualização reverte sozinha, o NAS continua funcionando com a versão anterior: não há pressa para resolver. A causa habitual é ficar sem espaço no disco do sistema, e o painel diz isso com essas palavras.

Verificação dos serviços

Painel de controle → Verificação do sistema revisa um por um o painel, o armazenamento, SMB, NFS, WebDAV, SSH, Docker, os backups e as câmeras. Ela não olha o que o painel tem salvo que deveria acontecer: olha o sistema —se a unidade do systemd está viva, se há algo escutando na porta, se o firewall deixa passar, se a configuração bate com o que foi pedido— e cada problema vem com o que fazer.

É a primeira coisa a abrir quando algo “não funciona” a partir de outro dispositivo: ela diz se a falha está no NAS ou fora dele, que é metade do trabalho.

Monitor de recursos

O que o NAS esteve fazendo enquanto você não olhava. O app Monitor guarda o uso de processador, memória, disco e rede e o desenha em quatro gráficos, com o intervalo a escolher: última hora, dia, semana ou mês.

Serve para responder às três perguntas que um número instantâneo não responde:

• “Está lento… desde quando?” — um degrau no gráfico de CPU ou de memória diz o dia e quase a hora em que começou, o que costuma coincidir com um aplicativo instalado ou com um backup novo.
• “Está ficando sem memória?” — um teto plano em 100 % durante horas é isso; picos pontuais ao copiar arquivos são normais.
• “Estou aproveitando a rede?” — o gráfico de rede durante uma cópia grande diz se o gargalo é o disco ou o cabo.

O histórico é gravado pelo próprio NAS a cada poucos minutos e ocupa muito pouco: não é preciso ligar nada, ele já está rodando. Ao reinstalar ou ao destruir o volume ele começa do zero, porque é histórico, não dados.

A área de trabalho

O painel inteiro vive numa área de trabalho com janelas, igual no navegador e no LGM Connect.

Áreas de trabalho virtuais e central de controle

• Há três áreas de trabalho, cada uma com as suas janelas. Para trocar, use Ctrl+Alt+← / →, deslize dois dedos de lado sobre o fundo ou use as áreas de trabalho da bandeja do dock. Para levar uma janela para outra, clique com o botão direito na barra de título → «Mover para outra área de trabalho». Ao recarregar, cada janela volta para a sua área de trabalho.
• Ctrl+Espaço abre a Central de controle: todos os apps e configurações que a sua conta pode abrir, organizados, e as configurações deste dispositivo, com a letra grande à mão.

O botão direito e o toque longo

• O botão direito abre um menu em todo lugar: o fundo, a barra de cima, as janelas, os widgets, o dock, Aplicativos e dentro de cada app. Nos campos de texto continua aparecendo o do navegador, para copiar e colar.
• Os menus têm submenus e mostram os seus atalhos, e funcionam com as setas, Enter e Esc.
• No fundo ficam «Atualizar a área de trabalho» e «Ajustes rápidos» (tema, widgets e barra). Na barra de título de uma janela: minimizar, maximizar, encaixar em meia tela, trocar de área de trabalho ou fechar. Sobre um app em Aplicativos: abrir, colocar na área de trabalho ou fixar na barra.
• No celular, mantenha o dedo meio segundo em qualquer lugar: aparece o mesmo menu, e confirmar dá uma vibraçãozinha.

O dock e os widgets

• De fábrica, o dock traz os apps do dia a dia que a sua conta pode abrir, e os abertos no fim, depois de um traço. Um ponto marca o app aberto, um balão os avisos não lidos dele, e o ícone mostra o andamento das tarefas dele. Se você já tinha deixado do seu jeito, fica como estava.
• Ele tem três modos, no botão direito → «Configurar a barra»: «Sempre visível», «Esconder sozinha» e «Flutuante compacta».
• No fim do dock fica a bandeja do sistema: as áreas de trabalho, a rede do NAS, desligar ou reiniciar e «Sua conta», onde estão os seus dados e «Sair».
• Cada widget escolhe o seu tamanho — «Pequeno (meia linha)», «Largo (linha inteira)» ou «Grande» — no menu «⋯» ou com o botão direito, que também recolhe, configura, duplica ou remove o widget. Isso fica salvo com a sua conta, então segue você para outro dispositivo.

IA local

O app IA local responde a partir do próprio NAS, sem mandar nada para fora. Quem administra o NAS liga e escolhe o modelo; depois libera o app em Painel de controle → Usuários e grupos como qualquer outro (de fábrica, mais ninguém tem).

• Cada conta, a sua. Cada pessoa com a permissão usa a IA com as suas pastas e os seus documentos: resumir, deixar uma planilha na sua pasta, organizar a sua área de trabalho. O que cada conta conversa, e o que a IA lembra dela, só ela vê, nem quem administra.
• Conversas salvas. Em «Conversas» há várias, com nome, salvas no NAS: continuam lá ao fechar a janela ou recarregar. «Começar outra conversa» abre uma nova.
• Usa o painel com as suas permissões. Ela procura a ação, deixa o botão para você ir até a tela e, se algo mudaria o NAS, mostra antes o que vai fazer e espera você tocar em «Aprovar». Nunca pode mais do que você, e o que lê num documento trata como dado, não como ordem. «Parar» corta na hora. Para quem administra, ela também pode instalar um app da Central de pacotes ou medir a velocidade dos discos, sempre com aprovação.
• O estado do NAS. Pergunte como o NAS está e ela responde com o cartão **«Como o NAS está agora»**: um veredito — Bem, Atenção ou Grave — com os números (discos, temperaturas, rede, placa de vídeo) e o guia de onde sai cada passo; cada citação abre o seu guia. Ao abrir, ela sugere o que vale a pena conferir: um disco quente, um backup que falhou, um volume quase cheio.
• «Perguntar à IA», no botão direito de um contêiner, um disco, um arquivo, um aviso ou um widget, pergunta sobre aquilo sem você precisar explicar.
• «Explique de um jeito simples», embaixo de cada resposta, junto de copiar e perguntar de novo, repete a resposta sem palavras técnicas.

A aba Placas de vídeo

O antigo app Vídeo e IA agora é a aba Placas de vídeo da IA local, e só quem administra vê: cada placa de vídeo e dispositivo de IA do NAS, quanto é usado e quais aplicativos estão com ele. Se você tinha um atalho para o app antigo, ele não existe mais: abra IA local → Placas de vídeo.

Terminal web

Shell real no navegador, só para administradores. Ele começa como o usuário do serviço (nas, sem privilégios), e o botão “Sessão root” abre um shell de administrador. Os dois —e também o console de um contêiner, no Docker— pedem antes para confirmar a senha e o código do segundo fator, se você o tiver ativado (ou uma chave de acesso): a permissão é um token de uso único que expira em 60 segundos e só abre o console para o qual foi pedido. A sessão root é criada pelo assistente privilegiado (o serviço do painel roda com NoNewPrivileges=yes, onde o sudo não funciona) e cada abertura fica registrada na auditoria. Dali você pode instalar o que quiser (docker run …, apt install …); se o que você iniciar publicar uma porta web, ele aparecerá no Docker e no Launchpad.

Licença e período de teste

Existe uma licença Doméstica (pagamento único, com um ano de atualizações que é estendido ano a ano), uma Vitalícia (atualizações para sempre) e a Empresarial (mensal, anual ou vitalícia). Tudo é feito em Painel de controle → Licença, que mostra também a contagem regressiva das atualizações que restam.

• Quando as atualizações acabam, o NAS continua funcionando por inteiro: só não instala as versões publicadas depois. Atualizar o LGM-OS avisa e leva a lgm-os.com para adicionar um ano ou passar para Vitalícia; a licença estendida chega sozinha ao NAS em poucas horas.
• Se uma assinatura Empresarial for cancelada, ao acabar o período pago o NAS continua como doméstico: as funções de empresa desligam e nada é apagado.
• Vincular a sua conta. Clique em Vincular minha conta: o painel mostra um código e um endereço do lgm-os.com. Abra-o em qualquer dispositivo —o celular serve—, entre com a sua conta gratuita e escolha o que fazer com esse NAS: começar o teste ou **usar uma licença sua**. O painel fica sabendo sozinho em poucos segundos; não é preciso copiar nenhuma chave.
• O teste dura 60 dias e libera tudo menos o endereço do LGM Túnel, que é da licença. É um por dispositivo e da conta que o começou: reinstalar continua o mesmo teste, com a mesma data de término.
• Um NAS recém-instalado tem 7 dias para ser vinculado. Até lá ele funciona inteiro e o painel lembra você disso.
• Se você tiver várias licenças, ao vincular você escolhe qual vai nesse dispositivo e dá a ela um nome (“Casa”, “Escritório”) para distingui-las na sua conta.
• Com uma licença comprada não é preciso vincular nada: **Tenho uma chave → Colar uma chave** continua funcionando como sempre.

Quando o teste acaba: “só dados”

Sem licença, ao acabar o teste —ou os 7 dias sem vincular— o NAS fica em só dados. Os seus dados nunca ficam retidos:

• Continua funcionando o que serve para levá-los: entrar no painel, **ver e baixar todos os seus arquivos, as pastas da casa só para leitura** a partir dos seus dispositivos, o estado dos discos e os avisos deles, atualizar o sistema, desligar e reiniciar.
• Fica em pausa todo o resto: os apps e as máquinas virtuais param, as câmeras deixam de gravar e os backups e as tarefas agendadas não rodam. A VPN e o nome de casa continuam funcionando: se você estiver fora, pode entrar para buscar os seus arquivos e para ativar a licença.
• Nada é excluído. Ao ativar uma licença, o que estava em funcionamento volta a iniciar do jeito que você deixou.

Algo deu errado?

Algo deu errado? fica na barra superior da área de trabalho —no celular, é o primeiro item da central de controle— e em Painel de controle → Licença. Ele envia um relatório para o suporte: o que você escrever, a versão e o app que estava falhando. Se você deixar a caixa marcada, vão junto os dados técnicos do dispositivo e as últimas linhas de erro do painel, das quais o NAS retira antes senhas, endereços com credenciais, e-mails e caminhos de pastas pessoais. Ninguém entra no seu NAS: o relatório é a única coisa que sai.

Sistema

• Nome do dispositivo: o que você definiu ao instalar é alterado em **Painel de controle → Informações do dispositivo, com o botão Alterar** que fica ao lado do nome. Só letras minúsculas, números e hífens (de 1 a 63, sem começar nem terminar com hífen): é um nome de máquina, não um título. É o endereço pelo qual se entra no NAS (https://<nome>.local:5001), então ao alterá-lo é preciso atualizar os favoritos da casa toda. O NAS volta a se anunciar sozinho na rede (o Finder do Mac e “Rede” do Windows); o certificado do painel leva o nome dentro e é refeito na próxima reinicialização, então até lá o navegador avisa ao entrar pelo nome novo.
• Rede: IP estático/DHCP por interface via systemd-networkd. ⚠️ Um erro aqui pode deixar o NAS inacessível; tenha um console físico à mão.
• Hora: o fuso horário e a sincronização por NTP ficam em **Painel de controle → Região e idioma. Logo abaixo, Servidores de hora** permite escrever os seus, um por linha (pool.ntp.org, ou o endereço do roteador, que quase sempre dá a hora). Vazio = os que vêm com o sistema, que é o normal; eles são alterados quando a rede não tem saída para a internet ou tem a porta 123/UDP fechada, porque com o relógio errado os certificados expiram antes da hora e as tarefas agendadas disparam fora de hora.
• Tela do servidor (modo quiosque): se o dispositivo tiver um monitor conectado (ou o console da sua máquina virtual), ele inicia mostrando este mesmo painel em tela cheia, como qualquer outro sistema operacional, e continua sendo administrado pela web a partir do resto da rede como antes. Ele só é instalado quando há tela e se desliga com um interruptor em Painel de controle → Informações do dispositivo.

O console nunca desaparece: o painel ocupa o terminal 7 e o login de sempre fica no 1. Se a tela quebrar —o X não inicia, o navegador fecha, o painel não responde— com Ctrl+Alt+F1 você tem um console de verdade, e Ctrl+Alt+F7 volta ao painel. Pelo console, lgm kiosk off o desliga, lgm kiosk log diz por que está falhando e lgm kiosk on o liga de novo.

• Atualizações do sistema operacional: não são feitas pelo painel. Um apt upgrade sem supervisão pode reiniciar serviços ou deixá-los pela metade sem ninguém na frente; quem quiser atualizar o Debian tem o terminal. O que é atualizado pelo painel é o LGM-OS, que é código próprio e sabe se reiniciar sozinho.
• Backup da configuração: download avulso ou tarefa agendada do tipo “backup” para um pool. Leva todo o estado do painel (usuários, grupos, pastas da casa com as suas permissões, serviços, firewall, rede, tarefas…) menos os segredos do dispositivo, que são gerados de novo. Não inclui os seus dados (para isso existe o app Backups); guarde-o dentro do backup externo, porque é a primeira coisa de que você vai precisar ao reconstruir o dispositivo. Detalhes e restauração em disaster-recovery.md.
• Registros: journald por unidade; Auditoria: quem fez o quê e de qual IP.
• Enviar os registros para outro dispositivo (syslog): Painel de controle → Central de registros → Enviar os registros para outro dispositivo. Manda uma cópia de tudo o que o NAS registra para um servidor de registros da sua rede (dispositivo, porta —514 por padrão— e UDP ou TCP). Serve para ter tudo junto e, sobretudo, para que o rastro fique fora do NAS se alguém o invadir. Ao salvar, o destino é testado: com TCP a resposta é de verdade, e com UDP só se verifica que o dispositivo existe na rede, porque ninguém confirma um datagrama. Quem faz isso é o rsyslog, que o LGM-OS instala e deixa desligado até você ativar isto; num NAS instalado antes da 1.65 ele pode estar faltando, e a tela diz como instalá-lo.

Restaurar configurações de fábrica

Painel de controle → Restaurar configurações de fábrica deixa o painel como no primeiro dia sem reinstalar nem mexer nos discos: para quando o NAS muda de dono ou você prefere começar a configuração do zero. Só quem administra o vê.

Como se confirma. São necessárias três coisas: a sua senha, o código de duas etapas se a sua conta o tiver e um código de oito letras e números que só aparece na tela conectada ao NAS. Clique em Pedir o código e veja-o lá (se essa tela mostrar o painel, aperte Ctrl+Alt+F1). Ele expira em dez minutos, aceita três tentativas e tem que ser digitado à mão, porque é o que prova que você está com o NAS à sua frente. Sem tela conectada não dá: conecte uma. Também não dá enquanto houver em andamento algo que move dados —um backup, uma restauração, uma troca de disco— ou uma atualização: a tela diz o que é e que você deve esperar.

O que acontece depois. Antes de apagar qualquer coisa, o NAS guarda uma cópia das configurações atuais no disco do sistema, em /var/nas/apartados/fabrica-<data>. Ao terminar, o painel é reiniciado e pede para você criar a conta de administrador, como no primeiro dia, com o código de cadastro da tela do NAS. O primeiro aviso diz onde ficou essa cópia e, se algo não pôde ser removido, o que é e o que fazer com isso. Pelo painel não dá para desfazer.

Os seus dados continuam nos volumes: se o NAS sair de casa e você quiser apagá-los também, exclua o pool em Armazenamento.

Segurança

• Arquitetura de dois processos: a API roda como usuário nas sem privilégios e delega ao nas-helper (root) por um socket Unix; o assistente privilegiado só aceita uma lista fechada de comandos e caminhos (backend/app/core/allowlist.py).
• TLS: autoassinado gerado na primeira inicialização, com os endereços do dispositivo dentro e com validade de 396 dias —abaixo do limite de 398 que o iOS e o iPadOS aceitam; com mais que isso, um iPhone não deixa entrar no painel nem com o aviso—. Ele é revisado a cada inicialização e só é refeito se estiver para expirar ou se o NAS mudar de IP; o seu ou o do Let's Encrypt não são tocados. O normal é substituí-lo por um do Let's Encrypt ao publicar o NAS (veja Acesso pela internet); para colocar um seu à mão: ```bash cp tucert.pem /etc/nas/tls/cert.pem && cp tuclave.pem /etc/nas/tls/key.pem chgrp nas /etc/nas/tls/key.pem && chmod 640 /etc/nas/tls/key.pem systemctl restart nas-backend ```
• Proteção do login: 10 tentativas/minuto por IP; 5 falhas seguidas bloqueiam a conta por 5 minutos. Tudo fica na auditoria.
• Duração da sessão: de fábrica o painel se fecha sozinho depois de 30 minutos sem uso, e isso se altera em Painel de controle → Segurança → Regras da senha → **Duração da sessão** (de 5 a 1440 minutos). Não é um prazo rígido: cada coisa que você faz prolonga a sessão, então trabalhando ela nunca é cortada, e o que expira é um painel aberto e esquecido. Quem marcar “manter a sessão iniciada” ao entrar continua com 30 dias, e as sessões já abertas duram o que lhes foi dado: o prazo novo vale a partir do próximo acesso.
• Funções: admin (total) e viewer (só leitura), gerenciadas em Segurança.
• Nunca abra a porta 5001 no roteador: ela serve o painel com certificado autoassinado e expõe a API de administração sem nada na frente. Esse improviso não é mais necessário, porque há dois jeitos melhores de chegar de fora e o NAS traz os dois: a VPN —WireGuard, ou Tailscale e NetBird— (não publica nenhum serviço na internet) ou o **acesso externo** com Apache nas portas 80/443 e certificado válido do Let's Encrypt. São as duas seções a seguir.

Acesso pela internet

Painel de controle → Acesso externo: domínio dinâmico (DDNS), certificado do Let's Encrypt e proxy reverso para publicar o painel e os apps por subdomínio. O Apache fica como único serviço exposto (80 e 443) e encaminha para 127.0.0.1; a porta 5001 e as dos apps não saem do NAS. Com um certificado válido, além disso, a interface pode ser instalada como aplicativo (PWA).

O procedimento completo —portas do roteador, DuckDNS passo a passo, emissão e renovação do certificado, subdomínios e a lista de segurança prévia (2FA, Consultor de segurança, bloqueio de IPs)— está em external-access.md. Alternativa mais conservadora se você não precisa compartilhar com terceiros: a VPN do próprio NAS (seção seguinte), sem expor nenhum serviço.

Serviços de rede (VPN, DNS e DHCP)

Painel de controle → VPN, DNS e DHCP. As três peças que transformam o NAS no centro da rede de casa, ordenadas por risco:

• A VPN é o jeito mais seguro de chegar ao NAS de fora: não publica nenhum serviço na internet e dá acesso a toda a rede local, não só ao painel.
• O Tailscale e o NetBird são instalados pela mesma tela, nas suas abas, e são o caminho quando você não consegue abrir portas (CGNAT). O que entra por eles conta como da casa no firewall.
• O DNS e o DHCP são o mesmo serviço (dnsmasq), então pará-lo interrompe os dois: é justamente o que se precisa numa emergência (sudo systemctl stop dnsmasq).
• O dnsmasq é instalado desativado e só inicia quando você ativa o DNS ou o DHCP pelo painel.

Portas do roteador, instalação do cliente de VPN passo a passo, como apontar os dispositivos para o DNS e —o mais importante— como recuperar a rede se o DHCP deixar você sem conexão: network-services.md. Leia antes de ativar o DHCP, e guarde no celular: se você ficar sem rede, não vai conseguir consultá-lo pelo NAS.

Publicar apps no catálogo

Cada app é um diretório /var/nas/appstore/templates/<id>/ com:

• manifest.json — id, nome, descrição, images (pré-baixadas com progresso), web_port e env (variáveis que o instalador pede ao usuário; secret as oculta).
• docker-compose.yml — consome essas variáveis mais NAS_APP_DATA (caminho de dados que o backend injeta).

Instalar exige um pool: os dados de cada app ficam em <pool>/docker/<id>/ (as instalações anteriores a esta política continuam em /var/nas/apps/ e não são movidas). Essa pasta docker não é uma pasta da casa —o gerenciador de arquivos e o SMB/NFS não a mostram— e o nome dela é reservado ao criar pastas da casa. Cada porta que o app publicar (e, se ele compartilhar a rede do NAS, as que a receita dele declara) recebe ao instalá-lo uma regra no firewall com o nome do app, aberta à rede de casa. Em Segurança → Firewall ela é fechada ou aberta a qualquer origem; essa escolha volta se ele for reinstalado, e a regra é retirada ao desinstalar.

Para um repositório remoto, sirva por https um index.json:

{
  "apps": [
    {
      "id": "jellyfin",
      "manifest_url": "https://repo.example.com/jellyfin/manifest.json",
      "compose_url": "https://repo.example.com/jellyfin/docker-compose.yml",
      "sha256_manifest": "<sha256>",
      "sha256_compose": "<sha256>"
    }
  ]
}

Console da frota

Edição Empresarial. O app Frota mostra num relance todos os LGM-OS da empresa: se estão bem, os avisos não lidos, discos e volumes, capacidade, último backup bem-sucedido e versão, com a atualização pendente. Ele fala com cada NAS pelo painel criptografado de sempre (5001): não abre nenhuma porta nova. Um NAS que não responde aparece com o motivo e com os últimos dados conhecidos, sem atrasar os outros.

Adicionar um NAS. No NAS que você quer ver, abra Frota → Este NAS e crie uma chave: Só visualizar (lê o resumo dele e nada mais) ou Visualizar e atualizar (além disso, pode iniciar a atualização). No console, clique em “Adicionar um NAS”, digite o endereço e cole a chave. Antes de enviá-la, o console mostra a impressão digital do certificado desse NAS: compare com a que aparece em Frota → Este NAS e, se não for a mesma, não continue.

Um certificado que muda. A partir daí, o console só fala com esse NAS se o certificado for assinado pela mesma autoridade: a renovação anual não dispara alarme, mas um NAS reinstalado (ou alguém se passando por ele) aparece como “Certificado alterado” e não recebe a chave. Depois de reinstalá-lo, use “Comparar a impressão digital de novo”.

Atualizar em grupo. Marque “Incluir na atualização” nos NAS que quiser e clique em “Atualizar os selecionados”. Eles são atualizados um de cada vez, na ordem da lista, e se um falhar para ali: os outros ficam como estavam.

As chaves. As chaves dos outros NAS são guardadas à parte, fora do backup da configuração, e o painel não as mostra de novo. Se você restaurar a configuração em outro dispositivo, adicione cada NAS de novo. Para um console deixar de ver um NAS, revogue a chave dele nesse NAS (Frota → Este NAS).