http_proxy, https_proxy i no_proxy: configuració a Linux, Windows i Docker

Updated:

Les variables d'entorn HTTP_PROXY, HTTPS_PROXY i NO_PROXY indiquen a les eines de línia d'ordres i a les biblioteques de programació quin servidor intermediari utilitzar i a quines adreces connectar-se directament. La sintaxi estàndard és http://user:pass@ip:port per a totes dues variables de servidor intermediari, incloent-hi HTTPS_PROXY, mentre que NO_PROXY és una llista de dominis o adreces separats per comes. Definiu tant la forma en majúscules com en minúscules, ja que cada eina llegeix una variant diferent. Aquesta guia explica la configuració temporal i permanent a Linux, Windows i Docker, els casos en què les variables d'entorn no tenen cap efecte i com verificar-ho.

Servidors intermediaris HTTP/HTTPS a punt per als vostres servidors

Les tres variables

L'error més habitual és HTTPS_PROXY=https://.... L'esquema del valor descriu com connectar-se al mateix servidor intermediari, no pas al lloc web. Un servidor intermediari HTTP/HTTPS estàndard accepta connexions http://, de manera que tots dos valors comencen per http://. Els servidors intermediaris de VinaProxy s'entreguen en format ip:port:user:pass; si cal, convertiu-los a URL amb el conversor de format de servidor intermediari.

VariableValor d'exempleEfecte
HTTP_PROXY / http_proxyhttp://user:pass@ip:portServidor intermediari per a sol·licituds http://
HTTPS_PROXY / https_proxyhttp://user:pass@ip:portServidor intermediari per a sol·licituds https://; les eines obren un túnel CONNECT a través del servidor intermediari HTTP
NO_PROXY / no_proxylocalhost,127.0.0.1,.internal.localAdreces a les quals s'accedeix directament, ometent el servidor intermediari

Majúscules o minúscules?

No hi ha un estàndard únic; cada eina ho decideix. Per exemple, curl només llegeix http_proxy en minúscules per a les sol·licituds HTTP per raons de seguretat, però admet HTTPS_PROXY en qualsevol dels dos casos. La biblioteca requests de Python les llegeix totes dues. Altres eines prefereixen una forma i ignoren l'altra. L'opció més segura és assignar el mateix valor a totes dues formes.

Si la contrasenya conté caràcters com ara @, :, # o %, codifiqueu-la per a URL (@ es converteix en %40); altrament, les eines dividiran la cadena de manera incorrecta i obtindreu l'error 407 Proxy Authentication Required.

Linux i macOS

  • Temporal, només per al terminal actual: export http_proxy=http://user:pass@ip:port, després export https_proxy=$http_proxy, export HTTP_PROXY=$http_proxy i export HTTPS_PROXY=$http_proxy.
  • Ometre adreces internes: export no_proxy=localhost,127.0.0.1,.internal.local i export NO_PROXY=$no_proxy.
  • Permanent per al vostre usuari: afegiu aquestes línies export a ~/.bashrc o ~/.zshrc i obriu un terminal nou.
  • Per a tot el sistema a Ubuntu: afegiu http_proxy=http://user:pass@ip:port (sense export) a /etc/environment, i després tanqueu la sessió i torneu a iniciar-la. Trobareu tots els detalls a la guia de configuració de servidor intermediari a Ubuntu.
  • sudo elimina la majoria de les variables d'entorn per defecte. Utilitzeu sudo -E command o configureu env_keep si les ordres executades amb sudo també necessiten el servidor intermediari.
  • apt no detecta sempre de manera fiable les variables d'entorn sota sudo; creeu /etc/apt/apt.conf.d/95proxy amb el contingut Acquire::http::Proxy "http://user:pass@ip:port/"; i una línia coincident per a Acquire::https::Proxy.
  • Per eliminar-ho: executeu unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY i suprimiu les línies afegides als fitxers de configuració.

