Tutoriais de VPS
Guia de configuração de IPv6 em VPS: ativar pilha dupla, DNS, Nginx e erros comuns (2026)
Muitos VPS já vêm com IPv6, mas não configurado corretamente: ou não há registro AAAA, ou o firewall bloqueia o v6, ou o Nginx só escuta em IPv4. Este artigo traz um fluxo de configuração de pilha dupla que você pode copiar: desde confirmar se há um /64, verificar rotas, configurar netplan/ifupdown/NetworkManager, até DNS AAAA, escuta do Nginx/SSH, regras de UFW/ip6tables, e depois percorrer de uma vez os erros mais comuns.

Muita gente vê uma linha dizendo "IPv6 /64 Included" ao comprar um VPS e pensa: ótimo, um monte de endereços de graça.
Mas na hora de usar de verdade:
ping6não funciona- Seu domínio só tem registro A, e o AAAA continua vazio
- O Nginx só escuta em IPv4, então o acesso por IPv6 dá timeout direto
Este artigo faz uma coisa só: transformar o IPv6 de "enfeite" em "utilizável", tentando não quebrar sua configuração IPv4 existente.
Primeiro dê uma olhada no VPS:
ip -6 addr
ip -6 route
O que você normalmente quer ver:
- Um IPv6 público na interface de rede (geralmente começando com
2a01:,2400:) - Uma rota padrão
default via ... dev eth0
Se você só vê um endereço link-local como fe80::, isso basicamente significa "não configurado".
Autoteste de conectividade mais simples:
ping -6 -c 3 2606:4700:4700::1111
curl -6 -s https://api64.ipify.org && echo
ping -6funciona: pelo menos o roteamento não está mortocurl -6retorna um IPv6: seu IPv6 de saída está funcionando
Se já falhar nesta etapa, não corra para mexer no Nginx; 99% das vezes é: o provedor não habilitou para você, você não adicionou o gateway, ou o firewall eliminou o tráfego v6 de saída/entrada.
A principal diferença entre as distribuições é "onde fica o arquivo de configuração de rede". Vou colocar os três tipos mais comuns juntos; escolha o que corresponde ao seu caso.
Primeiro confirme o nome da interface:
ip link
Depois veja a configuração netplan existente:
ls -l /etc/netplan/
cat /etc/netplan/*.yaml
Exemplo (você precisa trocar addresses/gateway6/nameservers pelo que o provedor te deu):
network:
version: 2
ethernets:
eth0:
dhcp4: true
dhcp6: false
addresses:
- 2001:db8:1234:5678::2/64
gateway6: 2001:db8:1234:5678::1
nameservers:
addresses:
- 1.1.1.1
- 2606:4700:4700::1111
Aplique a configuração:
sudo netplan apply
Veja o /etc/network/interfaces:
cat /etc/network/interfaces
Exemplo:
auto eth0
iface eth0 inet dhcp
iface eth0 inet6 static
address 2001:db8:1234:5678::2
netmask 64
gateway 2001:db8:1234:5678::1
Reinicie a rede (os comandos podem variar um pouco entre sistemas):
sudo systemctl restart networking
nmcli con show
nmcli con mod "System eth0" ipv6.method manual \
ipv6.addresses "2001:db8:1234:5678::2/64" \
ipv6.gateway "2001:db8:1234:5678::1" \
ipv6.dns "2606:4700:4700::1111 2001:4860:4860::8888"
nmcli con up "System eth0"
Observação: o
2001:db8::acima é um prefixo de exemplo da documentação; você deve substituí-lo pelo seu IPv6 real.
Muita gente "acha que o IPv6 não funciona", quando na verdade só falta configurar o DNS.
- IPv4: registro A
- IPv6: registro AAAA
Você pode verificar com estes dois comandos:
# 本机或 VPS 都行
nslookup -type=A yourdomain.com
nslookup -type=AAAA yourdomain.com
Se o AAAA estiver vazio, quando você usar curl https://yourdomain.com, o navegador, claro, só poderá ir por IPv4.
Armadilha: depois de ativar o proxy da Cloudflare, mesmo que a origem não tenha IPv6, a Cloudflare pode te dar "IPv6 de frontend".
- Isso não significa que o IPv6 do seu VPS está configurado
- Só significa que os nós de borda da Cloudflare estão "fazendo fachada" para você
Para verificar se a origem realmente suporta IPv6, teste com "conexão direta à origem" (por exemplo, acesse diretamente o IPv6 do VPS ou desative temporariamente o proxy DNS).
O caso mais comum: o Nginx só tem listen 80;, sem listen [::]:80;.
Adicione na configuração do seu site (exemplo):
server {
listen 80;
listen [::]:80;
server_name example.com;
location / {
return 200 "ok\n";
}
}
Depois:
sudo nginx -t
sudo systemctl reload nginx
Você pode testar diretamente com IPv6:
# 用你的域名
curl -6 -I http://example.com
# 或者直接用 IPv6(注意要用中括号)
curl -I "http://[2001:db8:1234:5678::2]/"
Primeiro confirme se o UFW tem IPv6 habilitado:
sudo grep -n '^IPV6=' /etc/default/ufw
O que você quer ver:
IPV6=yes
Liberar portas (exemplo: SSH/HTTP/HTTPS):
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw reload
sudo ufw status verbose
Muita gente só configura o iptables, e como resultado o IPv6 fica totalmente exposto ou totalmente bloqueado.
sudo ip6tables -S
sudo ip6tables -L -n -v
As regras básicas que você precisa (exemplo, apenas para mostrar a ideia):
sudo ip6tables -A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT
sudo ip6tables -A INPUT -p tcp --dport 22 -j ACCEPT
sudo ip6tables -A INPUT -p tcp --dport 80 -j ACCEPT
sudo ip6tables -A INPUT -p tcp --dport 443 -j ACCEPT
sudo ip6tables -A INPUT -j DROP
Causa típica: firewall/grupo de segurança não aberto (especialmente se você só abriu regras IPv4).
Você pode iniciar temporariamente um teste de escuta no VPS:
sudo python3 -m http.server 8000 --bind ::
Depois, da sua máquina local:
curl -6 "http://[你的VPS_IPV6]:8000/"
Esse tipo de problema geralmente é "qualidade de roteamento": a saída IPv6 de algumas redes faz desvios, ou as operadoras não se importam muito com a qualidade do IPv6.
A abordagem é simples:
- Primeiro compare com
curl -6ecurl -4 - Se o v6 estiver claramente instável, considere não adicionar o AAAA por enquanto (ou deixar a Cloudflare gerenciar)
Se precisar de um diagnóstico de rede mais detalhado, leia este artigo:
Verifique primeiro:
- Se o Nginx tem
listen [::]:80/listen [::]:443 ssl - Se o serviço backend (por exemplo Node/Go) escuta em
0.0.0.0mas não em::
Se o seu problema é essencialmente "o site não abre", você pode seguir primeiro esta rota de diagnóstico:
- Guia de reforço de segurança do VPS: SSH + firewall + Fail2Ban
- Configuração de aceleração CDN da Cloudflare: melhoria gratuita da velocidade de acesso global
- Como investigar rede VPS lenta: do teste de velocidade à localização de perda de pacotes
- Site do VPS não abre? Diagnóstico e correção de problemas comuns