Guia de administração do LGM-OS

58 min · 22 secções

Este documento é o manual do dia a dia: cobre de uma ponta à outra o que se faz a partir do painel. Quando um tema precisa de mais pormenor do que cabe aqui, tem um guia próprio:

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

Os primeiros dez minutos

Este é o caminho completo desde que ligas o dispositivo até teres o NAS a fazer algo útil. Está pensado para ser feito de seguida, por ordem, e cada passo diz porque é que importa —os que se saltam por não se perceberem são precisamente os que fazem falta no dia mau—.

1. Entrar (1 min)

Abre https://<ip-do-nas>:5001. O IP aparece na própria consola do dispositivo ao arrancar.

O certificado é autoassinado e o navegador avisa: é normal numa máquina da tua casa —aceita-o—. Se te incomodar, substitui-se mais tarde por um a sério (ver Acesso a partir da internet).

O assistente de primeiro acesso pede-te para criar o administrador: nome em minúsculas e palavra-passe com pelo menos 8 caracteres. Não há utilizador nem palavra-passe de fábrica, por isso ninguém pode entrar antes de ti.

2. Preparar os discos (2 min)

Armazenamento → Criar volume. Só te propõe discos que se podem usar: o do sistema nunca aparece, e um com dados lá dentro fica assinalado para que não o formates sem querer.

• Um só disco: serve, mas não protege de nada. Chega para começar.
• Dois ou mais: escolhe espelho. Se um morrer, não se perde nada e troca-se a partir do painel. É a diferença entre um susto e uma perda.
• Btrfs ou ZFS: Btrfs se não tens a certeza de qual (é o que pede menos memória); ZFS se vais pôr muita RAM e queres o máximo em integridade.

No fim, o NAS cria sozinho as pastas do sistema (docker, vm) e três partilhadas: Galeria para as fotografias, Musica para as canções e Peliculas para a videoteca.

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

Painel de controlo → Pastas da casa → «Criar». Dá-lhe um nome curto e sem acentos (viaja para o Windows, para o Mac e para o telemóvel).

Painel de controlo → Utilizadores e grupos → uma conta por pessoa, não uma partilhada. É o que permite dar permissões diferentes, ver quem entrou e tirar o acesso a uma só pessoa sem mudar a palavra-passe da casa toda.

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

4. A cópia de segurança (3 min)

Este é o passo que ninguém faz e de que toda a gente se arrepende. Um NAS com espelho protege de um disco avariar; não protege de uma eliminação por engano, de um ransomware nem de um incêndio em casa. Para isso é preciso uma cópia FORA.

Cópias de segurança → «Nova cópia» → escolhe que pastas e para onde (um disco USB, outro dispositivo por SSH ou a tua nuvem). Guia completo: Cópias de segurança.

E a única coisa que não é opcional: restaura um ficheiro qualquer para verificar que a cópia serve. Uma cópia nunca restaurada não é uma cópia, é uma pasta grande.

5. Fechar a porta (1 min)

• Painel de controlo → Segurança → ativa a verificação em dois passos.
• Painel de controlo → Firewall → ativa-a. O painel e o SSH ficam sempre permitidos, por isso não podes ficar trancado lá fora.
• Painel de controlo → Alertas → configura o e-mail ou o webhook e carrega em «Enviar teste». Sem isto, o NAS não tem forma de te avisar de que um disco está a falhar.

E já está

A partir daqui, o resto acrescenta-se quando for preciso: aplicações, câmaras, acesso de fora ou VPN. O resto deste guia é a referência, tema a tema.

Armazenamento

• Criar volume: Armazenamento → «Criar volume». O assistente só propõe 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 quota e compressão próprias (Volumes → Pastas do volume).
• Instantâneos: separador Instantâneos para os manuais; Painel de controlo → Tarefas agendadas para os automáticos com retenção. O restauro ZFS usa rollback (elimina os instantâneos posteriores); o de Btrfs cria uma cópia gravável restaurado-<data> para rever antes.
• Saúde: o separador Saúde mostra o SMART e permite lançar scrubs. Agenda um scrub mensal com uma tarefa. Um disco com SMART «A FALHAR» deve ser substituído já: em «Discos dos pools» desse mesmo separador troca-se o disco avariado pelo novo (e amplia-se o pool com discos adicionais) sem descer à consola.

Cópias de segurança

Instantâneos e RAID vivem dentro do dispositivo: não protegem de um incêndio, de um roubo nem de um ransomware. Para isso existe a app Cópias de segurança, que tira os dados do NAS.

• Destinos: local (um disco USB ligado ao NAS ou outro pool) ou remoto por **rsync sobre SSH** (outro NAS ou servidor: casa de um familiar, o escritório, um VPS). O NAS gera a sua própria chave SSH e basta autorizar a parte pública no dispositivo de destino. Cada destino é testado escrevendo nele a sério antes de lhe confiar nada. O painel lista ainda o S3 como não disponível, com o motivo: carregar para S3 exige assinar cada pedido a partir do processo privilegiado, e esse processo só executa binários da allowlist. Está declarado no contrato da API para não o partir no dia em que for implementado, mas hoje a API rejeita um destino S3 em vez de fingir que funciona.
• Tarefas: pastas de origem, destino, horário e quantas versões (ou quantos dias) se guardam. Cada cópia é incremental: só viaja o que mudou, e as versões anteriores mantêm-se completas através de ligações físicas (rsync --link-dest), por isso ocupam pouco. Correm com progresso como as restantes tarefas longas e avisam pelos alertas se falharem (configura Painel de controlo → Alertas: uma cópia que falha em silêncio não é uma cópia). A cifragem do destino ainda não está disponível e a API rejeita-a explicitamente: se o destino for um disco que sai de casa, cifra-o tu no dispositivo de destino (LUKS) ou guarda-o num sítio de confiança.
• Restauro a partir da própria app: escolhes a versão e a pasta de destino. O histórico guarda cada execução com o seu tamanho e o erro exato.

O que copiar, com que frequência, como autorizar a chave passo a passo e —o mais importante— como verificar que a cópia serve restaurando-a a sério: backups.md.

Partilha de ficheiros

As pastas partilham-se a partir de Pastas da casa, e os distintivos SMB, NFS e WebDAV de cada uma carregam-se 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: aparece em «Rede» do Windows, na barra lateral do Finder do macOS e no explorador de ficheiros do Linux. Partilhar e anunciar-se são coisas diferentes, e por isso a firewall abre cinco portas, não duas:

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

Sobre o protocolo: negocia-se o mais alto que as duas partes admitam, e com Windows 10/11, macOS e Linux modernos isso é SMB 3.1.1 com cifragem. O mínimo fica no SMB2 de propósito, para não deixar de fora uma televisão ou um digitalizador que só falem essa versão.

Quem vê o quê

Nega-se por omissão, e 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 ligar a \NAS, não se abre, e também não se chega a ela por NFS nem pela consola. Para alguém entrar é preciso dar-lho no separador Pastas da sua ficha.

