O Jellyfin pode funcionar atrás de um proxy inverso num subcaminho?

Eva Wong é a redatora técnica e entusiasta residente na ZimaSpace. Uma geek desde sempre, apaixonada por homelabs e software de código aberto, dedica-se a traduzir conceitos técnicos complexos em guias práticos. A Eva acredita que a auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ajuda a comunidade a desmistificar configurações de hardware, desde montar o primeiro NAS até dominar os contentores Docker.

Sim. O Jellyfin pode funcionar por trás de um proxy inverso num subcaminho, como https://example.com/jellyfin, mas o Jellyfin e o proxy têm de usar o mesmo caminho base.

Uma falha de subcaminho costuma dar a impressão de que o site funciona apenas parcialmente: a página de início de sessão pode carregar, enquanto o JavaScript, as imagens, os WebSockets, os redirecionamentos ou os clientes nativos falham. Teste o caminho por camadas — primeiro o URL base, depois a rota do proxy e, por último, os cabeçalhos encaminhados e o endereço do cliente — para conseguir distinguir um caminho incompatível de um problema de TLS ou da identidade do proxy.

Faça corresponder o URL base do Jellyfin ao subcaminho público

Defina o URL base do Jellyfin como o prefixo público exato que pretende utilizar, por exemplo, /jellyfin. Não adicione um prefixo interno diferente só porque o proxy utiliza um bloco de localização com nome; o caminho visível no navegador e o URL base do Jellyfin devem corresponder à mesma raiz da aplicação.

A documentação do Jellyfin para o proxy inverso do Apache fornece explicitamente um exemplo de subcaminho e indica aos administradores que definam o URL base como /jellyfin antes de ligarem os clientes a esse endereço completo. exemplo oficial de subcaminho

Reinicie o Jellyfin depois de alterar o URL base e, em seguida, abra o subcaminho público numa nova janela de navegação privada. Se o redirecionamento inicial remover imediatamente /jellyfin ou o duplicar, corrija o URL base antes de alterar as definições de WebSocket ou autenticação.

Encaminhe o mesmo prefixo através do proxy inverso

Configure o proxy inverso para que os pedidos que começam pelo prefixo público sejam encaminhados para o Jellyfin sem introduzir uma transformação de caminho adicional. A configuração mais simples é um prefixo público, um URL base correspondente no Jellyfin e um serviço upstream.

O guia do Caddy para o Jellyfin mostra o mesmo padrão: configure o caminho base do Jellyfin, redirecione o prefixo sem barra final para a versão com barra final e encaminhe os pedidos sob esse prefixo para o backend do Jellyfin. caminho base e rota do proxy correspondentes

Se o navegador receber um erro 404 do proxy antes de o Jellyfin registar o pedido, a rota está errada na camada do proxy. Se o Jellyfin receber o pedido, mas gerar ligações sem o prefixo, o URL base está errado na camada da aplicação. Mantenha separados estes dois sinais de falha.

Verifique os recursos estáticos e os WebSockets, não apenas a página de início de sessão

Uma resposta HTML bem-sucedida não basta para considerar saudável a configuração do subcaminho. Abra as ferramentas de programador ou o registo do proxy e confirme que os pedidos de JavaScript, CSS, imagens, API e WebSocket permanecem todos sob o mesmo prefixo público.

Os exemplos de proxy inverso do Jellyfin incluem a configuração de WebSocket porque os clientes interativos mantêm uma ligação por socket além dos pedidos HTTP normais. Por isso, uma regra de proxy que trate apenas os pedidos de página pode parecer correta até que falhem o estado da reprodução, as atualizações da sessão ou o comportamento da interface em tempo real. requisitos do proxy inverso

O critério de sucesso é simples: não deve haver respostas 404/502 repetidas para recursos com prefixo, o WebSocket tem de estabelecer ligação com sucesso e a navegação não pode sair para a raiz do site. Se falhar apenas uma classe de pedidos, corrija essa regra do proxy em vez de alterar as definições da biblioteca ou da autenticação do Jellyfin.

Preserve a identidade do cliente através do proxy

Depois de o caminho funcionar, verifique as informações encaminhadas do cliente. O Jellyfin utiliza a configuração de confiança do proxy para decidir se os endereços e protocolos encaminhados devem ser aceites, o que afeta o comportamento entre acessos locais e remotos e as regras de acesso externo.

O guia de rede do Jellyfin avisa que os cabeçalhos encaminhados por um proxy não fidedigno são descartados e recomenda configurar o endereço do proxy em Proxies conhecidos. Definição de Proxies conhecidos Uma verificação separada do IP do cliente é útil quando o site funciona, mas todos os pedidos parecem ter origem no proxy.

Não resolva um problema de identificação confiando em todas as sub-redes privadas ou em todos os cabeçalhos encaminhados. Adicione apenas o salto real do proxy ou a rede de proxy controlada e compare um pedido da rede local com um pedido remoto nos registos do Jellyfin para confirmar que são classificados como esperado.

Teste os endereços do navegador e do cliente nativo separadamente

Introduza o endereço completo do servidor, incluindo o subcaminho, quando um cliente Jellyfin pedir o URL do servidor. Um cliente configurado como https://example.com não consegue deduzir que o Jellyfin está em /jellyfin.

Teste um navegador e um cliente nativo na rede local e, em seguida, repita o teste através do nome de domínio público. Se o nome de domínio funcionar, mas o acesso direto pelo IP local não, isso pode ser esperado quando a rota do proxy e o certificado dependem do nome de domínio; o teste entre nome de domínio e IP ajuda a isolar esse caso sem enfraquecer o proxy.

Continue quando o URL com prefixo continua a funcionar após o início de sessão, a navegação, a utilização de WebSocket e a reprodução nos clientes que realmente suporta. Se apenas um cliente falhar enquanto o navegador e os outros clientes funcionam, considere o problema relacionado com o endereço ou a compatibilidade do cliente, em vez de reescrever uma configuração de proxy que funciona.

Assistência e dicas

Mais para ler

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.