Ontem, ao configurar um novo notebook com Windows 11, percebi que baixar pacotes com pip e npm estava demorando muito, e no npm, gerando timeout. Inicialmente, achei que poderia ser problema de rede ou servidor, mas ao investigar mais a fundo, descobri que o problema estava relacionado ao IPv6 do Windows 11.
O problema
Por padrão, o Windows 11 prioriza conexões IPv6 sobre IPv4. Em muitas redes domésticas ou até corporativas, o IPv6 não está totalmente funcional, o que faz com que ferramentas como pip e npm tentem se conectar usando IPv6 primeiro.
Como a rede não responde via IPv6, a conexão fica “presa” até que caia para IPv4, causando lentidão significativa ao instalar pacotes.
Um teste simples no PowerShell confirmou o problema:
ping pypi.org
Resultado:
Pinging pypi.org [2a04:4e42:600::223] with 32 bytes of data:
Destination net unreachable.
Forçando IPv4:
ping -4 pypi.org
Resultado:
Pinging pypi.org [151.101.192.223] with 32 bytes of data:
Reply from 151.101.192.223: bytes=32 time=20ms
O mesmo comportamento foi observado para o npm:
ping registry.npmjs.org
IPv6 falhando, IPv4 funcionando normalmente.
Solução manual
A primeira abordagem foi alterar a prioridade do IPv4 no Windows para que o sistema tentasse IPv4 antes do IPv6. Isso é feito ajustando a tabela de prefixos IPv6:
netsh interface ipv6 set prefixpolicy ::ffff:0:0/96 60 3
Após esse ajuste, os pings começaram a resolver direto para IPv4, e tanto pip quanto npm voltaram a funcionar rapidamente.
Para quem quiser voltar ao padrão original (prioridade IPv6), basta executar:
netsh interface ipv6 reset
Tornando a solução permanente e automatizada
Embora o ajuste manual resolva o problema, percebi que seria útil criar uma solução automatizada para aplicar a configuração rapidamente, incluindo:
• Ajuste da prioridade IPv4 no Windows
• Configuração do pip para preferir IPv4
• Configuração do Node.js/npm para preferir IPv4
Criei um script PowerShell (.ps1) interativo, que permite:
1 - Forçar IPv4 em Windows, pip e npm
2 - Restaurar a configuração padrão (IPv6 primeiro)
O script ainda exibe a tabela de prefixos antes e depois da alteração, permitindo verificar que a mudança foi aplicada corretamente.
Resultado
Após aplicar o script:
• pip voltou a instalar pacotes rapidamente
• npm também deixou de sofrer com a lentidão
• O Windows 11 passou a usar IPv4 como prioridade sem desabilitar o IPv6 totalmente
Essa abordagem é mais segura do que desativar IPv6, evitando possíveis problemas em redes corporativas ou serviços que dependam de IPv6.
Se você tiver um notebook novo ou uma rede onde o IPv6 não está totalmente funcional, é comum notar lentidão em downloads de pacotes no pip e npm no Windows 11.
A solução ideal é forçar o IPv4 como prioridade, que pode ser feita manualmente com netsh ou de forma automatizada com um script PowerShell, garantindo rapidez e confiabilidade ao instalar pacotes, sem comprometer a funcionalidade do IPv6 no sistema.