Os administradores entram sempre em todas, além do que diga cada lista. É a segunda volta à chave: se alguma verificação do painel falhar, continua a ser preciso ser administrador. A exceção é um «sem acesso» posto de propósito sobre uma pessoa concreta, que se sobrepõe a tudo o resto — também se essa pessoa for administradora.

A minha unidade. Cada conta tem a sua pasta privada, em <volume>/homes/<conta>/archivos. Aparece em Ficheiros e é também onde entra o seu SFTP. É onde se deixa o que é de cada um sem montar uma pasta da casa, e traz já feitas as suas pastas Fotos, Música, Vídeos, Documentos e Transferências. Mais ninguém entra — nem as outras contas pela rede, nem escrevendo o caminho no painel — a não ser no que o dono partilhar com o botão «Partilhar» (Utilizadores e permissões). Nem quem administra, enquanto não ligar «Ver o conteúdo de todas as contas».

Na rede aparece como mais uma pasta da casa. Em Pastas da casa tem a sua linha, acima das outras, com um interruptor geral e os distintivos 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 ligar a \\NAS, como home ou com o nome da conta.
• NFS não pede palavra-passe, por isso só se liga com a lista de dispositivos que a podem montar (o seu IP ou a sua rede), e só esses a montam.
• WebDAV deixa-a em https://<NAS>:8081/~<conta> (ou na porta que o WebDAV tiver), para as contas com «Acesso web aos ficheiros» na sua ficha. É também o caminho pelo qual o LGM Connect a abre fora de casa.

Desligada, «A minha unidade» não aparece por nenhum dos três, mas os ficheiros não são tocados e continua a ver-se em Ficheiros. O SFTP é à parte: dá-se na ficha de cada conta e entra sempre na sua «A minha unidade», esteja o interruptor como estiver.

O que não é teu não se vê. Nem no painel nem na lista de pastas do Windows: só se mostram as pastas que essa conta pode abrir, por isso nem os nomes se leem. Um administrador entra em todas as pastas da casa, como sempre; as unidades dos outros só as vê com «Ver o conteúdo de todas as contas» ligado, e só para ver.

O Painel de controlo, por função. Uma conta normal encontra lá três coisas: a informação do dispositivo, a sua palavra-passe e o seu segundo fator, e a região e o aspeto. O resto são ecrãs de administração e não lhe são propostos; se chegar a um por uma ligação direta, é-lhe dito.

Uma pessoa, uma conta

Tudo se gere em Utilizadores e grupos. Cada pessoa tem uma palavra-passe e quatro capacidades que se marcam na sua ficha:

Desmarcar uma capacidade retira-a de verdade (antes só se davam permissões, e desmarcar não fazia nada). O separador Pastas da sua ficha distribui o acesso pasta a pasta: sem acesso, leitura e escrita, ou só leitura, e mostra também o que herda dos seus grupos. Ao guardar sem escrever palavra-passe mantém-se a que já tinha; só é precisa uma nova para a registar num serviço que ainda não tinha.

Na mesma ficha, «Conta infantil» (só para quem entra no painel, e só a define quem administra): essa pessoa verá em Filmes e séries unicamente o que estiver classificado como adequado até aos 12 anos, e nada do que não tiver classificação. O corte é feito pelo NAS e não pelo ecrã, por isso não se contorna colando o endereço de um filme. Ver «Filmes e séries».

O painel não deixa ficar sem administrador: nem tirando o acesso a si próprio, nem despromovendo ou eliminando o último que resta.

Relatório de ficheiros

Edição Empresarial. No «⋯» de cada pasta da casa, Relatório de ficheiros mostra o maior, o que ninguém mexe há os meses que escolheres e quanto ocupa cada pessoa. É feito pelo mesmo medidor que mostra os tamanhos em Ficheiros, pasta a pasta e sem pressa, por isso não trava o NAS; numa pasta enorme pode demorar, e podes fechar a janela entretanto. Se o volume não regista quando se abre um ficheiro, «sem mexer» quer dizer «sem alterar», e o relatório diz.

Um só caminho para toda a empresa

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

• As deste NAS escolhem-se da lista; para outro servidor escreve-se o nome (nas2 ou nas2.empresa.local) e a pasta partilhada.
• Ao adicionar uma, o painel verifica que esse servidor responde; se não, não se guarda.
• 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, por isso a lista de dispositivos é a única barreira. Com o NAS associado a um domínio (Serviço de diretório), a ficha de uma pasta com NFS deixa escolher Quem a pode montar: os dispositivos da lista, como sempre, ou cada pessoa com a sua conta do domínio (Kerberos), com tudo assinado ou tudo cifrado. Assinado e cifrado são um pouco mais lentos, e o dispositivo tem de estar associado ao mesmo domínio. Na primeira vez numa pasta, o NAS verifica que tem a sua chave de NFS no domínio; se não, não se guarda e diz-te o que fazer.

Procurar ficheiros

• A pesquisa de Ficheiros apoia-se num índice de nomes que o NAS mantém sozinho: uma passagem a cada dois minutos que só olha para as pastas cuja data mudou, por isso não relê o disco inteiro nem se nota. Procurar passa a ser instantâneo e, sobretudo, completo: o percurso em direto desistia às 60 000 entradas e devolvia «há mais do que o que se mostra».
• O índice vive no estado do sistema (/var/nas/state/indice.db), não junto aos teus dados, e só guarda caminhos: quem pode ver o quê continua a ser decidido pela pasta da casa em cada pesquisa. Ocupa pouco —uns 20 MB por cada 150 000 ficheiros— e, se for eliminado, volta a construir-se sozinho.
• Da primeira vez demora o que demorar a ler a árvore —de uns segundos a uma noite, conforme o número de ficheiros—, e entretanto a pesquisa funciona como antes, a percorrer.
• O que crias, carregas, moves ou eliminas no painel fica registado no momento; o que chegar por SMB ou NFS aparece na passagem seguinte.
• Afinar a pesquisa não pede para voltar a carregar em Enter: já dentro dos resultados, mudar a palavra refá-los sozinha. Só quando o índice está pronto; se não estiver, continua a procurar-se ao carregar em Enter, para não pôr o NAS a percorrer o disco a cada tecla.
• Procurar dentro do conteúdo (a caixa da pesquisa) também se apoia no índice —pergunta-lhe que documentos há e por que ordem, do mais recente para o mais antigo— mas abre-os e lê-os nesse momento, com os seus limites: indexar o texto de tudo custaria disco e CPU a sério.

As pastas do sistema

