§ Agente QoinCamera

Baixe o agente e conecte seus DVRs em minutos.

O agente roda dentro da sua rede, descobre DVRs automaticamente e conecta-se à nuvem via WebSocket outbound. Sem abrir portas, sem VPN, sem IP fixo.

Carregando releases...

§ Instalação

Três caminhos. Escolha o seu.

Debian / Ubuntu (recomendado)

Pacote .deb com serviço systemd. Roda como usuário não-privilegiado e reinicia automaticamente em caso de falha.

Instalar

# baixe o .deb apropriado em app.qoin.camera/download
sudo apt install ./qoincamera-agent_*_amd64.deb

Configurar

sudo cp /etc/qoincamera-agent/config.example.toml \
        /etc/qoincamera-agent/config.toml
sudo nano /etc/qoincamera-agent/config.toml
# cole o agent_token fornecido pelo painel

Iniciar

sudo systemctl enable --now qoincamera-agent
sudo journalctl -u qoincamera-agent -f

Linux (binário estático)

Para distribuições sem apt — Fedora, Arch, Alpine, LXC containers. Você controla onde instalar e como rodar.

Instalar

chmod +x qoincamera-agent-linux-amd64
sudo mv qoincamera-agent-linux-amd64 /usr/local/bin/qoincamera-agent

Configurar

sudo mkdir -p /etc/qoincamera-agent
sudo nano /etc/qoincamera-agent/config.toml
# use o config.example.toml como base

Rodar (foreground, teste)

qoincamera-agent --config /etc/qoincamera-agent/config.toml

Windows

Executável standalone. Use o NSSM ou Task Scheduler para rodar como serviço.

Preparar

# crie uma pasta (ex: C:\QoinCamera)
# copie o .exe baixado para ela
# renomeie para agent.exe (opcional)

Configurar

# crie C:\QoinCamera\config.toml
# cole o token fornecido e os ranges de rede

Rodar

C:\QoinCamera\agent.exe --config C:\QoinCamera\config.toml
# Para rodar como serviço, use NSSM:
# nssm install QoinCameraAgent C:\QoinCamera\agent.exe

§ Arquivo de configuração

config.toml

Campos obrigatórios estão marcados. Copie o agent_token do painel em Agentes → Provisionar.

[agent]
# obrigatório — copiado do painel
agent_token = "qca_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
name = "Agent da Matriz"

[cloud]
# onde o agente se conecta (padrão)
url = "wss://api.qoin.camera/ws/agent"

[discovery]
# onde procurar DVRs — ajuste para sua rede
enabled = true
networks = ["192.168.1.0/24", "10.10.10.0/24"]
interval_secs = 300

[go2rtc]
# portas locais. Só mude se houver conflito.
api_port = 1984
webrtc_port = 8555

§ Troubleshooting

Quando algo dá errado

O agente não aparece como online no painel: Verifique se o token em config.toml está correto. Nos logs (journalctl -u qoincamera-agent -f no Linux) procure por 'authenticated' ou erros 401. Em 99% dos casos é token inválido ou problema de DNS.
Os DVRs não aparecem automaticamente: Confirme que discovery.networks está com os ranges corretos da sua rede. Use `ip addr` (Linux) ou `ipconfig` (Windows). Alguns DVRs antigos só respondem ao ONVIF na porta 8000 — o agente tenta múltiplas portas, mas firewalls internos podem bloquear.
Streaming fica preto em algumas câmeras: Provavelmente a câmera está em H.265 e o modelo do DVR não responde bem ao stream principal. O sistema tenta automaticamente usar o sub-stream como fallback. Se persistir, contate o suporte — pode ser necessário ajustar o codec no próprio DVR.
Posso rodar o agente num Raspberry Pi?: Sim. O binário ARM64 roda em Raspberry Pi 4/5 rodando Raspberry Pi OS 64-bit ou Ubuntu. A versão .deb arm64 é a forma mais simples de instalar.
Preciso abrir portas no firewall?: Não. O agente só faz conexões OUTBOUND via HTTPS/WebSocket (porta 443). Se sua rede bloqueia HTTPS de saída, algo está muito errado — fale com o TI.