Agente local
Todos os testes rodam no agente instalado na rede do cliente, garantindo que a origem seja o IP dele.
Conexão com o agente
Por padrão a interface procura o agente em http://127.0.0.1:8765. Ajuste se ele estiver em outra porta ou em outra máquina da mesma rede.
O código muda a cada inicialização do agente e impede que outros sites abertos no navegador usem o agente para varrer a rede do cliente. Sem o código correto, o agente responde apenas o próprio status.
Endereço em uso agora: http://127.0.0.1:8765
Como executar na máquina do cliente
Baixe o pacote, extraia em qualquer pasta da máquina que está dentro da rede do cliente e execute um único arquivo.
Baixar agente 1.4.1 (.zip)
Passo 1 — Extrair o pacote
- Baixe o pacote 1.4.1 e extraia em uma pasta nova na máquina que está dentro da rede do cliente — não execute o arquivo diretamente de dentro do ZIP.
- Se já usou uma versão anterior, feche a janela do agente antigo e apague a pasta antiga antes de extrair. Extrair por cima costuma manter os arquivos velhos em uso, e a tela continuaria mostrando a versão antiga.
Passo 2 — Executar o único arquivo
- Windows: duplo clique em
INICIAR_AGENTE.bat. Linux/macOS:bash iniciar_agente.sh. - O próprio script verifica e instala o Python na versão correta, as dependências e o ffprobe — não é preciso instalar nada manualmente. A primeira execução precisa de internet e pode levar alguns minutos; as próximas abrem em segundos.
- O script nunca encerra programas de terceiros: só desliga um agente Pix Force anterior registrado por ele mesmo. Se a 8765 estiver em uso, sobe na próxima porta livre (8766, 8767…) e, se todas estiverem ocupadas, em uma porta livre escolhida pelo sistema.
- Se o firewall do Windows perguntar, libere a porta.
Passo 3 — Deixar a janela aberta e conectar
- Mantenha a janela do agente aberta durante os testes — fechá-la desliga o agente.
- Copie da janela o endereço e o código do agente para os campos acima e clique em Testar. Se preferir, clique em Detectar porta — a interface procura o agente nas portas 8765 a 8770 sozinha.
- Abrir esse endereço direto no navegador mostra apenas a página de status do agente — a ferramenta é usada aqui nesta interface.
Sem o agente rodando na rede do cliente, nenhum teste pode ser executado a partir do IP dele — os resultados só são válidos com o agente conectado.
Solução de problemas
- “Deseja finalizar o arquivo em lotes (S/N)?” → responda N e Enter. Se já respondeu S, execute o
INICIAR_AGENTE.batnovamente. - “Python nao encontrado” após a instalação automática → feche a janela, abra o
INICIAR_AGENTE.batnovamente (o PATH só é reconhecido em uma nova janela). - “A porta 8765 esta em uso por outro programa” → o agente sobe sozinho em outra porta. Clique em Detectar porta ou use o endereço exibido na janela.
- “Código do agente ausente ou inválido” → o agente foi reiniciado e gerou um código novo. Copie o código atual da janela e salve novamente.
- Erro de CORS ou 404 em
/api/status→ feche a janela antiga, baixe o agente 1.4.1 pelo botão acima, extraia em uma pasta nova e execute novamente. A janela deve mostrar “Agent 1.4.1”. Aba anônima não encerra um agente antigo que continua rodando no Windows. - Por segurança o agente escuta apenas em
127.0.0.1: ele deve rodar na mesma máquina em que a interface está aberta. - Falha ao instalar dependências → verifique internet/proxy e rode o script novamente.
- A janela do agente precisa continuar aberta na outra máquina.
Versão portátil (.exe)
O pacote já inclui o build_exe.ps1. Em uma máquina Windows com Python, rode powershell -ExecutionPolicy Bypass -File build_exe.ps1 para gerar um executável portátil que dispensa Python e já serve a interface junto.