Em «Pastas da casa» aparecem também as que o próprio NAS cria: docker (os dados das aplicações), vm (os discos das máquinas virtuais), camaras (as gravações), Galeria (as fotografias e os vídeos), Musica (as canções) e Peliculas (a videoteca). Podem ser partilhadas pela rede, ter reciclagem e permissões, mas não se lhes muda o nome, nem se movem, nem se eliminam: tirá-las de baixo deixa as câmaras, a Galeria, a Música e os Filmes a apontar para uma pasta que já não existe. Têm a etiqueta SISTEMA na lista, e as que já existiam no teu NAS recebem-na ao atualizar. Dentro da tua «A minha unidade» podes criar pastas com esses mesmos nomes: aí não reservam nada. Só aparecem quando o volume está preparado —tem as suas pastas docker, vm e appstore—, coisa que até agora só acontecia nos volumes criados a partir do painel: um adotado ou vindo de uma reinstalação ficava sem elas. O NAS revê isto agora a cada dez minutos e cria-as se faltarem.

Fotografias e vídeos (Galeria)

• O NAS cria uma pasta da casa «Galeria» da primeira vez que há um volume: é o sítio evidente para deixar as fotografias (vê-se em Ficheiros, partilha-se pela rede e o telemóvel pode copiar para lá o rolo da câmara), e a Galeria indexa-a sempre. É uma pasta do sistema, por isso não se lhe muda o nome nem se elimina a partir do 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 fotografias e os vídeos que já estão nas tuas pastas da casa e ordena-os numa linha do tempo por meses.
• Atualiza-se sozinha, a cada meia hora. O que chega por SMB —a cópia do rolo da câmara do telemóvel, que é como chegam quase todas— aparece sem ninguém carregar em nada; «Procurar fotos novas» continua lá para quando não queres esperar. Se não escolheres pastas, indexa «Galeria» e as partilhadas cujo nome soe a fotografias ou vídeos (Fotos, Photos, Imágenes, DCIM, Vídeos); na própria app podem escolher-se à mão. Não entram nem a pasta das câmaras de vigilância nem uma videoteca de filmes: isso não são recordações.
• O índice é um SQLite à parte e preenche-se em segundo plano: a primeira passagem de uma pasta grande demora, e a app diz que está a analisar entretanto. Deixar de partilhar uma pasta tira-a do índice na passagem seguinte.
• Os álbuns são listas, não pastas: uma fotografia pode estar em vários e criar, mudar o nome ou eliminar um álbum não toca num único ficheiro do disco. Transferir um dá um zip.
• Os vídeos são servidos por intervalos, por isso pode saltar-se para um minuto concreto sem transferir o ficheiro inteiro, e a sua miniatura é uma imagem do segundo 1.
• Que formatos entram: JPEG (incluindo .jfif), PNG, WebP, AVIF, GIF, BMP, TIFF, HEIC/HEIF (iPhone) e RAW de câmara —.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 pede um processador de imagem inteiro e segundos por fotografia): mostra-se a pré-visualização que a câmara deixou dentro do ficheiro, que é um JPEG quase em tamanho completo e é o que fazem todas as galerias. Quem a tira é o exiftool; os HEIC abre-os o heif-convert. O LGM-OS instala-os; se faltarem, essas fotografias são indexadas na mesma mas ficam sem miniatura e o painel di-lo.
• Live Photos: o iPhone guarda cada uma como dois ficheiros (IMG_0042.HEIC e IMG_0042.MOV). A Galeria reconhece-os pelo nome e mostra um só elemento, com a etiqueta «Live» e um botão no visualizador para ver o movimento. Antes apareciam as duas coisas e transferir uma pasta do telemóvel duplicava a grelha.
• Eliminar a partir da Galeria envia para a reciclagem do NAS: recupera-se em Ficheiros.
• O detetor de duplicados agrupa por tamanho e início do ficheiro, e nunca deixa eliminar a última cópia que resta de uma fotografia.

Música

