← Назад к блогу
RUENZHESARPTDEFRJAKOITTRIDVIFAHI

Настройка прокси в PyCharm, IntelliJ IDEA и WebStorm: полный гайд для разработчика

Подробное руководство по настройке прокси в JetBrains IDE — PyCharm, IntelliJ IDEA, WebStorm и других. Обходите блокировки, устанавливайте плагины и скачивайте зависимости без ограничений.

📅21 июля 2026 г.

Если плагины в JetBrains IDE не устанавливаются, Maven или pip не могут скачать зависимости, а Marketplace просто не открывается — скорее всего, проблема в сетевых ограничениях. Прокси решает это за несколько минут. В этой статье разберём все способы настройки: через встроенный интерфейс IDE, через системные переменные и через конфигурационные файлы — для PyCharm, IntelliJ IDEA, WebStorm, GoLand и других продуктов JetBrains.

Зачем разработчику прокси в IDE

JetBrains IDE активно обращаются к сети: скачивают плагины из Marketplace, обновляют индексы, подтягивают зависимости через Maven Central, PyPI, npm и другие репозитории, проверяют лицензию, синхронизируют настройки через JetBrains Account. Если хотя бы один из этих запросов блокируется — работа замедляется или вовсе встаёт.

Вот конкретные ситуации, когда без прокси не обойтись:

  • Корпоративная сеть с файрволом. Многие компании пропускают внешний трафик только через корпоративный прокси-сервер. Без его настройки в IDE плагины не установятся, а зависимости не скачаются.
  • Геоблокировки. Часть репозиториев и CDN ограничена по географии. Прокси с нужной локацией снимает это ограничение.
  • Работа из страны с ограниченным интернетом. JetBrains Marketplace, GitHub Packages, Maven Central могут быть недоступны напрямую.
  • Разработка и тестирование сетевых приложений. Нужно направить трафик IDE через определённый узел, чтобы проверить поведение приложения из другого региона.
  • Безопасность в публичных сетях. При работе из кафе или коворкинга прокси шифрует трафик IDE и защищает токены и ключи от перехвата.
  • Обход санкционных ограничений. После 2022 года ряд внешних репозиториев и сервисов ввёл ограничения по IP — прокси позволяет продолжить работу без смены инструментария.

В отличие от браузера, где прокси настраивается один раз и работает глобально, в JetBrains IDE прокси нужно настраивать отдельно — и иногда сразу в нескольких местах: в самой IDE, в менеджере зависимостей и в интерпретаторе языка. Разберём каждый уровень по порядку.

Какой тип прокси выбрать для JetBrains

JetBrains IDE поддерживают три типа прокси: HTTP, HTTPS и SOCKS5. Для большинства задач разработчика подойдут HTTP/HTTPS-прокси — они прозрачно работают со всеми запросами IDE, Maven, Gradle и pip. SOCKS5 даёт больше гибкости и работает на уровне TCP, что полезно для нестандартных протоколов.

Тип прокси Поддержка в IDE Подходит для Особенности
HTTP/HTTPS ✅ Нативная Плагины, зависимости, лицензия Проще всего настроить
SOCKS5 ✅ Нативная Любые TCP-соединения Поддерживает аутентификацию
PAC-файл ✅ Через системные настройки Корпоративные сети Гибкая маршрутизация
Системный прокси ✅ Автоопределение Когда уже настроен в ОС Не требует доп. настроек

Если вы работаете с корпоративным прокси — скорее всего, он HTTP/HTTPS с аутентификацией по логину и паролю. Если подключаете внешний прокси-сервис для обхода блокировок, обратите внимание на прокси дата-центров — они обеспечивают высокую скорость и стабильность соединения, что критично при скачивании больших зависимостей и индексов.

Настройка прокси через интерфейс IDE (HTTP/HTTPS)

Это самый простой и рекомендуемый способ. Настройки применяются ко всем сетевым запросам IDE: Marketplace, обновления, проверка лицензии, синхронизация плагинов. Инструкция одинакова для PyCharm, IntelliJ IDEA, WebStorm, GoLand, Rider, CLion и других продуктов линейки.

Шаг 1. Откройте настройки IDE

На Windows и Linux: File → Settings (или Ctrl+Alt+S).
На macOS: PyCharm → Preferences (или Cmd+,).

Шаг 2. Найдите раздел прокси

В левой панели настроек перейдите по пути: Appearance & Behavior → System Settings → HTTP Proxy. Либо просто начните вводить слово proxy в строку поиска настроек — IDE сразу покажет нужный раздел.

Шаг 3. Выберите тип прокси и заполните данные

В разделе HTTP Proxy вы увидите три варианта:

  • No proxy — прямое соединение (по умолчанию).
  • Auto-detect proxy settings — IDE возьмёт настройки из операционной системы.
  • Manual proxy configuration — ручная настройка. Выберите этот вариант.

