Se o Jellyfin abrir a partir do painel do ZimaOS, mas o seu telemóvel ou televisão não o conseguir encontrar na rede local, o contentor Jellyfin pode estar saudável, enquanto a porta exposta à LAN ou o protocolo de deteção é diferente do que o cliente Jellyfin espera. Essa é a distinção que resolveu a confusão nesta discussão da IceWhale Community, em abril de 2026.
O detalhe mais importante da discussão é que a instalação do ZimaOS através da App Store aí descrita **não** disponibilizava o Jellyfin na porta 8096 do anfitrião. Mapeava a porta 8097 no anfitrião ZimaOS para a porta 8096 dentro do contentor Jellyfin. Um segundo problema afetava a deteção automática: o Jellyfin espera a porta 7359/UDP, enquanto a comunidade indicou que a definição da aplicação ZimaOS nessa altura apresentava a porta 7359 como TCP. São problemas distintos, por isso teste primeiro o acesso direto e só depois a deteção.
Porque funciona o Jellyfin a partir do painel do ZimaOS, mas não a partir da LAN
O autor original conseguia abrir o Jellyfin através do painel do ZimaOS, mas um nmap a pesquisa não encontrou a porta TCP 8096 e os clientes Jellyfin num telemóvel e numa televisão não conseguiam ver o servidor. Esta combinação pode parecer um problema do ISP ou do router, mas o acesso local normalmente não requer o reencaminhamento de portas públicas. O primeiro ponto a verificar é o mapeamento de portas do Docker utilizado pela aplicação ZimaOS instalada.
Uma resposta da comunidade sugeriu inicialmente verificar a existência de um mapeamento direto, como:
8096:8096Em seguida, outro participante forneceu o detalhe específico do ZimaOS relevante para o pacote da App Store utilizado na discussão:
Anfitrião: 8097/TCP
Contentor: 8096/TCPCom esse mapeamento, pesquisar ou aceder à porta 8096 do anfitrião não testará a interface Web do Jellyfin. O teste correto na LAN para essa instalação é:
http://ZIMAOS_LAN_IP:8097Isto também explica por que razão abrir o Jellyfin a partir do painel do ZimaOS pode funcionar: o painel já conhece a porta do anfitrião da interface Web configurada para a aplicação.
Testar manualmente o Jellyfin antes de resolver problemas de deteção
A partir de um telemóvel, portátil ou outro dispositivo ligado à mesma rede doméstica, introduza o endereço da LAN do servidor ZimaOS e a porta real do anfitrião apresentada nas definições da aplicação Jellyfin. Para a configuração da App Store referida na discussão, isso significa:
http://192.168.x.x:8097Substituir 192.168.x.x com o IP da LAN do sistema ZimaOS. Se esta página carregar, o serviço Web do Jellyfin está acessível e o problema restante é provavelmente a deteção automática ou a configuração do cliente, e não o contentor principal.
Se a página não carregar, abra as definições da aplicação Jellyfin no ZimaOS e confirme o mapeamento atual da porta da interface Web. Não presuma que a definição atual da App Store ainda utiliza exatamente a mesma porta do anfitrião observada em abril de 2026. Os modelos de aplicações e as definições de rede do ZimaOS podem mudar entre versões.
Porque pode o ZimaOS utilizar a porta 8097 quando a documentação do Jellyfin indica 8096
O Jellyfin upstream utiliza 8096/TCP como porta HTTP predefinida. A documentação de rede do Jellyfin oficial indica 8096/TCP para HTTP e 7359/UDP para a descoberta de clientes.
O Docker permite que um anfitrião exponha uma porta externa diferente, mantendo inalterada a porta interna do Jellyfin. Um mapeamento como:
8097:8096significa que os dispositivos na sua LAN se ligam a ZIMAOS_IP:8097, enquanto o tráfego é encaminhado para a porta 8096 dentro do contentor Jellyfin. Este é um comportamento válido do Docker; os dois números de porta não têm de ser iguais.
O exemplo oficial do contentor Jellyfin normalmente publica 8096:8096/tcp e 7359:7359/udp. O ZimaOS pode escolher uma porta diferente para a interface Web no anfitrião, para evitar conflitos com outro serviço. Por isso, o valor importante para o seu telemóvel ou TV é a porta atual do anfitrião apresentada pelo ZimaOS, e não simplesmente a predefinição original.
A descoberta automática do Jellyfin utiliza a porta 7359 UDP
A última resposta no tópico da comunidade identificou um segundo detalhe de configuração: as definições do Docker do ZimaOS visíveis na altura mostravam a porta 7359 como TCP, enquanto o Jellyfin define essa porta como UDP para a descoberta de clientes na rede local.
A documentação atual do Jellyfin confirma:
-
8096/TCP— serviço HTTP predefinido do Jellyfin dentro de uma instalação padrão. -
8920/TCP— serviço HTTPS opcional quando ativado. -
7359/UDP— descoberta do cliente Jellyfin na rede local.
Se a definição atual da aplicação Jellyfin no ZimaOS ainda mapear a porta 7359 como TCP, altere esse mapeamento de descoberta para UDP ou recrie o mapeamento como 7359/UDP. Não altere o mapeamento da interface Web de TCP para UDP; o HTTP na porta 8096 continua a utilizar TCP.
Adicionar manualmente o servidor Jellyfin no telemóvel ou na TV
A descoberta automática é conveniente, mas não é necessária para utilizar o Jellyfin. Se o acesso direto pela LAN funcionar, adicione manualmente o servidor no cliente Jellyfin utilizando a porta do anfitrião configurada pelo ZimaOS:
http://ZIMAOS_LAN_IP:8097Para uma instalação diferente da ZimaOS, substitua 8097 com a porta real da interface Web no anfitrião apresentada nas definições da aplicação.
Se o endereço introduzido manualmente funcionar, mas a descoberta automática não, concentre-se na porta 7359/UDP e na segmentação da rede local, em vez de reinstalar o Jellyfin. As transmissões de descoberta precisam geralmente de que o cliente e o servidor estejam na mesma sub-rede local acessível; o isolamento da rede Wi-Fi de convidados, as regras de VLAN ou a filtragem da firewall podem impedir a descoberta, mesmo quando o acesso HTTP direto é permitido.
Como verificar o mapeamento de portas do Jellyfin na ZimaOS
- Abra as definições da aplicação Jellyfin na ZimaOS.
- Localize o mapeamento das portas da interface Web ou do contentor.
- Identifique a porta TCP do anfitrião mapeada para a porta
8096do contentor Jellyfin. - Testar
http://ZIMAOS_LAN_IP:HOST_PORTa partir de outro dispositivo da LAN. - Em seguida, verifique o mapeamento de descoberta da porta
7359. - Confirme que 7359 utiliza UDP, e não TCP, se pretender a descoberta automática na LAN.
- Reinicie a aplicação Jellyfin depois de alterar as definições de rede do Docker.
Se estiver a utilizar uma instalação Docker personalizada em vez do pacote da ZimaOS App Store, o guia oficial do contentor Jellyfin apresenta os mapeamentos de referência upstream:
8096:8096/tcp
7359:7359/udpO que significa se o Nmap não conseguir ver a porta 8096?
Neste tópico específico, uma porta do anfitrião 8096 fechada ou inexistente não provava que o Jellyfin estivesse indisponível. O pacote da ZimaOS App Store referido pela comunidade utilizava, em vez disso, a porta do anfitrião 8097. Assim, um teste útil consiste em analisar a porta que a ZimaOS expõe efetivamente:
nmap -p 8097 ZIMAOS_LAN_IPSe as definições atuais da aplicação mostrarem outra porta do anfitrião, analise essa porta. Utilize isto apenas como verificação de resolução de problemas na LAN; não é necessário expor diretamente o Jellyfin à Internet pública apenas para ligar um telemóvel ou televisor dentro de casa.
É necessário o encaminhamento de portas no router ou no ISP para o acesso local ao Jellyfin?
Não, não para dispositivos que comunicam dentro da mesma rede doméstica. O autor original contactou o suporte do ISP, mas os sintomas descritos no tópico estavam relacionados com portas locais do Docker e problemas de descoberta. O encaminhamento de portas públicas só é uma questão separada quando pretende, deliberadamente, aceder ao Jellyfin a partir do exterior da sua rede doméstica.
O guia de rede do próprio Jellyfin alerta para o facto de a abertura de uma porta de serviço para uma rede mais abrangente aumentar a exposição. Mantenha esta resolução de problemas focada primeiro no acesso pela LAN. Para acesso remoto, utilize um proxy inverso corretamente configurado, uma rede privada sobreposta ou outro método seguro de acesso remoto, em vez de abrir portas sem compreender as implicações de segurança.
Lista de verificação para resolução de problemas do Jellyfin na LAN do ZimaOS
- Confirme que o Jellyfin está em execução e abre a partir do painel do ZimaOS.
- Abra as definições da aplicação e registe o mapeamento atual da interface Web entre o anfitrião e o contentor.
- Se apresentar
8097:8096, ligue-se ahttp://ZIMAOS_IP:8097, e não a porta 8096. - Experimente esse endereço noutro dispositivo na mesma LAN.
- Se o acesso direto funcionar, adicione manualmente o endereço no cliente móvel ou de TV do Jellyfin.
- Verifique se a porta de deteção 7359 do Jellyfin está mapeada como UDP.
- Certifique-se de que o telemóvel ou a televisão não estão isolados numa rede Wi-Fi de convidado nem bloqueados por uma VLAN.
- Reinicie o contentor do Jellyfin depois de alterar a configuração das portas.
- Só depois destas verificações deve investigar as regras da firewall do anfitrião ou uma segmentação de rede mais complexa.
Perguntas frequentes sobre o Jellyfin não encontrado no ZimaOS
Que porta devo utilizar para o Jellyfin no ZimaOS?
Utilize a porta da interface Web no anfitrião apresentada nas definições da aplicação Jellyfin do ZimaOS. Na discussão da comunidade de abril de 2026, a instalação através da App Store utilizava a porta do anfitrião 8097 mapeada para a porta interna do Jellyfin 8096. Não assuma que todos os pacotes posteriores utilizam a mesma porta do anfitrião.
Porque é que o Jellyfin indica a porta 8096, mas o ZimaOS utiliza a 8097?
8096 é a porta HTTP interna predefinida do Jellyfin. O Docker pode publicar esse serviço através de uma porta diferente no anfitrião. O mapeamento do ZimaOS indicado era 8097:8096, pelo que os clientes da LAN precisavam do IP do ZimaOS e da porta 8097.
A porta 7359 do Jellyfin deve ser TCP ou UDP?
UDP. A documentação oficial de rede do Jellyfin define a porta 7359/UDP para a deteção de clientes na rede local. A comunidade comunicou uma configuração da aplicação ZimaOS que a apresentava como TCP, o que pode interferir com a deteção automática.
Porque é que consigo abrir o Jellyfin a partir do painel do ZimaOS, mas não na aplicação de TV?
O painel pode abrir a interface Web utilizando a porta configurada internamente pelo ZimaOS. Uma aplicação de TV tem de alcançar o endereço e a porta do anfitrião acessíveis pela LAN, e a deteção automática depende adicionalmente do tráfego de deteção UDP. É por isso que o acesso pelo painel, por si só, não prova que a deteção esteja corretamente configurada.
Posso utilizar o Jellyfin sem a deteção automática do servidor?
Sim. Introduza manualmente o endereço do servidor no cliente Jellyfin. Para o mapeamento indicado na discussão, o formato é http://ZIMAOS_LAN_IP:8097. Utilize a porta do anfitrião atual se for diferente.