• O NAS cria uma pasta da casa «Musica» da primeira vez que há um volume: é o sítio evidente para deixar as canções —vê-se em Ficheiros e partilha-se pela rede, por isso a discoteca arrasta-se a partir do computador—, e a Música olha sempre para ela. É uma pasta do sistema: não se lhe muda o nome nem se elimina a partir do 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 ficheiros de áudio que já estão nas tuas pastas da casa e ordena-os por artista, por álbum e por pasta. O índice é um SQLite à parte; eliminá-lo não toca numa única canção, e a análise seguinte refá-lo.
• Atualiza-se sozinha. Vê se algo mudou a cada dez minutos e faz uma passagem completa a cada hora; «Procurar música» continua lá para quando não queres esperar.
• Se não escolheres pastas, olha para todas as partilhadas. A música de uma casa está em «Música», em «Discos», em «CDs» e na pasta de cada um, por isso adivinhar pelo nome deixaria a app vazia sem dizer porquê; filtrar por extensão não custa nada. No próprio ecrã podem limitar-se (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 ficheiro faz de título e o da pasta de álbum, por isso pode ouvir-se desde o primeiro momento; o artista, o ano, a faixa e a duração leem-se depois, por lotes e em segundo plano. Num dispositivo sem ffmpeg fica pelo primeiro e o ecrã di-lo numa linha.
• Capas: o cover.jpg (ou folder.jpg, ou front.jpg) da pasta do disco. Se não houver, tira-se a que vem dentro do próprio ficheiro, copiando-a sem recodificar. Um álbum sem nenhuma das duas é desenhado com a sua inicial: não é um erro.
• Completar a partir da internet (desligado de fábrica, quem o liga é quem administra). O NAS envia os nomes dos teus artistas, discos e canções a 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 sua fotografia, a sua biografia e a letra das canções. **Não se envia nenhum ficheiro nem nenhum dado teu, e não se toca numa única canção.** O que é da casa manda sempre: o ano das tuas etiquetas ganha ao do catálogo, e o cover.jpg e a capa incorporada ganham à da internet. Completa-se aos poucos em segundo plano —os catálogos aceitam poucos pedidos por segundo e o NAS respeita-o—; «Completar agora» faz um lote longo sem esperar.
• Corrigir à mão (com «Completar a partir da internet» ligado, e só quem administra). O emparelhamento automático prefere deixar um disco sem capa a pôr-lhe a de outro, por isso com uma pasta chamada «Disco 1» não reconhece nada. O botão Corrigir do cabeçalho de um disco, do de um artista e do menu de cada canção procura esse nome no catálogo e mostra os candidatos com a sua capa: ao escolher um aplica-se a sua ficha, e **o artista do disco vai para todas as suas canções que não tenham nenhum** —que é o que tira o «Sem artista» de meia discoteca extraída de CD—. O que foi escolhido à mão não volta a ser emparelhado sozinho, e numa canção pode desfazer-se para voltar ao que dizia o seu ficheiro.
• Reconhecer canções sem etiquetas (desligado de fábrica, quem o liga é quem administra). As canções que chegaram como Track01.mp3 —de um CD extraído sem consultar nada— são identificadas pelo seu som: o NAS calcula um resumo acústico dos dois primeiros minutos, pergunta-o ao catálogo livre AcoustID e põe-lhe **título, artista e disco. Não se envia nenhum ficheiro, só esse resumo, e não se toca numa única canção**: o reconhecido é escrito na biblioteca. Na linha de cada canção há um botão para a reconhecer no momento e, nas já reconhecidas, para as **devolver ao que dizia o seu ficheiro**. Só se olha para o que parece sem etiquetas (sem artista, ou com títulos como «Faixa 3» ou «AudioTrack 07»); o que já está bem não se toca. O reconhecido entra depois em «Completar a partir da internet» como qualquer outra canção, e assim recebe capa e data.
• É precisa uma chave gratuita: regista-te em acoustid.org/new-application e cola-a nas definições da Música. Sem chave a função explica-se e não se ativa; a chave é verificada junto do AcoustID antes de ser guardada e não viaja na cópia de segurança.
• Letras: pedem-se ao abrir uma canção, não ao indexar, e ficam guardadas. Se a letra vier sincronizada, a linha que está a tocar é realçada e tocar numa linha salta para esse momento. Um ficheiro .lrc ou .txt com o mesmo nome junto à canção sobrepõe-se à internet e funciona mesmo que «Completar a partir da internet» esteja desligado.
• A música é servida por intervalos, por isso pode saltar-se para um minuto concreto sem transferir a canção inteira. Continua a tocar ao mudar de separador e com a janela minimizada.
• As listas de reprodução e as favoritas são de cada um: mais ninguém as vê, e eliminar uma lista não toca num único ficheiro do disco.
• A fronteira é a de sempre: o que não podes abrir em Ficheiros não aparece aqui, nem o nome nem a capa.

Rádio

• Milhares de estações da internet, no separador «Rádio». Vêm do catálogo livre radio-browser.info: não é preciso criar nenhuma conta nem colar nenhuma chave.
• Procura-se por nome, por país (o teu vem predefinido) e por tema. Sem procurar nada mostram-se as mais ouvidas do teu país.
• O som passa pelo NAS, não pelo teu navegador. É o que faz com que toquem também as estações que ainda emitem sem cifra —um navegador bloqueia-as dentro de uma página segura, sem dizer nada— e, de caminho, a estação vê uma só ligação em vez da de cada telemóvel e cada computador da casa.
• Verifica-se que a estação toca antes de a pôr. Um catálogo aberto tem estações desligadas há anos: por isso carregar demora mais um segundo e, quando algo não funciona, diz-se o que se passa («não começou a tocar em 10 segundos») em vez de deixar o leitor mudo.
• As tuas estações são tuas: as guardadas e as últimas ouvidas não as vê mais ninguém, nem quem administra. Viajam na cópia da configuração.
• Toca no leitor de sempre: continua a tocar ao mudar de separador e controla-se com as teclas de música do teclado e a partir do ecrã de bloqueio do telemóvel.

Podcasts

• Subscreve pelo nome ou colando o endereço do RSS, na mesma caixa. Os nomes procuram-se 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 subscreves nem por onde vais, nem quem administra. O programa é transferido UMA vez mesmo que o sigam três pessoas da casa.
• Atualiza-se sozinho a cada seis horas, e «Atualizar» fá-lo no momento. Se um programa deixar de responder, a sua ficha di-lo e os seus episódios continuam lá.
• Avisar-me dos episódios novos: um interruptor por pessoa. Chega um aviso por programa e por passagem, nunca um por episódio.
• Lembra-se de por onde ias em cada episódio, como em Filmes e séries, e pode marcar-se como ouvido à mão. Também aqui o áudio passa pelo NAS, e saltar para um minuto concreto continua a funcionar.
• O que se transfere é 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» da primeira vez que há um volume: é o sítio evidente para deixar os filmes e as séries —vê-se em Ficheiros e partilha-se pela rede, por isso arrastam-se a partir do computador—, e a aplicação olha sempre para ela. É uma pasta do sistema: não se lhe muda o nome nem se elimina a partir do painel. Sem acentos 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 tuas pastas da casa e ordena-os em filmes e séries. O índice é um SQLite à parte; eliminá-lo não toca num único ficheiro.
• Escolhe as pastas (decide quem administra: vale para a casa toda). Se não escolheres nenhuma, olha para «Peliculas» e para as partilhadas cujo nome soe a videoteca («Series», «Cine»). As gravações das câmaras nunca entram.
• O nome do ficheiro é a ficha. De «Origen (2010).mkv» 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 agrupa-os. De fábrica não se consulta nada de fora, por isso o que se vê é o que está no ficheiro: um nome bem posto faz toda a diferença.
• Completar a partir da internet (Definições, e decide quem administra). **Desligado de fábrica, e desligado o NAS não conta a ninguém que filmes tens. Ligado, envia o título e o ano de cada filme e de cada série para a Wikidata, para a Wikipedia** e para o TVmaze, e traz capa, sinopse, géneros, data de estreia e os títulos dos episódios. Não sai mais nada: nem caminhos, nem nomes de ficheiros, nem quem vê o quê.
• Duas chaves opcionais e gratuitas. Com a de themoviedb.org (serve a «API Key (v3)» ou o token v4) as capas são melhores e chegam ainda o trailer, o elenco e a saga; com a de omdbapi.com, a nota do IMDb. Sem nenhuma funciona na mesma, com o que dão a Wikipedia e o TVmaze. Cada chave é testada ao guardá-la: se o catálogo não a reconhecer, não se guarda e diz-se porquê. As chaves nunca saem do NAS e não viajam na cópia da configuração.
• O que é da casa manda. Se ao lado do filme houver um .nfo (o que deixam o Kodi, o Jellyfin e os organizadores de videoteca), é daí que saem o título e a sinopse; e se o nome do ficheiro ou da pasta tiver um identificador do IMDb (tt1375666), a ficha é pedida exata em vez de ser procurada pelo título.
• Completa-se sozinha, aos poucos, depois de cada procura de filmes; «Completar agora» faz um lote longo sem esperar. O que nenhum catálogo reconhece fica como está e não se volta a perguntar; o que falhou por causa da rede tenta-se novamente passadas umas horas.
• «Corrigir», na ficha, emparelha à mão: procura por título e ano e mostra as fichas candidatas com a sua capa para escolher a certa.
• O trailer abre-se fora, num separador novo: dentro do painel não se incorpora nenhum leitor de terceiros.
• «Também podes gostar» e «Para ti». Na ficha de um filme ou de uma série aparece uma fila com até oito títulos parecidos, e na página inicial outra a partir do que viste por último (ninguém vê a de outro). Só se recomenda o que ESTÁ no NAS e dentro das tuas pastas: não há nada para ir buscar a lado nenhum. Com chave do themoviedb.org usam-se as suas recomendações e cruzam-se com a tua videoteca; sem chave compara-se por saga, géneros e década, que é o que traz «Completar a partir da internet». Com essa função desligada não há nada com que comparar e as filas não aparecem. O que é calculado guarda-se uma semana; corrigir uma ficha à mão refá-lo.
• Avisar de episódios novos (Definições, por baixo de «Completar a partir da internet» e dentro dele: com aquele desligado, isto não pergunta nada). Uma vez por dia pergunta-se ao catálogo, por cada série do NAS, qual foi o seu último episódio emitido; se esse não estiver aqui, chega um aviso do painel com a temporada, o número, o título e a data em que foi emitido. De cada episódio avisa-se uma só vez, mesmo que continue a não estar. Com chave do themoviedb.org pergunta-se lá; sem nenhuma, ao TVmaze. Uma série emparelhada com a Wikidata ou com o OMDb não dá este aviso: esses catálogos não listam os episódios com a sua data.
• Capas: manda sempre a imagem que estiver ao lado (Origen (2010).jpg, poster.jpg, folder.jpg); depois, a que tiver sido transferida do catálogo; e se não houver nenhuma, o NAS tira uma imagem dos 10 % do filme. Um filme sem nenhuma das três é desenhado com a sua inicial: não é um erro.
• Atualiza-se sozinha. Vê se algo mudou a cada dez minutos e faz uma passagem completa a cada hora; «Procurar filmes» continua lá para quando não queres esperar.
• Reproduz-se no painel. O que o navegador abre tal como 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-o em tempo real, copiando o vídeo quando basta mudar o som. O ecrã diz quando está a converter e porquê.
• Qualidade: ao lado das legendas, enquanto vês algo. «Original» é o normal; 1080p, 720p e 480p pedem ao NAS que reduza a imagem, que é o que faz falta quando estás a ver fora de casa ou num telemóvel e vai aos soluços. Só aparecem as qualidades inferiores à do filme. Muda-se sem perder o minuto e fica escolhida nesse dispositivo para as seguintes.
• Legendas: os .srt ou .vtt que estiverem ao lado do ficheiro, com o idioma no nome se o tiver (Origen (2010).en.srt). Convertem-se em tempo real 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 transfere a que escolheres. O ficheiro é deixado junto ao filme (Origen (2010).es.srt), por isso a partir desse momento a casa toda o tem; se nessa pasta não se puder escrever, fica no NAS e vê-se na mesma.
• As marcadas «Para este ficheiro» são as que estão sincronizadas com a tua cópia exata: o catálogo emparelhou-as por uma impressão digital do ficheiro, não pelo título. As outras podem estar adiantadas ou atrasadas em relação à tua versão.
• «Legendas automáticas» (Definições, por baixo de «Completar a partir da internet» e desligado de fábrica): com ele ligado, ao abrir um filme que não traz legendas no teu idioma o NAS procura-as uma vez e deixa-as postas. O que não encontra não volta a ser perguntado sozinho; o botão de procurar à mão volta a tentar sempre que carregares nele.
• Sai de casa o título, o ano e essa impressão digital do ficheiro; nunca o seu caminho nem quem o vê. A fonte é o opensubtitles.org, e funciona sem te registares em nada.
• Conta do opensubtitles.com, opcional. Sem ela procura-se e transfere-se na mesma, com a quota diária partilhada por toda a gente; com uma conta gratuita própria (chave, utilizador e palavra-passe) a quota é tua. É testada ao guardá-la: se não a reconhecerem, não se guarda e diz-se porquê. Nunca sai do NAS e não viaja na cópia da configuração.
• Continua onde paraste. Cada conta guarda o seu próprio minuto e ninguém vê o dos outros; aos 95 % o filme dá-se por terminado e sai de «Continuar a ver». Numa série é proposto o episódio seguinte.
• «Continuar a ver» também no ambiente de trabalho. Com o botão «+» do painel de quadros (em cima à direita) liga-se o quadro «Continuar a ver»: até seis filmes ou episódios a meio com a sua capa e por onde vão, e um clique abre a aplicação nesse filme. Só é proposto a quem tiver Filmes e séries.
• Contas infantis. Marcando «Conta infantil» na ficha de uma pessoa (Painel de controlo → Utilizadores e grupos), essa conta só vê aqui o que estiver classificado como adequado até aos 12 anos: o catálogo, as séries, a pesquisa, «Continuar a ver» e o leitor. O corte é feito pelo NAS, não pelo ecrã, por isso 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, por isso liga «Completar a partir da internet» —é daí que vem— ou a videoteca dessa pessoa ficará quase vazia. A aplicação di-lo numa linha, para que não pareça avariada.
• A fronteira é a de sempre: o que não podes abrir em Ficheiros não aparece aqui, nem o nome nem a capa.

Aplicações (Docker)

• Centro de pacotes: instala as receitas da casa (/var/nas/appstore/templates/), que chegam com cada versão do NAS: 1058 aplicações de outros programadores, selecionadas e testadas por nós, cada uma com a sua versão fixa. Não se transfere nenhum catálogo de terceiros.
• Pesquisa, etiquetas de categoria com contadores e filtro «Instaladas» para andar pelo catálogo.
• O botão «⟳» de uma app instalada transfere a imagem nova e recria os contentores.
• A app Docker mostra registos em direto, CPU/RAM e controla contentores individuais. Um contentor criado à mão (a partir do terminal, por exemplo) que publique uma porta TCP tem o seu botão «Abrir» e aparece no Launchpad como mais uma aplicação.

Atualizar o LGM-OS sem reinstalar

A partir do painel: Painel de controlo → Atualizar o LGM-OS → «Atualizar agora». Mais nada. Não é preciso voltar a passar a ISO 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, transfere-a e instala-a.

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

1. O NAS pede a última versão publicada e compara-a com a sua. Compara números, não texto: a 1.10.0 é posterior à 1.9.0.
2. Transfere o pacote e verifica o seu SHA-256 contra o que o servidor anunciou. Se não coincidir, não instala nada e di-lo com essas palavras: o que chegou não é o que o servidor disse que ia chegar, o que é muito diferente de «a transferência falhou».
3. Aplica a atualização com o mesmo procedimento de sempre: compila, valida e só então promove. Se o painel não responder depois, reverte sozinho para a versão anterior.

A partir da consola: 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» aplica-as sozinhas a cada 6/12/24 horas ou a cada 7 dias, e só dentro do intervalo que escolheres (de fábrica, das 03:00 às 06:00): a atualização reinicia os serviços e os gravadores das câmaras, e de madrugada não incomoda ninguém. Fora do intervalo o aviso chega na mesma.
• A partir do teu próprio código (só se tiveres clonado o repositório): se o dispositivo tiver um checkout de git com remoto, o painel usa-o em vez do servidor de versões. É o caminho de quem desenvolve; para um NAS instalado a partir da ISO não é preciso nada disto.

O que o NAS conta à web

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

Com esse mesmo aviso viajam os dados técnicos do dispositivo, para te poder ajudar se algo falhar: fabricante e modelo da placa, processador, memória, os discos (modelo, tamanho, tipo e estado de saúde), como estão montados os volumes, o tipo de placas de rede e gráfica, e quantas apps, máquinas virtuais e câmaras há. Sem números de série, sem endereços de rede e sem nada teu lá dentro (nem nomes de ficheiros, nem contas). Desligam-se em Painel de controlo → Licença → Dados técnicos e suporte, e Ver o que é enviado —em «Algo correu mal?»— mostra exatamente o que sai. As versões novas chegam por vagas: a cada dispositivo calha num dia diferente dos primeiros, e «Instalar mesmo assim» instala-a antes de lhe calhar.

Durante a atualização

Vais ver uma barra com a fase e uma percentagem aproximada —cópia de segurança, 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 chega já preparada e fica no lugar em segundos. O painel reinicia-se a meio: a barra di-lo e continua a contar assim que ele volta.

No fim, o atualizador verifica que tudo o que estava ligado continua ligado (Docker, Samba, libvirt, NFS…) e, se algo ficou parado, arranca-o e diz o seu nome. Também se a atualização falhar: uma versão que desiste a meio não te pode deixar sem contentores nem sem pastas da casa.

Se falhar

O aviso vermelho traz as últimas linhas do registo —que é onde está o erro— e uma lista expansível com o registo completo. A partir da consola:

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

Como a atualização reverte sozinha, o NAS fica a funcionar com a versão anterior: não há pressa em resolvê-lo. A causa habitual é ficar sem espaço no disco do sistema, e o painel di-lo com essas palavras.

Verificação dos serviços

Painel de controlo → Verificação do sistema revê um a um o painel, o armazenamento, SMB, NFS, WebDAV, SSH, Docker, as cópias de segurança e as câmaras. Não olha para o que o painel tem guardado que devia acontecer: olha para o sistema —se a unidade do systemd está viva, se há algo a escutar na porta, se a firewall o deixa passar, se a configuração bate certo 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: diz se a falha está no NAS ou fora dele, que é metade do trabalho.

Monitor de recursos

O que o NAS esteve a fazer enquanto não estavas a olhar. A app Monitor guarda o uso de processador, memória, disco e rede e desenha-o em quatro gráficos, com o intervalo à escolha: última hora, dia, semana ou mês.

Serve para responder às três perguntas a 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, que costuma coincidir com uma aplicação instalada ou com uma cópia nova.
• «Fica sem memória?» — um teto plano nos 100 % durante horas é isso; picos pontuais ao copiar ficheiros são normais.
• «Estou a aproveitar a rede?» — o gráfico de rede durante uma cópia grande diz se o estrangulamento é o disco ou o cabo.

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

O ambiente de trabalho

Todo o painel vive num ambiente de trabalho com janelas, igual no navegador e no LGM Connect.

Áreas de trabalho virtuais e centro de controlo

• Há três áreas de trabalho, cada uma com as suas janelas. Muda-se com Ctrl+Alt+← / →, deslizando dois dedos de lado sobre o fundo ou a partir das áreas de trabalho na área do sistema da dock. Para levar uma janela para outra, botão direito na barra de título → «Mover para outra área de trabalho». Ao recarregar, cada janela volta à sua área de trabalho.
• Ctrl+Espaço abre o Centro de controlo: todas as apps e definições que a tua conta pode abrir, arrumadas, e as definiçõ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 o lado: o fundo, a barra de cima, as janelas, os widgets, a dock, Aplicações e dentro de cada app. Nos campos de texto continua a aparecer o do navegador, para copiar e colar.
• Os menus têm submenus e mostram os seus atalhos, e usam-se com as setas, Enter e Esc.
• No fundo estão «Atualizar o ambiente de trabalho» e «Definições rápidas» (tema, widgets e barra). Na barra de título de uma janela: minimizar, maximizar, encaixar em meio ecrã, mudar de área de trabalho ou fechar. Sobre uma app em Aplicações: abri-la, pô-la no ambiente de trabalho ou fixá-la na barra.
• No telemóvel, mantém o dedo meio segundo em qualquer sítio: aparece o mesmo menu, e confirmar dá uma pequena vibração.

A dock e os widgets

• De origem, a dock traz as apps do dia a dia que a tua conta pode abrir, e as abertas no fim, depois de um traço. Um ponto marca a app aberta, um balão os seus avisos por ler, e o ícone mostra o avanço das suas tarefas. Se já a tinhas a teu gosto, fica como estava.
• Tem três modos, no seu botão direito → «Configurar a barra»: «Sempre visível», «Esconder-se sozinha» e «Flutuante compacta».
• No fim da dock está a área do sistema: as áreas de trabalho, a rede do NAS, desligar ou reiniciar e «A tua conta», onde estão os teus dados e «Terminar sessão».
• Cada widget escolhe o seu tamanho — «Pequeno (meia linha)», «Largo (linha inteira)» ou «Grande» — no seu menu «⋯» ou com o botão direito, que também o recolhe, o configura, o duplica ou o tira. Fica guardado com a tua conta, por isso segue-te para outro dispositivo.

IA local

A app IA local responde a partir do próprio NAS, sem mandar nada para fora. Quem administra o NAS liga-a e escolhe o modelo; depois concede-a em Painel de controlo → Utilizadores e grupos como qualquer outra app (de origem, mais ninguém a tem).

• Cada conta, a sua. Cada pessoa com a permissão usa-a com as suas pastas e os seus documentos: resumi-los, deixar uma folha de cálculo na sua pasta, arrumar o seu ambiente de trabalho. O que cada conta diz, e o que a IA recorda dela, só ela vê, nem quem administra.
• Conversas guardadas. Em «Conversas» há várias, com nome, guardadas no NAS: continuam lá ao fechar a janela ou recarregar. «Começar outra conversa» abre uma nova.
• Usa o painel com as tuas permissões. Procura a ação, deixa-te o botão para ir ao ecrã e, se algo mudaria o NAS, mostra-te antes o que vai fazer e espera que carregues em «Aprovar». Nunca pode mais do que tu, e o que lê num documento toma-o como dado, não como ordem. «Parar» corta-a no momento. A quem administra pode ainda instalar uma app do Centro de pacotes ou medir a velocidade dos discos, sempre com aprovação.
• O estado do NAS. Pergunta-lhe como está o NAS e responde com o cartão **«Como está o NAS agora»**: um veredicto — Bem, Atenção ou Grave — com os seus números (discos, temperaturas, rede, placa gráfica) e o guia de onde sai cada passo; cada citação abre o seu guia. Ao abrir, sugere o que convém rever: um disco quente, uma cópia que falhou, um volume quase cheio.
• «Perguntar à IA», no botão direito de um contentor, um disco, um ficheiro, um aviso ou um widget, pergunta-lhe por isso sem teres de o explicar.
• «Explica-me de forma simples», debaixo de cada resposta junto a copiar e voltar a perguntar, repete-a sem palavras técnicas.

O separador Placas gráficas

A antiga app Gráficos e IA é agora o separador Placas gráficas da IA local, e só quem administra o vê: cada placa gráfica e dispositivo de IA do NAS, quanto se usa e que aplicações a têm. Se tinhas um atalho para a app antiga, já não existe: abre IA local → Placas gráficas.

Terminal web

Shell real no navegador, só para administradores. Arranca como o utilizador do serviço (nas, sem privilégios), e o botão «Sessão root» abre uma shell de administrador. As duas —e também a consola de um contentor, em Docker— pedem antes para confirmar a palavra-passe e o código do segundo fator, se o tiveres ativo (ou uma chave de acesso): a permissão é um token de uma só utilização que expira em 60 segundos e só abre a consola para a qual foi pedido. A sessão root é criada pelo assistente privilegiado (o serviço do painel corre com NoNewPrivileges=yes, onde o sudo não pode funcionar) e cada abertura fica na auditoria. A partir daí podes instalar o que quiseres (docker run …, apt install …); se o que lançares publicar uma porta web, aparecerá no Docker e no Launchpad.

Licença e período de avaliação

Há uma licença Doméstica (pagamento único, com um ano de atualizações que se prolonga de ano a ano), uma Vitalícia (atualizações para sempre) e a Empresarial (mensal, anual ou vitalícia). Tudo se faz em Painel de controlo → Licença, que mostra também a contagem decrescente das atualizações que restam.

• Quando as atualizações acabam, o NAS continua a funcionar por inteiro: só não instala as versões publicadas depois. Atualizar o LGM-OS di-lo e leva a lgm-os.com para acrescentar um ano ou passar a Vitalícia; a licença prolongada chega sozinha ao NAS em poucas horas.
• Se uma subscrição Empresarial for cancelada, ao acabar o período pago o NAS continua como doméstico: as funções de empresa desligam-se e nada se apaga.
• Associar a tua conta. Carrega em Associar a minha conta: o painel mostra um código e um endereço de lgm-os.com. Abre-o a partir de qualquer dispositivo —o telemóvel serve—, entra com a tua conta gratuita e escolhe o que fazer com esse NAS: **começar o período de avaliação ou usar uma licença tua**. O painel fica a saber sozinho em poucos segundos; não é preciso copiar nenhuma chave.
• O período de avaliação dura 60 dias e abre 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 período, com a mesma data de fim.
• Um NAS acabado de instalar tem 7 dias para ser associado. Até lá funciona por inteiro e o painel lembra-to.
• Se tiveres várias licenças, ao associar escolhes qual vai para esse dispositivo e dás-lhe um nome («Casa», «Escritório») para as distinguires na tua conta.
• Com uma licença comprada não é preciso associar nada: **Tenho uma chave → Colar uma chave** continua a funcionar como sempre.

Quando o período de avaliação acaba: «só dados»

Sem licença, ao acabar o período de avaliação —ou os 7 dias sem associar— o NAS fica em só dados. Os teus dados nunca ficam retidos:

• Continua a funcionar o que serve para os levares: entrar no painel, **ver e transferir todos os teus ficheiros, as pastas da casa só de leitura** a partir dos teus dispositivos, o estado dos discos e os seus avisos, atualizar o sistema, desligar e reiniciar.
• Fica em pausa tudo o resto: as apps e as máquinas virtuais param, as câmaras deixam de gravar e as cópias e tarefas agendadas não correm. A VPN e o nome de casa continuam a funcionar: se estiveres fora, podes entrar para ir buscar os teus ficheiros e para ativar a licença.
• Não se elimina nada. Ao ativar uma licença, o que estava em funcionamento volta a arrancar tal como o deixaste.

Algo correu mal?

Algo correu mal? está na barra de cima do ambiente de trabalho —no telemóvel, é a primeira coisa do centro de controlo— e em Painel de controlo → Licença. Envia um relatório ao suporte: o que escreveres, a versão e a app que estava a falhar. Se deixares a caixa marcada, vão juntos os dados técnicos do dispositivo e as últimas linhas de erro do painel, das quais o NAS retira antes palavras-passe, endereços com credenciais, e-mails e caminhos de pastas pessoais. Ninguém entra no teu NAS: o relatório é a única coisa que sai.

Sistema

• Nome do dispositivo: o que puseste ao instalar muda-se em **Painel de controlo → Informação do dispositivo, com o botão Alterar** que está ao lado do nome. Só letras minúsculas, números e hífenes (de 1 a 63, sem começar nem acabar em 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), por isso ao mudá-lo é preciso atualizar os marcadores da casa toda. O NAS volta a anunciar-se sozinho na rede (o Finder do Mac e «Rede» do Windows); o certificado do painel tem o nome lá dentro e é refeito no reinício seguinte, por isso 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; tem uma consola física à mão.
• Hora: o fuso horário e a sincronização por NTP estão em Painel de controlo → Região e idioma. Por baixo, Servidores de hora deixa escrever os teus, um por linha (pool.ntp.org, ou o endereço do router, que quase sempre dá a hora). Vazio = os que o sistema traz, que é o normal; mudam-se 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 do tempo e as tarefas agendadas disparam fora de horas.
• Ecrã do servidor (modo quiosque): se o dispositivo tiver um monitor ligado (ou a consola da sua máquina virtual), arranca a mostrar este mesmo painel em ecrã inteiro, como qualquer outro sistema operativo, e continua a ser administrado pela web a partir do resto da rede como antes. Instala-se sozinho quando há ecrã e desliga-se com um interruptor em Painel de controlo → Informação do dispositivo.

A consola nunca desaparece: o painel ocupa o terminal 7 e o início de sessão de sempre fica no 1. Se o ecrã se estragar —o X não arranca, o navegador fecha-se, o painel não responde— com Ctrl+Alt+F1 tens uma consola a sério, e Ctrl+Alt+F7 volta ao painel. A partir da consola, lgm kiosk off desliga-o, lgm kiosk log diz porque falha e lgm kiosk on volta a ligá-lo.

• Atualizações do sistema operativo: não se fazem a partir do painel. Um apt upgrade sem supervisão pode reiniciar serviços ou deixá-los a meio sem ninguém à frente; quem quiser atualizar o Debian tem o terminal. O que se atualiza a partir do painel é o LGM-OS, que é código próprio e sabe reiniciar-se sozinho.
• Cópia da configuração: transferência pontual ou tarefa agendada do tipo «backup» para um pool. Leva todo o estado do painel (utilizadores, 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 teus dados (para isso, a app Cópias de segurança); guarda-a dentro da cópia externa, porque é a primeira coisa de que vais precisar ao reconstruir o dispositivo. Pormenores e restauro em disaster-recovery.md.
• Registos: journald por unidade; Auditoria: quem fez o quê e a partir de que IP.
• Enviar os registos para outro dispositivo (syslog): Painel de controlo → Centro de registos → Enviar os registos para outro dispositivo. Envia uma cópia de tudo o que o NAS deixa escrito para um servidor de registos da tua rede (dispositivo, porta —514 por omissão— e UDP ou TCP). Serve para ter tudo junto e, sobretudo, para que o rasto fique fora do NAS se alguém lá entrar. Ao guardar testa-se o destino: com TCP a resposta é a sério, e com UDP só se verifica que o dispositivo existe na rede, porque ninguém confirma um datagrama. Quem o faz é o rsyslog, que o LGM-OS instala e deixa desligado até ligares isto; num NAS instalado antes da 1.65 pode faltar e o ecrã diz-te como o pôr.

Repor as definições de fábrica

Painel de controlo → Repor as definições de fábrica deixa o painel como no primeiro dia sem reinstalar nem tocar nos discos: para quando o NAS muda de mãos ou preferes começar a configuração do zero. Só o vê quem administra.

Como se confirma. São precisas três coisas: a tua palavra-passe, o código de dois passos se a tua conta o tiver e um código de oito letras e números que só aparece no ecrã ligado ao NAS. Carrega em Pedir o código e vê-o lá (se esse ecrã mostrar o painel, carrega em Ctrl+Alt+F1). Expira ao fim de dez minutos, admite três tentativas e tem de ser escrito à mão, porque é o que prova que tens o NAS à frente. Sem ecrã ligado não é possível: liga um. Também não enquanto estiver a decorrer algo que move dados —uma cópia, um restauro, uma troca de disco— ou uma atualização: o ecrã diz o que é e que esperes.

O que acontece depois. Antes de eliminar o que quer que seja, o NAS guarda uma cópia das definições atuais no seu disco do sistema, em /var/nas/apartados/fabrica-<data>. No fim o painel reinicia-se e pede-te para criar a conta de administrador, como no primeiro dia, com o código de registo do ecrã do NAS. O primeiro aviso diz onde ficou essa cópia e, se algo não pôde ser retirado, o que é e o que fazer com isso. A partir do painel não se pode desfazer.

Os teus dados continuam nos volumes: se o NAS sair de casa e os quiseres eliminar também, elimina o pool em Armazenamento.

Segurança

• Arquitetura de dois processos: a API corre como utilizador nas sem privilégios e delega no nas-helper (root) através de um socket Unix; o assistente privilegiado só aceita uma lista fechada de comandos e caminhos (backend/app/core/allowlist.py).
• TLS: autoassinado gerado no primeiro arranque, com os endereços do dispositivo lá dentro e com validade de 396 dias —abaixo do limite de 398 que o iOS e o iPadOS aceitam; com mais, um iPhone não deixa entrar no painel nem com o aviso—. É revisto em cada arranque e refeito só se estiver para expirar ou se o NAS mudar de IP; o teu ou o do Let's Encrypt não se tocam. O normal é substituí-lo por um do Let's Encrypt ao publicar o NAS (ver Acesso a partir da internet); para pôr um teu à 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 início de sessão: 10 tentativas/minuto por IP; 5 falhas seguidas bloqueiam a conta 5 minutos. Tudo fica na auditoria.
• Duração da sessão: de fábrica o painel fecha-se sozinho ao fim de **30 minutos sem ser usado**, e muda-se em Painel de controlo → Segurança → Regras da palavra-passe → Duração da sessão (de 5 a 1440 minutos). Não é um prazo rígido: cada coisa que fazes prolonga a sessão, por isso a trabalhar nunca se corta 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 manda a partir do acesso seguinte.
• Funções: admin (total) e viewer (só leitura), geridas em Segurança.
• Nunca abras a porta 5001 no router: serve o painel com certificado autoassinado e expõe a API de administração sem nada à frente. Esse remendo já não faz falta, porque há duas formas melhores de chegar de fora e o NAS traz as duas: a VPN —WireGuard, ou Tailscale e NetBird— (não publica nenhum serviço na internet) ou o acesso externo com Apache em 80/443 e certificado válido do Let's Encrypt. As duas secções seguintes.

Acesso a partir da internet

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

O procedimento completo —portas do router, 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 não precisas de partilhar com terceiros: a VPN do próprio NAS (secção seguinte), sem expor nenhum serviço.

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

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

• A VPN é a forma mais segura 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 instalam-se a partir do mesmo ecrã, nos seus separadores, e são o caminho quando não podes abrir portas (CGNAT). O que entra por eles conta como da casa na firewall.
• O DNS e o DHCP são o mesmo serviço (dnsmasq), por isso pará-lo detém os dois: é precisamente o que é preciso numa emergência (sudo systemctl stop dnsmasq).
• O dnsmasq instala-se desativado e só arranca quando ativas o DNS ou o DHCP a partir do painel.

Portas do router, 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 te deixar sem ligação: network-services.md. Lê-o antes de ativar o DHCP, e guarda-o no telemóvel: se ficares sem rede, não o vais poder consultar a partir do 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é-transferidas com progresso), web_port e env (variáveis que o instalador pede ao utilizador; secret oculta-as).
• 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 vivem em <pool>/docker/<id>/ (as instalações anteriores a esta política continuam em /var/nas/apps/ e não se movem). Essa pasta docker não é uma pasta da casa —o gestor de ficheiros e o SMB/NFS não a mostram— e o seu nome está reservado ao criar pastas da casa. Cada porta que a app publique (e, se partilhar a rede do NAS, as que a sua receita declara) recebe ao instalá-la uma regra na firewall com o nome da app, aberta à rede de casa. Em Segurança → Firewall fecha-se ou abre-se a qualquer origem; essa escolha volta se for reinstalada, e a regra é retirada ao desinstalar.

Para um repositório remoto serve 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>"
    }
  ]
}

