turbgate — instalador Windows (acesso remoto a equipamentos de portaria)

INSTALADOR_WINDOWS.md

🪟 Instalador turbgate — Windows

TL;DR: baixe https://turbgate.botbox.info/setup.exe, abra como Administrador e cole o token de 32 caracteres que o gestor mandou.

Tempo total: ~3 min por PC Windows. Zelador faz sozinho.

O que você precisa em mãos

• PC Windows 10 ou 11 (64 bits) com cabo de rede
• Acesso de Administrador no PC (senha do Windows do dono)
• O token de instalação — string de 32 caracteres gerada no ERP pelo gestor (ver "Onde achar o token" abaixo)
• Conexão de internet funcionando

Onde achar o token (gestor)

1. Logado no ERP, vai em Equipamentos do cliente
2. Menu ⋮ → "Ver Tunnels Ativos"
3. Modal abre com seção "Token de instalação"
4. Clica em Copiar — token de 32 caracteres tipo cc2d85d7a1...
5. Manda esse token pro zelador via WhatsApp/email

O token é único por cliente e automaticamente reutilizável (1 token serve pra TODOS os equipamentos daquele cliente, independente da plataforma). Nunca expira sozinho — só se você clicar "Regenerar" no modal (que invalida instalações antigas).

⚠️ Cuidado: regenerar token derruba todos os turbgates existentes do cliente. Eles param de comunicar com o ERP em ~1min e precisam ser reinstalados com o token novo. Só regenere em caso de vazamento confirmado.

Passo a passo (com prints mentais 🖼️)

1. Baixar o instalador

No navegador do PC (Chrome, Edge, qualquer), abre o link:

https://turbgate.botbox.info/setup.exe

Vai baixar um arquivo chamado turbgate-setup.exe (~4 MB). Costuma cair na pasta Downloads.

Atenção: alguns navegadores avisam "este arquivo pode ser perigoso". Clica Manter ou Manter mesmo assim — é normal pra arquivos .exe baixados.

🔐 Antes de abrir, confira o hash (recomendado — ver "Verificar a integridade" abaixo). Enquanto o instalador não é assinado, o hash é a garantia de que o arquivo é o oficial e não foi adulterado.

2. Abrir o instalador

Vai na pasta Downloads (ou onde caiu) → duplo-clique em turbgate-setup.exe.

3. Permitir como Administrador

Vai aparecer um popup azul/amarelo do Windows: "Deseja permitir que este aplicativo faça alterações no dispositivo?"

Clica Sim. (Se pedir senha de admin, digita ela.)

4. Wizard de instalação

Abre uma janela com 5 telas — só clicar Avançar em todas, exceto a do token:

• Tela 1 (boas vindas): clica Avançar
• Tela 2 (pasta de instalação C:\Program Files\turbgate): clica Avançar
• Tela 3 (atalhos no menu Iniciar): clica Avançar
• Tela 4: cola o token (ou digita o código do cliente) → Avançar
• Tela 5 (resumo): clica Instalar

5. Aguardar (~30 segundos)

Vai aparecer barra de progresso. Pode aparecer brevemente uma janela preta (cmd) — é normal, fecha sozinho.

6. Concluir

Clica Concluir. Pronto, instalado.

🔐 Verificar a integridade (recomendado)

Enquanto o setup.exe não tem assinatura (Authenticode), o hash SHA-256 é o que garante que você baixou o instalador oficial e intacto. Custa 10 segundos.

Zelador — no PowerShell, calcule o hash do que baixou:

Get-FileHash "$env:USERPROFILE\Downloads\turbgate-setup.exe" -Algorithm SHA256 | Format-List Hash

Compare com o hash que o gestor mandou (junto do token). Bateu → pode rodar. Não bateu → pare e avise o suporte (arquivo errado ou adulterado).

Gestor — o hash canônico vem do manifest.json (que é assinado), no campo setup_exe_sha256. Pegue e mande pro zelador junto do token:

