Jellyseerr: Guia para principiantes na gestão dos media domésticos

Se estiver a utilizar o Jellyfin, já sabe que é excelente para alojar e transmitir a sua coleção multimédia. No entanto, algumas partes podem ser problemáticas, como a gestão de pedidos. É aqui que entra o Jellyseerr. 

Oferecendo facilidade de utilização e funcionalidades avançadas, o Jellyseerr pode levar a sua biblioteca multimédia para o próximo nível. Este guia guia-o através do que é e como garantir uma integração perfeita para a sua configuração.

Índice

1. O que é o Jellyseerr?
2. Como instalar o Jellyseerr
3. Passo a passo da configuração básica do Jellyseerr
4. Configuração avançada
5. Otimizar o desempenho do Jellyseer
6. Solução de Problemas Comuns
7. Perguntas mais frequentes
8. Considerações finais

1. O que é o Jellyseerr?

O Jellyseerr é uma ferramenta de código aberto que pode facilitar a gestão dos pedidos de media no seu servidor Jellyfin. Ele funciona como um intermediário entre o servidor de mídia, ferramentas de automação e usuários. As principais coisas que ele lida são pedidos, aprovação e rastreamento de mídia.

Embora tenha sido concebido principalmente para o Jellyfin, o Jellyseerr pode funcionar com outros servidores multimédia como o Plex e o Emby. No entanto, os criadores alertaram para o facto de algumas funcionalidades poderem ser diferentes noutras plataformas.

• Gestão de pedidos personalizável: Funcionalidades avançadas para pedir meios de comunicação com um sistema de revisão e aprovação fácil.
• Manuseamento de automação: A aplicação pode acionar ferramentas populares como Radarr, Sonarr e Prowlarr quando necessário.
• Notificações: Fornece actualizações em tempo real sobre o estado de cada pedido. 

Leia também: 

• Jellyfin Vs Plex - Batalha dos gestores de multimédia
• As 7 principais alternativas ao Plex

b. Pré-requisitos de instalação

Antes de instalar o Jellyseerr, certifique-se do seguinte:

• Servidor multimédia: O Jellyfin está instalado e a funcionar.
• Ferramentas de automatização: Radarr, Sonarr e Prowlarr (para indexadores).
• Base de dados: SQLite (Também é possível utilizar o PostgreSQL)
• Ambiente de alojamento: NAS / Home Server / Seedbox

2. Como instalar o Jellyseerr

O Jellyseerr pode ser executado em todas as plataformas que suportam o Jellfin. Embora as combinações sejam extensas, concentrar-nos-emos principalmente naquelas que suportam Docker uma vez que é a forma mais fiável de gerir a configuração. 

Se não estiver familiarizado com o Docker, leia o Guia do RapidSeedbox para iniciantes no Docker.

a. Opção 1: Para utilizadores NAS

Aceda ao seu contentor Docker no seu NAS e retire a imagem do Jellyseerr. Pode fazê-lo navegando para o separador "Registry", procurando por Jellyseer e descarregando a imagem.

Em seguida, crie um contentor:

Vai a "Contentor" e clica em "Criar" para iniciar um novo contentor Jellyseer.

• Definir os seguintes parâmetros: 

Mapeamento de volumes:

• Mapeamento de portas:

Mapear uma porta local (por exemplo, 3000) para a porta 3000 do contentor.

• Variáveis de ambiente:

• Iniciar o contentor.

Agora pode aceder ao Jellyseerr abrindo o seu browser e indo para http://:3000.

Leia também: Os 8 melhores NAS Synology para multimédia e sincronização de ficheiros

b. Opção 2: Para servidores domésticos Seedbox / Linux

Certifique-se de que sua seedbox suporta Docker (a maioria dos provedores suporta) e use SSH para fazer login. Em seguida, execute o contêiner Jellyseerr com o seguinte:

Nota: Substitua /path/to/config pelo seu diretório de armazenamento da seedbox.

