← Torna al blog
RUENZHESARPTDEFRJAKOITTRIDVIFAHI

Configurazione del proxy in PyCharm, IntelliJ IDEA e WebStorm: guida completa per sviluppatori

Guida dettagliata per la configurazione del proxy in JetBrains IDE - PyCharm, IntelliJ IDEA, WebStorm e altri. Bypassate i blocchi, installate plugin e scaricate dipendenze senza limitazioni.

📅21 luglio 2026
```html

Se i plugin nelle IDE JetBrains non si installano, Maven o pip non riescono a scaricare le dipendenze, e il Marketplace non si apre — probabilmente il problema è nelle restrizioni di rete. Un proxy risolve questo problema in pochi minuti. In questo articolo esamineremo tutti i metodi di configurazione: tramite l'interfaccia integrata dell'IDE, tramite variabili di sistema e tramite file di configurazione — per PyCharm, IntelliJ IDEA, WebStorm, GoLand e altri prodotti JetBrains.

Perché uno sviluppatore ha bisogno di un proxy nell'IDE

Le IDE JetBrains accedono attivamente alla rete: scaricano plugin dal Marketplace, aggiornano gli indici, recuperano dipendenze tramite Maven Central, PyPI, npm e altri repository, verificano le licenze, sincronizzano le impostazioni tramite JetBrains Account. Se anche una sola di queste richieste viene bloccata, il lavoro si rallenta o si ferma completamente.

Ecco alcune situazioni specifiche in cui non si può fare a meno di un proxy:

  • Rete aziendale con firewall. Molte aziende consentono il traffico esterno solo tramite un server proxy aziendale. Senza la sua configurazione nell'IDE, i plugin non si installeranno e le dipendenze non verranno scaricate.
  • Geoblocchi. Alcuni repository e CDN sono limitati geograficamente. Un proxy con la posizione desiderata rimuove questa limitazione.
  • Lavorare da un paese con internet limitato. JetBrains Marketplace, GitHub Packages, Maven Central potrebbero non essere accessibili direttamente.
  • Sviluppo e test di applicazioni di rete. È necessario indirizzare il traffico dell'IDE attraverso un nodo specifico per verificare il comportamento dell'applicazione da un'altra regione.
  • Sicurezza nelle reti pubbliche. Quando si lavora da un caffè o da un coworking, un proxy cripta il traffico dell'IDE e protegge i token e le chiavi dall'intercettazione.
  • Bypassare le restrizioni sanzionatorie. Dopo il 2022, alcuni repository e servizi esterni hanno introdotto limitazioni per IP — un proxy consente di continuare a lavorare senza cambiare strumenti.

A differenza del browser, dove il proxy viene configurato una sola volta e funziona globalmente, nelle IDE JetBrains il proxy deve essere configurato separatamente — e a volte in più posti: nell'IDE stesso, nel gestore delle dipendenze e nell'interprete del linguaggio. Esaminiamo ogni livello in ordine.

Quale tipo di proxy scegliere per JetBrains

Le IDE JetBrains supportano tre tipi di proxy: HTTP, HTTPS e SOCKS5. Per la maggior parte delle attività degli sviluppatori, i proxy HTTP/HTTPS sono sufficienti — funzionano in modo trasparente con tutte le richieste dell'IDE, Maven, Gradle e pip. SOCKS5 offre maggiore flessibilità e funziona a livello TCP, il che è utile per protocolli non standard.

Tipo di proxy Supporto nell'IDE Adatto per Caratteristiche
HTTP/HTTPS ✅ Nativo Plugin, dipendenze, licenza Più semplice da configurare
SOCKS5 ✅ Nativo Qualsiasi connessione TCP Supporta l'autenticazione
File PAC ✅ Tramite impostazioni di sistema Reti aziendali Routing flessibile
Proxy di sistema ✅ Auto-rilevamento Quando già configurato nel SO Non richiede configurazioni aggiuntive

Se stai lavorando con un proxy aziendale, probabilmente è HTTP/HTTPS con autenticazione tramite nome utente e password. Se stai collegando un servizio proxy esterno per bypassare le restrizioni, presta attenzione ai proxy dei data center — forniscono alta velocità e stabilità di connessione, che è critica durante il download di grandi dipendenze e indici.

Configurazione del proxy tramite l'interfaccia dell'IDE (HTTP/HTTPS)

Questo è il metodo più semplice e raccomandato. Le impostazioni si applicano a tutte le richieste di rete dell'IDE: Marketplace, aggiornamenti, verifica della licenza, sincronizzazione dei plugin. Le istruzioni sono le stesse per PyCharm, IntelliJ IDEA, WebStorm, GoLand, Rider, CLion e altri prodotti della linea.

Passo 1. Apri le impostazioni dell'IDE

Su Windows e Linux: File → Impostazioni (o Ctrl+Alt+S).
Su macOS: PyCharm → Preferenze (o Cmd+,).

Passo 2. Trova la sezione proxy

Nel pannello sinistro delle impostazioni, vai al percorso: Aspetto & Comportamento → Impostazioni di sistema → Proxy HTTP. Oppure inizia semplicemente a digitare la parola proxy nella barra di ricerca delle impostazioni — l'IDE mostrerà subito la sezione necessaria.

Passo 3. Seleziona il tipo di proxy e compila i dati

Nella sezione Proxy HTTP vedrai tre opzioni:

  • Nessun proxy — connessione diretta (predefinita).
  • Rilevamento automatico delle impostazioni del proxy — l'IDE prenderà le impostazioni dal sistema operativo.
  • Configurazione manuale del proxy — configurazione manuale. Seleziona questa opzione.

Se scegli Configurazione manuale del proxy, compila i campi:

  • Nome host — indirizzo IP o dominio del server proxy. Ad esempio: proxy.example.com o 192.168.1.100.
  • Numero di porta — porta del proxy. Valori standard: 8080, 3128, 8888.
  • Nessun proxy per — host che devono andare direttamente (senza proxy). Di solito qui si aggiungono localhost, 127.0.0.1, domini interni dell'azienda.
  • Autenticazione proxy — se il proxy richiede nome utente e password, seleziona la casella e inserisci le credenziali.

Passo 4. Controlla la connessione

Clicca sul pulsante Controlla connessione e inserisci un qualsiasi URL — ad esempio, https://plugins.jetbrains.com. Se tutto è configurato correttamente, l'IDE mostrerà lo stato Connessione riuscita. Dopo di che, clicca OK e riavvia l'IDE.

💡 Consiglio

Le impostazioni del Proxy HTTP nelle IDE JetBrains vengono memorizzate globalmente — si applicano a tutti i progetti e vengono salvate tra i riavvii. Se hai bisogno di passare tra proxy per diverse attività, è più comodo utilizzare le variabili di ambiente di sistema (descritte di seguito).

Configurazione del proxy SOCKS5 nelle IDE JetBrains

SOCKS5 è un protocollo più flessibile, che funziona non solo con HTTP/HTTPS, ma anche con qualsiasi connessione TCP. Questo è utile se il tuo fornitore di proxy offre proprio SOCKS5, o se stai usando un tunnel SSH.

Nell'interfaccia delle IDE JetBrains, la sezione SOCKS si trova nello stesso posto: Aspetto & Comportamento → Impostazioni di sistema → Proxy HTTP. Nel blocco Configurazione manuale del proxy, cambia il pulsante di opzione da HTTP a SOCKS.

Compila i campi in modo simile al proxy HTTP:

  • Nome host — indirizzo del server SOCKS5.
  • Numero di porta — porta (di solito 1080 o 1081).
  • Autenticazione proxy — nome utente e password, se richiesti.

Un'importante considerazione: il client SOCKS integrato delle IDE JetBrains funziona a livello JVM e intercetta solo quelle connessioni che l'IDE stabilisce direttamente tramite Java. I processi esterni — Maven Wrapper, Gradle Daemon, pip, npm — vengono eseguiti come processi separati e non ereditano le impostazioni del proxy dall'interfaccia dell'IDE. Per loro è necessaria una configurazione separata (vedi le sezioni seguenti).

Configurazione tramite parametri JVM (vmoptions)

Se le impostazioni tramite l'interfaccia non funzionano (ad esempio, in alcune versioni dell'IDE o utilizzando plugin non standard), puoi impostare il proxy direttamente tramite i parametri JVM. Questo è un metodo affidabile a basso livello, che si applica garantitamente a tutte le connessioni JVM.

Come aprire il file vmoptions

Nel menu dell'IDE vai a: Aiuto → Modifica opzioni VM personalizzate.... Si aprirà il file pycharm64.vmoptions (o idea64.vmoptions per IntelliJ IDEA) nella directory delle impostazioni utente.

Aggiungi alla fine del file le seguenti righe per il 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

Per il proxy SOCKS5 utilizza altri parametri:

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

Dopo aver salvato il file, riavvia l'IDE. I parametri si applicheranno a tutte le connessioni JVM, incluso il download degli indici, il lavoro con i plugin e il client Git integrato.

⚠️ Importante

Se la password contiene caratteri speciali (@, #, %), devono essere eseguite in codifica URL. Ad esempio, @ → %40. Altrimenti, la JVM analizzerà erroneamente i parametri e il proxy non funzionerà.

Proxy tramite variabili di ambiente di sistema

Questo metodo è particolarmente comodo su Linux e macOS, così come negli ambienti CI/CD. Le variabili di ambiente vengono ereditate non solo dalla JVM, ma anche dai processi figli — cioè Maven, Gradle, pip, npm le raccoglieranno automaticamente.

Variabili standard per il 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

Aggiungi queste righe a ~/.bashrc, ~/.zshrc o ~/.profile a seconda della tua shell. Dopo di che, riavvia il terminale e avvia l'IDE da lì — raccoglierà le variabili di ambiente.

Su Windows, le variabili vengono impostate tramite l'interfaccia di sistema:

  1. Apri Pannello di controllo → Sistema → Impostazioni di sistema avanzate → Variabili di ambiente.
  2. Nella sezione "Variabili utente", clicca su Crea.
  3. Aggiungi le variabili HTTP_PROXY e HTTPS_PROXY con il valore http://username:[email protected]:8080.
  4. Riavvia l'IDE.

Nota: le IDE JetBrains su Windows vengono eseguite come processo separato tramite un launcher, e le variabili di ambiente impostate nella sessione corrente del terminale potrebbero non essere trasferite all'IDE. È più sicuro impostarle tramite l'interfaccia di sistema o tramite il file vmoptions.

Proxy per Maven e Gradle all'interno di IntelliJ IDEA

Maven e Gradle sono strumenti separati con i propri file di configurazione. Anche se il proxy è configurato nell'interfaccia dell'IDE, Maven Wrapper e Gradle Daemon potrebbero ignorare queste impostazioni, poiché vengono eseguiti come processi JVM autonomi.

Proxy per Maven

Apri il file ~/.m2/settings.xml (crealo se non esiste) e aggiungi la sezione <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 hai bisogno di configurare il proxy separatamente per HTTP e HTTPS, aggiungi due blocchi <proxy> con diversi id e protocol.

Proxy per Gradle

Per Gradle, le impostazioni del proxy vengono impostate nel file ~/.gradle/gradle.properties (globalmente) o nel file gradle.properties nella radice del progetto (per un progetto specifico): 

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

Dopo aver salvato il file, IntelliJ IDEA raccoglierà automaticamente le nuove impostazioni al successivo aggiornamento del progetto Gradle. Clicca sul pulsante Ricarica tutti i progetti Gradle (icona di aggiornamento nel pannello Gradle a destra) — e le dipendenze inizieranno a essere scaricate tramite il proxy.

Proxy per pip e conda in PyCharm

PyCharm è l'IDE principale per gli sviluppatori Python. L'installazione dei pacchetti tramite pip e conda avviene tramite processi separati, che non leggono le impostazioni del proxy dall'interfaccia di PyCharm. Ecco come configurare il proxy per ciascun gestore di pacchetti.

Proxy per pip

Metodo 1 — tramite argomento della riga di comando durante l'installazione del pacchetto: 

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

Metodo 2 — tramite file di configurazione pip (applicato in modo permanente). Apri o crea il file:

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

Metodo 3 — tramite variabili di ambiente (funziona sia per pip che per altri strumenti Python): 

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

Proxy per conda

Conda utilizza un proprio file di configurazione .condarc. Aprilo nella directory home e aggiungi: 

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

Oppure esegui il comando nel terminale di PyCharm: 

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

Se stai lavorando con mirror PyPI (ad esempio, il mirror di Yandex o Nexus aziendale), puoi semplicemente passare pip a un indice alternativo invece di utilizzare un proxy. Ma se anche il mirror non è disponibile, il proxy rimane l'unica soluzione. Per un funzionamento stabile con PyPI, i proxy residenziali sono molto adatti — sembrano richieste utente normali e non vengono bloccati dai fornitori CDN di PyPI.

Problemi comuni e loro soluzioni

Anche con una configurazione corretta, a volte qualcosa può andare storto. Esaminiamo i problemi più comuni e come risolverli.

Problema 1: «Connection refused» o «Unable to connect to proxy»

Motivo: host errato, porta errata o proxy non disponibile.
Soluzione: controlla l'indirizzo e la porta del proxy. Prova a connetterti al proxy tramite curl nel terminale: 

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

Se curl non si connette nemmeno — il problema è nel proxy stesso, non nelle impostazioni dell'IDE.

Problema 2: Il proxy è configurato, ma i plugin non si installano comunque

Motivo: l'IDE ha memorizzato nella cache le vecchie impostazioni o le impostazioni non si sono applicate a tutti i componenti.
Soluzione:

  1. Chiudi completamente l'IDE (assicurati che il processo non sia in background).
  2. Pulisci la cache: File → Invalida cache → Invalida e riavvia.
  3. Controlla che nel file vmoptions non ci siano parametri in conflitto.

Problema 3: Errore SSL/TLS durante l'uso del proxy

Motivo: il proxy aziendale esegue un'ispezione SSL (MITM) e sostituisce i certificati. La JVM non si fida del certificato sostituito.
Soluzione: chiedi all'amministratore di sistema di fornire il certificato radice del CA aziendale e importalo nel Java KeyStore: 

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

Nelle IDE JetBrains c'è uno strumento integrato: Impostazioni → Strumenti → Certificati del server — lì puoi aggiungere un certificato di fiducia tramite GUI.

Problema 4: Il proxy con autenticazione non accetta la password

Motivo: caratteri speciali nella password non sono stati eseguiti in codifica, oppure il proxy utilizza autenticazione NTLM/Kerberos (proxy aziendali Microsoft).
Soluzione: per i proxy NTLM, la JVM lo supporta nativamente, ma è necessario impostare parametri aggiuntivi: 

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

Problema 5: Git all'interno dell'IDE non funziona tramite proxy

Motivo: il client Git integrato di JetBrains utilizza Git di sistema, non le connessioni JVM. Le impostazioni del proxy dall'IDE non lo influenzano.
Soluzione: configura il proxy direttamente in Git: 

git config --global http.proxy http://username:[email protected]:8080
git config --global https.proxy http://username:[email protected]:8080
Sintomo Probabile causa Modo di risoluzione
I plugin non si installano Il proxy non è configurato nell'IDE Impostazioni → Proxy HTTP
Maven non scarica le dipendenze Nessuna impostazione in settings.xml ~/.m2/settings.xml → proxies
pip non installa i pacchetti pip non legge le impostazioni dell'IDE pip.conf o variabili ENV
Errori SSL Ispezione MITM sul proxy Importa certificato aziendale
Git non funziona tramite proxy Git non legge le impostazioni JVM git config --global http.proxy
Gradle non si sincronizza Nessuna impostazione in gradle.properties ~/.gradle/gradle.properties

Conclusione

La configurazione del proxy nelle IDE JetBrains non è un solo pulsante, ma diversi livelli di configurazione. La cosa principale da ricordare è che l'IDE stesso (plugin, licenza, Marketplace) viene configurato tramite Impostazioni → Proxy HTTP o tramite parametri JVM in vmoptions. I gestori delle dipendenze — Maven, Gradle, pip, conda — richiedono una configurazione separata nei loro file di configurazione. Git all'interno dell'IDE viene configurato tramite git config globale.

Se utilizzi un proxy per bypassare geoblocchi o restrizioni della rete aziendale, è importante scegliere un server proxy stabile e veloce. Per lavorare con repository, Marketplace e scaricare dipendenze, i proxy dei data center sono molto adatti — forniscono alta velocità e latenze minime, che sono critiche durante la sincronizzazione di grandi progetti con centinaia di dipendenze. Se hai bisogno della massima compatibilità con i servizi che bloccano gli IP dei server, considera i proxy residenziali — utilizzano indirizzi reali degli utenti e praticamente non suscitano sospetti nei sistemi di protezione CDN e nei repository.

```