Ponto biométrico sem IP fixo: como resolver o problema de rede de uma vez

O bloqueio mais comum do setor

Um cliente quer ponto biométrico em 5 franquias. Três usam internet residencial, uma usa 4G e a quinta está em obra. O fornecedor local responde: "precisamos de IP fixo em cada unidade". E aí o projeto morre: o IP fixo custa a mais, às vezes nem está disponível, e configurar 5 redes diferentes não é um plano — é uma lista de tickets.

O problema de fundo é o modelo de conexão: se o seu software entra na rede do cliente para ler o relógio, a rede do cliente precisa estar acessível de fora. É esse requisito que gera todo o problema.

As opções tradicionais (e seu custo real)

Como funciona o modo push (versão conceitual)

Os terminais ZKTeco modernos suportam um modo em que é o dispositivo que sai: ele se conecta ao endereço do servidor na nuvem e entrega seus eventos — marcações, pulsos de vida, sincronizações — por iniciativa própria, sem que ninguém entre na rede onde está instalado.

As consequências práticas:

• O IP do cliente pode ser dinâmico e mudar quando quiser: não importa, porque você nunca entra na rede dele.
• 4G funciona: um roteador com chip é a instalação mais comum em obra e eventos.
• Várias unidades atrás de um único NAT: vários terminais compartilham a mesma saída de internet sem conflito.
• Zero tickets de rede: não há portas para abrir, nem regras de firewall para negociar com o cliente.

O que isso significa para o seu software

Se você desenvolve o sistema (ERP, folha, gestão de condomínios), o modo push muda a conversa de implantação:

• Onboarding em horas, não em semanas: o técnico da unidade configura apenas o endereço do servidor no terminal, e o número de série fica registrado na sua plataforma.
• Multi-unidade sem infraestrutura: cada filial é mais um terminal na API, não um projeto de rede.
• Eventos em tempo real: você recebe cada marcação no momento, não importa arquivos no fim do dia.

Consumir os eventos pelo seu backend fica assim:

import { createClient } from 'redis';

const sub = createClient({
  socket: { host: process.env.REDIS_HOST, port: Number(process.env.REDIS_PORT) },
  password: process.env.REDIS_PASSWORD
});

await sub.connect();

await sub.subscribe('punch_SEU-SERIAL', (message) => {
  const event = JSON.parse(message);
  // marcar ponto no seu sistema, notificar, disparar regras...
  console.log(event.pin, event.timestamp);
});

E se preferir consultar em vez de escutar, a API REST expõe os relatórios por terminal com faixa de datas e paginação.

E se a internet da unidade cair?

É a pergunta certa. Os terminais armazenam as marcações na memória local enquanto não há conexão e as reenviam quando a rede volta: o dispositivo é tolerante a quedas temporárias. Para o seu software, a recomendação é simples: use os eventos em tempo real para o urgente (notificações, acessos) e o relatório REST como fonte da verdade para a conciliação.

Perguntas frequentes