Agora pode usar o domínio ou IP da sua seedbox e a porta (por exemplo, http://:3000) para aceder ao Jellyseerr. 

Se estiver a executar um servidor doméstico Windows, pode utilizar este mesmo conjunto de comandos. Apenas o processo de instalação do Docker será alterado.

Leia também:

• Deve utilizar uma caixa de sementes?
• O que faz uma caixa de sementes?

Experimente o RapidSeedbox hoje!

3. Passo a passo da configuração básica do Jellyseerr

Para utilizar totalmente o Jellyseerr, conecte-o ao seu servidor Jellyfin. Isso permite que o Jellyseerr gerencie solicitações de mídia e adicione conteúdo aprovado diretamente à sua biblioteca.

Abra o seu browser e navegue para http://:3000 (ou o URL equivalente para a sua plataforma). Utilize as credenciais de administrador predefinidas criadas durante a configuração. Se solicitado, crie uma senha forte para a conta de administrador.

Aceder à página de definições:

• Uma vez iniciada a sessão, clique no ícone de engrenagem das definições na interface do Jellyseerr.
• Navegue até à secção Servidor multimédia.

Adicionar detalhes do Jellyfin:

• Host/IP: Digite o endereço IP ou o nome de domínio do seu servidor Jellyfin (por exemplo, 192.168.1.100 ou https://myjellyfinserver.com).
• Porta: Utilizar a porta predefinida (8096 para HTTP ou 8920 para HTTPS).
• Chave de API: Obtenha-a a partir do Jellyfin iniciando sessão no Jellyfin, acedendo a Definições do utilizador > Chaves de API e criando uma nova chave para o Jellyseerr.
• Clique em Guardar para aplicar as definições.

Testar a ligação:

O Jellyseerr fornece um botão "Testar conexão" para confirmar a integração bem-sucedida. Clique nele para verificar se o servidor está acessível.

a. Adicionar Radarr, Sonarr e Prowlarr

O Jellyseerr integra-se com ferramentas de automação como Radarr, Sonarr e Prowlarr para lidar com o download e a organização da mídia solicitada. Nas configurações do Jellyseerr, localize e abra a guia Integrações.

Adicionar Radarr com os seguintes detalhes:

• Host/IP: O endereço IP ou domínio do seu servidor Radarr (por exemplo, http://localhost:7878 ou http://192.168.1.100:7878).
• Chave da API: Obtenha-a no Radarr em Definições > Geral > Segurança.
• Clique em Guardar e Testar ligação para garantir que a configuração está correta.

Adicionar Sonarr:

Repita o processo acima, mas utilize a respectiva porta (predefinição: 8989) e a chave da API em Definições > Geral > Segurança.

Adicionar Prowlarr (opcional):

Se utilizar o Prowlarr para gerir indexadores, clique em Adicionar integração e selecione Prowlarr.

Introduza o IP, a porta (predefinição: 9696) e a chave API em Definições > Geral > Segurança no Prowlarr.

Leia também:

• Guia completo do Radarr - Como instalar, usar e muito mais
• Guia do Sonarr - Configuração, como utilizar e muito mais
• Guia do Prowlarr: Como Instalar, Configurar e Utilizar

4. Configuração avançada

Personalize a configuração para corresponder às suas preferências quando o Jellyseerr estiver integrado no Jellyfin e nas suas ferramentas de automatização.

a. Definir funções e permissões do utilizador

• Vá para Gestão de utilizadores nas definições.
• Crie contas de utilizador para as pessoas que irão fazer pedidos ou gerir aprovações.
• Atribuir funções

b. Definir preferências de qualidade predefinidas

Na secção Integrações, configure o Radarr e o Sonarr para dar prioridade a qualidades específicas. Por exemplo, pode definir o Radarr para transferir filmes em 4K ou o Sonarr para preferir versões HDTV-1080p para programas de TV.

c. Ativar etiquetas e filtragem

Utilize etiquetas para organizar ou dar prioridade a pedidos específicos. Por exemplo, atribua uma etiqueta "Crianças" a conteúdos para crianças ou "4K" a filmes de alta qualidade. É preferível configurar filtros para dar prioridade aos pedidos com etiquetas específicas automaticamente.

d. Proteja a sua instalação (Importante!)

Se o seu servidor ou o Jellyseerr estiver acessível a partir da Internet, proteja-o activando o HTTPS.

Use um proxy reverso como o Nginx ou o Traefik para lidar com certificados SSL e fornecer um domínio personalizado (por exemplo, https://jellyseer.mydomain.com).

Leia também: 

• Gerenciador de proxy Nginx: Como configurar e usar
• Traefik vs NGINX: Comparação de design e finalidade

5. Otimizar o desempenho do Jellyseerr

Embora o Jellyseerr seja relativamente leve, nós o executamos em ambientes com poucos recursos. Por causa disso, ele pode ficar lento ou não responder, travar sob uso intenso ou falhar no processamento eficiente de solicitações.

A causa principal reside frequentemente nas limitações dos recursos do sistema ou nas ineficiências da base de dados. Eis como pode optimizá-la para maximizar o desempenho:

a. Identificar as limitações de recursos

CPU, RAM ou armazenamento limitados podem causar atrasos ou falhas. Aloque recursos adicionais do sistema para o Jellyseerr aumentando os limites de CPU e memória do contêiner do Docker:

b. Otimizar a base de dados

O Jellyseerr usa SQLite por defeito, o que funciona bem para pequenas configurações mas pode tornar-se um gargalo à medida que a sua biblioteca multimédia e base de utilizadores cresce. Para mitigar isso, você pode migrar para PostgreSQL, que é mais robusto e escalável.

• Instale o PostgreSQL no seu servidor ou utilize um serviço PostgreSQL baseado na nuvem.
• Actualize a configuração do Jellyseerr para utilizar o PostgreSQL definindo DB_TYPE=postgresql e fornecendo detalhes de ligação.
• Migrar os dados existentes do SQLite para o PostgreSQL utilizando uma ferramenta de migração ou a documentação do Jellyseerr.

c. Reiniciar o contentor Docker periodicamente

Com o tempo, o uso temporário de recursos dentro do contêiner do Docker pode se acumular, levando a um desempenho degradado. Resolva isso com reinicializações periódicas do contêiner do Docker do Jellyseerr para limpar o uso temporário de recursos:

reiniciar o docker jellyseerr

Para garantir uma manutenção regular, pode automatizar este processo com uma tarefa cron ou com o Programador de Tarefas do Windows.

d. Otimizar as notificações e as actualizações

As notificações ou actualizações de estado frequentes podem causar uma carga desnecessária no servidor, especialmente em ambientes com vários utilizadores.

• Reduzir a frequência das actualizações de estado nas definições do Jellyseerr.
• Limite as notificações a eventos essenciais (por exemplo, aprovação de um pedido ou adição de meios de comunicação) para evitar atividade excessiva em segundo plano.

e. Minimizar plug-ins ou recursos desnecessários

A execução de plugins adicionais ou a ativação de funcionalidades não utilizadas pode afetar desnecessariamente o desempenho do Jellyseerr.

• Desativar funcionalidades ou integrações que não utiliza ativamente.
• Audite as definições e integrações do Jellyseerr para otimizar o fluxo de trabalho.

6. Resolução de problemas comuns

Mesmo com uma instalação bem configurada, pode encontrar problemas ao utilizar o Jellyseerr. Abaixo encontram-se problemas comuns, as suas potenciais causas e soluções detalhadas para o ajudar a resolvê-los eficazmente.

a. O Jellyseerr não consegue ligar-se ao Jellyfin

Se o Jellyseerr não conseguir ligar-se ao seu servidor Jellyfin, poderá notar que os pedidos não são processados ou que os detalhes do media não podem ser recuperados. 

Este problema é normalmente causado por detalhes incorrectos do servidor introduzidos no Jellyseerr, tais como um endereço IP, número de porta ou chave API inválidos. Restrições de rede, como um firewall que bloqueia a comunicação entre o Jellyseerr e o Jellyfin, também podem ser o culpado.

Soluções possíveis:

• Verifique novamente o endereço IP ou domínio do Jellyfin, a porta (8096 para HTTP ou 8920 para HTTPS) e a chave API nas configurações do Jellyseerr.
• Regenere a chave da API no Jellyfin em Definições do utilizador > Chaves da API, se necessário.
• Certifique-se de que não existem regras de firewall a bloquear o acesso. Para o efeito, pode testar a ligação utilizando um comando como:

b. Pedidos que não figuram em Radarr/Sonarr

Quando os pedidos aprovados não aparecem no Radarr ou no Sonarr, muitas vezes isso se deve a configurações de integração incorretas no Jellyseerr. Isso pode incluir URLs inválidos, portas erradas ou chaves de API incompatíveis. 

Outra causa comum é o facto de o servidor Jellyseerr não conseguir chegar a Radarr ou Sonarr devido a restrições de rede ou má configuração.

Soluções possíveis:

• Verifique os URLs para Radarr e Sonarr nas configurações do Jellyseerr. Por exemplo, use http://:7878 ou http://:8989.
• Confirme as chaves da API recuperando-as em Definições > Geral > Segurança no Radarr e no Sonarr.
• Teste a ligação no separador de integrações do Jellyseerr para garantir que tudo está configurado corretamente.

c. Os media não são descarregados

Se os pedidos aprovados aparecerem no Radarr ou no Sonarr mas as transferências não forem iniciadas, o problema reside frequentemente na configuração do cliente de transferência ou dos indexadores. Um cliente de download mal configurado, como o qBittorrent ou o Transmission, pode não estar conectado corretamente. 

Em alternativa, os indexadores em falta ou mal configurados no Radarr ou no Sonarr podem não conseguir encontrar o conteúdo solicitado.

Soluções possíveis:

• Certifique-se de que o cliente de download foi adicionado corretamente no Radarr/Sonarr com o endereço IP, a porta e a chave de API adequados.
• Teste os indexadores no Radarr ou no Sonarr pesquisando manualmente o conteúdo solicitado.
• Verifique os registos no Radarr ou no Sonarr para detetar quaisquer erros relacionados com transferências ou ligações de indexadores.

d. Os meios de comunicação não aparecem no Jellyfin

Se o conteúdo baixado não aparecer na sua biblioteca do Jellyfin, isso geralmente se deve a caminhos incorretos da biblioteca ou a varreduras atrasadas da biblioteca. Os caminhos da biblioteca no Jellyfin podem não corresponder ao local de download do Radarr ou do Sonarr, ou o Jellyfin pode não estar verificando a biblioteca com frequência suficiente. 

As incompatibilidades de metadados também podem fazer com que o conteúdo não seja apresentado corretamente.

Soluções possíveis:

• Verifique se os caminhos da biblioteca do Jellyfin estão configurados corretamente para corresponder aos diretórios de download usados pelo Radarr e Sonarr.
• Acione manualmente uma verificação da biblioteca no Jellyfin navegando até Painel > Bibliotecas e selecionando Verificar arquivos da biblioteca.
• Utilize o gestor de metadados do Jellyfin para verificar e atualizar os metadados dos suportes em falta.

e. A interface Web do Jellyseerr não está a carregar

Se não conseguir aceder à interface Web do Jellyseerr, o contentor poderá não estar a funcionar ou o mapeamento de portas na configuração do Docker poderá estar incorreto. Este problema também pode surgir se um proxy reverso estiver mal configurado ou se os certificados SSL estiverem incorretamente configurados para acesso HTTPS.

Soluções possíveis:

• Verifique o estado do contentor Docker do Jellyseerr utilizando o comando: 

• Reiniciar o contentor se estiver parado:

reiniciar o docker jellyseerr

• Certifique-se de que a configuração do Docker ou do NAS mapeia a porta correta (predefinição: 3000).
• Verifique o certificado SSL e as definições de proxy se estiver a utilizar HTTPS com um proxy invertido.

f. As notificações não funcionam

Quando os utilizadores não recebem notificações sobre actualizações de pedidos, isso deve-se frequentemente ao facto de as definições de notificação no Jellyseerr não terem sido configuradas ou de o serviço de notificação escolhido (por exemplo, e-mail ou push) estar mal configurado. 

Isto também pode ocorrer se o serviço de notificação não tiver credenciais ou definições de ligação adequadas.

Soluções possíveis:

• Vá a Definições > Notificações no Jellyseerr e configure o serviço de notificação (por exemplo, correio eletrónico ou um serviço de notificação push).
• Testar o sistema de notificação desencadeando uma atualização do pedido.
• Verificar os registos de erros relacionados com a configuração do serviço de notificação.

7. Perguntas mais frequentes

8. Considerações finais

Se ainda não o fez, agora é a altura de configurar o Jellyseerr e experimentar os seus benefícios em primeira mão. Simplifique a sua gestão de media, melhore a sua experiência Jellyfin e mantenha os seus utilizadores satisfeitos com esta ferramenta de pedido de media.

Os principiantes na gestão de uma coleção multimédia devem começar a aprender a utilizar o Jellyseerr desde cedo. Não vai acreditar na rapidez com que a sua coleção pode crescer e ficar fora de controlo. 

Obtenha o RapidSeedbox agora!