Migre o Jellyfin começando por declarar o comportamento atual, protegendo o estado persistente e, depois, adicionando serviços em etapas reversíveis e testadas.
Este procedimento destina-se a um contentor Docker funcional que já não se adequa a um comando não documentado ou a uma configuração tudo-em-um. O objetivo não é maximizar o número de contentores, mas sim obter um serviço Jellyfin reproduzível, com montagens, redes, dispositivos, indicadores de integridade, âmbito das cópias de segurança e reversão explícitos. Mantenha o armazenamento dos ficheiros multimédia independente do estado da aplicação, preserve a instância antiga até à aprovação dos testes de aceitação e adicione apenas dependências que a família consiga gerir.
Definir o que a resiliência deve abranger
Escolha as falhas que a nova pilha deve suportar: uma falha do processo Jellyfin, uma atualização de imagem defeituosa, a perda do armazenamento de configuração, um proxy indisponível, o reinício do anfitrião ou a perda total do anfitrião. Cada uma exige uma medida de controlo diferente. Uma política de reinício é útil após a saída de um processo; não restaura um volume eliminado nem repara uma montagem de ficheiros multimédia inacessível.
Defina objetivos de recuperação mensuráveis para a configuração, o histórico de visualização e a disponibilidade do serviço. Decida quanto tempo de inatividade e que perda de dados são aceitáveis, quem recebe um alerta e que elementos podem ser recriados. Este âmbito evita que uma pequena migração doméstica acumule bases de dados, proxies, painéis e automatizações que não reduzem nenhum risco identificado.
Inventariar o contentor em execução
Registe a referência exata da imagem, o comando, as variáveis de ambiente, as portas publicadas, as redes, a política de reinício, os IDs de utilizador e de grupo, os mapeamentos de dispositivos, as definições de DNS, as etiquetas, a montagem da configuração, a montagem da cache, as montagens dos ficheiros multimédia e os segredos. Registe também a propriedade e as permissões de todos os caminhos do anfitrião. Uma captura de ecrã da interface de um contentor não é um registo completo da implementação.
Converta esse inventário numa definição Compose sem alterar o comportamento. O método passo a passo, opção a opção, deste guia de migração de Docker run para Compose é valioso porque considera a reprodutibilidade, e não a expansão das funcionalidades, como a primeira meta. Fixe o digest ou a versão da imagem atualmente em execução para a migração inicial.
Separar o estado persistente, a cache e os ficheiros multimédia
Associe a configuração e o estado da base de dados do Jellyfin a um caminho persistente com um nome claro. Coloque a cache descartável e os segmentos de transcodificação num caminho separado, para que não sejam confundidos com dados essenciais para as cópias de segurança. Monte os ficheiros multimédia de que é proprietário de forma independente e só de leitura, quando o fluxo de trabalho o permitir; uma camada de aplicação resiliente não deve esbater os limites de proteção de uma grande biblioteca multimédia.
Pare o Jellyfin ou coloque-o em estado de espera antes da primeira cópia de um estado consistente, exceto se o método de cópia de segurança garantir a consistência da aplicação. Registe as permissões, as somas de verificação ou as contagens de ficheiros, a hora da cópia de segurança e o local de restauro. Nunca parta do princípio de que a imagem do contentor contém dados do utilizador: a definição da implementação, os segredos, o estado persistente e as referências aos ficheiros multimédia são elementos de recuperação separados.
Comprove o restauro antes de alterar a rede
Crie um destino de restauro temporário, copie para lá o estado protegido da aplicação e inicie o serviço Jellyfin com a versão fixada numa porta alternativa, com os ficheiros multimédia montados em modo só de leitura. Verifique os utilizadores, as bibliotecas, o histórico de visualização, os metadados, os plug-ins e uma reprodução representativa. Elimine a instância temporária e repita o processo com base no procedimento escrito se algum passo tiver dependido da memória.
Uma cópia de segurança prática do Compose tem de preservar o ficheiro de implementação, os dados de ambiente, os volumes e qualquer exportação da base de dados consistente com a aplicação. Este guia de cópia de segurança e atualização do Compose explica por que motivo copiar apenas uma imagem ou os ficheiros de uma base de dados em utilização não constitui um processo completo de recuperação.
Mude para o serviço Jellyfin declarativo
Escolha uma janela de manutenção, pare o contentor antigo, faça a cópia de segurança final do estado consistente e impeça o reinício automático da instância antiga. Inicie o serviço Compose equivalente com os mesmos caminhos persistentes e o mesmo acesso aos dispositivos. Mantenha a rota pública inalterada apenas depois de as verificações locais do estado e da reprodução serem bem-sucedidas.
Valide o estado dos contentores, os registos, a visibilidade das bibliotecas, o acesso aos dispositivos de hardware, a reprodução direta, uma transcodificação representativa, o tratamento das legendas e um reinício. Se o serviço não conseguir aceder a um dispositivo ou ponto de montagem, pare e restaure o contentor anterior em vez de editar várias camadas sob pressão. A reversão consiste na imagem anterior fixada, no estado anterior à transição e nos parâmetros de execução originais.
Adicione serviços adjacentes, um limite de cada vez
Introduza um proxy inverso apenas quando o acesso remoto exigir uma rota gerida separadamente. Adicione monitorização quando existir um indicador de estado definido e alguém puder agir com base nele. Adicione um canal de alertas quando for necessário detetar ciclos de reinício, perda de armazenamento ou falhas nas cópias de segurança. Cada serviço precisa de um responsável, de uma decisão sobre o estado persistente, de um âmbito de rede, de um método de atualização e da definição do impacto de uma falha.
A razão arquitetónica para estes limites é abordada separadamente na explicação da ZimaSpace sobre por que motivo as implementações do Jellyfin utilizam pilhas de serviços. Durante a migração, aplique esse modelo com prudência: agrupe os componentes que têm de recuperar em conjunto e evite que a reprodução dependa de painéis ou automatizações opcionais.
Torne observáveis o estado de saúde, as atualizações e as cópias de segurança
Defina o estado de saúde com base no percurso do utilizador, não apenas num processo em execução. Verifique se o Jellyfin responde localmente, se a montagem dos ficheiros multimédia está presente, se a rota pública chega ao serviço pretendido quando ativada e se é possível ler um ficheiro conhecido. Encaminhe as verificações falhadas para um canal de notificações que o operador já utilize, com contexto suficiente para distinguir uma falha da aplicação de uma falha de armazenamento ou de rede.
Mantenha a definição do Compose sob controlo de versões, não inclua segredos no repositório e reveja as alterações às imagens antes da implementação. Automatize as cópias de segurança apenas depois de um restauro manual ser bem-sucedido. O fluxo de trabalho deste guia de verificações de estado e monitorização do Jellyfin ilustra como as declarações, verificações, alertas e cópias de segurança se interligam; mantenha um ponto de aprovação e reversão para atualizações que possam alterar o estado armazenado.
Realize ensaios de falha antes de retirar o caminho antigo
Reinicie o anfitrião, pare o Jellyfin inesperadamente, torne o proxy indisponível, desligue um caminho de multimédia de teste e restaure o estado da aplicação numa localização temporária limpa. Confirme o alerta esperado, a ordem de recuperação e o comportamento visível para o utilizador em cada ensaio. Não simule a perda destrutiva de armazenamento contra a única cópia dos ficheiros multimédia.
Registe o tempo de recuperação e todos os comandos manuais. Um contentor que reinicia rapidamente, mas volta a apresentar uma biblioteca vazia, não passou no teste do serviço. Uma cópia de segurança que existe, mas não pode ser restaurada dentro do prazo previsto, não passou no teste de recuperação. Corrija esses limites antes de adicionar mais serviços.
Conclua a migração com um contrato operacional estável
Retire o contentor original apenas depois de o novo serviço Jellyfin resistir à utilização normal em casa, a uma atualização planeada, ao reinício do anfitrião e a um ensaio de restauro bem-sucedido. Arquive os parâmetros antigos, a última cópia de segurança anterior à mudança, a definição atual do Compose, o método de recuperação dos segredos, o mapa de montagens e os passos de reversão, de acordo com a política de retenção escolhida.
Pare de expandir quando a pilha for reproduzível, monitorizada, recuperável e compreensível para o seu operador. Adicione outro nó ou dependência apenas quando isso for exigido por um requisito mensurável de capacidade, confiança ou domínio de falha. A resiliência resulta de um estado conhecido e de uma recuperação praticada, não do número de contentores no diagrama.
Configuração de NAS e servidor
Mais para ler

Um servidor no dormitório pode funcionar silenciosamente o suficiente para dormir, estudar e fazer videochamadas?
Sim - um servidor num dormitório pode passar despercebido se o hardware consumir pouca energia, as vibrações do armazenamento forem controladas, as tarefas mais...

Um homelab de estudante que pode passar do quarto da residência universitária para o primeiro apartamento
Mantenha um homelab de estudante portátil, separando os serviços da rede específica de cada divisão, minimizando o hardware, criando cópias de segurança do estado...

Como partilhar um servidor doméstico com colegas de casa sem partilhar contas nem ficheiros privados
Dê a cada pessoa que partilha a casa uma identidade própria, armazenamento privado e apenas os privilégios partilhados de que precisa; mantenha a administração,...



