Quando algo não funciona: por onde começar

14 min · 12 seções

Este guia está organizado pelo que você vê, não pelo que falha. Procure o sintoma, e dali sai o que verificar e em que ordem.

Uma regra antes de tudo: o painel diz o que sabe e não adivinha. Se uma tela dá um motivo, esse motivo foi verificado; se ela diz “não foi possível verificar”, é porque de fato não foi possível, e é aí que entra este guia.

1. Não consigo abrir o painel

A primeira coisa é separar duas situações muito diferentes: o NAS não responde ou seu navegador não quer entrar. Dá para distinguir em dez segundos.

1.1 Ele continua nesse endereço?

A causa número um de “não abre” não é um defeito: é que o IP mudou. Isso acontece quando o roteador reinicia e distribui os endereços de novo.

Com um monitor e um teclado conectados ao NAS, ou por SSH:

lgm

Mostra a versão, o nome do dispositivo e o endereço do painel. Se for diferente do que você tinha salvo, esse era o problema, e a solução de fundo é dar a ele um endereço fixo: Painel de controle → Rede, ou pelo console lgm set-ip.

1.2 O serviço está rodando?

systemctl status nas-backend nas-helper

São os dois que importam: nas-backend é o painel e nas-helper é o processo com permissões que faz o trabalho do sistema. Se um dos dois estiver parado:

sudo systemctl restart nas-backend
lgm log

lgm log mostra o registro do painel, que é onde o motivo vai estar.

⚠️ Se você acabou de atualizar e o painel não volta, veja a seção 6.

1.3 “O servidor NAS não está respondendo agora (reiniciando?)”

Esta mensagem aparece dentro do painel: a página carregou, então o navegador chegou ao NAS em algum momento. Dois casos:

• Você acabou de atualizar ou reiniciar. É normal durante alguns segundos; o painel tenta novamente sozinho e volta.
• Aparece logo ao abrir e não some. Então a página que você está vendo veio da cópia salva no navegador, não do NAS. Costuma ser o certificado: o navegador recusa a conexão e nunca chega a mostrar o próprio aviso, que é a única tela onde dá para aceitá-lo. Na própria mensagem há o botão “Entrar sem a cópia salva”, que apaga essa cópia e recarrega; então aparece o aviso de certificado de sempre.

2. Eu entro, mas um aplicativo diz que não tenho acesso

Não é um defeito: é a distribuição de aplicativos. Cada conta tem os seus e com que nível — ver, ou ver e mexer —, e quem manda é o NAS, não o ícone.

Quem administra muda isso em Painel de controle → Usuários e grupos → a conta → Aplicativos. Está tudo explicado em Usuários, permissões e o que cada um vê.

Duas coisas que confundem:

• O ícone sumiu. Ao retirar um aplicativo, ele desaparece também da área de trabalho e da busca dessa conta. Não foi desinstalado: não é dela.
• Consigo ver, mas não mudar. É o nível “ver”. Os botões que gravam não aparecem. Em Câmeras, Backups e Armazenamento, é o máximo que se pode dar a uma conta que não administra.

3. Não vejo o NAS no Windows, no Mac ou no celular

Vá na ordem, do mais comum ao menos comum:

1. Essa conta tem acesso à pasta? Compartilhar uma pasta e dar acesso a alguém são duas coisas diferentes: Painel de controle → Pastas da casa → a pasta → Permissões.
2. O protocolo está ligado? SMB, NFS e WebDAV são ligados separadamente em `Painel de controle → Serviços de arquivos`, e além disso é preciso marcá-lo em cada pasta.
3. A senha do SMB não é a do painel se você nunca a definiu. Ao criar a conta, as duas são definidas ao mesmo tempo, mas mudar uma não muda a outra.
4. Digite o endereço à mão em vez de esperar que ele apareça sozinho: no Windows \\192.168.1.50, no Mac smb://192.168.1.50. A descoberta automática da rede é a primeira coisa que falha e não significa nada.
5. Só falta a “Minha unidade”? Ela tem a própria linha em `Painel de controle → Pastas da casa`: se estiver desligada, ou sem o protocolo que você usa, não aparece. Por NFS, além disso, só os dispositivos da lista dela a montam.

Todos os detalhes, dispositivo por dispositivo, em Conectar seus dispositivos ao NAS.

4. Está lento

Antes de mexer em qualquer coisa, veja quem está trabalhando: o Monitor mostra CPU, memória, rede e discos ao vivo. Com isso, três casos:

• Os discos a 100 % e todo o resto tranquilo. Quase sempre é um scrub, um backup ou o indexador de fotos. Termina e passa; em Armazenamento e em Backups dá para ver o que está em andamento.
• A rede no máximo. Alguém está copiando algo, ou há um torrent enviando. Os limites de velocidade dos downloads ficam no próprio app.
• Tudo tranquilo e mesmo assim lento. Se for um torrent, veja o aviso da porta no app Downloads: com a porta fechada, você só baixa dos pares a que você mesmo se conecta, e isso é uma fração da velocidade. Se for SMB, experimente copiar um arquivo grande em vez de muitos pequenos: mil arquivos de 10 KB são mil conversas, e isso é lento em qualquer NAS.

