Perguntas frequentes
Perguntas sobre instalação
A tela exibe “Error response from daemon: toomanyrequests: Rate exceeded”
Pergunta: recebo um erro ao baixar as imagens Docker.
Resposta: há um congestionamento no download da imagem Docker. Aguarde um pouco e execute novamente o script de shell do instalador.
Não é possível baixar a imagem do contêiner por meio de um proxy
Pergunta: não consigo baixar imagens de contêiner usando uma conexão com a internet via proxy.
Resposta: é necessário adicionar as configurações do proxy ao daemon do Docker.
Configuração do daemon do Docker
Crie um arquivohttp-proxy.confno diretório/etc/systemd/system/docker.service.d/.sudo mkdir -p /etc/systemd/system/docker.service.d/ sudo nano /etc/systemd/system/docker.service.d/http-proxy.confAdicione o seguinte conteúdo ao arquivo:
[Service] Environment="HTTP_PROXY=http://your-proxy-server:3128" Environment="HTTPS_PROXY=http://your-proxy-server:3128" Environment="NO_PROXY=localhost,127.0.0.1"Substitua
your-proxy-serverpelo nome do host ou endereço IP do seu servidor proxy.Recarregue o daemon do Docker
Para aplicar as alterações, recarregue o daemon do Docker.sudo systemctl daemon-reload sudo systemctl restart docker
Não é possível instalar devido a outros erros exibidos
Pergunta: recebo erros e não consigo concluir a instalação.
Resposta:
- Talvez o espaço de armazenamento esteja acabando. Verifique o espaço disponível.
- Se uma mensagem de erro aparecer durante a execução do script de shell do instalador, registre essa mensagem e entre em contato com o suporte.
A instalação foi concluída, mas não é possível acessar o sistema
Pergunta: a instalação foi concluída, mas não consigo acessar a interface web.
Resposta: verifique se o Docker está funcionando corretamente. Execute o comando abaixo para confirmar:
sudo docker ps
Se estiver funcionando corretamente, será exibida uma lista dos contêineres em execução.
Se nada for exibido ou aparecer uma mensagem de erro, verifique novamente a instalação e as configurações do Docker.
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
ea5b30e0d8f7 public.ecr.aws/mediaharbor/stream:latest "/usr/local/bin/janu…" 45 seconds ago Up 10 seconds stream
30b909ec82b7 public.ecr.aws/mediaharbor/mhb:latest "/bin/bash /mnt/run.…" 45 seconds ago Up 10 seconds mhb
e4cead5b7988 public.ecr.aws/mediaharbor/ui:latest "/nodejs/bin/node se…" 45 seconds ago Up 10 seconds 0.0.0.0:3000->3000/tcp, :::3000->3000/tcp ui
9c79d6582467 public.ecr.aws/mediaharbor/api:latest "docker-entrypoint.s…" 45 seconds ago Up 11 seconds 0.0.0.0:8080->8080/tcp, :::8080->8080/tcp api
714364d2acaf public.ecr.aws/mediaharbor/proxy:latest "/docker-entrypoint.…" 45 seconds ago Up 42 seconds proxy
590ca661bf7b mariadb:11 "docker-entrypoint.s…" 45 seconds ago Up 43 seconds 0.0.0.0:3306->3306/tcp, :::3306->3306/tcp, 33060/tcp db
- Se a instalação tiver sido feita em um serviço de nuvem, verifique as configurações do grupo de segurança.
- Confirme se as portas mencionadas em Requisitos de rede estão abertas.
Perguntas sobre reprodução
A reprodução funciona com latência normal, mas não com baixa latência
Pergunta: consigo reproduzir no modo de latência normal, mas não no modo de baixa latência.
Resposta: em um ambiente com travessia de NAT, se o endereço IP global mudar depois da instalação, a conectividade WebRTC será perdida.
Execute installer.sh novamente para atualizar as configurações com o endereço IP global atual.
Não é possível reproduzir quando um sinal de alta taxa de bits é recebido
Pergunta: não consigo reproduzir quando recebo um sinal de alta taxa de bits.
Resposta: abra as configurações avançadas da fonte de entrada e aumente o valor de probe size.
Perguntas sobre rede
Não é possível receber sinais multicast em um ambiente IGMPv2
Pergunta: não consigo receber sinais multicast em um ambiente IGMPv2.
Resposta: no Linux, o IGMPv3 costuma vir habilitado por padrão, mas alguns ambientes multicast exigem a mudança para IGMPv2.
Como configurar o IGMPv2
1. Aplique o IGMPv2 temporariamente para testar
Você pode mudar para o IGMPv2 usando o seguinte comando:
sudo sysctl -w net.ipv4.conf.<interface_name>.force_igmp_version=2
Exemplo para receber multicast em eth1:
sudo sysctl -w net.ipv4.conf.eth1.force_igmp_version=2
Depois de confirmar que as associações multicast estão ocorrendo por IGMPv2, você pode tornar a configuração persistente.
2. Torne a configuração persistente
Para manter a configuração de IGMPv2 após a reinicialização, adicione a seguinte linha a /etc/sysctl.conf:
echo "net.ipv4.conf.<interface_name>.force_igmp_version=2" | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
Exemplo para eth1:
echo "net.ipv4.conf.eth1.force_igmp_version=2" | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
Isso garante que o IGMPv2 continue aplicado após a reinicialização.
Os pacotes multicast são recebidos, mas não são processados
Pergunta: os pacotes multicast estão chegando, mas não estão sendo recebidos.
Resposta: no Linux, o rp_filter (reverse path filtering) vem habilitado por padrão. Dependendo da configuração de roteamento, os pacotes multicast podem ser descartados por engano.
Desabilitar esse filtro pode permitir que os pacotes sejam recebidos corretamente.
1. Verifique o estado atual do rp_filter
cat /proc/sys/net/ipv4/conf/<interface_name>/rp_filter
Significado dos valores de saída:
1→ Filtragem estrita (padrão)2→ Filtragem menos estrita0→ Filtragem desabilitada
Exemplo de verificação em eth1:
cat /proc/sys/net/ipv4/conf/eth1/rp_filter
2. Desabilite o rp_filter temporariamente
Você pode desabilitar o rp_filter (0) com o seguinte comando:
sudo sysctl -w net.ipv4.conf.<interface_name>.rp_filter=0
Exemplo para eth1:
sudo sysctl -w net.ipv4.conf.eth1.rp_filter=0
Depois de confirmar que a recepção multicast funciona, você pode tornar a configuração persistente.
3. Torne a configuração persistente
Para manter rp_filter=0 após a reinicialização, adicione a seguinte linha a /etc/sysctl.conf:
echo "net.ipv4.conf.<interface_name>.rp_filter=0" | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
Exemplo para eth1:
echo "net.ipv4.conf.eth1.rp_filter=0" | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
Isso garante que rp_filter=0 continue aplicado após a reinicialização.
Perguntas sobre licença e autenticação
A mensagem “API KEY MISSING or WRONG API CONFIG” aparece sobre o vídeo
Pergunta: a mensagem “API KEY MISSING or WRONG API CONFIG” aparece sobre o vídeo.
Resposta: a chave de API informada durante a instalação pode estar incorreta.
Execute installer.sh novamente e informe outra vez a chave de API.
A mensagem “NO LICENSE or LICENSE EXPIRED” aparece sobre o vídeo
Pergunta: a mensagem “NO LICENSE or LICENSE EXPIRED” aparece sobre o vídeo.
Resposta:
- Talvez o servidor do MediaHarbor não consiga se comunicar com o sistema de gerenciamento de licenças.
Verifique se há conexão com a internet. - Talvez seus pontos estejam acabando.
Acesse o sistema de gerenciamento de licenças e verifique se ainda há pontos disponíveis.
Perguntas sobre configuração e gerenciamento
Se você esqueceu a senha definida na página Security Configure
Pergunta: esqueci a senha definida na página Security Configure.
Resposta: primeiro, verifique se o MediaHarbor está parado. Se estiver em execução, pare-o usando o seguinte comando:
docker-compose down
Depois de confirmar que o MediaHarbor está parado, execute o seguinte comando para redefinir a senha:
docker-compose run --rm api node reset_password.js
Após concluir a redefinição da senha, inicie o MediaHarbor.
docker-compose up -d
Como conectar o MediaHarbor ao servidor Zabbix interno
Pergunta: quero conectar o MediaHarbor ao nosso servidor Zabbix interno.
Resposta: o MediaHarbor tem um agente Zabbix instalado. Ao configurar o firewall para abrir a porta TCP 10050, você poderá adicionar o MediaHarbor ao servidor Zabbix e monitorá-lo.
# For AlmaLinux / Rocky Linux
sudo firewall-cmd --add-port=10050/tcp --zone=public --permanent
sudo firewall-cmd --reload
# For Ubuntu
sudo ufw allow 10050/tcp
sudo ufw reload
Como migrar as configurações para outro servidor ou fazer backup
Pergunta: quero migrar as configurações para outro servidor ou fazer backup.
Resposta: é possível copiar todas as configurações copiando a pasta DB.
# Stop MediaHarbor (if it's running)
sudo docker-compose down
# Compress the DB folder into a tar.gz file
sudo tar -zcvf backup.tar.gz DB
# Start MediaHarbor (if needed)
sudo docker-compose up -d
# Copy the backup file to the new server
# Example: If you want to copy it to /home/user on 192.168.XXX.XXX
scp backup.tar.gz user@192.168.XXX.XXX:/home/user
# Log in to the new server and extract the transferred backup file
# Example: If you copied it to /home/user on 192.168.XXX.XXX
ssh user@192.168.XXX.XXX
cd /home/user
sudo tar -zxvf backup.tar.gz
Informações de suporte
Se o problema persistir ou se você precisar de mais suporte, entre em contato pelos canais abaixo:
Para realizar testes-piloto antes da implantação em escala completa, você pode solicitar pontos de avaliação.