Proxy-Einstellungen in PyCharm, IntelliJ IDEA und WebStorm: Ultimativer Leitfaden für Entwickler

```html

Wenn Plugins in JetBrains IDE nicht installiert werden, Maven oder pip Abhängigkeiten nicht herunterladen können und der Marketplace einfach nicht öffnet — liegt das wahrscheinlich an Netzwerkbeschränkungen. Ein Proxy löst dies in wenigen Minuten. In diesem Artikel werden wir alle Möglichkeiten zur Einrichtung durchgehen: über die integrierte IDE-Oberfläche, über Umgebungsvariablen und über Konfigurationsdateien — für PyCharm, IntelliJ IDEA, WebStorm, GoLand und andere Produkte von JetBrains.

Warum ein Proxy in der IDE für Entwickler

JetBrains IDE greifen aktiv auf das Netzwerk zu: Sie laden Plugins aus dem Marketplace herunter, aktualisieren Indizes, ziehen Abhängigkeiten über Maven Central, PyPI, npm und andere Repositories, überprüfen Lizenzen und synchronisieren Einstellungen über das JetBrains-Konto. Wenn auch nur eine dieser Anfragen blockiert wird, verlangsamt sich die Arbeit oder steht ganz still.

Hier sind konkrete Situationen, in denen Sie ohne Proxy nicht auskommen:

• Unternehmensnetzwerk mit Firewall. Viele Unternehmen lassen externen Traffic nur über einen Unternehmensproxy-Server durch. Ohne dessen Konfiguration in der IDE können Plugins nicht installiert und Abhängigkeiten nicht heruntergeladen werden.
• Geoblockierungen. Teile von Repositories und CDN sind geografisch eingeschränkt. Ein Proxy mit dem richtigen Standort hebt diese Einschränkung auf.
• Arbeiten aus einem Land mit eingeschränktem Internet. JetBrains Marketplace, GitHub Packages, Maven Central sind möglicherweise nicht direkt verfügbar.
• Entwicklung und Test von Netzwerk-Anwendungen. Es ist notwendig, den Traffic der IDE über einen bestimmten Knoten zu leiten, um das Verhalten der Anwendung aus einer anderen Region zu überprüfen.
• Sicherheit in öffentlichen Netzwerken. Bei der Arbeit aus einem Café oder Coworking-Space verschlüsselt der Proxy den Traffic der IDE und schützt Tokens und Schlüssel vor Abfangen.
• Umgehung von Sanktionen. Nach 2022 haben einige externe Repositories und Dienste IP-Beschränkungen eingeführt — ein Proxy ermöglicht es, ohne Wechsel der Werkzeuge weiterzuarbeiten.

Im Gegensatz zum Browser, wo der Proxy einmal konfiguriert wird und global funktioniert, muss der Proxy in JetBrains IDE separat konfiguriert werden — und manchmal an mehreren Stellen: in der IDE selbst, im Abhängigkeitsmanager und im Sprachinterpreter. Lassen Sie uns jede Ebene der Reihe nach durchgehen.

Welchen Proxy-Typ für JetBrains wählen

JetBrains IDE unterstützen drei Proxy-Typen: HTTP, HTTPS und SOCKS5. Für die meisten Aufgaben von Entwicklern sind HTTP/HTTPS-Proxys geeignet — sie arbeiten transparent mit allen Anfragen der IDE, Maven, Gradle und pip. SOCKS5 bietet mehr Flexibilität und funktioniert auf TCP-Ebene, was für nicht-standardisierte Protokolle nützlich ist.

Proxy-Typ	Unterstützung in der IDE	Geeignet für	Besonderheiten
HTTP/HTTPS	✅ Nativ	Plugins, Abhängigkeiten, Lizenz	Am einfachsten einzurichten
SOCKS5	✅ Nativ	Alle TCP-Verbindungen	Unterstützt Authentifizierung
PAC-Datei	✅ Über Systemeinstellungen	Unternehmensnetzwerke	Flexible Routenführung
Systemproxy	✅ Automatische Erkennung	Wenn bereits im OS konfiguriert	Benötigt keine zusätzlichen Einstellungen

Wenn Sie mit einem Unternehmensproxy arbeiten — ist er wahrscheinlich HTTP/HTTPS mit Authentifizierung über Benutzername und Passwort. Wenn Sie einen externen Proxy-Dienst zum Umgehen von Blockaden verwenden, achten Sie auf Datacenter-Proxys — sie bieten hohe Geschwindigkeit und Stabilität der Verbindung, was entscheidend ist, wenn große Abhängigkeiten und Indizes heruntergeladen werden.

Proxy über die IDE-Oberfläche einrichten (HTTP/HTTPS)

Dies ist die einfachste und empfohlene Methode. Die Einstellungen gelten für alle Netzwerk-Anfragen der IDE: Marketplace, Updates, Lizenzüberprüfung, Plugin-Synchronisation. Die Anleitung ist für PyCharm, IntelliJ IDEA, WebStorm, GoLand, Rider, CLion und andere Produkte der Reihe identisch.

Schritt 1. Öffnen Sie die IDE-Einstellungen

Unter Windows und Linux: Datei → Einstellungen (oder Strg+Alt+S).
Unter macOS: PyCharm → Einstellungen (oder Cmd+,).

Schritt 2. Finden Sie den Proxy-Bereich

Gehen Sie im linken Einstellungsbereich zu: Erscheinungsbild & Verhalten → Systemeinstellungen → HTTP-Proxy. Oder beginnen Sie einfach, das Wort proxy in die Suchleiste einzugeben — die IDE zeigt sofort den benötigten Abschnitt an.

Schritt 3. Wählen Sie den Proxy-Typ und füllen Sie die Daten aus

Im Abschnitt HTTP-Proxy sehen Sie drei Optionen:

• Kein Proxy — direkte Verbindung (Standard).
• Proxy-Einstellungen automatisch erkennen — die IDE übernimmt die Einstellungen aus dem Betriebssystem.
• Manuelle Proxy-Konfiguration — manuelle Einrichtung. Wählen Sie diese Option.

Wenn Sie Manuelle Proxy-Konfiguration auswählen, füllen Sie die Felder aus:

• Hostname — IP-Adresse oder Domain des Proxy-Servers. Zum Beispiel: proxy.example.com oder 192.168.1.100.
• Portnummer — Proxy-Port. Standardwerte: 8080, 3128, 8888.
• Kein Proxy für — Hosts, die direkt (ohne Proxy) gehen sollen. Normalerweise werden hier localhost, 127.0.0.1, interne Unternehmens-Domains hinzugefügt.
• Proxy-Authentifizierung — wenn der Proxy Benutzername und Passwort benötigt, setzen Sie ein Häkchen und geben Sie die Anmeldedaten ein.

Schritt 4. Überprüfen Sie die Verbindung

Klicken Sie auf die Schaltfläche Verbindung überprüfen und geben Sie eine beliebige URL ein — zum Beispiel https://plugins.jetbrains.com. Wenn alles korrekt konfiguriert ist, zeigt die IDE den Status Verbindung erfolgreich an. Klicken Sie danach auf OK und starten Sie die IDE neu.

SOCKS5-Proxy in JetBrains IDE einrichten

SOCKS5 ist ein flexibleres Protokoll, das nicht nur mit HTTP/HTTPS, sondern auch mit allen TCP-Verbindungen funktioniert. Dies ist nützlich, wenn Ihr Proxy-Anbieter genau SOCKS5 bereitstellt oder wenn Sie ein SSH-Tunnel verwenden.

Im Interface von JetBrains IDE befindet sich der SOCKS-Bereich ebenfalls dort: Erscheinungsbild & Verhalten → Systemeinstellungen → HTTP-Proxy. Im Block Manuelle Proxy-Konfiguration wechseln Sie die Radiobutton von HTTP auf SOCKS.

Füllen Sie die Felder ähnlich wie beim HTTP-Proxy aus:

• Hostname — Adresse des SOCKS5-Servers.
• Portnummer — Port (normalerweise 1080 oder 1081).
• Proxy-Authentifizierung — Benutzername und Passwort, falls erforderlich.

Ein wichtiger Punkt: Der integrierte SOCKS-Client von JetBrains IDE arbeitet auf JVM-Ebene und erfasst nur die Verbindungen, die die IDE direkt über Java herstellt. Externe Prozesse — Maven Wrapper, Gradle Daemon, pip, npm — werden als separate Prozesse gestartet und erben nicht die Proxy-Einstellungen aus der IDE-Oberfläche. Für sie ist eine separate Konfiguration erforderlich (siehe die folgenden Abschnitte).

Einrichtung über JVM-Parameter (vmoptions)

Wenn die Einstellungen über die Oberfläche nicht funktionieren (zum Beispiel in einigen Versionen der IDE oder bei Verwendung nicht-standardisierter Plugins), können Sie den Proxy direkt über JVM-Parameter festlegen. Dies ist eine zuverlässige Low-Level-Methode, die garantiert auf alle JVM-Verbindungen angewendet wird.

So öffnen Sie die vmoptions-Datei

Gehen Sie im IDE-Menü zu: Hilfe → Benutzerdefinierte VM-Optionen bearbeiten.... Es öffnet sich die Datei pycharm64.vmoptions (oder idea64.vmoptions für IntelliJ IDEA) im Verzeichnis der Benutzereinstellungen.

Fügen Sie am Ende der Datei folgende Zeilen für den HTTP-Proxy hinzu:

-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

Für SOCKS5-Proxys verwenden Sie andere Parameter:

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

Nach dem Speichern der Datei starten Sie die IDE neu. Die Parameter werden auf alle JVM-Verbindungen angewendet, einschließlich des Ladens von Indizes, der Arbeit mit Plugins und des integrierten Git-Clients.

Proxy über Umgebungsvariablen

Diese Methode ist besonders praktisch unter Linux und macOS sowie in CI/CD-Umgebungen. Umgebungsvariablen werden nicht nur von der JVM, sondern auch von untergeordneten Prozessen geerbt — das bedeutet, dass Maven, Gradle, pip, npm sie ebenfalls automatisch übernehmen.

Standardvariablen für HTTP-Proxys:

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

Fügen Sie diese Zeilen in ~/.bashrc, ~/.zshrc oder ~/.profile je nach Ihrer Shell hinzu. Starten Sie danach das Terminal neu und starten Sie die IDE von dort — sie übernimmt die Umgebungsvariablen.

Unter Windows werden die Variablen über die Systemoberfläche festgelegt:

1. Öffnen Sie Systemsteuerung → System → Erweiterte Systemeinstellungen → Umgebungsvariablen.
2. Im Block „Benutzervariablen“ klicken Sie auf Neu.
3. Fügen Sie die Variablen HTTP_PROXY und HTTPS_PROXY mit dem Wert http://username:[email protected]:8080 hinzu.
4. Starten Sie die IDE neu.

Bitte beachten Sie: JetBrains IDE wird unter Windows als separater Prozess über den Launcher gestartet, und Umgebungsvariablen, die in der aktuellen Terminalsitzung festgelegt sind, werden möglicherweise nicht an die IDE übergeben. Es ist zuverlässiger, sie über die Systemoberfläche oder über die vmoptions-Datei festzulegen.

Proxy für Maven und Gradle in IntelliJ IDEA

Maven und Gradle sind separate Tools mit eigenen Konfigurationsdateien. Selbst wenn der Proxy in der IDE-Oberfläche konfiguriert ist, können Maven Wrapper und Gradle Daemon diese Einstellungen ignorieren, da sie als eigenständige JVM-Prozesse gestartet werden.

Proxy für Maven

Öffnen Sie die Datei ~/.m2/settings.xml (erstellen Sie sie, falls sie nicht existiert) und fügen Sie den Abschnitt <proxies> hinzu:

<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>

Wenn Sie den Proxy separat für HTTP und HTTPS konfigurieren müssen, fügen Sie zwei Blöcke <proxy> mit unterschiedlichen id und protocol hinzu.

Proxy für Gradle

Für Gradle werden die Proxy-Einstellungen in der Datei ~/.gradle/gradle.properties (global) oder in der Datei gradle.properties im Projektstamm (für ein bestimmtes Projekt) festgelegt:

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

Nach dem Speichern der Datei wird IntelliJ IDEA die neuen Einstellungen automatisch bei der nächsten Synchronisation des Gradle-Projekts übernehmen. Klicken Sie auf die Schaltfläche Alle Gradle-Projekte neu laden (Aktualisierungssymbol in der Gradle-Leiste rechts) — und die Abhängigkeiten beginnen, über den Proxy heruntergeladen zu werden.

Proxy für pip und conda in PyCharm

PyCharm ist die Haupt-IDE für Python-Entwickler. Die Installation von Paketen über pip und conda erfolgt über separate Prozesse, die die Proxy-Einstellungen aus der PyCharm-Oberfläche nicht lesen. So richten Sie den Proxy für jeden Paketmanager ein.

Proxy für pip

Methode 1 — über das Kommandozeilenargument beim Installieren des Pakets:

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

Methode 2 — über die Konfigurationsdatei von pip (gilt dauerhaft). Öffnen oder erstellen Sie die Datei:

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

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

Methode 3 — über Umgebungsvariablen (funktioniert sowohl für pip als auch für andere Python-Tools):

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

Proxy für conda

Conda verwendet eine eigene Konfigurationsdatei .condarc. Öffnen Sie sie im Home-Verzeichnis und fügen Sie hinzu:

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

Oder führen Sie den Befehl im PyCharm-Terminal aus:

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

Wenn Sie mit PyPI-Spiegeln (z.B. dem Yandex-Spiegel oder einem Unternehmens-Nexus) arbeiten, können Sie pip einfach auf einen alternativen Index umschalten, anstatt einen Proxy zu verwenden. Wenn der Spiegel jedoch ebenfalls nicht verfügbar ist, bleibt der Proxy die einzige Lösung. Für eine stabile Arbeit mit PyPI sind residential Proxys gut geeignet — sie sehen aus wie normale Benutzeranfragen und werden von den CDN-Anbietern von PyPI nicht blockiert.

Häufige Probleme und deren Lösung

Selbst bei korrekter Konfiguration läuft manchmal etwas schief. Lassen Sie uns die häufigsten Probleme und deren Lösungen durchgehen.

Problem 1: „Verbindung abgelehnt“ oder „Kann keine Verbindung zum Proxy herstellen“

Ursache: falscher Host, Port oder der Proxy ist nicht verfügbar.
Lösung: Überprüfen Sie die Adresse und den Port des Proxys. Versuchen Sie, sich über curl im Terminal mit dem Proxy zu verbinden:

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

Wenn curl sich auch nicht verbindet — liegt das Problem am Proxy selbst und nicht an den IDE-Einstellungen.

Problem 2: Proxy ist konfiguriert, aber Plugins werden trotzdem nicht installiert

Ursache: Die IDE hat alte Einstellungen zwischengespeichert oder die Einstellungen wurden nicht auf alle Komponenten angewendet.
Lösung:

1. Schließen Sie die IDE vollständig (stellen Sie sicher, dass der Prozess nicht im Hintergrund läuft).
2. Leeren Sie den Cache: Datei → Caches ungültig machen → Ungültig machen und neu starten.
3. Überprüfen Sie, ob in der Datei vmoptions keine konfliktierenden Parameter vorhanden sind.

Problem 3: SSL/TLS-Fehler beim Arbeiten über den Proxy

Ursache: Der Unternehmensproxy führt eine SSL-Inspektion (MITM) durch und ersetzt Zertifikate. Die JVM vertraut dem ersetzten Zertifikat nicht.
Lösung: Bitten Sie den Systemadministrator, das Root-Zertifikat der Unternehmens-CA bereitzustellen, und importieren Sie es in den Java KeyStore:

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

In JetBrains IDE gibt es ein integriertes Tool: Einstellungen → Werkzeuge → Serverzertifikate — dort können Sie ein vertrauenswürdiges Zertifikat über die GUI hinzufügen.

Problem 4: Proxy mit Authentifizierung akzeptiert das Passwort nicht

Ursache: spezielle Zeichen im Passwort sind nicht maskiert, oder der Proxy verwendet NTLM/Kerberos-Authentifizierung (Microsoft Unternehmensproxies).
Lösung: Für NTLM-Proxys unterstützt die JVM dies nativ, aber es müssen zusätzliche Parameter festgelegt werden:

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

Problem 5: Git innerhalb der IDE funktioniert nicht über den Proxy

Ursache: Der integrierte Git-Client von JetBrains verwendet das systemeigene Git und nicht die JVM-Verbindungen. Die Proxy-Einstellungen aus der IDE haben keinen Einfluss auf ihn.
Lösung: Konfigurieren Sie den Proxy direkt in Git:

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

Symptom	Wahrscheinliche Ursache	Methode zur Behebung
Plugins werden nicht installiert	Proxy nicht in der IDE konfiguriert	Einstellungen → HTTP-Proxy
Maven lädt keine Abhängigkeiten herunter	Keine Einstellungen in settings.xml	~/.m2/settings.xml → proxies
pip installiert keine Pakete	pip liest keine Einstellungen der IDE	pip.conf oder ENV-Variablen
SSL-Fehler	MITM-Inspektion am Proxy	Import des Unternehmenszertifikats
Git funktioniert nicht über den Proxy	Git liest keine JVM-Einstellungen	git config --global http.proxy
Gradle synchronisiert nicht	Keine Einstellungen in gradle.properties	~/.gradle/gradle.properties

Fazit

Die Einrichtung eines Proxys in JetBrains IDE ist nicht nur ein Knopfdruck, sondern mehrere Konfigurationsebenen. Das Wichtigste, was Sie sich merken sollten: Die IDE selbst (Plugins, Lizenz, Marketplace) wird über Einstellungen → HTTP-Proxy oder über JVM-Parameter in vmoptions konfiguriert. Abhängigkeitsmanager — Maven, Gradle, pip, conda — erfordern eine separate Konfiguration in ihren Konfigurationsdateien. Git innerhalb der IDE wird über die globale git config konfiguriert.

Wenn Sie einen Proxy zum Umgehen von Geoblockierungen oder Unternehmensnetzwerkbeschränkungen verwenden, ist es wichtig, einen stabilen und schnellen Proxy-Server auszuwählen. Für die Arbeit mit Repositories, dem Marketplace und dem Herunterladen von Abhängigkeiten sind Datacenter-Proxys gut geeignet — sie bieten hohe Geschwindigkeit und minimale Latenzen, was entscheidend ist, wenn große Projekte mit Hunderten von Abhängigkeiten synchronisiert werden. Wenn jedoch maximale Kompatibilität mit Diensten erforderlich ist, die Server-IP blockieren, sollten Sie residential Proxys in Betracht ziehen — sie verwenden echte Benutzeradressen und wecken bei den Schutzsystemen von CDN und Repositories kaum Verdacht.