5. Um disco está dando erros

Não o desconecte ainda. Com RAID, tirar o disco errado transforma um problema numa perda.

1. Armazenamento → Proteção → Saúde e criptografia diz qual é o disco e o que ele tem (SMART). Anote o número de série, que é a única coisa que não muda; a letra (sda, sdb) pode mudar ao reiniciar.
2. Se o volume continuar funcionando, faça um backup agora antes de mexer em qualquer coisa. Um disco que começa a falhar costuma aguentar horas.
3. A substituição é feita pelo painel e está explicada passo a passo em [Recuperação de desastres](disaster-recovery.md).

6. Atualizei e algo deu errado

lgm log e lgm progress contam o que aconteceu na última atualização.

• O painel não volta. O atualizador guarda uma cópia das unidades antes de mexer nelas justamente para isso. systemctl status nas-backend dirá se ele não inicia, e lgm log, o motivo.
• Uma tarefa crítica pela metade. Se houver uma restauração ou um backup em andamento, a atualização se recusa a começar. É de propósito.

Voltar à versão anterior

Se uma versão nova quebrar algo e você não puder esperar a correção, em Painel de controle → Atualizar o LGM-OS há um botão “Voltar ao X” com a versão que havia antes da última atualização. Ele devolve o painel a essa versão em um minuto; seus dados e suas configurações ficam como estão e os aplicativos continuam rodando. A versão retirada não volta a ser instalada sozinha: quando quiser, “Instalar mesmo assim”. O botão não aparece se a atualização mudou o formato das configurações (a versão anterior não as entenderia); o painel avisa.

7. O disco encheu

A primeira coisa é saber de que disco estamos falando: o do sistema e o dos dados são diferentes e se resolvem de formas diferentes.

• O volume de dados. Painel de controle → Relatório de espaço mostra com o que o disco está sendo gasto e os arquivos repetidos. Atenção aos snapshots: o que você exclui continua ocupando espaço enquanto houver um snapshot que se lembre dele.
• O disco do sistema. Enche com registros, imagens do Docker e downloads no lugar errado. O botão Limpar da Central de pacotes — que exclui imagens e volumes que ninguém usa mais — e a lixeira são os dois primeiros lugares.

8. Como pedir ajuda com dados

Em Painel de controle → Verificação do sistema há um botão, Baixar relatório para o suporte, que baixa um arquivo com tudo o que é preciso para entender o que está acontecendo com o dispositivo: a versão, como foi a última atualização, a verificação dos serviços, os discos, a rede, os aplicativos do Docker, os avisos e as últimas linhas do registro do painel (no máximo 5.000, do último dia). Prepará-lo pode levar um minuto. Envie-o como está para quem estiver ajudando você; é o que poupa as dez perguntas de ida e volta. Ele não contém senhas: nem as das contas do NAS, nem as das câmeras, nem as das nuvens. Os campos que as guardam aparecem como [oculto].

Se você preferir ver por conta própria pelo console:

lgm info      # versão, dispositivo e endereço
lgm log       # o registro do painel
systemctl status nas-backend nas-helper

E a seção Testes de rede da Verificação traz as verificações de rede — resolver um nome, acessar a internet, ver se uma porta responde — sem sair do navegador.

⚠️ Antes de colar um registro em qualquer lugar, leia-o. O painel apaga as senhas das mensagens que mostra, mas um registro do sistema é do sistema e pode conter endereços internos ou nomes das suas pastas.

9. “A configuração … estava danificada”

As configurações do painel ficam em arquivos de /var/nas/state, um por assunto: users.json as contas, shared_folders.json as pastas da casa, e assim por diante. Se um deles não puder ser lido, o painel não cai: ele o separa como <nome>.json.corrupt, continua com os valores de fábrica dessa parte e avisa com “A configuração “…” estava danificada”. O que você nota depende de qual for:

⚠️ Até recuperá-la, não crie nem edite nada dessa parte do painel: você salvaria os valores de fábrica por cima. Com shared_folders separado, criar uma pasta voltaria a publicar só essa.

Quase sempre o arquivo está bom. Até a 2.0.4, uma leitura que dava errado separava arquivos que no disco estavam perfeitos. Desde a 2.0.4 isso não acontece mais, e ao iniciar o painel recoloca sozinho os que são lidos corretamente: você verá “A configuração “…” se recuperou sozinha”.

9.1 Recuperá-la

Por SSH, ou com um monitor e um teclado conectados ao NAS:

1. Com uma versão anterior à 2.0.4, atualize. Ao iniciar a versão nova, ela é recolocada sozinha, e não é preciso fazer mais nada:

sudo lgm update

1. Se você já tem a 2.0.4 ou posterior, reinicie o painel; ao iniciar, ele verifica os arquivos separados:

sudo systemctl restart nas-backend