Windows

  • CMD, només per a la finestra actual: set HTTP_PROXY=http://user:pass@ip:port i set HTTPS_PROXY=http://user:pass@ip:port.
  • PowerShell, sessió actual: $env:HTTP_PROXY = 'http://user:pass@ip:port' i $env:HTTPS_PROXY = 'http://user:pass@ip:port'.
  • Permanent per al vostre usuari: setx HTTP_PROXY http://user:pass@ip:port i setx HTTPS_PROXY http://user:pass@ip:port. Només s'aplicaran a les finestres i aplicacions que s'obrin a partir d'aquell moment.
  • O bé des de la interfície gràfica: Propietats del sistema, Variables d'entorn, i afegiu-les a Variables d'usuari.
  • Important: les variables d'entorn són independents de la configuració del servidor intermediari del sistema de Windows. Els navegadors i moltes aplicacions amb interfície gràfica utilitzen la configuració del sistema, mentre que curl, git, pip i Python llegeixen les variables d'entorn. La configuració del sistema s'explica a la guia de configuració de servidor intermediari a Windows.

Docker: tres ubicacions diferents

Amb Docker, el servidor intermediari pot caldre en tres llocs diferents, i configurar-lo al lloc equivocat és un motiu freqüent pel qual sembla que no funcioni tot i haver-lo definit.

  • El dimoni de Docker en baixar imatges: el dimoni no veu les variables del vostre terminal. Creeu /etc/systemd/system/docker.service.d/http-proxy.conf amb una secció [Service] i Environment="HTTP_PROXY=http://user:pass@ip:port" "HTTPS_PROXY=http://user:pass@ip:port" "NO_PROXY=localhost,127.0.0.1", i després executeu sudo systemctl daemon-reload i sudo systemctl restart docker.
  • Contenidors i construccions: afegiu un bloc proxies a ~/.docker/config.json amb httpProxy, httpsProxy i noProxy; l'eina de línia d'ordres de Docker els transferirà automàticament als nous contenidors i construccions.
  • Per ordre: docker run -e HTTPS_PROXY=http://user:pass@ip:port image o docker build --build-arg HTTPS_PROXY=http://user:pass@ip:port ..
  • Dins d'un contenidor, localhost és el mateix contenidor. Si el servidor intermediari s'executa a l'amfitrió, no utilitzeu 127.0.0.1 en el valor del servidor intermediari. Trobareu la guia pas a pas a la guia de configuració de servidor intermediari a Docker.

Com escriure NO_PROXY correctament

  • Separat per comes, sense espais: localhost,127.0.0.1,.internal.local,api.company.com.
  • Un punt inicial com a .internal.local sol coincidir amb tots els subdominis; moltes eines tracten internal.local de la mateixa manera.
  • Els intervals CIDR com ara 10.0.0.0/8 són compatibles amb algunes eines i amb d'altres no. Per seguretat, enumereu les adreces o utilitzeu noms d'amfitrió.
  • Incloeu sempre localhost i 127.0.0.1 perquè els serveis locals no passin pel servidor intermediari.
  • Afegiu serveis interns, registres privats de paquets i amfitrions de bases de dades per evitar errors de connexió confusos.

Verificar, solucionar problemes i mantenir la seguretat

  • Llistar els valors actuals: env | grep -i proxy a Linux, Get-ChildItem Env: | Where-Object Name -like '*proxy*' a PowerShell.
  • Comproveu la IP de sortida amb curl -s https://httpbin.org/ip i compareu-la amb la IP del servidor intermediari, o bé obriu quina és la meva IP des d'aquella màquina. Afegiu -v per confirmar que curl es connecta realment a través del servidor intermediari. Vegeu la guia de servidor intermediari per a curl.
  • No tots els programes llegeixen les variables d'entorn. Algunes biblioteques de Node.js i aplicacions que gestionen la seva pròpia xarxa requereixen una configuració explícita del servidor intermediari, com s'explica a la configuració de servidor intermediari per a axios a Node.js.
  • Les variables que contenen contrasenyes de servidors intermediaris es poden filtrar mitjançant l'historial de l'intèrpret d'ordres, registres o llistes de processos. No pugeu fitxers de configuració amb contrasenyes a Git; si se'n filtra cap, canvieu la contrasenya del servidor intermediari al tauler de control.
  • Per eliminar completament la configuració del servidor intermediari, seguiu com desactivar un servidor intermediari.

