Proxy en PyCharm e IntelliJ IDEA: configuración en 5 minutos

```html

Si los plugins en los IDE de JetBrains no se instalan, Maven o pip no pueden descargar dependencias, y el Marketplace simplemente no se abre, es probable que el problema esté en las restricciones de red. Un proxy resuelve esto en unos minutos. En este artículo, analizaremos todas las formas de configuración: a través de la interfaz integrada del IDE, a través de variables de sistema y a través de archivos de configuración — para PyCharm, IntelliJ IDEA, WebStorm, GoLand y otros productos de JetBrains.

¿Por qué necesita un proxy el desarrollador en el IDE?

Los IDE de JetBrains acceden activamente a la red: descargan plugins del Marketplace, actualizan índices, obtienen dependencias a través de Maven Central, PyPI, npm y otros repositorios, verifican licencias, sincronizan configuraciones a través de JetBrains Account. Si al menos una de estas solicitudes es bloqueada, el trabajo se ralentiza o se detiene por completo.

Aquí hay situaciones concretas en las que no se puede prescindir de un proxy:

Red corporativa con firewall. Muchas empresas permiten el tráfico externo solo a través de un servidor proxy corporativo. Sin su configuración en el IDE, los plugins no se instalarán y las dependencias no se descargarán.
Geobloqueos. Parte de los repositorios y CDN están restringidos geográficamente. Un proxy con la ubicación adecuada elimina esta restricción.
Trabajo desde un país con internet limitado. JetBrains Marketplace, GitHub Packages, Maven Central pueden no estar disponibles directamente.
Desarrollo y prueba de aplicaciones de red. Es necesario dirigir el tráfico del IDE a través de un nodo específico para verificar el comportamiento de la aplicación desde otra región.
Seguridad en redes públicas. Al trabajar desde una cafetería o un coworking, el proxy cifra el tráfico del IDE y protege tokens y claves de ser interceptados.
Eludir restricciones sancionadoras. Después de 2022, varios repositorios y servicios externos impusieron restricciones por IP; el proxy permite continuar trabajando sin cambiar de herramientas.

A diferencia del navegador, donde el proxy se configura una vez y funciona globalmente, en los IDE de JetBrains el proxy debe configurarse por separado, y a veces en varios lugares: en el propio IDE, en el gestor de dependencias y en el intérprete del lenguaje. Analizaremos cada nivel por orden.

Qué tipo de proxy elegir para JetBrains

Los IDE de JetBrains admiten tres tipos de proxy: HTTP, HTTPS y SOCKS5. Para la mayoría de las tareas de desarrollo, los proxies HTTP/HTTPS son adecuados, ya que funcionan de manera transparente con todas las solicitudes del IDE, Maven, Gradle y pip. SOCKS5 ofrece más flexibilidad y funciona a nivel TCP, lo que es útil para protocolos no estándar.

Tipo de proxy	Soporte en el IDE	Adecuado para	Características
HTTP/HTTPS	✅ Nativo	Plugins, dependencias, licencia	Más fácil de configurar
SOCKS5	✅ Nativo	Cualquier conexión TCP	Soporta autenticación
Archivo PAC	✅ A través de configuraciones del sistema	Redes corporativas	Enrutamiento flexible
Proxy del sistema	✅ Autodetección	Cuando ya está configurado en el SO	No requiere configuraciones adicionales

Si trabaja con un proxy corporativo, es probable que sea HTTP/HTTPS con autenticación por nombre de usuario y contraseña. Si está conectando un servicio proxy externo para eludir bloqueos, preste atención a los proxies de centros de datos — proporcionan alta velocidad y estabilidad de conexión, lo cual es crítico al descargar grandes dependencias e índices.

Configuración del proxy a través de la interfaz del IDE (HTTP/HTTPS)

Este es el método más simple y recomendado. Las configuraciones se aplican a todas las solicitudes de red del IDE: Marketplace, actualizaciones, verificación de licencia, sincronización de plugins. La instrucción es la misma para PyCharm, IntelliJ IDEA, WebStorm, GoLand, Rider, CLion y otros productos de la línea.

Paso 1. Abra la configuración del IDE

En Windows y Linux: File → Settings (o Ctrl+Alt+S).
En macOS: PyCharm → Preferences (o Cmd+,).

Paso 2. Encuentre la sección de proxy

En el panel izquierdo de configuraciones, siga la ruta: Appearance & Behavior → System Settings → HTTP Proxy. O simplemente comience a escribir la palabra proxy en la barra de búsqueda de configuraciones — el IDE mostrará inmediatamente la sección necesaria.

Paso 3. Seleccione el tipo de proxy y complete los datos

En la sección HTTP Proxy verá tres opciones:

No proxy — conexión directa (por defecto).
Auto-detectar configuraciones de proxy — el IDE tomará la configuración del sistema operativo.
Configuración manual del proxy — configuración manual. Seleccione esta opción.

Al seleccionar Configuración manual del proxy, complete los campos:

Nombre del host — dirección IP o dominio del servidor proxy. Por ejemplo: proxy.example.com o 192.168.1.100.
Número de puerto — puerto del proxy. Valores estándar: 8080, 3128, 8888.
No proxy para — hosts que deben ir directamente (sin proxy). Normalmente se añaden localhost, 127.0.0.1, dominios internos de la empresa.
Autenticación del proxy — si el proxy requiere nombre de usuario y contraseña, marque la casilla e introduzca las credenciales.

Paso 4. Verifique la conexión

Haga clic en el botón Check connection e introduzca cualquier URL — por ejemplo, https://plugins.jetbrains.com. Si todo está configurado correctamente, el IDE mostrará el estado Connection successful. Después de esto, haga clic en OK y reinicie el IDE.

💡 Consejo

Las configuraciones de HTTP Proxy en los IDE de JetBrains se almacenan globalmente — se aplican a todos los proyectos y se guardan entre reinicios. Si necesita alternar entre proxies para diferentes tareas, es más conveniente usar variables de entorno del sistema (se describen a continuación).

Configuración del proxy SOCKS5 en los IDE de JetBrains

SOCKS5 es un protocolo más flexible que funciona no solo con HTTP/HTTPS, sino también con cualquier conexión TCP. Esto es útil si su proveedor de proxy proporciona SOCKS5, o si está utilizando un túnel SSH.

En la interfaz de los IDE de JetBrains, la sección SOCKS se encuentra en el mismo lugar: Appearance & Behavior → System Settings → HTTP Proxy. En el bloque Configuración manual del proxy, cambie el botón de opción de HTTP a SOCKS.

Complete los campos de manera similar a los del proxy HTTP:

Nombre del host — dirección del servidor SOCKS5.
Número de puerto — puerto (normalmente 1080 o 1081).
Autenticación del proxy — nombre de usuario y contraseña, si se requieren.

Un matiz importante: el cliente SOCKS integrado de los IDE de JetBrains funciona a nivel de JVM y solo intercepta aquellas conexiones que el IDE establece directamente a través de Java. Los procesos externos — Maven Wrapper, Gradle Daemon, pip, npm — se ejecutan como procesos separados y no heredan la configuración del proxy de la interfaz del IDE. Para ellos se necesita una configuración separada (ver secciones a continuación).

Configuración a través de parámetros JVM (vmoptions)

Si la configuración a través de la interfaz no funciona (por ejemplo, en algunas versiones del IDE o al usar plugins no estándar), se puede establecer el proxy directamente a través de los parámetros JVM. Este es un método confiable de bajo nivel que se aplica garantizadamente a todas las conexiones JVM.

Cómo abrir el archivo vmoptions

En el menú del IDE, vaya a: Help → Edit Custom VM Options.... Se abrirá el archivo pycharm64.vmoptions (o idea64.vmoptions para IntelliJ IDEA) en el directorio de configuraciones del usuario.

Agregue las siguientes líneas al final del archivo para el 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 el proxy SOCKS5, use otros parámetros:

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

Después de guardar el archivo, reinicie el IDE. Los parámetros se aplicarán a todas las conexiones JVM, incluyendo la carga de índices, el trabajo con plugins y el cliente Git integrado.

⚠️ Importante

Si la contraseña contiene caracteres especiales (@, #, %), deben ser escapados en codificación URL. Por ejemplo, @ → %40. De lo contrario, la JVM no analizará correctamente los parámetros y el proxy no funcionará.

Proxy a través de variables de entorno del sistema

Este método es especialmente conveniente en Linux y macOS, así como en entornos CI/CD. Las variables de entorno son heredadas no solo por la JVM, sino también por los procesos hijos — es decir, Maven, Gradle, pip, npm también las captarán automáticamente.

Variables estándar para el 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

Agregue estas líneas a ~/.bashrc, ~/.zshrc o ~/.profile dependiendo de su shell. Después de esto, reinicie la terminal y ejecute el IDE desde allí — capturará las variables de entorno.

En Windows, las variables se establecen a través de la interfaz del sistema:

Abra Panel de control → Sistema → Configuración avanzada del sistema → Variables de entorno.
En el bloque "Variables de usuario", haga clic en Crear.
Agregue las variables HTTP_PROXY y HTTPS_PROXY con el valor http://username:[email protected]:8080.
Reinicie el IDE.

Tenga en cuenta: los IDE de JetBrains en Windows se inician como un proceso separado a través del lanzador, y las variables de entorno establecidas en la sesión actual de la terminal pueden no ser transferidas al IDE. Es más confiable establecerlas a través de la interfaz del sistema o a través del archivo vmoptions.

Proxy para Maven y Gradle dentro de IntelliJ IDEA

Maven y Gradle son herramientas separadas con sus propios archivos de configuración. Incluso si el proxy está configurado en la interfaz del IDE, Maven Wrapper y Gradle Daemon pueden ignorar estas configuraciones porque se ejecutan como procesos JVM independientes.

Proxy para Maven

Abra el archivo ~/.m2/settings.xml (creelo si no existe) y agregue la sección <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>

Si necesita configurar el proxy por separado para HTTP y HTTPS, agregue dos bloques <proxy> con diferentes id y protocol.

Proxy para Gradle

Para Gradle, las configuraciones del proxy se establecen en el archivo ~/.gradle/gradle.properties (globalmente) o en el archivo gradle.properties en la raíz del proyecto (para un proyecto 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

Después de guardar el archivo, IntelliJ IDEA capturará automáticamente las nuevas configuraciones en la siguiente sincronización del proyecto Gradle. Haga clic en el botón Reload All Gradle Projects (el ícono de actualización en el panel de Gradle a la derecha) — y las dependencias comenzarán a descargarse a través del proxy.

Proxy para pip y conda en PyCharm

PyCharm es el IDE principal para desarrolladores de Python. La instalación de paquetes a través de pip y conda se realiza a través de procesos separados que no leen la configuración del proxy de la interfaz de PyCharm. Aquí se explica cómo configurar el proxy para cada gestor de paquetes.

Proxy para pip

Método 1 — a través del argumento de la línea de comandos al instalar un paquete:

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

Método 2 — a través del archivo de configuración de pip (se aplica de forma permanente). Abra o cree el archivo:

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

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

Método 3 — a través de variables de entorno (funciona tanto para pip como para otras herramientas de Python):

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

Proxy para conda

Conda utiliza su propio archivo de configuración .condarc. Ábralo en el directorio de inicio y agregue:

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

O ejecute el comando en la terminal de PyCharm:

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

Si está trabajando con espejos de PyPI (por ejemplo, el espejo de Yandex o Nexus corporativo), puede simplemente cambiar pip a un índice alternativo en lugar de usar un proxy. Pero si el espejo también no está disponible, el proxy sigue siendo la única solución. Para un funcionamiento estable con PyPI, los proxies residenciales son muy adecuados — parecen solicitudes de usuario normales y no son bloqueados por los proveedores de CDN de PyPI.

Problemas comunes y sus soluciones

Incluso con la configuración correcta, a veces algo sale mal. Analicemos los problemas más comunes y cómo resolverlos.

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

Causa: host incorrecto, puerto o el proxy no está disponible.
Solución: verifique la dirección y el puerto del proxy. Intente conectarse al proxy a través de curl en la terminal:

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

Si curl tampoco se conecta, el problema está en el propio proxy, no en la configuración del IDE.

Problema 2: El proxy está configurado, pero los plugins aún no se instalan

Causa: el IDE ha almacenado en caché configuraciones antiguas o las configuraciones no se aplicaron a todos los componentes.
Solución:

Cierre completamente el IDE (asegúrese de que el proceso no esté colgado en segundo plano).
Limpiar la caché: File → Invalidate Caches → Invalidate and Restart.
Verifique que en el archivo vmoptions no haya parámetros en conflicto.

Problema 3: Error SSL/TLS al trabajar a través del proxy

Causa: el proxy corporativo realiza inspección SSL (MITM) y reemplaza certificados. La JVM no confía en el certificado reemplazado.
Solución: pida al administrador del sistema que proporcione el certificado raíz del CA corporativo e impórtelo en Java KeyStore:

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

En los IDE de JetBrains hay una herramienta integrada: Settings → Tools → Server Certificates — allí se puede agregar un certificado de confianza a través de la GUI.

Problema 4: El proxy con autenticación no acepta la contraseña

Causa: caracteres especiales en la contraseña no están escapados, o el proxy utiliza autenticación NTLM/Kerberos (proxies corporativos de Microsoft).
Solución: para el proxy NTLM, la JVM lo admite de forma nativa, pero se deben establecer parámetros adicionales:

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

Problema 5: Git dentro del IDE no funciona a través del proxy

Causa: el cliente Git integrado de JetBrains utiliza Git del sistema, no conexiones JVM. Las configuraciones del proxy del IDE no le afectan.
Solución: configure el proxy directamente en Git:

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

Síntoma	Causa probable	Método de corrección
Los plugins no se instalan	El proxy no está configurado en el IDE	Settings → HTTP Proxy
Maven no descarga dependencias	No hay configuraciones en settings.xml	~/.m2/settings.xml → proxies
pip no instala paquetes	pip no lee configuraciones del IDE	pip.conf o variables ENV
Errores SSL	Inspección MITM en el proxy	Importar certificado corporativo
Git no funciona a través del proxy	Git no lee configuraciones JVM	git config --global http.proxy
Gradle no se sincroniza	No hay configuraciones en gradle.properties	~/.gradle/gradle.properties

Conclusión

La configuración del proxy en los IDE de JetBrains no es solo un botón, sino varios niveles de configuración. Lo principal que debe recordar: el propio IDE (plugins, licencia, Marketplace) se configura a través de Settings → HTTP Proxy o a través de parámetros JVM en vmoptions. Los gestores de dependencias — Maven, Gradle, pip, conda — requieren configuraciones separadas en sus archivos de configuración. Git dentro del IDE se configura a través de git config global.

Si utiliza un proxy para eludir geobloqueos o restricciones de red corporativa, es importante elegir un servidor proxy estable y rápido. Para trabajar con repositorios, Marketplace y descargar dependencias, los proxies de centros de datos son muy adecuados — proporcionan alta velocidad y mínimas latencias, lo cual es crítico al sincronizar grandes proyectos con cientos de dependencias. Si necesita la máxima compatibilidad con servicios que bloquean IPs de servidores, considere los proxies residenciales — utilizan direcciones de usuario reales y prácticamente no levantan sospechas en los sistemas de protección de CDN y repositorios.