Como restaurar o Plex após uma atualização falhada do contentor
Pare o contentor Plex que falhou e o respetivo atualizador automático antes de extrair outra imagem. Preserve primeiro os registos atuais e o caminho real da configuração do Plex; a recuperação é muito mais segura quando o contentor danificado não pode continuar a substituir-se nem a escrever no estado da aplicação.
Num NAS doméstico, uma atualização de contentor pode falhar em várias camadas: a nova imagem pode não arrancar, o serviço recriado pode perder um volume ou uma definição de rede, ou a nova compilação do Plex pode abrir os dados da aplicação existentes de forma diferente. O limite importante é a configuração persistente do Plex, especialmente a base de dados e os metadados em `/config`. Este procedimento separa a imagem, a definição do contentor, as montagens e a base de dados antes de alterar qualquer um deles; em seguida, restaura a camada mínima que falhou e verifica a identidade original do servidor, a biblioteca e a reprodução. Se os registos indicarem corrupção da base de dados ou uma migração irreversível, pare antes de forçar uma imagem mais antiga sobre a única cópia desse estado.
Pare o ciclo de atualização e capture o estado da falha
Desative o atualizador automático do Plex e interrompa qualquer ciclo de reinícios rápidos. Mantenha os outros serviços saudáveis em execução, a menos que o Plex partilhe uma base de dados que exija uma paragem coordenada. O objetivo é manter a falha estável durante tempo suficiente para a inspecionar, não reiniciar toda a pilha da aplicação e apagar a sequência de acontecimentos.
Registe a etiqueta exata da imagem, o ID da imagem e o resumo criptográfico do contentor que falhou, quando disponíveis. Guarde as montagens efetivas, as variáveis de ambiente, as portas publicadas, o modo de rede, os aliases de rede, os mapeamentos de dispositivos, os grupos adicionados, a política de reinício e o estado de funcionamento. Uma etiqueta como `latest` não é, por si só, um registo de reversão fiável, pois pode apontar para conteúdos de imagem diferentes ao longo do tempo.
Exporte os registos recentes antes de tentar iniciar novamente e anote a primeira mensagem fatal, não apenas o código de saída final. Um ficheiro em falta, uma recusa de permissão, um erro da base de dados, uma instrução não suportada ou um conflito de endereços encaminham a recuperação por caminhos diferentes. Registe também quando foi executada a atualização e se o contentor foi recriado, pois uma simples extração não altera um contentor existente, enquanto a recriação pode alterar a sua definição efetiva.
Pode prosseguir quando a falha for reproduzível e conseguir responder a quatro perguntas: que imagem foi executada, que caminhos persistentes utilizou, que definições de execução recebeu e que erro apareceu primeiro. Se esses factos ainda forem desconhecidos, fazer outra extração ou reinicialização apenas acrescenta ruído, sem tornar a recuperação mais segura.
Proteger a configuração do Plex antes de recriar o contentor
Trate o contentor como substituível e a configuração do Plex como persistente. O estado crítico encontra-se normalmente no caminho do anfitrião ou no volume nomeado montado em `/config`; as bibliotecas multimédia devem permanecer em pontos de montagem separados. Recriar o serviço só acarreta um risco reduzido quando este se volta a ligar ao mesmo estado persistente, em vez de a um diretório vazio.
Inspecione o ponto de montagem a partir do anfitrião e de um contexto temporário só de leitura, se a sua plataforma o suportar. Confirme que existem a base de dados, as preferências, os metadados, os dados dos plug-ins e os registos esperados. Registe a origem do ponto de montagem, o sistema de ficheiros, a propriedade, as permissões, o espaço disponível e se este passou a estar em modo só de leitura. Um diretório vazio no caminho esperado é um aviso para parar, não uma autorização para deixar o Plex criar aí um novo servidor.
Faça uma cópia de segurança de todo o caminho de configuração previsto antes de testar uma reversão e, em seguida, verifique se a cópia pode ser listada ou restaurada numa localização isolada. Se o sistema de ficheiros suportar instantâneos, um instantâneo pode acelerar a recuperação, mas não deve ser a única cópia quando o mesmo dispositivo de armazenamento possa estar a falhar. Mantenha o estado afetado e a última cópia de segurança conhecida como funcional até o servidor ser verificado.
Não elimine ficheiros de preferências, ficheiros da base de dados nem metadados para fazer a imagem mais antiga arrancar. Se a configuração não puder ser lida de forma consistente, se a respetiva propriedade não for clara ou se não for possível verificar uma cópia, avance diretamente para a recuperação do armazenamento ou da base de dados. A recriação do contentor não consegue reparar uma fonte de estado não fiável.
Determine se a falha está na imagem, na definição, no ponto de montagem ou na base de dados
Compare o contentor capturado com a última implementação funcional antes de escolher uma reparação. Comece pela primeira linha fatal do registo e pela definição efetiva e, em seguida, enquadre a falha num de quatro ramos: a nova imagem não consegue ser executada, a definição do contentor foi alterada, um caminho persistente está indisponível ou o Plex não consegue utilizar o estado de aplicação existente.
Uma falha de imagem ou de runtime surge normalmente antes de o Plex conseguir abrir `/config`: erros de arquitetura, instruções de CPU não suportadas, bibliotecas de runtime em falta ou uma saída imediata do processo com a definição do contentor inalterada. Uma falha de reprodução específica da versão desapareceu depois de o servidor regressar a uma imagem anterior do Plex, o que torna a reversão um indicador útil quando a mesma definição funcionava antes e nenhum ponto de montagem ou permissão foi alterado.
Surge uma falha de definição ou de montagem após a recriação quando o Plex arranca sem conteúdos multimédia, com um servidor vazio, acesso a ficheiros negado, sem endpoint Web ou sem acesso ao hardware. Compare as origens dos volumes guardadas e efetivas, o UID/GID, os grupos, as portas, o modo de rede, os dispositivos e o ambiente. Corrija a primeira discrepância comprovada em vez de alterar todos os campos de uma só vez.
As mensagens da base de dados e da migração exigem uma análise separada. Se a nova compilação iniciou uma alteração do esquema, uma imagem mais antiga poderá não conseguir ler o estado resultante. Faça novamente uma cópia de segurança da configuração atual, preserve os registos e não force arranques repetidos em várias versões. Este ramo requer uma imagem compatível, uma cópia de segurança pré-atualização verificada ou uma reparação consciente da base de dados.
| Resultado observado | Ramo principal | Primeira reparação |
|---|---|---|
| O processo termina antes de ler `/config` | Imagem ou ambiente de execução | Inicie a imagem retida e conhecida como funcional com a definição inalterada |
| O Plex arranca como um servidor novo ou vazio | Mapeamento incorreto de `/config` | Pare-o e restaure a origem original do ponto de montagem |
| A configuração ou os conteúdos multimédia mostram erros de permissão | Propriedade do ponto de montagem ou estado só de leitura | Restaure o UID/GID, os grupos ou o acesso ao armazenamento comprovados |
| Os registos mostram uma falha de migração ou da base de dados | Estado da aplicação | Preserve o estado e utilize uma imagem compatível ou uma cópia de segurança verificada |
Repor a última imagem Plex conhecida como funcional
Escolha a imagem exata que foi executada com êxito pela última vez. Prefira um digest de imagem retido, uma referência de versão imutável ou um ID de imagem local a uma etiqueta que muda. Mantenha as atualizações automáticas desativadas para que o atualizador não substitua o restauro assim que este arrancar.
Recrie apenas o serviço Plex a partir da definição guardada. Mantenha a mesma identidade do projeto ou do contentor quando esta afetar as redes, as mesmas fontes de `/config` e dos conteúdos multimédia, as mesmas portas, o mesmo modo de rede, ambiente, UID/GID, grupos e dispositivos. Não remova volumes nem execute uma limpeza de todo o sistema antes de testar a imagem anterior.
Acompanhe o primeiro arranque em tempo real. Um restauro bem-sucedido da imagem deverá abrir a configuração original, manter a mesma identidade do servidor, disponibilizar as bibliotecas existentes e eliminar o erro fatal anterior. Deixe a transcodificação de hardware opcional e as análises em segundo plano para depois, até o início de sessão e o acesso aos conteúdos multimédia funcionarem.
Pare se a imagem antiga indicar que a base de dados é mais recente, incompatível ou está a meio de uma migração. Mudar repetidamente de versão pode dificultar a compreensão do ponto de recuperação. Restaure uma cópia verificada da configuração anterior à atualização para um caminho isolado ou avance para uma imagem Plex compatível, em vez de forçar um downgrade inseguro.
Restaure a definição original do contentor quando o rollback não for suficiente
Se a imagem comprovadamente funcional continuar a falhar, volte à comparação das definições. Restaure uma definição em falta de cada vez e reinicie apenas o Plex após cada alteração. Assim, as evidências mantêm-se claras: quando o servidor voltar, saberá qual foi a dependência de execução responsável.
Comece pelos mounts de `/config` e dos ficheiros multimédia. Confirme que o contentor vê os caminhos pretendidos e consegue lê-los com o utilizador configurado. Se a atualização recriou o Plex com um UID ou GID diferente, um grupo suplementar ou um contexto de segurança diferente, restaure deliberadamente a última identidade funcional ou corrija a propriedade do armazenamento. Não torne toda a árvore de appdata acessível a todos como atalho.
Em seguida, verifique o caminho Web e os dispositivos opcionais. Restaure a rede anfitriã anterior ou a porta publicada, os aliases de rede e a integração no proxy inverso antes de alterar as regras da firewall. Confirme primeiro a interface Web através do caminho direto do servidor. Adicione o dispositivo GPU e o acesso ao grupo de renderização apenas depois de o Plex conseguir arrancar, carregar a biblioteca e transmitir um fluxo básico compatível com software.
Uma reparação bem-sucedida da definição tem um estado claro: o contentor vê a configuração e os ficheiros multimédia pretendidos, o endpoint do Plex está acessível e os registos já não mostram o erro de dependência selecionado. Se o mesmo erro da base de dados persistir após essas verificações, pare de recriar o contentor e volte ao ramo protegido do estado da aplicação.
Verifique a base de dados, a biblioteca e a reprodução do Plex antes de reativar as atualizações
Um processo em execução é apenas a primeira verificação de recuperação. Inicie sessão através do endpoint direto do Plex e confirme que é o servidor original associado à conta, não um servidor novo criado com um diretório de configuração vazio. Consulte os registos de arranque para detetar corrupção da base de dados, tentativas repetidas de migração e inicialização inesperada da biblioteca.
Abra vários itens existentes da biblioteca e confirme que os cartazes, os metadados, o estado de visualização e os caminhos dos ficheiros estão presentes. Teste o acesso a um ficheiro multimédia pequeno e conhecido como funcional, no mesmo armazenamento utilizado antes da atualização. Se os metadados existirem, mas os conteúdos multimédia não estiverem disponíveis, a base de dados pode estar saudável, enquanto ainda é necessário reparar uma montagem ou uma permissão.
Reproduza o ficheiro conhecido num cliente local e, se aplicável, no cliente que revelou a falha. Registe o modo de reprodução e confirme que é possível avançar e recuar na reprodução. Trate a ausência de aceleração por GPU, o acesso remoto ou o comportamento das legendas como linhas de investigação separadas se a reprodução básica funcionar; estes problemas não devem impedir a preservação de um servidor recuperado.
Por fim, execute um reinício controlado do serviço Plex, mantendo o atualizador desativado. A recuperação só é bem-sucedida quando a mesma identidade do servidor, a base de dados, as bibliotecas, os metadados, o acesso aos conteúdos multimédia e a reprodução básica regressam após esse reinício. Mantenha os registos da falha e a cópia de segurança guardados até ser possível repetir este resultado completo.
Saiba quando parar e tornar recuperável a próxima atualização do Plex
Pare a reparação local do contentor quando os registos reportarem repetidamente corrupção da base de dados, o sistema de ficheiros de configuração devolver erros de E/S, a única cópia do estado tiver sido parcialmente migrada ou nenhuma imagem compatível conseguir abri-la. Preserve os identificadores da imagem, a definição efetiva, os registos e a cópia de segurança da configuração. Nessa altura, um restauro com conhecimento da base de dados ou uma reparação do armazenamento é mais segura do que continuar a recriar contentores.
Quando o Plex estiver estável, documente o digest da imagem recuperada, a definição do contentor, os caminhos persistentes, a identidade de execução, o modo de rede, os dispositivos e os resultados da verificação. O processo de recuperação de um único serviço mais abrangente é útil quando o Plex também depende de bases de dados partilhadas, redes proxy ou outros serviços da stack, mas essas dependências saudáveis não devem ser restauradas apenas porque o Plex falhou.
Para a próxima atualização, crie e verifique uma nova cópia de segurança de `/config`, mantenha a imagem atual, desative a limpeza automática, atualize o Plex manualmente e repita as verificações de identidade, biblioteca, reprodução e reinício antes de voltar a ativar a automatização. Uma atualização só está concluída quando preserva um destino de reversão testado, além de uma nova versão funcional.
Produtos recomendados
Suporte e Dicas
Mais para Ler
O Plex pode partilhar uma GPU com outro contentor Docker?
O Plex e outro contentor conseguem frequentemente aceder à mesma GPU, mas é necessário testar o suporte dos controladores, o mapeamento de dispositivos, a...
Como saber se um erro do Plex vem do cliente ou do servidor
Reproduza o mesmo item noutro cliente, compare o percurso da sessão e, em seguida, recolha provas do servidor apenas depois de o âmbito lhe...
Como configurar a cache do Plex e o armazenamento temporário de transcodificação
Proteja o estado persistente do Plex enquanto coloca os ficheiros temporários de transcodificação num armazenamento local adequado e, em seguida, verifique a limpeza, o...