Preguntes freqüents

HTTPS_PROXY ha de començar per http:// o per https://?

Gairebé sempre per http://. L'esquema descriu la connexió amb el servidor intermediari, i un servidor intermediari HTTP/HTTPS estàndard accepta connexions HTTP i canalitza el trànsit HTTPS.

Per què curl ignora el meu HTTP_PROXY?

curl només llegeix http_proxy en minúscules per a les sol·licituds HTTP. Establiu també la variant en minúscules o passeu el servidor intermediari directament amb l'opció -x.

Les variables d'entorn fan que el meu navegador utilitzi el servidor intermediari?

Normalment no a Windows ni a macOS, on els navegadors fan servir la configuració de servidor intermediari del sistema. Les variables d'entorn afecten sobretot les eines de línia d'ordres i les biblioteques.

Per què docker pull continua fallant després d'exportar el servidor intermediari?

El dimoni de Docker s'executa com un servei independent i no veu les variables del vostre terminal. Configureu el servidor intermediari per al servei docker mitjançant systemd i reinicieu-lo.

Puc utilitzar aquests servidors intermediaris mitjançant ALL_PROXY com a SOCKS?

Els servidors intermediaris de VinaProxy són HTTP/HTTPS amb autenticació per usuari i contrasenya. Utilitzeu HTTP_PROXY i HTTPS_PROXY tal com s'ha mostrat anteriorment.

Servidors intermediaris HTTP/HTTPS a punt per als vostres servidors

IPv4 privada a 7 països i ISP estàtic al Vietnam i als EUA. Autenticació amb usuari i contrasenya, format ip:port:user:pass i amplada de banda il·limitada.

Consulta els preus

Related articles

Configuració de proxies
Com configurar un proxy a Docker (contenidors, Compose i builds)
Encamina contenidors Docker i serveis Docker Compose a través de proxies HTTP(S) autenticats amb HTTP_PROXY, HTTPS_PROXY i NO_PROXY. Mira els exemples.
Configuració de proxies
Com configurar un proxy a Ubuntu i Debian Linux
Configura proxies HTTP(S) de VinaProxy a Ubuntu Server i Desktop a /etc/environment, el gestor APT, serveis systemd i la configuració de xarxa de GNOME.
Configuració de proxies
Com utilitzar un proxy amb cURL (sintaxi de línia d'ordres i depuració)
Com utilitzar curl amb proxys HTTP(S) autenticats (-x http://user:pass@ip:port i -U) a Linux, macOS i Windows, i comprovar capçaleres i latència.
Configuració de proxies
Com configurar un proxy a Windows 10 i Windows 11
Configura proxies HTTP(S) de VinaProxy a Windows 10 i Windows 11 amb la configuració WinINET del sistema, variables d'entorn de PowerShell o netsh winhttp.
Productes
Proxies ISP residencials estàtics
Proxies ISP residencials estàtics als Estats Units i Vietnam. IPs registrades en operadors domèstics, dedicades a un client i amb ample de banda il·limitat.
Productes
Proxies IPv4 privats de centre de dades
Compra proxies IPv4 de centre de dades als EUA, Vietnam, Japó, Corea del Sud, Singapur, el Regne Unit i Hong Kong. HTTP(S)/SOCKS5 (Vietnam: només HTTP) i ample de banda il·limitat.
ISP · vietnam
Pròxies ISP estàtics de Vietnam: IP vietnamites de xarxa domèstica per als vostres comptes més valuosos
Pròxies ISP estàtics de Vietnam amb IP domèstiques. Una IP vietnamita fixa per a botigues Shopee, TikTok Shop, comptes d'anuncis de Facebook i Zalo OA.
IPV4 · united states
Pròxies IPv4 privats dels EUA: IP de datacenter nord-americanes ràpides i dedicades
Pròxies IPv4 privats EUA per a scraping, rànquings, anuncis i recerca a Amazon. IP estàtica, un usuari per IP, ample de banda il·limitat i activació ràpida.