(Invoke-RestMethod https://turbgate.botbox.info/manifest.json).setup_exe_sha256

# (Linux/Mac) — mesma coisa:
curl -s https://turbgate.botbox.info/manifest.json | jq -r .setup_exe_sha256

Por que isso ajuda: o canal já é HTTPS, mas o hash pinado out-of-band (gestor → zelador) protege também contra o mirror servir um instalador trocado. É a mesma ideia do checksum do instalador Linux.

Como confirmar que está funcionando

Modo simples (zelador):

1. Pressiona Windows + R
2. Digita services.msc → Enter
3. Procura "turbgate client" na lista (organize por nome A-Z se precisar)
4. Status deve estar "Em execução"

Se aparecer "Parado" ou não estiver na lista, ver troubleshooting abaixo.

Modo técnico (suporte):

sc query turbgate

Tem que mostrar STATE: 4 RUNNING.

Ou olhar no painel de equipamentos do ERP — devices da portaria voltam pra ONLINE em ~2min.

Onde ficam os arquivos

O que	Onde no Windows
Programa (binário)	C:\Program Files\turbgate\turbgate.exe
Configuração	C:\ProgramData\turbgate\turbgate.yaml
Certificado mTLS	C:\ProgramData\turbgate\cert.pem
Log de instalação	C:\ProgramData\turbgate\install.log
Service Windows	nome turbgate, auto-start

ProgramData é oculto por padrão. Se quiser navegar até lá: barra de endereços do Explorer → digita C:\ProgramData\turbgate → Enter.

Como desinstalar

Modo 1 (Painel de Controle):

1. Win → digita "Adicionar ou remover programas" → Enter
2. Procura turbgate
3. Clica → Desinstalar

Modo 2 (direto):

• Vai em C:\Program Files\turbgate\ → duplo-clique em unins000.exe

🆘 Deu problema?

Sintoma	O que checar
Download bloqueado pelo antivírus	O instalador ainda não é assinado (code signing em andamento), então o AV pode marcar como suspeito — é falso-positivo esperado. NÃO desative o antivírus. Em vez disso: (1) confirme que baixou de https://turbgate.botbox.info/setup.exe (cadeado no navegador), (2) confira o hash (seção "Verificar a integridade" abaixo) contra o que o gestor mandou, (3) se bater, libere só esse arquivo no AV (exceção pontual) e siga. Se não bater, pare e avise o suporte.
"App bloqueado pra proteger seu PC" (SmartScreen)	Confira o hash primeiro ("Verificar a integridade"). Batendo: Mais informações → Executar mesmo assim. (o instalador ainda não tem code signing — será assinado; até lá, o hash é a sua garantia.)
Wizard reclama "Falha ERP" no final	Sem internet OU cliente_id digitado errado. Confere o número e reabra o instalador. Suporte pode regenerar token se necessário.
Service "turbgate client" não aparece	Instalação travou. Olha o log em C:\ProgramData\turbgate\install.log (abre no Bloco de Notas). Manda print pro suporte.
Service aparece mas "Parado"	Tenta iniciar manual: clique-direito em "turbgate client" → Iniciar. Se voltar a parar, problema na config — manda log do suporte.
Devices ainda OFFLINE no ERP após 5min	Firewall do cliente bloqueando porta 7000 saída? Testa no cmd: Test-NetConnection turbgate.botbox.info -Port 7000 (PowerShell) — tem que dar True.
PC reiniciou e turbgate não voltou	Service deveria iniciar sozinho no boot. Confere services.msc → turbgate client → Tipo de inicialização = Automático.

Manda print do erro + print do services.msc pro grupo do suporte que a gente resolve junto.

🔄 Atualização

Automática: ~5min após o PC ligar e a cada 10min depois, o turbgate checa https://turbgate.botbox.info/manifest.json. Se houver versão nova, baixa, valida sha256 e aplica sozinho — service reinicia, config (cliente.txt, turbgate.yaml, certificados) é preservada. Log em C:\ProgramData\turbgate\update.log.

Manual (forçar agora ou se o auto-update falhar): baixa o novo setup.exe da mesma URL e instala por cima como Administrador. Mantém config, reinicia service.