> For the complete documentation index, see [llms.txt](https://docs.plenit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.plenit.com/docs-pt/productos/servers/how-to/how-to-configure-geoip-to-block-or-allow-countries.md).

# Como Configurar GeoIP para Bloquear ou Permitir Países nos teus Servidores

GeoIP deixa-te decidir a partir de que países é permitido ou bloqueado o tráfego para as **IPs públicas** dos teus serviços.

É uma forma simples de reduzir a superfície de ataque quando o tráfego legítimo só deve chegar a partir de regiões concretas.

> #### 👍 O que ganhas
>
> Controlo do acesso aos teus serviços por país de origem, por cada IP pública, com retorno ao estado predefinido num clique.

### Para que serve

* **Segurança**: bloqueia regiões de onde só recebes ataques.
* **Simplicidade**: regras por país, sem manter listas de IPs à mão.
* **Conformidade**: aplica restrições por país se o teu cliente o exigir (por exemplo, RGPD ou requisitos setoriais).
* **Flexibilidade**: políticas diferentes por servidor ou por rede, conforme o caso.

### Como funciona

O GeoIP combina duas camadas:

* **Camada perimetral**, na borda da infraestrutura: filtra o tráfego por país. Aqui reside a política global predefinida (a lista de países bloqueados).
* **Camada de rede da tua subscrição**: controla as portas e os protocolos de **Entrada/Saída** dentro da tua rede. Não filtra por país.

No GeoIP, para cada IP pública escolhes os **países bloqueados**: assinalado equivale a **Negar** e sem assinalar a **Permitir**. Se permites um país que a global bloqueia, cria-se uma exceção do tipo *permitir*; se bloqueias um que a global não bloqueia, cria-se uma regra *negar* tua.

> #### 🚧 O GeoIP não abre portas
>
> O GeoIP filtra por país na camada perimetral, mas não mexe nas portas. Se a porta ou o protocolo continuarem fechados nas tuas regras de Entrada/Saída, o tráfego não passa mesmo que permitas esse país.

### Antes de começar

* Iniciar sessão no painel da Plenit.
* Ter permissões de administração sobre **Servidores**.
* Que a rede sobre a qual vais trabalhar tenha pelo menos uma **IP pública**.

### Passo 1. Acede ao GeoIP

1. No painel, abre **Cloud Services → Servidores** e entra na tua subscrição de servidores.
2. Na barra superior de separadores, abre **Firewall**.
3. Abre o separador secundário **Geolocalização**.

![Acesso ao separador Geolocalização do Firewall](https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2FIyUPrjXEoQb47yXzQBG8%2Fservidores-howto-geoip-01.png?alt=media\&token=c1e0f0f6-0a86-43e0-ad47-08c449e9719c)

### Passo 2. Seleciona a rede

No topo, usa o **seletor de rede** para escolher onde aplicar o GeoIP. Verás a tabela de IPs públicas (IP público) e quantos países cada uma tem bloqueados (Países bloqueados).

> #### 📘 145 entradas bloqueadas por defeito
>
> É habitual ver 145 entradas bloqueadas de início. Dessas 145 entradas, 140 são países e 5 são territórios sem população permanente: a Antártida, a ilha Bouvet, as ilhas Heard e McDonald, as Terras Austrais e Antárticas Francesas e as ilhas Geórgia do Sul.

![Seleção da rede e lista de IPs públicas](https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2FVYYR9GV8qFqch2mRaQWB%2Fservidores-howto-geoip-02.png?alt=media\&token=380209e5-c423-40b8-9437-1c4202d7fcdf)

### Passo 3. Revê as IPs públicas e entra em edição

Na tabela vês cada IP pública, o seu número de países bloqueados e a ação **Editar**. Clica em **Editar** na IP que queiras ajustar.

![Tabela de IPs públicas com a opção de editar](https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2FlWE3agFLubfGlZUYwEBc%2Fservidores-howto-geoip-03.png?alt=media\&token=5bb4792f-8e0f-4b7b-9560-11be3078f6d2)

### Passo 4. Gere os países

Abre-se o ecrã Editar países. À esquerda, assinala continentes inteiros ou expande-os com + para escolher países concretos; também os podes procurar com Procurar país. À direita vês a lista de países que ficam bloqueados. **Assinalado = bloqueado**; **sem assinalar = permitido**. Tens **Guardar**, **Restaurar definições** e **Cancelar**.

![Seletor de países para bloquear ou permitir](https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2FzavsJpEJJ9lyvPD2NjWk%2Fservidores-howto-geoip-04.png?alt=media\&token=d559f85f-6dc9-4288-96f5-68be5f2f6344)

### Passo 5. Confirma e aplica

Clica em **Guardar**, revê no aviso Are you sure? a lista de países que vão ser bloqueados ou permitidos e clica em **Confirmar**. As alterações sincronizam-se com a infraestrutura: não é imediato, demora alguns minutos.

![Resumo e confirmação das alterações de GeoIP](https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2FRqClwAxzofBT4u9F8ozq%2Fservidores-howto-geoip-05.png?alt=media\&token=ba1b009d-f319-49d6-8259-7aad5a5ce0f3)

### Passo 6. Verifica o resultado

Verifica o contador de **países bloqueados** na IP editada e faz testes de acesso se precisares. Para uma verificação rápida a partir de uma origem do país que queiras validar:

```bash
curl -I http://<IP-PUBLICA>
```

Como a filtragem depende do país de origem, para testar um país bloqueado precisas de sair a partir desse país (por exemplo, através de uma VPN nessa região). Se precisares de começar do zero, usa **Restaurar definições**.

### Casos práticos

| Caso                               | O que fazes                                                                       |
| ---------------------------------- | --------------------------------------------------------------------------------- |
| Permitir apenas Espanha e Portugal | Assinala todos os países, desassinala Espanha e Portugal, **Guardar → Confirmar** |
| Permitir o Canadá temporariamente  | Desassinala o Canadá, **Guardar → Confirmar**; ao terminares, volta a assinalá-lo |
| Não conheces o estado atual        | **Restaurar definições** e começa do zero a partir da política global             |

### Conselhos de utilização

* **Menos é mais**: bloqueia primeiro e abre apenas o indispensável.
* **Uniformiza**: aplica a mesma política base a várias IPs e documenta as exceções.
* **Usa Restaurar definições** como reset quando não souberes que regras estão aplicadas.
* **Lembra-te da camada de rede**: se a porta ou o protocolo estiver fechado em Entrada/Saída, não entram mesmo que permitas o país.

### Se algo não bater certo

| Sintoma                                     | Causa provável                            | O que fazer                                                  |
| ------------------------------------------- | ----------------------------------------- | ------------------------------------------------------------ |
| O botão Confirmar está desativado           | Não há alterações para aplicar            | Faz alguma alteração ou sai com Cancelar                     |
| Permiti um país, mas continua sem funcionar | Falta propagação ou a porta está fechada  | Espera alguns minutos e revê as tuas regras de Entrada/Saída |
| Bloqueei demais e perdi o acesso            | Política demasiado restritiva             | Usa **Restaurar definições**                                 |
| Não vejo o separador Geolocalização         | A vista não está disponível no teu painel | Contacta o Partner Success para a habilitarem                |

### Conclusão

O GeoIP dá-te uma alavanca de segurança simples: decides por país quem chega às tuas IPs públicas, sem manter listas de endereços à mão e com um botão de reset quando precisares.

A regra de ouro é lembrar que atua apenas sobre o país de origem: as portas e os protocolos continuam a ser governados por ti nas regras de Entrada/Saída, por isso o GeoIP acrescenta-se a essa camada, não a substitui.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.plenit.com/docs-pt/productos/servers/how-to/how-to-configure-geoip-to-block-or-allow-countries.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