1. À mão, sem atualizar nem reiniciar. Cole isto inteiro. Recoloca cada arquivo separado que seja uma configuração boa, não sobrescreve um que já tenha sido salvo de novo e não mexe nos que estão danificados de verdade:

sudo python3 - <<'EOF'
import glob, json, os
d = "/var/nas/state"
for apartado in sorted(glob.glob(d + "/*.json.corrupt")):
    nombre = os.path.basename(apartado)[:-len(".json.corrupt")]
    destino = f"{d}/{nombre}.json"
    if os.path.exists(destino):
        print(f"- {nombre}: ya hay uno nuevo, no se toca"); continue
    try:
        doc = json.loads(open(apartado, "rb").read().decode("utf-8"))
    except Exception as e:
        print(f"- {nombre}: roto de verdad, se deja ({e})"); continue
    if not isinstance(doc, dict):
        print(f"- {nombre}: no tiene forma de ajuste, se deja"); continue
    st = os.stat(apartado)
    tmp = destino + ".reponiendo"
    with open(tmp, "wb") as f:
        f.write(json.dumps(doc, indent=2, ensure_ascii=False).encode("utf-8")); f.flush(); os.fsync(f.fileno())
    os.chown(tmp, st.st_uid, st.st_gid); os.chmod(tmp, 0o600); os.replace(tmp, destino)
    print(f"+ {nombre}: repuesto")
EOF

Cada linha com + é uma configuração recolocada, e isso se nota na hora: com users, já dá para entrar.

9.2 Se estiver danificada de verdade

Se o passo 3 disser “roto de verdad” (danificado de verdade), o que há no arquivo não pode ser aproveitado e é preciso tirá-lo do backup da configuração.

• Você consegue entrar no painel (a danificada não é users): Painel de controle → Backup da configuração → “Restaurar a partir de arquivo…”.
• Você não consegue entrar (a danificada é users): ela é tirada do backup por SSH. Primeiro, o mais recente:

sudo find /mnt /srv -name 'nas-config-*.tar.gz' -printf '%T+ %p\n' 2>/dev/null | sort | tail -3

E dele, só essa configuração (troque o caminho pelo que apareceu acima):

COPIA=/mnt/tank/backups/nas-config-XXXX.tar.gz
sudo tar -xzf "$COPIA" -C /tmp state/users.json
sudo install -o "$(stat -c %U /var/nas/state)" -g "$(stat -c %G /var/nas/state)" -m 600 \
  /tmp/state/users.json /var/nas/state/users.json
sudo rm -rf /tmp/state

• Sem backup das contas: reinicie o painel (sudo systemctl restart nas-backend). Sem contas, volta o assistente da primeira inicialização; ele pede o código de cadastro, que só aparece na tela do próprio NAS ou com sudo lgm alta. Crie o administrador e cadastre de novo as outras contas. Seus arquivos e pastas não são tocados.

10. Um aviso de erros no barramento PCIe

O NAS vigia o barramento PCIe, por onde os discos NVMe, as controladoras de discos, as placas de rede e a placa de vídeo conversam com a placa-mãe, e avisa assim que um deles começa a dar erros, dizendo qual.

• «Erros corrigidos no barramento PCIe»: o sistema corrigiu e por enquanto nada se perde. Se o aviso se repetir e a contagem continuar subindo, costuma ser um contato frouxo ou um dispositivo começando a falhar: desligue o NAS e encaixe de novo o dispositivo no slot.
• «Erros no barramento PCIe»: erros que o sistema não conseguiu corrigir. Costuma ser um dispositivo mal encaixado, esquentando ou começando a falhar. Se for um disco, **faça já um backup do que importa**; depois desligue o NAS, encaixe de novo o dispositivo e confira se chega ar até ele.

11. As chaves do painel e o chip TPM

As chaves que o painel guarda para funcionar — a da VPN, a do DNS dinâmico, a do nobreak e outras — ficam salvas criptografadas com o chip TPM 2.0 da placa-mãe se o dispositivo tiver um. Não há nada para ativar, e num dispositivo sem chip elas são salvas como sempre.

Se um dia o chip deixar de abri-las, o NAS liga mesmo assim e avisa com «O chip de segurança não abre os segredos do painel». Costuma acontecer ao trocar a placa-mãe ou ao apagar o TPM na BIOS. Enquanto isso, a VPN, o DNS dinâmico e o que usar essas chaves não funciona.

• Nada se perdeu. Entre no painel com uma conta de administrador digitando a senha dela, e as chaves se recuperam sozinhas. O aviso «Segredos do painel recuperados» confirma.
• Se o chip funcionar, elas voltam a ser salvas com ele; se o dispositivo não tiver mais um chip que funcione, são salvas como antes, sem ele.

Veja também

• Recuperação de desastres — quando algo grave já aconteceu.
• Usuários, permissões e o que cada um vê — quase tudo do tipo “não consigo ver isto”.
• Glossário — o que significa cada palavra estranha das que aparecem aqui.