При выборе Manual proxy configuration заполните поля:

  • Host name — IP-адрес или домен прокси-сервера. Например: proxy.example.com или 192.168.1.100.
  • Port number — порт прокси. Стандартные значения: 8080, 3128, 8888.
  • No proxy for — хосты, которые должны идти напрямую (без прокси). Обычно сюда добавляют localhost, 127.0.0.1, внутренние домены компании.
  • Proxy authentication — если прокси требует логин и пароль, поставьте галочку и введите учётные данные.

Шаг 4. Проверьте соединение

Нажмите кнопку Check connection и введите любой URL — например, https://plugins.jetbrains.com. Если всё настроено верно, IDE покажет статус Connection successful. После этого нажмите OK и перезапустите IDE.

💡 Совет

Настройки HTTP Proxy в JetBrains IDE хранятся глобально — они применяются ко всем проектам и сохраняются между перезапусками. Если вам нужно переключаться между прокси для разных задач, удобнее использовать системные переменные окружения (описаны ниже).

Настройка SOCKS5-прокси в JetBrains IDE

SOCKS5 — более гибкий протокол, который работает не только с HTTP/HTTPS, но и с любыми TCP-соединениями. Это полезно, если ваш прокси-провайдер предоставляет именно SOCKS5, или если вы используете SSH-туннель.

В интерфейсе JetBrains IDE раздел SOCKS находится там же: Appearance & Behavior → System Settings → HTTP Proxy. В блоке Manual proxy configuration переключите радиокнопку с HTTP на SOCKS.

Заполните поля аналогично HTTP-прокси:

  • Host name — адрес SOCKS5-сервера.
  • Port number — порт (обычно 1080 или 1081).
  • Proxy authentication — логин и пароль, если требуются.

Важный нюанс: встроенный SOCKS-клиент JetBrains IDE работает на уровне JVM и перехватывает только те соединения, которые IDE устанавливает напрямую через Java. Внешние процессы — Maven Wrapper, Gradle Daemon, pip, npm — запускаются как отдельные процессы и не наследуют настройки прокси из интерфейса IDE. Для них нужна отдельная настройка (см. разделы ниже).

Настройка через JVM-параметры (vmoptions)

Если настройки через интерфейс не работают (например, в некоторых версиях IDE или при использовании нестандартных плагинов), можно задать прокси напрямую через JVM-параметры. Это надёжный низкоуровневый способ, который гарантированно применяется ко всем соединениям JVM.

Как открыть файл vmoptions

В меню IDE перейдите: Help → Edit Custom VM Options.... Откроется файл pycharm64.vmoptions (или idea64.vmoptions для IntelliJ IDEA) в директории пользовательских настроек.

Добавьте в конец файла следующие строки для 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

Для SOCKS5-прокси используйте другие параметры:

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

После сохранения файла перезапустите IDE. Параметры применятся ко всем JVM-соединениям, включая загрузку индексов, работу с плагинами и встроенный Git-клиент.

⚠️ Важно

