Guia de Configuração de Câmeras — Acesso via RTSP (Modo Pull)
Passo a passo para a equipe de TI liberar o acesso RTSP das câmeras à Pix Safety: redirecionamento de porta, restrição de origem no firewall, credenciais sem o caractere @, formato do link por fabricante e parâmetros de codificação.
Este guia é destinado à equipe de TI ou ao integrador de CFTV do cliente. Ele descreve o que precisa ser configurado na rede e nas câmeras para que a plataforma Pix Safety consuma os streams de vídeo via RTSP em modo pull.
Versão em PDF: baixar o guia completo
Visão geral: RTMP (push) x RTSP (pull)
| Modo | Quem inicia a conexão | Onde é configurado | Quando usar |
|---|---|---|---|
| RTMP (push) | A câmera/servidor do cliente envia o vídeo | Encoder ou VMS do cliente | Quando não é possível expor portas de entrada |
| RTSP (pull) | A Pix Safety busca o vídeo na câmera | Roteador/firewall + câmera | Padrão recomendado, com menor esforço no ambiente do cliente |
No modo pull, nossa infraestrutura conecta-se à câmera. Por isso é necessário que a câmera esteja acessível a partir da internet, em um endereço e porta específicos, com acesso restrito somente à origem da Pix Force.
Pré-requisitos
- Câmera IP com suporte a RTSP habilitado
- Link de internet com IP público (fixo é o ideal) ou serviço de DDNS
- Acesso administrativo ao roteador/firewall para criar regras de NAT
- Banda de upload disponível conforme a tabela de codificação mais abaixo
Passo 1 — Redirecionamento de porta (NAT)
Crie uma regra de encaminhamento no roteador/firewall para cada câmera que será integrada.
| Campo | Valor |
|---|---|
| Porta externa | Uma porta por câmera (ex.: 8554, 8555, 8556...) |
| IP interno | Endereço da câmera na rede local |
| Porta interna | Porta RTSP da câmera (normalmente 554) |
| Protocolo | TCP |
Reserve o IP da câmera no DHCP (ou configure IP fixo na própria câmera). Se o endereço interno mudar, a regra de NAT deixa de funcionar e o stream cai.
Passo 2 — Restrição de origem no firewall
Não deixe a porta aberta para a internet inteira. Libere o acesso apenas para a origem da Pix Force:
- Host:
media.safety.pixforce.ai - IP:
34.172.98.34
Se o firewall aceitar somente IP, use o endereço acima. Havendo alteração do IP de origem, comunicamos previamente pelo canal de suporte.
Passo 3 — Usuário e senha dedicados
Crie na câmera um usuário exclusivo para a integração, com permissão apenas de visualização do stream.
Atenção: a senha não pode conter o caractere@. Ele é o separador entre credenciais e host na URL RTSP e quebra a interpretação do link. Evite também:/?#%e espaços.
Use senhas fortes combinando letras maiúsculas, minúsculas, números e caracteres como ! - _.
Passo 4 — Formato do link RTSP
O formato geral é:
rtsp://USUARIO:SENHA@IP_PUBLICO:PORTA_EXTERNA/CAMINHO_DO_STREAMCaminhos mais comuns por fabricante:
| Fabricante | Caminho do stream principal |
|---|---|
| Intelbras / Dahua | /cam/realmonitor?channel=1&subtype=0 |
| Hikvision | /Streaming/Channels/101 |
| Axis | /axis-media/media.amp |
| Genérico ONVIF | /onvif1 ou /live/ch00_0 |
Exemplo prático:
rtsp://pixforce:Str0ng-Pass@200.150.10.5:8554/cam/realmonitor?channel=1&subtype=0Consulte o manual do fabricante quando o caminho não estiver na tabela — ele costuma aparecer como "RTSP URL" nas configurações de rede da câmera.
Parâmetros de codificação obrigatórios
| Parâmetro | Valor recomendado |
|---|---|
| Codec | H.264 |
| Resolução | 1280x720 (mínimo) — 1920x1080 preferencial |
| FPS | 10 quadros por segundo |
| GOP / Intervalo de I-frame | 1 a 2 segundos (ex.: 10 a 20 com 10 FPS) |
| Controle de taxa | CBR |
| Bitrate | 1 a 2 Mbps por câmera |
Banda de upload necessária, aproximada:
| Câmeras | Upload dedicado |
|---|---|
| 1 a 4 | 8 Mbps |
| 5 a 10 | 20 Mbps |
| 11 a 20 | 40 Mbps |
GOP longo aumenta o tempo até o primeiro quadro e prejudica a análise em tempo real. Mantenha o intervalo de I-frame curto.
Validação do acesso
Antes de enviar os dados, teste o link de fora da rede local (use um 4G/5G ou outra conexão). Testar dentro da rede não valida o NAT.
No VLC: Mídia > Abrir Fluxo de Rede e cole a URL RTSP completa.
Via linha de comando:
ffprobe -v error -rtsp_transport tcp -show_streams "rtsp://USUARIO:SENHA@IP:PORTA/CAMINHO"O retorno deve trazer o stream de vídeo com codec h264 e a resolução configurada.
Checklist de dados a enviar à Pix Force
- Nome/identificação de cada câmera e o local monitorado
- URL RTSP completa e testada externamente
- Usuário e senha do stream (sem o caractere
@) - IP público ou endereço DDNS e porta externa de cada câmera
- Resolução, FPS e bitrate configurados
- Contato do responsável de TI para eventuais ajustes
Problemas mais comuns
| Sintoma | Causa provável |
|---|---|
| Funciona na rede local e falha externamente | Regra de NAT ausente ou porta bloqueada pelo provedor |
| Conexão recusada de forma intermitente | IP público dinâmico sem DDNS ou IP interno alterado pelo DHCP |
| Erro de autenticação | Senha com @ ou outro caractere reservado |
| Vídeo travando ou atrasado | Upload insuficiente, GOP longo ou bitrate alto demais |
Suporte
Ficou alguma dúvida na configuração? Abra um chamado para a área Safety aqui mesmo na plataforma, anexando o link RTSP testado e prints das regras de firewall. Nossa equipe valida o acesso e conclui a integração.
Perguntas frequentes
Posso usar uma senha com o caractere @?
Não. O @ separa credenciais do host na URL RTSP e faz a conexão falhar. Troque a senha do usuário da integração por uma sem @, :, /, ?, #, % ou espaços.
O stream funciona na rede local, mas dá timeout para a Pix Force. O que verificar?
Confirme a regra de NAT (porta externa → IP interno:554/TCP), a liberação da origem media.safety.pixforce.ai / 34.172.98.34 e se o provedor não bloqueia portas de entrada. Teste sempre a URL a partir de uma conexão externa.
Não tenho IP fixo. Consigo integrar?
Sim, usando DDNS. Configure o serviço no roteador ou na própria câmera e informe o hostname DDNS no lugar do IP público.
Qual o impacto de um GOP alto?
Um intervalo longo de I-frame atrasa o início da decodificação e reduz a precisão da análise em tempo real. Configure o GOP entre 1 e 2 segundos.
Minha câmera não permite a resolução recomendada. E agora?
Utilize a resolução mais próxima disponível, mantendo no mínimo 1280x720 e 10 FPS, e informe o valor configurado no envio dos dados. Nossa equipe avalia o impacto no modelo de IA.
Este material foi útil?
Sua avaliação ajuda a melhorar o conteúdo da central.