Pular para o conteúdo
Documentação

GeoIP

Escolha a fonte das faixas de IP por país (ipdeny ou MaxMind GeoLite2), configure a license key e atualize as faixas usadas nas regras de País e Continente.

R Regis Manze 20/11/2026 4 min de leitura

A tela GeoIP define de onde o proxy tira as faixas de IP de cada país. Essas faixas alimentam as condições Pais e Continente das regras e a coluna Pais da tela Investigar IP.

Para abrir, vá em Seguranca > GeoIP no menu lateral. O topo da tela mostra quantos países já estão em cache, a fonte atual e quando as faixas da MaxMind foram atualizadas pela última vez.

Escolher a fonte

Fonte Vantagens Exige
ipdeny.com Mais simples; baixa só os países que você usa Nada, não precisa de conta
MaxMind GeoLite2 Mais preciso Uma license key gratuita da MaxMind

Usar o ipdeny

  1. No quadro Configuracao, marque ipdeny.com.
  2. Clique em Salvar.

O ipdeny é a fonte padrão. Cada país é baixado (IPv4 e IPv6) na primeira vez que aparece numa regra.

Usar a MaxMind GeoLite2

Configurar a MaxMind GeoLite2 como fonte de GeoIP

  1. Crie uma conta gratuita GeoLite2 em maxmind.com.
  2. Na conta, abra Manage License Keys e clique em Generate para gerar uma license key.
  3. No miniProxy, no quadro Configuracao, marque MaxMind GeoLite2.
  4. Cole a chave no campo MaxMind license key.
  5. Clique em Salvar.
  6. No quadro Atualizar faixas agora, clique em Atualizar agora para baixar a base.

Só a license key é necessária. O Account ID que a MaxMind também mostra não é pedido nem usado pelo miniProxy.

Depois de salva, o campo mostra o selo salva com os 4 primeiros caracteres da chave. A chave fica guardada no servidor em /etc/haproxy/geoip.json, com acesso restrito ao administrador do sistema.

Dica: para trocar só a fonte sem mexer na chave, deixe o campo MaxMind license key em branco e clique em Salvar. A chave atual é mantida.

Atenção: se a mensagem Falha no download (key invalida?) aparecer ao atualizar, confira se a chave foi copiada inteira e se ainda está ativa na conta da MaxMind.

Atualizar as faixas

O quadro Atualizar faixas agora tem o botão Atualizar agora. O que ele faz depende da fonte:

Fonte O que acontece
MaxMind GeoLite2 Baixa o arquivo GeoLite2-Country-CSV e regera as faixas de todos os países de uma vez
ipdeny.com Baixa de novo os países que já estão em cache. Países novos são baixados sob demanda, quando aparecem numa regra

Nos dois casos, as faixas dos continentes já usados em regras também são regeradas.

O painel não atualiza as faixas sozinho. Clique em Atualizar agora de tempos em tempos (por exemplo, uma vez por mês) e sempre que trocar de fonte.

Atenção: o botão Atualizar agora grava as faixas novas, mas não recarrega o HAProxy. As regras de País e Continente passam a usar as faixas novas no próximo recarregamento, que acontece ao salvar qualquer alteração de configuração no painel.

Uso nas regras de País e Continente

As faixas são usadas na página Regras, aba Condicoes:

  • Condição Pais: informe o código de duas letras do país (ex.: br) ou vários separados por vírgula (ex.: cn,ru). Vários países na mesma condição funcionam como "qualquer um deles".
  • Condição Continente: informe o código do continente (af, an, as, eu, na, oc, sa) ou vários separados por vírgula. A faixa do continente é a união das faixas de todos os países dele.

Ao salvar uma regra com país ou continente que ainda não está em cache, o painel baixa as faixas na hora. Se o download falhar, a regra não é salva e aparece Nao consegui baixar as faixas de IP de: seguido dos países.

Exemplo: para bloquear acessos de fora do Brasil a um caminho específico, crie uma regra com a condição Pais marcada como nao e e valor br, some a condição de caminho e escolha a ação de bloqueio.

Atenção: IPs da Whitelist sempre passam. Se um gateway de pagamento ou um serviço externo for barrado por uma regra de país, coloque os IPs dele na Whitelist.

Veja também

Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!