Infraestrutura
Como configurar WireGuard em VPS com segurança
Aprenda como configurar WireGuard em VPS, proteger chaves e firewall, conectar clientes e manter uma VPN privada estável para acesso remoto seguro na VPS.
Resposta direta
Para configurar WireGuard em uma VPS, instale o pacote wireguard, gere um par de chaves para o servidor e outro para cada cliente, crie a interface wg0 e habilite o encaminhamento de pacotes no Linux. O servidor precisa aceitar uma porta UDP, normalmente 51820, e aplicar NAT quando os clientes usarem a VPS como saída para a internet. Cada dispositivo deve ter endereço privado exclusivo, como 10.8.0.2/32, e sua própria chave. Depois, ative o serviço com systemctl enable --now wg-quick@wg0 e valide o túnel usando wg show, ping e testes de IP público. Em produção, proteja os arquivos com permissão 600, limite o firewall, mantenha o sistema atualizado e nunca reutilize a chave privada do servidor nos clientes.
Resumo rápido
- Uma VPS com 1 vCPU, 1 GB de RAM e 10 GB de disco atende poucos usuários e tráfego moderado.
- O WireGuard transporta os túneis por UDP e usa pares de chaves públicas e privadas.
- Cada cliente precisa de uma chave exclusiva e de um endereço IP próprio dentro da rede privada.
AllowedIPsdefine quais destinos passam pelo túnel e também participa da seleção de rotas.- O encaminhamento IPv4 deve ser habilitado com
net.ipv4.ip_forward=1. - Túnel completo geralmente exige NAT; acesso apenas à rede privada pode usar roteamento direto.
- Firewall, rotação de chaves, atualizações e testes de restauração fazem parte da operação.
Como escolher e preparar a VPS
Recursos mínimos e localização
O WireGuard consome poucos recursos quando comparado a aplicações web, bancos de dados ou painéis de hospedagem. Para acesso administrativo de até cinco pessoas, uma VPS com 1 vCPU, 1 GB de RAM e 10 a 20 GB de SSD costuma oferecer margem suficiente. Uma equipe com 10 a 30 dispositivos, tráfego de arquivos e acesso a aplicações internas pode começar com 2 vCPUs, 2 GB de RAM e uma interface de rede capaz de sustentar o volume contratado. CPU passa a importar quando muitos clientes transferem dados simultaneamente ou quando a VPN é usada como gateway de internet.
A localização afeta principalmente a latência. Um desenvolvedor em São Paulo conectado a uma instância na mesma região tende a obter respostas menores do que obteria em um servidor nos Estados Unidos ou na Europa, mas o resultado depende da operadora, do peering e da rota. A escolha de VPS para VPN privada no Brasil deve considerar latência medida, franquia de transferência, política de uso e disponibilidade de endereços públicos, não apenas a cidade anunciada.
Portas, IP público e rede do provedor
O cenário mais simples usa um IPv4 público diretamente associado à VPS. Instâncias atrás de NAT também podem funcionar, desde que o provedor permita encaminhar uma porta UDP externa até a porta do WireGuard. Antes da instalação, confirme se o painel possui firewall de borda, se a rede bloqueia UDP e qual é o nome da interface principal, como eth0, ens3 ou enp1s0.
A tabela resume pontos de partida, não limites absolutos. Capacidade real depende de CPU, rota, criptografia, quantidade de conexões e limites do provedor.
| Perfil | CPU e RAM iniciais | Rede privada sugerida | Clientes ativos | Uso típico |
|---|---|---|---|---|
| Acesso individual | 1 vCPU e 1 GB | 10.8.0.0/24 | 1 a 5 | SSH, painel interno e banco de desenvolvimento |
| Pequena equipe | 2 vCPUs e 2 GB | 10.20.0.0/24 | 5 a 30 | Git, intranet, monitoramento e arquivos |
| Gateway de produção | 2 a 4 vCPUs e 4 GB | 10.40.0.0/23 | 20 a 100 | Serviços privados e saída controlada para internet |
| Site a site | 2 vCPUs e 2 GB | Sub-redes sem sobreposição | 2 ou mais redes | Integração entre escritório, cloud e laboratório |
Reserve o endereço 10.8.0.1 para o servidor e documente cada IP entregue. Evite faixas que já existam nas redes domésticas dos usuários. Usar 192.168.0.0/24, por exemplo, pode criar conflito quando o notebook estiver conectado a um roteador com a mesma sub-rede.
Instalação do WireGuard no Linux
Instalação no Ubuntu ou Debian
Comece atualizando o índice de pacotes e instalando o WireGuard. As versões atuais do Ubuntu e do Debian incluem o módulo necessário em kernels suportados, enquanto o pacote fornece ferramentas como wg e wg-quick.
sudo apt update
sudo apt install wireguard qrencode
sudo modprobe wireguard
wg --version
O pacote qrencode é opcional. Ele ajuda a importar a configuração em celulares sem copiar o arquivo, mas o QR code contém a chave privada do cliente. Gere e exiba esse código somente em um terminal confiável, longe de gravações de tela e logs de sessão. Em distribuições da família RHEL, a instalação pode ser feita com dnf install wireguard-tools, desde que os repositórios e o kernel da distribuição ofereçam suporte.
Confirme a interface de saída antes de montar as regras de NAT:
ip route show default
ip -brief address
Se a rota padrão mostrar default via 203.0.113.1 dev ens3, a interface externa é ens3. Copiar uma configuração que usa eth0 sem verificar esse detalhe é uma causa frequente de túnel conectado sem acesso à internet.
Geração segura das chaves
Crie o diretório da configuração com acesso restrito e use umask 077 para impedir leitura por outros usuários. A chave privada não deve ser enviada a serviços externos nem incluída em repositórios Git.
sudo install -d -m 700 /etc/wireguard
cd /etc/wireguard
sudo sh -c 'umask 077; wg genkey > server.key; wg pubkey < server.key > server.pub'
sudo chmod 600 server.key
Repita o processo para cada cliente em seu próprio dispositivo. Se isso não for possível, gere o par temporariamente no servidor, entregue a configuração por um canal seguro e remova a cópia local da chave privada do cliente. Para um notebook chamado dev-ana, por exemplo, registre apenas a chave pública e o IP atribuído no inventário do servidor. O arquivo privado deve permanecer no notebook.
Confira permissões com sudo stat /etc/wireguard/server.key. O resultado deve mostrar modo 0600 e proprietário root. Backups da VPS precisam tratar esse diretório como dado sensível. Um snapshot contendo chaves privadas concede acesso à VPN a quem conseguir restaurá-lo ou baixá-lo.
Configuração do servidor e do roteamento
Arquivo wg0.conf
Crie /etc/wireguard/wg0.conf com a interface privada, a porta UDP e um bloco Peer para cada cliente. O exemplo usa 10.8.0.0/24, servidor em 10.8.0.1 e interface pública ens3. Substitua os marcadores pelas chaves correspondentes, sem publicar a chave privada em tickets, chats ou documentação compartilhada.
[Interface]
Address = 10.8.0.1/24
ListenPort = 51820
PrivateKey = <CHAVE_PRIVADA_DO_SERVIDOR>
SaveConfig = false
PostUp = iptables -A FORWARD -i wg0 -j ACCEPT; iptables -A FORWARD -o wg0 -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT; iptables -t nat -A POSTROUTING -o ens3 -j MASQUERADE
PostDown = iptables -D FORWARD -i wg0 -j ACCEPT; iptables -D FORWARD -o wg0 -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT; iptables -t nat -D POSTROUTING -o ens3 -j MASQUERADE
[Peer]
PublicKey = <CHAVE_PUBLICA_DO_CLIENTE_ANA>
AllowedIPs = 10.8.0.2/32
A máscara /32 no peer impede que dois clientes reivindiquem a mesma faixa. Para adicionar outro dispositivo, atribua 10.8.0.3/32 e uma chave pública diferente. Não coloque a mesma chave em celular e notebook, pois isso dificulta revogação, auditoria e diagnóstico de roaming.
Encaminhamento e NAT
Ative o encaminhamento IPv4 de forma persistente:
sudo tee /etc/sysctl.d/99-wireguard.conf > /dev/null <<'EOF'
net.ipv4.ip_forward=1
EOF
sudo sysctl --system
As regras PostUp e PostDown do exemplo permitem encaminhamento e aplicam masquerade. NAT é necessário quando o cliente usa a VPS como gateway e a rede externa não possui rota de retorno para 10.8.0.0/24. Para acessar apenas serviços instalados na própria VPS, ele pode ser dispensado. Em uma rede corporativa com roteador controlado, uma alternativa mais limpa é criar uma rota estática para 10.8.0.0/24 apontando para a VPS, preservando os endereços dos clientes nos logs.
Proteja o arquivo e teste antes de habilitar na inicialização:
sudo chmod 600 /etc/wireguard/wg0.conf
sudo wg-quick up wg0
sudo wg show
sudo systemctl enable wg-quick@wg0
Se wg-quick up informar que a interface já existe, use sudo wg-quick down wg0 antes de repetir. Se houver erro em iptables, confirme se o pacote está instalado e se a distribuição usa regras próprias em nftables. Misturar UFW, regras manuais e firewall do provedor sem documentar a ordem pode produzir bloqueios difíceis de reproduzir.
Como conectar clientes e controlar o tráfego
Configuração do primeiro cliente
No notebook, instale o aplicativo oficial ou o pacote wireguard-tools, gere um par de chaves e crie uma configuração como esta:
[Interface]
Address = 10.8.0.2/32
PrivateKey = <CHAVE_PRIVADA_DO_CLIENTE>
DNS = 1.1.1.1
[Peer]
PublicKey = <CHAVE_PUBLICA_DO_SERVIDOR>
Endpoint = vpn.exemplo.com.br:51820
AllowedIPs = 10.8.0.0/24
PersistentKeepalive = 25
Endpoint pode usar o IP público ou um nome DNS. Um nome facilita trocar o endereço da VPS, mas o cliente precisa resolver esse domínio antes de abrir o túnel. PersistentKeepalive = 25 ajuda dispositivos atrás de NAT ou redes móveis a manter o mapeamento UDP. Em um servidor com endereço público estável, essa opção normalmente fica apenas nos clientes que necessitam dela.
Split tunnel, túnel completo e DNS
O exemplo usa split tunnel: somente destinos da rede 10.8.0.0/24 passam pela VPN. É adequado para SSH, banco privado e painéis internos, mantendo navegação e videoconferências na conexão local. Para enviar todo o tráfego IPv4 pelo servidor, altere para AllowedIPs = 0.0.0.0/0. Nesse modo, o NAT do servidor precisa funcionar e a franquia de transferência da VPS passa a ser consumida por downloads, atualizações e streaming dos clientes.
DNS exige uma decisão separada. Definir DNS = 1.1.1.1 muda o resolvedor enquanto a interface está ativa em clientes compatíveis, mas não cria resolução para nomes internos. Uma equipe pode hospedar Unbound ou outro resolvedor em 10.8.0.1 e configurar DNS = 10.8.0.1. Teste vazamentos e comportamento quando o túnel cair, sobretudo em notebooks corporativos com gerenciadores de rede.
WireGuard com IPv6
Para uma rede interna IPv6, pode-se adicionar Address = fd42:8:8::1/64 no servidor e fd42:8:8::2/128 no cliente. Já o acesso nativo à internet por IPv6 depende de prefixo roteado pelo provedor e de regras específicas no firewall. NAT66 não deve ser copiado automaticamente da configuração IPv4. O conteúdo sobre IPv6 em VPS no Brasil ajuda a separar endereço público, prefixo roteado e suporte efetivo do provedor.
Se o cliente anunciar ::/0 sem o servidor encaminhar IPv6 corretamente, sites que preferem IPv6 podem falhar enquanto o IPv4 continua funcionando. Nesse caso, configure o caminho IPv6 completo ou mantenha apenas 0.0.0.0/0 até validar rota, DNS, firewall e retorno dos pacotes.
Firewall, hardening e proteção das chaves
Regras mínimas de firewall
O firewall precisa liberar a porta UDP do WireGuard sem expor serviços administrativos desnecessários. Com UFW, uma base simples permite SSH antes de ativar o bloqueio e abre 51820/udp:
sudo ufw allow 22/tcp
sudo ufw allow 51820/udp
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw enable
sudo ufw status verbose
Se o SSH usa outra porta, ajuste a regra antes de habilitar o UFW. Mantenha uma sessão administrativa aberta e teste uma segunda conexão para evitar bloqueio acidental. O firewall do painel da VPS também deve liberar UDP 51820, mas duplicar regras não substitui o filtro dentro do sistema. Um guia de firewall e hardening de segurança em VPS pode ser usado para revisar SSH por chave, atualizações e redução da superfície exposta.
Depois que a VPN estiver validada, serviços como PostgreSQL, Redis ou um painel administrativo podem escutar somente em 10.8.0.1 ou em 127.0.0.1. Outra opção é permitir suas portas apenas pela interface wg0. Não exponha banco de dados em 0.0.0.0 contando apenas com uma senha forte.
Isolamento entre clientes
A regra ampla FORWARD -i wg0 -j ACCEPT permite que clientes encaminhem tráfego pela VPS. Se notebooks não devem conversar entre si, aplique uma política mais específica com nftables ou regras de encaminhamento por origem e destino. Um prestador pode receber acesso apenas a 10.50.0.10:443, enquanto a equipe interna alcança toda a sub-rede. Essa segmentação reduz o impacto de um dispositivo comprometido.
Rotação e revogação
Revogar um cliente consiste em remover seu bloco Peer e recarregar a configuração. Use sudo wg syncconf wg0 <(wg-quick strip wg0) em um shell compatível ou faça uma interrupção planejada com wg-quick down e up. Para troca gradual, gere uma nova chave, crie temporariamente outro peer com IP diferente, valide o acesso e só então exclua a chave antiga.
Mantenha um inventário com nome do dispositivo, responsável, IP, chave pública e data da última revisão. Não registre chaves privadas. Uma PresharedKey exclusiva por peer pode acrescentar uma camada simétrica, mas também precisa de distribuição e rotação seguras. Ela não substitui a proteção das chaves privadas nem o controle de acesso aos serviços internos.
Operação, testes e solução de problemas
Como verificar o túnel
No servidor, sudo wg show apresenta peers, endpoint observado, último handshake e contadores de transferência. Um handshake recente confirma que houve troca criptográfica, mas não garante que roteamento, DNS e NAT estejam corretos. Faça testes em camadas: primeiro o endereço do túnel, depois um serviço privado e, por último, a internet.
ping -c 3 10.8.0.1
ssh [email protected]
curl -4 https://ifconfig.me
sudo wg show
No modo split tunnel, o curl deve continuar mostrando o IP da conexão local. No túnel completo, deve mostrar o IPv4 público da VPS. Esse teste envolve um serviço externo e não deve ser usado para enviar informações sensíveis.
Falhas comuns de conexão
Quando não existe handshake, verifique Endpoint, porta UDP, chave pública do servidor, firewall da VPS e firewall de borda. Use sudo ss -lunp | grep 51820 para confirmar que há um socket escutando. sudo tcpdump -ni any udp port 51820 revela se os pacotes chegam, embora a captura não consiga ler o conteúdo criptografado.
Se há handshake, mas não há tráfego, confira AllowedIPs, endereços duplicados, ip_forward, regras de FORWARD e nome da interface externa. Execute ip route get 1.1.1.1 para identificar a saída real. Em redes domésticas, conflitos entre 10.8.0.0/24 e uma rota local podem desviar os pacotes antes que cheguem ao WireGuard.
MTU, desempenho e monitoramento
A MTU padrão costuma funcionar, mas encapsulamento adicional, PPPoE ou outra VPN no caminho pode causar páginas que carregam parcialmente. Teste MTU = 1380 no cliente e no servidor quando pings pequenos funcionarem e transferências maiores travarem. Reduza de forma controlada, pois um valor muito baixo aumenta overhead.
Monitore disponibilidade da interface, handshakes e tráfego sem transformar a VPN em instrumento de vigilância. Um alerta pode sinalizar ausência de handshake de um gateway site a site por cinco minutos, mas notebooks de usuários ficam naturalmente inativos. Acompanhe CPU, perda de pacotes, largura de banda e espaço em disco. O WireGuard não gera, por padrão, um histórico detalhado de conexões, então auditoria de acesso deve ocorrer também nos serviços finais, como SSH, Git e painéis internos.
Antes de atualizar kernel ou migrar a VPS, exporte a configuração de forma criptografada e teste restauração em ambiente isolado. Nunca mantenha duas instâncias ativas com a mesma chave privada e o mesmo endpoint sem entender como os clientes resolverão o destino. Para mudanças de IP, reduza previamente o TTL do DNS, atualize o registro e valide clientes em redes diferentes.
Recomendações por perfil
Desenvolvedor individual
Para acessar SSH, banco de homologação e ferramentas pessoais, comece com 1 vCPU, 1 GB de RAM e uma rede 10.8.0.0/24. Use split tunnel com AllowedIPs = 10.8.0.0/24, pois isso evita enviar navegação cotidiana pela VPS. Mantenha um peer para o notebook e outro para o celular, mesmo que pertençam à mesma pessoa. Abra somente SSH e a porta UDP do WireGuard no firewall. Se a VPN proteger apenas serviços da própria instância, vincule esses serviços a 10.8.0.1 e dispense regras complexas de acesso entre sub-redes.
Pequena equipe
Uma equipe de 5 a 30 pessoas deve priorizar inventário, revogação e separação de permissões. Uma configuração inicial de 2 vCPUs e 2 GB de RAM oferece folga operacional, mas rede e CPU precisam ser observadas durante transferências simultâneas. Entregue um IP e uma chave para cada dispositivo, não apenas para cada usuário. Divida fornecedores e colaboradores em faixas ou regras distintas. Automatizar a criação dos peers reduz erros, desde que o processo nunca grave chaves privadas em logs. Faça uma revisão mensal de dispositivos ativos e remova acessos de pessoas que mudaram de função ou saíram do time.
Ambiente de produção
Para serviços críticos, trate a VPN como parte da infraestrutura de acesso, não como o único controle de segurança. Combine WireGuard com autenticação do serviço final, SSH por chave, privilégios mínimos, registros de auditoria e backups testados. Um gateway com 2 a 4 vCPUs e 4 GB de RAM é um ponto de partida para dezenas de clientes, não uma garantia de throughput. Meça latência, uso de CPU e perda de pacotes com o tráfego real. Documente rotas, regras de firewall, responsáveis por chaves e procedimento de emergência. Se a VPN for o único caminho administrativo, planeje acesso alternativo pelo console do provedor para corrigir falhas de rede ou firewall.
Continue lendo
Perguntas frequentes
Qual é a configuração mínima de VPS para rodar WireGuard?
Para uso individual ou até cinco clientes com tráfego moderado, 1 vCPU, 1 GB de RAM e 10 a 20 GB de SSD formam um ponto de partida razoável. O WireGuard ocupa pouco espaço e não exige um banco de dados. O limite costuma aparecer primeiro na CPU, na largura de banda ou na franquia de transferência quando a VPS funciona como gateway de internet. Para uma equipe com vários downloads simultâneos, comece com 2 vCPUs e 2 GB de RAM, monitore o consumo e ajuste com base no tráfego real.
O servidor WireGuard precisa ter um endereço IP público?
Um IP público facilita a configuração porque o cliente pode alcançar diretamente a porta UDP do WireGuard. Ele não é obrigatório se a VPS estiver atrás de NAT e o provedor oferecer encaminhamento de porta até a instância. Também é possível usar um endereço IPv6 público quando todos os clientes possuem conectividade IPv6 funcional. Em qualquer cenário, o endpoint precisa ser alcançável a partir da internet. Confirme ainda se o firewall de borda permite UDP, pois liberar a porta apenas dentro do Linux não resolve um bloqueio aplicado pela rede do provedor.
É obrigatório usar a porta UDP 51820?
Não. A porta 51820 é uma convenção comum nos exemplos do WireGuard, mas o serviço pode escutar em outra porta UDP disponível, como 51821 ou 41732. A mesma porta deve aparecer em `ListenPort`, no firewall e no `Endpoint` configurado nos clientes. Trocar a porta reduz ruído causado por varreduras genéricas, mas não substitui criptografia, atualizações e proteção das chaves. Antes da mudança, confira se a nova porta não está ocupada e se o firewall do provedor e o firewall do sistema operacional permitem o tráfego.
Qual é a diferença entre split tunnel e túnel completo?
No split tunnel, apenas redes listadas em `AllowedIPs`, como `10.8.0.0/24`, passam pelo WireGuard. Navegação, streaming e outros destinos continuam usando a conexão local do cliente. No túnel completo, `0.0.0.0/0` envia todo o tráfego IPv4 pela VPS, que precisa encaminhar pacotes e normalmente aplicar NAT. O túnel completo centraliza a saída e protege tráfego em redes não confiáveis, mas aumenta consumo de banda e dependência do servidor. A escolha deve acompanhar o objetivo da VPN, não uma preferência automática por um dos modos.
Posso usar a mesma chave WireGuard em vários dispositivos?
Tecnicamente, uma configuração copiada pode funcionar em mais de um dispositivo, mas essa prática causa conflitos de endpoint, dificulta auditoria e impede revogar apenas um aparelho. Cada notebook, celular, servidor ou roteador deve gerar sua própria chave privada e receber um endereço exclusivo, como `10.8.0.2/32`. O servidor armazena somente a chave pública correspondente. Se um telefone for perdido, o administrador remove apenas aquele peer, sem interromper o notebook do mesmo usuário. Esse modelo também facilita identificar endereços duplicados e acompanhar o último handshake de cada dispositivo.
Como usar IPv6 no WireGuard sem quebrar a conexão?
Comece atribuindo uma faixa privada, como `fd42:8:8::/64`, com um endereço `/128` para cada cliente. Para oferecer saída IPv6 pública, a VPS precisa receber do provedor um prefixo roteável ou uma configuração compatível com encaminhamento. Ative `net.ipv6.conf.all.forwarding=1`, crie regras de firewall e confirme a rota de retorno. Não anuncie `::/0` aos clientes antes desses testes, pois aplicações podem preferir IPv6 e falhar silenciosamente. Se o provedor entregar apenas um endereço isolado, confirme a topologia recomendada antes de tentar compartilhar conectividade com os peers.
Fontes consultadas
- WireGuard Quick Start · coletado em 05/11/2026
- WireGuard Protocol and Cryptography · coletado em 05/11/2026
- Ubuntu Server Firewall Documentation · coletado em 05/11/2026
- Ubuntu wg-quick Manual Page · coletado em 05/11/2026