Consola da frota

Edição Empresarial. A app Frota mostra de relance todos os LGM-OS da empresa: se estão bem, os avisos por ler, discos e volumes, capacidade, última cópia boa e versão, com a atualização pendente. Fala com cada NAS pelo painel cifrado 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 queres ver, abre Frota → Este NAS e cria uma chave: Só ver (lê o resumo dele e mais nada) ou Ver e atualizar (além disso, pode lançar a atualização). Na consola, carrega em «Adicionar um NAS», escreve o endereço e cola a chave. Antes de a enviar, a consola mostra a impressão digital do certificado desse NAS: compara-a com a que aparece em Frota → Este NAS e, se não for a mesma, não continues.

Um certificado que muda. A partir daí, a consola só fala com esse NAS se o certificado for assinado pela mesma autoridade: a renovação de cada ano não dá alarme, mas um NAS reinstalado (ou alguém a fazer-se passar por ele) aparece como «Certificado alterado» e não recebe a chave. Depois de o reinstalar, «Comparar a impressão digital outra vez».

Atualizar em grupo. Marca «Incluir ao atualizar» nos NAS que quiseres e carrega em «Atualizar os escolhidos». Atualizam-se um de cada vez, pela ordem da lista, e se um falhar para aí: os outros ficam como estavam.

As chaves. As chaves dos outros NAS guardam-se à parte, fora da cópia da configuração, e o painel não as volta a mostrar. Se restaurares a configuração noutro dispositivo, volta a adicionar cada NAS. Para uma consola deixar de ver um NAS, revoga a chave dela nesse NAS (Frota → Este NAS).