Coletor remoto¶
Para sites e filiais atrás de firewall, o coletor roda em um host Linux local e envia tudo por HTTPS (443) à plataforma.
Pré-requisitos¶
- Host Linux com Docker (2 vCPU / 2 GB para até ~10 dispositivos).
- Saída 443 até o endereço público da plataforma (
QV_PUBLIC_URL/general.base_url). - Acesso às portas de gerência dos dispositivos do site (Portas).
- Token do coletor: Administração › Coletores › Registrar coletor (transporte HTTPS).
Opção 1 — comando Docker¶
Copie o comando exibido ao registrar o coletor:
docker run -d --name quantix-collector --restart unless-stopped \
-e QV_API_URL=https://quantix.empresa.local -e QV_COLLECTOR_TOKEN=qvc_... \
-e QV_COLLECTOR_NAME=coletor-sp -e QV_COLLECTOR_TRANSPORT=https \
quantix/quantix-vision-backend:8.3.0 collector
Com CA corporativa: monte o certificado e defina SSL_CERT_FILE
(-v /etc/pki/ca.crt:/etc/quantix/ca.crt:ro -e SSL_CERT_FILE=/etc/quantix/ca.crt).
Opção 2 — Ansible¶
# host_vars/coletor-sp.empresa.local/vault.yml: vault_collector_token_sp: qvc_...
cd deploy/ansible
ansible-playbook collector.yml --ask-vault-pass --limit coletor-sp.empresa.local
Gera /opt/quantix-collector/.env e um compose com container somente leitura, cap_drop: ALL,
tmpfs e limites de CPU/memória. collector_ca_bundle_src monta a CA.
Opção 3 — assistente “Instalar em host remoto” (recomendada)¶
Em Administração › Coletores, clique em Instalar em host remoto (ou na ação de mesmo nome na
linha do coletor). O assistente registra ou reaproveita o coletor, pede host/IP, usuário SSH e a
credencial SSH (tipo chave ou usuário/senha) e dispara a implantação via SSH, acompanhando o
progresso em tempo real — tudo pela interface, sem docker run manual no host remoto. Por baixo, ele
cria um job do runbook Implantar coletor remoto (abaixo). Detalhes em
Manual do administrador › Coletores.
Opção 4 — runbook “Implantar coletor remoto” (Automação)¶
Em Automação, execute Implantar coletor remoto informando host/IP, usuário SSH, credencial SSH (do tipo chave ou senha), o coletor registrado e o transporte. O runbook instala o Docker (Debian/Ubuntu ou RHEL), remove um coletor anterior e sobe o container. Um novo token é gerado para o coletor e entregue somente ao host de destino. Exige aprovação (risco médio).
Verificação¶
Em até 30 s o coletor aparece Online com versão e host. Atribua os dispositivos do site a ele. Problemas: Troubleshooting › Coleta.