Uma alteração no proxy ou no DNS não deve terminar automaticamente todas as sessões do Jellyfin. A perda da sessão costuma ocorrer quando a alteração também modifica o nome de anfitrião, o esquema, o caminho, a identidade do servidor de backend, a camada de autenticação ou a rota do cliente que o estado de início de sessão existente espera.
Comece por distinguir uma simples atualização do registo DNS de uma alteração da origem. Mantenha inalterados uma conta e um dispositivo conhecidos, compare o acesso direto pela rede local com o nome de anfitrião público habitual e registe o primeiro pedido falhado antes de apagar os dados do cliente. O objetivo é identificar qual foi o limite alterado, não repor as contas dos utilizadores até o problema desaparecer.
Determine primeiro se a origem pública mudou realmente
Anote o esquema, o nome de anfitrião, a porta, o caminho base e a rota do proxy, antigos e novos. Um registo DNS A ou AAAA pode apontar o mesmo nome de anfitrião para um endereço diferente sem alterar a origem do navegador, enquanto a mudança de um nome de anfitrião para outro ou a alteração do caminho base de uma aplicação cria um limite diferente para o cliente. As migrações para domínios personalizados também exigem que a aplicação e o percurso de autenticação utilizem o novo domínio; uma lista de verificação para a migração de domínios personalizados torna explícita esta relação entre DNS e aplicação.
O estado de autenticação depende do local onde é apresentado. Uma lista de verificação do âmbito dos cookies de sessão útil começa por identificar o domínio e o caminho associados a cada mecanismo de autenticação. Os clientes Jellyfin não armazenam todos o estado da mesma forma, por isso teste o cliente afetado em vez de presumir que o comportamento do navegador se aplica a todas as aplicações.
Se o nome de anfitrião antigo continuar a funcionar, mas o novo pedir autenticação, considere isso uma migração de origem esperada até prova em contrário. Se o mesmo nome de anfitrião terminar a sessão de todos apenas após as alterações no proxy, mantenha o nome de anfitrião e investigue a identidade a montante, os cabeçalhos e a autenticação do lado do proxy.
Verifique se o DNS continua a apontar para a mesma instância Jellyfin pretendida
Resolução do nome do anfitrião a partir de um cliente da rede local e, se o acesso remoto for importante, a partir de um resolvedor externo. Confirme se o endereço devolvido chega ao proxy inverso pretendido e se este encaminha para o serviço Jellyfin esperado, não para um contentor antigo, uma instância de teste, um clone restaurado ou um segundo servidor com uma base de dados persistente diferente.
Uma mudança de DNS pode parecer um problema de sessão quando, na realidade, encaminha o cliente para um backend diferente. Compare uma resposta que identifique o servidor, o comportamento da lista de utilizadores, o estado das bibliotecas e o destino do upstream do proxy antes de alterar a autenticação. Se a nova rota chegar a uma instância do Jellyfin nova ou restaurada, as credenciais existentes do cliente poderão já não corresponder a uma sessão válida nessa instância.
O fluxo de trabalho relacionado do ZimaSpace para manter separados os ciclos de vida do proxy e do estado das sessões é útil neste caso: o reinício de um ingress não deve substituir silenciosamente a identidade da aplicação nem o estado que valida as sessões existentes.
Compare o Host, o esquema, o caminho e a autenticação do proxy encaminhados
Registe a configuração efetiva do proxy após a alteração. Compare o valor público de Host, o esquema encaminhado, o endereço do cliente, o caminho de atualização do websocket, os redirecionamentos e qualquer middleware de autenticação com a última configuração funcional. Um redirecionamento de HTTPS para um URL HTTP inesperado ou para um anfitrião alternativo pode fazer parecer que um início de sessão válido desapareceu.
Se houver outra camada de autenticação à frente do Jellyfin, mantenha estáveis a respetiva chave de assinatura, o nome e o domínio dos cookies e o repositório de sessões ao substituir o proxy. Os designs de balanceadores de carga recorrem a sessões persistentes e ao estado de encaminhamento para manter um pedido no backend pretendido; alterar essa camada pode causar um encerramento de sessão ou um ciclo, mesmo que o próprio Jellyfin continue a funcionar normalmente.
Não copie cegamente cabeçalhos de um exemplo de proxy sem relação com o seu caso. Altere um valor de cada vez, e só quando o pedido com falha ou o redirecionamento demonstrar que o valor atual está errado. A configuração de proxy mais segura é a mais simples que preserva a origem pública e chega de forma consistente ao backend correto.
Teste com um cliente limpo sem apagar as provas originais
Antes de limpar o que quer que seja, guarde a hora da falha, a versão do browser ou da aplicação, o estado do pedido, a cadeia de redirecionamento, a linha do registo do proxy e a entrada do registo do Jellyfin. Em seguida, inicie sessão através da nova rota numa janela de navegação privada ou num segundo dispositivo de teste. Se o novo início de sessão funcionar, fica provado que o serviço está acessível; não explica por que motivo o estado anterior deixou de ser utilizável.
Compare três percursos, por esta ordem: endereço direto do Jellyfin na LAN, nome de anfitrião habitual a partir da LAN e nome de anfitrião habitual a partir do exterior da LAN. Se o acesso direto funcionar e o nome de anfitrião falhar, não altere os utilizadores nem o estado da base de dados e investigue o DNS, o TLS, o proxy ou o middleware. Se todos os percursos recusarem a mesma conta que sabe estar correta, o problema voltou a estar no Jellyfin ou no respetivo estado persistente.
Só limpe os dados específicos do site no cliente afetado depois de recolher provas sobre o percurso do pedido. Evite eliminar todos os dispositivos registados ou revogar todas as sessões como primeira medida, pois isso elimina a possibilidade de comparar os dados e distinguir uma migração de encaminhamento de uma falha de autenticação no servidor.
Valide a alteração após a expiração do DNS, o reinício do proxy e o reinício do sistema
Depois de aplicar a correção adequada, aguarde até expirar o período TTL de DNS anterior, reinicie apenas o proxy, depois reinicie o serviço Jellyfin e, por fim, reinicie o anfitrião. Após cada operação, repita os testes de início e fim de sessão, início da reprodução, avanço e recuo na reprodução e reconexão, usando o mesmo nome de anfitrião.
Um resultado estável significa que o nome de anfitrião continua a resolver para o proxy pretendido, que o proxy volta a ligar-se à instância do Jellyfin pretendida, que as sessões existentes sobrevivem a reinícios normais dos componentes quando devem e que um novo início de sessão continua válido. Se as falhas surgirem apenas durante o arranque de toda a pilha, use o processo de recuperação do proxy até ao servidor de origem para distinguir problemas de disponibilidade de problemas de autenticação.
Registe nas notas de implementação o nome de anfitrião final, o nome do servidor de origem do proxy, o caminho base, a origem do certificado e qualquer segredo de sessão configurado no proxy. Assim, será possível testar futuras alterações de DNS ou do proxy com base num contrato de identidade conhecido, em vez de o tentar redescobrir a partir dos sintomas no navegador.
Perguntas frequentes
A alteração de um registo DNS, por si só, invalida as sessões do Jellyfin?
Regra geral, não, se continuarem a ser usados o mesmo nome de anfitrião, esquema, caminho e instância do Jellyfin. Uma alteração de DNS torna-se relevante para as sessões quando encaminha os clientes para outro servidor de origem, altera a origem pública, modifica o TLS ou os redirecionamentos, ou altera uma camada de autenticação à frente do Jellyfin.
Devo revogar todas as sessões do Jellyfin após alterar um proxy?
Não como primeira medida de reparação. Preserve um cliente com falhas como evidência, confirme que a nova rota chega ao servidor pretendido e teste um novo início de sessão separadamente. Revogue sessões apenas quando tiver alterado as credenciais intencionalmente, suspeitar de exposição de tokens ou confirmar que o estado antigo do cliente deixou de ser fiável.
Assistência e dicas
Mais para ler

Como manter vídeos para adultos no seu NAS ocultos dos membros da família
Mantenha os vídeos para adultos privados num NAS familiar. Verifique as permissões das pastas, o acesso às bibliotecas do Plex e do Jellyfin, as...

O que verificar antes de carregar um modelo da comunidade em Transformers
Utilize a atualização da sandbox Jinja do Transformers para rever a proveniência dos modelos, os modelos de chat, o código remoto, os pesos serializados...

Execute o Mirage localmente: OCR e deteção de objetos a partir de uma imagem
Experimente o pequeno modelo de visão local da Cactus Compute, valide o OCR e a extração de objetos com dados reais e compreenda os...



