Proxy no PyCharm e IntelliJ IDEA: configuração em 5 minutos

```html

Se os plugins nas IDEs da JetBrains não estão sendo instalados, Maven ou pip não conseguem baixar dependências, e o Marketplace simplesmente não abre — provavelmente, o problema está nas restrições de rede. O proxy resolve isso em poucos minutos. Neste artigo, vamos explorar todas as maneiras de configurar: através da interface integrada da IDE, através de variáveis de sistema e através de arquivos de configuração — para PyCharm, IntelliJ IDEA, WebStorm, GoLand e outros produtos da JetBrains.

Por que um desenvolvedor precisa de proxy na IDE

As IDEs da JetBrains fazem uso ativo da rede: baixam plugins do Marketplace, atualizam índices, puxam dependências através do Maven Central, PyPI, npm e outros repositórios, verificam licenças, sincronizam configurações através da JetBrains Account. Se pelo menos uma dessas solicitações for bloqueada — o trabalho é atrasado ou até mesmo interrompido.

Aqui estão situações específicas em que o uso de proxy é indispensável:

Rede corporativa com firewall. Muitas empresas permitem tráfego externo apenas através de um servidor proxy corporativo. Sem a configuração adequada na IDE, os plugins não serão instalados e as dependências não serão baixadas.
Geobloqueios. Parte dos repositórios e CDN é restrita geograficamente. Um proxy na localização correta remove essa restrição.
Trabalho de um país com internet restrita. O Marketplace da JetBrains, GitHub Packages, Maven Central podem não estar disponíveis diretamente.
Desenvolvimento e teste de aplicações de rede. É necessário direcionar o tráfego da IDE através de um nó específico para verificar o comportamento da aplicação em outra região.
Segurança em redes públicas. Ao trabalhar de um café ou coworking, o proxy criptografa o tráfego da IDE e protege tokens e chaves contra interceptação.
Contornar restrições de sanções. Após 2022, vários repositórios e serviços externos impuseram restrições por IP — o proxy permite continuar o trabalho sem mudar de ferramentas.

Ao contrário do navegador, onde o proxy é configurado uma vez e funciona globalmente, nas IDEs da JetBrains o proxy precisa ser configurado separadamente — e às vezes em vários lugares: na própria IDE, no gerenciador de dependências e no interpretador de linguagem. Vamos analisar cada nível em ordem.

Qual tipo de proxy escolher para JetBrains

As IDEs da JetBrains suportam três tipos de proxy: HTTP, HTTPS e SOCKS5. Para a maioria das tarefas de desenvolvimento, proxies HTTP/HTTPS são adequados — eles funcionam de forma transparente com todas as solicitações da IDE, Maven, Gradle e pip. SOCKS5 oferece mais flexibilidade e opera no nível TCP, o que é útil para protocolos não padrão.

Tipo de proxy	Suporte na IDE	Adequado para	Características
HTTP/HTTPS	✅ Nativo	Plugins, dependências, licença	Mais fácil de configurar
SOCKS5	✅ Nativo	Qualquer conexão TCP	Suporta autenticação
Arquivo PAC	✅ Através das configurações do sistema	Redes corporativas	Roteamento flexível
Proxy do sistema	✅ Auto-detectar	Quando já configurado no SO	Não requer configurações adicionais

Se você está trabalhando com um proxy corporativo — provavelmente, ele é HTTP/HTTPS com autenticação por login e senha. Se você está conectando um serviço de proxy externo para contornar bloqueios, preste atenção aos proxies de data center — eles oferecem alta velocidade e estabilidade de conexão, o que é crítico ao baixar grandes dependências e índices.

Configuração de proxy através da interface da IDE (HTTP/HTTPS)

Este é o método mais simples e recomendado. As configurações se aplicam a todas as solicitações de rede da IDE: Marketplace, atualizações, verificação de licença, sincronização de plugins. A instrução é a mesma para PyCharm, IntelliJ IDEA, WebStorm, GoLand, Rider, CLion e outros produtos da linha.

Passo 1. Abra as configurações da IDE

No Windows e Linux: File → Settings (ou Ctrl+Alt+S).
No macOS: PyCharm → Preferences (ou Cmd+,).

Passo 2. Encontre a seção de proxy

No painel esquerdo das configurações, navegue até: Appearance & Behavior → System Settings → HTTP Proxy. Ou simplesmente comece a digitar a palavra proxy na barra de pesquisa das configurações — a IDE mostrará imediatamente a seção necessária.

Passo 3. Selecione o tipo de proxy e preencha os dados

Na seção HTTP Proxy, você verá três opções:

No proxy — conexão direta (padrão).
Auto-detectar configurações de proxy — a IDE pegará as configurações do sistema operacional.
Configuração manual de proxy — configuração manual. Selecione esta opção.

Ao escolher Configuração manual de proxy, preencha os campos:

Nome do host — endereço IP ou domínio do servidor proxy. Por exemplo: proxy.example.com ou 192.168.1.100.
Número da porta — porta do proxy. Valores padrão: 8080, 3128, 8888.
Sem proxy para — hosts que devem ir diretamente (sem proxy). Normalmente, adiciona-se localhost, 127.0.0.1, domínios internos da empresa.
Autenticação do proxy — se o proxy requer login e senha, marque a caixa e insira as credenciais.

Passo 4. Verifique a conexão

Clique no botão Check connection e insira qualquer URL — por exemplo, https://plugins.jetbrains.com. Se tudo estiver configurado corretamente, a IDE mostrará o status Connection successful. Após isso, clique em OK e reinicie a IDE.

💡 Dica

As configurações de HTTP Proxy nas IDEs da JetBrains são armazenadas globalmente — elas se aplicam a todos os projetos e são mantidas entre reinicializações. Se você precisa alternar entre proxies para diferentes tarefas, é mais conveniente usar variáveis de ambiente do sistema (descritas abaixo).

Configuração de proxy SOCKS5 nas IDEs da JetBrains

SOCKS5 é um protocolo mais flexível, que funciona não apenas com HTTP/HTTPS, mas também com qualquer conexão TCP. Isso é útil se o seu provedor de proxy oferece SOCKS5, ou se você está usando um túnel SSH.

Na interface das IDEs da JetBrains, a seção SOCKS está no mesmo lugar: Appearance & Behavior → System Settings → HTTP Proxy. No bloco Configuração manual de proxy, altere o botão de opção de HTTP para SOCKS.

Preencha os campos da mesma forma que para o proxy HTTP:

Nome do host — endereço do servidor SOCKS5.
Número da porta — porta (geralmente 1080 ou 1081).
Autenticação do proxy — login e senha, se necessário.

Um detalhe importante: o cliente SOCKS integrado das IDEs da JetBrains opera no nível JVM e intercepta apenas aquelas conexões que a IDE estabelece diretamente através do Java. Processos externos — Maven Wrapper, Gradle Daemon, pip, npm — são executados como processos separados e não herdam as configurações de proxy da interface da IDE. Para eles, é necessária uma configuração separada (veja as seções abaixo).

Configuração através de parâmetros JVM (vmoptions)

Se as configurações através da interface não funcionam (por exemplo, em algumas versões da IDE ou ao usar plugins não padrão), você pode definir o proxy diretamente através dos parâmetros JVM. Este é um método confiável de baixo nível que é garantido para se aplicar a todas as conexões JVM.

Como abrir o arquivo vmoptions

No menu da IDE, vá para: Help → Edit Custom VM Options.... O arquivo pycharm64.vmoptions (ou idea64.vmoptions para IntelliJ IDEA) será aberto no diretório de configurações do usuário.

Adicione as seguintes linhas ao final do arquivo para proxy HTTP:

-Dhttp.proxyHost=your.proxy.host
-Dhttp.proxyPort=8080
-Dhttps.proxyHost=your.proxy.host
-Dhttps.proxyPort=8080
-Dhttp.proxyUser=username
-Dhttp.proxyPassword=password
-Dhttps.proxyUser=username
-Dhttps.proxyPassword=password
-Dhttp.nonProxyHosts=localhost|127.0.0.1|*.local

Para proxy SOCKS5, use os seguintes parâmetros:

-DsocksProxyHost=your.socks.host
-DsocksProxyPort=1080
-DsocksProxyVersion=5

Após salvar o arquivo, reinicie a IDE. As configurações se aplicarão a todas as conexões JVM, incluindo o download de índices, trabalho com plugins e o cliente Git integrado.

⚠️ Importante

Se a senha contiver caracteres especiais (@, #, %), eles precisam ser escapados na codificação URL. Por exemplo, @ → %40. Caso contrário, a JVM não analisará corretamente os parâmetros e o proxy não funcionará.

Proxy através de variáveis de ambiente do sistema

Este método é especialmente conveniente no Linux e macOS, assim como em ambientes CI/CD. As variáveis de ambiente são herdadas não apenas pela JVM, mas também pelos processos filhos — ou seja, Maven, Gradle, pip, npm também as pegarão automaticamente.

Variáveis padrão para proxy HTTP:

export HTTP_PROXY=http://username:[email protected]:8080
export HTTPS_PROXY=http://username:[email protected]:8080
export NO_PROXY=localhost,127.0.0.1,::1

Adicione essas linhas em ~/.bashrc, ~/.zshrc ou ~/.profile dependendo do seu shell. Após isso, reinicie o terminal e inicie a IDE a partir dele — ela pegará as variáveis de ambiente.

No Windows, as variáveis são definidas através da interface do sistema:

Abra Painel de Controle → Sistema → Configurações avançadas do sistema → Variáveis de ambiente.
No bloco "Variáveis de usuário", clique em Criar.
Adicione as variáveis HTTP_PROXY e HTTPS_PROXY com o valor http://username:[email protected]:8080.
Reinicie a IDE.

Observe: as IDEs da JetBrains no Windows são executadas como um processo separado através do launcher, e as variáveis de ambiente definidas na sessão atual do terminal podem não ser passadas para a IDE. É mais confiável defini-las através da interface do sistema ou através do arquivo vmoptions.

Proxy para Maven e Gradle dentro do IntelliJ IDEA

Maven e Gradle são ferramentas separadas com seus próprios arquivos de configuração. Mesmo que o proxy esteja configurado na interface da IDE, o Maven Wrapper e o Gradle Daemon podem ignorar essas configurações, pois são executados como processos JVM independentes.

Proxy para Maven

Abra o arquivo ~/.m2/settings.xml (crie-o se não existir) e adicione a seção <proxies>:

<settings>
  <proxies>
    <proxy>
      <id>main-proxy</id>
      <active>true</active>
      <protocol>https</protocol>
      <host>proxy.example.com</host>
      <port>8080</port>
      <username>your_username</username>
      <password>your_password</password>
      <nonProxyHosts>localhost|127.0.0.1</nonProxyHosts>
    </proxy>
  </proxies>
</settings>

Se você precisar configurar proxies separadamente para HTTP e HTTPS, adicione dois blocos <proxy> com diferentes id e protocol.

Proxy para Gradle

Para o Gradle, as configurações de proxy são definidas no arquivo ~/.gradle/gradle.properties (globalmente) ou no arquivo gradle.properties na raiz do projeto (para um projeto específico):

systemProp.http.proxyHost=proxy.example.com
systemProp.http.proxyPort=8080
systemProp.http.proxyUser=your_username
systemProp.http.proxyPassword=your_password
systemProp.http.nonProxyHosts=localhost|127.0.0.1

systemProp.https.proxyHost=proxy.example.com
systemProp.https.proxyPort=8080
systemProp.https.proxyUser=your_username
systemProp.https.proxyPassword=your_password

Após salvar o arquivo, o IntelliJ IDEA automaticamente pegará as novas configurações na próxima sincronização do projeto Gradle. Clique no botão Reload All Gradle Projects (ícone de atualização na barra do Gradle à direita) — e as dependências começarão a ser baixadas através do proxy.

Proxy para pip e conda no PyCharm

PyCharm é a IDE principal para desenvolvedores Python. A instalação de pacotes através do pip e conda ocorre através de processos separados, que não leem as configurações de proxy da interface do PyCharm. Veja como configurar o proxy para cada gerenciador de pacotes.

Proxy para pip

Método 1 — através do argumento da linha de comando ao instalar um pacote:

pip install requests --proxy http://username:[email protected]:8080

Método 2 — através do arquivo de configuração do pip (aplicado permanentemente). Abra ou crie o arquivo:

Linux/macOS: ~/.config/pip/pip.conf
Windows: %APPDATA%\pip\pip.ini

[global]
proxy = http://username:[email protected]:8080

Método 3 — através de variáveis de ambiente (funciona tanto para pip quanto para outras ferramentas Python):

export HTTP_PROXY=http://username:[email protected]:8080
export HTTPS_PROXY=http://username:[email protected]:8080

Proxy para conda

O conda usa seu próprio arquivo de configuração .condarc. Abra-o no diretório inicial e adicione:

proxy_servers:
  http: http://username:[email protected]:8080
  https: http://username:[email protected]:8080

Ou execute o comando no terminal do PyCharm:

conda config --set proxy_servers.http http://proxy.host:8080
conda config --set proxy_servers.https http://proxy.host:8080

Se você está trabalhando com espelhos do PyPI (por exemplo, o espelho do Yandex ou Nexus corporativo), pode simplesmente alternar o pip para um índice alternativo em vez de usar um proxy. Mas se o espelho também não estiver disponível — o proxy permanece a única solução. Para um funcionamento estável com o PyPI, proxies residenciais são uma boa opção — eles se parecem com solicitações de usuários comuns e não são bloqueados pelos provedores de CDN do PyPI.

Problemas comuns e suas soluções

Mesmo com a configuração correta, às vezes algo dá errado. Vamos analisar os problemas mais comuns e como resolvê-los.

Problema 1: "Connection refused" ou "Unable to connect to proxy"

Causa: host ou porta incorretos ou proxy indisponível.
Solução: verifique o endereço e a porta do proxy. Tente conectar ao proxy através do curl no terminal:

curl -x http://proxy.host:8080 https://plugins.jetbrains.com

Se o curl também não conectar — o problema está no próprio proxy, e não nas configurações da IDE.

Problema 2: Proxy configurado, mas plugins ainda não são instalados

Causa: a IDE armazenou em cache as configurações antigas ou as configurações não se aplicaram a todos os componentes.
Solução:

Feche completamente a IDE (certifique-se de que o processo não está em segundo plano).
Limpe o cache: File → Invalidate Caches → Invalidate and Restart.
Verifique se no arquivo vmoptions não há parâmetros conflitantes.

Problema 3: Erro SSL/TLS ao trabalhar através do proxy

Causa: o proxy corporativo realiza inspeção SSL (MITM) e substitui os certificados. A JVM não confia no certificado substituído.
Solução: peça ao administrador do sistema para fornecer o certificado raiz do CA corporativo e importe-o no Java KeyStore:

keytool -import -alias corporate-ca -keystore $JAVA_HOME/lib/security/cacerts \
  -file corporate-ca.crt -storepass changeit

Nas IDEs da JetBrains, há uma ferramenta integrada: Settings → Tools → Server Certificates — onde você pode adicionar um certificado confiável através da interface gráfica.

Problema 4: Proxy com autenticação não aceita a senha

Causa: caracteres especiais na senha não estão escapados, ou o proxy usa autenticação NTLM/Kerberos (proxies corporativos da Microsoft).
Solução: para proxies NTLM, a JVM o suporta nativamente, mas é necessário definir parâmetros adicionais:

-Djdk.http.auth.tunneling.disabledSchemes=""
-Djdk.http.auth.proxying.disabledSchemes=""

Problema 5: Git dentro da IDE não funciona através do proxy

Causa: o cliente Git integrado da JetBrains usa o Git do sistema, e não as conexões da JVM. As configurações de proxy da IDE não afetam isso.
Solução: configure o proxy diretamente no Git:

git config --global http.proxy http://username:[email protected]:8080
git config --global https.proxy http://username:[email protected]:8080

Sintoma	Causa provável	Como corrigir
Plugins não estão sendo instalados	Proxy não configurado na IDE	Settings → HTTP Proxy
Maven não baixa dependências	Sem configurações no settings.xml	~/.m2/settings.xml → proxies
pip não instala pacotes	pip não lê configurações da IDE	pip.conf ou variáveis de ambiente
Erros SSL	Inspeção MITM no proxy	Importar certificado corporativo
Git não funciona através do proxy	Git não lê configurações da JVM	git config --global http.proxy
Gradle não sincroniza	Sem configurações no gradle.properties	~/.gradle/gradle.properties

Conclusão

A configuração de proxy nas IDEs da JetBrains não é apenas um botão, mas vários níveis de configuração. O principal a lembrar: a própria IDE (plugins, licença, Marketplace) é configurada através de Settings → HTTP Proxy ou através dos parâmetros JVM em vmoptions. Gerenciadores de dependências — Maven, Gradle, pip, conda — requerem configuração separada em seus arquivos de configuração. O Git dentro da IDE é configurado através do git config global.

Se você está usando um proxy para contornar geobloqueios ou restrições de rede corporativa, é importante escolher um servidor proxy estável e rápido. Para trabalhar com repositórios, Marketplace e baixar dependências, proxies de data center são uma boa escolha — eles oferecem alta velocidade e latências mínimas, o que é crítico ao sincronizar grandes projetos com centenas de dependências. Se a máxima compatibilidade com serviços que bloqueiam IPs de servidor for necessária, considere proxies residenciais — eles usam endereços de usuários reais e praticamente não levantam suspeitas nos sistemas de proteção de CDN e repositórios.