Como configurar um servidor de mídia Jellyfin no Linux

Para configurar um servidor de mídia Jellyfin no Linux , instale o pacote do servidor, abra o assistente web, crie uma conta de administrador e adicione suas pastas de mídia. Este guia utiliza o instalador atual do Jellyfin com verificação de checksum para Debian, Ubuntu e derivados suportados. Outras distribuições Linux devem seguir as orientações do Jellyfin para contêineres ou pacotes da comunidade.

Antes de começar, monte seu dispositivo de armazenamento e anote o caminho do Linux, como /srv/media/Movies. O pacote executa o Jellyfin como uma conta de serviço separada chamada jellyfin, que precisa de permissão para acessar diretórios pai e ler arquivos. Para outras distribuições ou configuração manual do repositório, consulte o guia de instalação oficial do Linux .

Instale e configure o Jellyfin

1. Baixe e verifique o instalador.

No servidor Debian ou Ubuntu, abra um terminal ou conecte-se via SSH. Instale as ferramentas de download e checksum e, em seguida, obtenha o script e o arquivo de checksum correspondente:

sudo apt update
sudo apt install curl coreutils
mkdir -p ~/jellyfin-setup && cd ~/jellyfin-setup
curl -fsSLO https://repo.jellyfin.org/install-debuntu.sh
curl -fsSLO https://repo.jellyfin.org/install-debuntu.sh.sha256sum
sha256sum -c install-debuntu.sh.sha256sum

Continue somente se o resultado for install-debuntu.sh: OK. Como o instalador é executado com privilégios elevados, você pode inspecioná-lo primeiro com less install-debuntu.sh. O guia do Jellyfin lista as distribuições derivadas compatíveis e as opções de instalação manual.

2. Execute o instalador e verifique o serviço.

Execute o script verificado e confirme se o Jellyfin está ativo:

sudo bash install-debuntu.sh
sudo systemctl status jellyfin

Se estiver parado, habilite-o na inicialização e inicie-o com sudo systemctl enable --now jellyfin.

3. Abra o assistente de configuração.

A partir de um dispositivo na mesma rede, acesse http://<server-ip>:8096, substituindo o espaço reservado pelo endereço LAN do servidor Linux. Use http://localhost:8096no próprio servidor. A porta 8096/TCPé a porta HTTP padrão. Se a página não carregar, verifique o serviço e permita a porta no firewall para dispositivos LAN confiáveis.

4. Escolha um idioma e crie um administrador.

Selecione o idioma da interface de configuração e, em seguida, insira um nome de usuário de administrador e uma senha forte e exclusiva. Essa conta controla as configurações do servidor e os usuários; adicione outras contas após o assistente, se necessário.

5. Adicione uma biblioteca de mídia

Escolha Adicionar Biblioteca de Mídia , selecione um tipo como Filmes, Séries ou Música, insira um nome de exibição e adicione o caminho completo da pasta. Bibliotecas separadas ajudam o Jellyfin a identificar o conteúdo. Por exemplo, use uma pasta como /srv/media/Movies/Arrival (2016)/Arrival (2016).mkv. Consulte o guia de bibliotecas e o guia de nomenclatura de filmes .

Se uma pasta estiver faltando ou estiver vazia após a verificação, teste o acesso como a conta de serviço. sudo -u jellyfin ls /srv/media/MoviesConceda a ela apenas permissões de leitura e de navegação no diretório por meio do seu grupo de mídia ou de uma ACL com escopo. Evite permissões recursivas amplas chmod 777ou alterações na propriedade de um disco inteiro. O FAQ oficial também aponta permissões e organização de arquivos como causas comuns de mídia ausente.

6. Defina o idioma e a região dos metadados.

Escolha o idioma e a região que o Jellyfin deve priorizar para títulos, descrições e outros metadados obtidos. Essa configuração é independente do idioma da interface de configuração e pode ser alterada posteriormente para cada biblioteca. Os resultados dependem da disponibilidade do provedor e de uma conexão com a internet.

7. Analise as configurações de acesso remoto.

Desative o acesso remoto para um servidor somente local. Se você pretende assistir de fora de casa, ative a opção " Permitir acesso remoto a este servidor" e configure separadamente uma conexão segura, como uma VPN ou um proxy reverso HTTPS. O assistente de configuração não fornece criptografia nem conclui a configuração do roteador. Desative a opção "Ativar mapeamento automático de portas ", a menos que você precise especificamente do UPnP; a Jellyfin recomenda desativá-lo, a menos que seja necessário.

Não encaminhe a porta HTTP 8096diretamente para a internet pública. A porta HTTPS padrão do Jellyfin é 8920/TCP8080 e permanece inativa até que o HTTPS seja configurado. Consulte o guia de rede oficial antes de habilitar o acesso remoto.

8. Finalize e teste a reprodução.

Conclua o assistente, faça login e deixe o Jellyfin analisar as pastas selecionadas. Teste a partir de outro dispositivo na sua rede local, inserindo manualmente o endereço e a porta do servidor caso a detecção automática não o encontre. Os aplicativos compatíveis estão listados na página oficial de clientes .

Corrigir problemas comuns de configuração

• Página web indisponível: verifique sudo systemctl status jellyfino endereço IP do servidor, a porta 8096e as regras do firewall da LAN. Logs recentes: sudo journalctl -u jellyfin -n 50 --no-pager.
• Biblioteca vazia: confirme se o armazenamento está montado e se a jellyfinconta tem permissão para ler a pasta. Use o tipo de biblioteca correto e a nomenclatura compatível.
• O cliente não consegue descobrir o servidor: insira o endereço da LAN :8096manualmente. A descoberta local usa UDP 7359, mas a entrada direta do endereço não depende da descoberta.

Após a reprodução local estar funcionando, adicione usuários ou configure o acesso remoto como uma tarefa de rede separada.