Если в пароле есть специальные символы (@, #, %), их нужно экранировать в URL-кодировке. Например, @ → %40. Иначе JVM неправильно распарсит параметры и прокси не заработает.

Прокси через системные переменные окружения

Этот способ особенно удобен на Linux и macOS, а также в CI/CD-средах. Переменные окружения наследуются не только JVM, но и дочерними процессами — то есть Maven, Gradle, pip, npm тоже их подхватят автоматически.

Стандартные переменные для 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

Добавьте эти строки в ~/.bashrc, ~/.zshrc или ~/.profile в зависимости от вашей оболочки. После этого перезапустите терминал и запустите IDE из него — она подхватит переменные окружения.

На Windows переменные задаются через системный интерфейс:

  1. Откройте Панель управления → Система → Дополнительные параметры системы → Переменные среды.
  2. В блоке «Переменные пользователя» нажмите Создать.
  3. Добавьте переменные HTTP_PROXY и HTTPS_PROXY со значением http://username:[email protected]:8080.
  4. Перезапустите IDE.

Обратите внимание: JetBrains IDE на Windows запускается как отдельный процесс через лаунчер, и переменные окружения, заданные в текущей сессии терминала, могут не передаться в IDE. Надёжнее задавать их через системный интерфейс или через файл vmoptions.

Прокси для Maven и Gradle внутри IntelliJ IDEA

Maven и Gradle — это отдельные инструменты со своими конфигурационными файлами. Даже если прокси настроен в интерфейсе IDE, Maven Wrapper и Gradle Daemon могут игнорировать эти настройки, потому что запускаются как самостоятельные JVM-процессы.

Прокси для Maven

Откройте файл ~/.m2/settings.xml (создайте его, если не существует) и добавьте секцию <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>

Если вам нужно настроить прокси отдельно для HTTP и HTTPS, добавьте два блока <proxy> с разными id и protocol.

Прокси для Gradle

Для Gradle настройки прокси задаются в файле ~/.gradle/gradle.properties (глобально) или в файле gradle.properties в корне проекта (для конкретного проекта): 

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

После сохранения файла IntelliJ IDEA автоматически подхватит новые настройки при следующей синхронизации Gradle-проекта. Нажмите кнопку Reload All Gradle Projects (иконка обновления в панели Gradle справа) — и зависимости начнут скачиваться через прокси.

Прокси для pip и conda в PyCharm

PyCharm — основная IDE для Python-разработчиков. Установка пакетов через pip и conda происходит через отдельные процессы, которые не читают настройки прокси из интерфейса PyCharm. Вот как настроить прокси для каждого менеджера пакетов.

Прокси для pip

Способ 1 — через аргумент командной строки при установке пакета: 

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

Способ 2 — через конфигурационный файл pip (применяется постоянно). Откройте или создайте файл:

  • Linux/macOS: ~/.config/pip/pip.conf
  • Windows: %APPDATA%\pip\pip.ini
[global]
proxy = http://username:[email protected]:8080

Способ 3 — через переменные окружения (работает и для pip, и для других Python-инструментов): 

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

Прокси для conda

Conda использует собственный конфигурационный файл .condarc. Откройте его в домашней директории и добавьте: 

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

Или выполните команду в терминале PyCharm: 

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

Если вы работаете с PyPI-зеркалами (например, зеркало Яндекса или корпоративный Nexus), можно вместо прокси просто переключить pip на альтернативный индекс. Но если зеркало тоже недоступно — прокси остаётся единственным решением. Для стабильной работы с PyPI хорошо подходят резидентные прокси — они выглядят как обычные пользовательские запросы и не блокируются CDN-провайдерами PyPI.

Частые проблемы и их решение

Даже при правильной настройке иногда что-то идёт не так. Разберём самые распространённые проблемы и способы их устранения.

Проблема 1: «Connection refused» или «Unable to connect to proxy»

Причина: неверный хост, порт или прокси недоступен.
Решение: проверьте адрес и порт прокси. Попробуйте подключиться к прокси через curl в терминале: 

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

Если curl тоже не подключается — проблема в самом прокси, а не в настройках IDE.

Проблема 2: Прокси настроен, но плагины всё равно не устанавливаются

Причина: IDE кэшировала старые настройки или настройки применились не ко всем компонентам.
Решение:

  1. Полностью закройте IDE (убедитесь, что процесс не висит в фоне).
  2. Очистите кэш: File → Invalidate Caches → Invalidate and Restart.
  3. Проверьте, что в файле vmoptions нет конфликтующих параметров.

Проблема 3: Ошибка SSL/TLS при работе через прокси

Причина: корпоративный прокси выполняет SSL-инспекцию (MITM) и подменяет сертификаты. JVM не доверяет подменённому сертификату.
Решение: попросите системного администратора предоставить корневой сертификат корпоративного CA и импортируйте его в Java KeyStore: 

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

В JetBrains IDE есть встроенный инструмент: Settings → Tools → Server Certificates — там можно добавить доверенный сертификат через GUI.

Проблема 4: Прокси с аутентификацией не принимает пароль

Причина: специальные символы в пароле не экранированы, или прокси использует NTLM/Kerberos аутентификацию (корпоративные прокси Microsoft).
Решение: для NTLM-прокси JVM поддерживает его нативно, но нужно задать дополнительные параметры: 

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

Проблема 5: Git внутри IDE не работает через прокси

Причина: встроенный Git-клиент JetBrains использует системный Git, а не JVM-соединения. Настройки прокси из IDE на него не влияют.
Решение: настройте прокси непосредственно в Git: 

git config --global http.proxy http://username:[email protected]:8080
git config --global https.proxy http://username:[email protected]:8080
Симптом Вероятная причина Способ исправления
Плагины не ставятся Прокси не настроен в IDE Settings → HTTP Proxy
Maven не качает зависимости Нет настроек в settings.xml ~/.m2/settings.xml → proxies
pip не ставит пакеты pip не читает настройки IDE pip.conf или ENV-переменные
SSL-ошибки MITM-инспекция на прокси Импорт корп. сертификата
Git не работает через прокси Git не читает настройки JVM git config --global http.proxy
Gradle не синхронизируется Нет настроек в gradle.properties ~/.gradle/gradle.properties

Заключение

Настройка прокси в JetBrains IDE — это не одна кнопка, а несколько уровней конфигурации. Главное, что нужно запомнить: сама IDE (плагины, лицензия, Marketplace) настраивается через Settings → HTTP Proxy или через параметры JVM в vmoptions. Менеджеры зависимостей — Maven, Gradle, pip, conda — требуют отдельной настройки в своих конфигурационных файлах. Git внутри IDE настраивается через глобальный git config.

Если вы используете прокси для обхода геоблокировок или ограничений корпоративной сети, важно выбрать стабильный и быстрый прокси-сервер. Для работы с репозиториями, Marketplace и скачивания зависимостей хорошо подходят прокси дата-центров — они обеспечивают высокую скорость и минимальные задержки, что критично при синхронизации больших проектов с сотнями зависимостей. Если же нужна максимальная совместимость с сервисами, которые блокируют серверные IP, рассмотрите резидентные прокси — они используют реальные пользовательские адреса и практически не вызывают подозрений у защитных систем CDN и репозиториев.