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.
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.
| Variable | Valor d'exemple | Efecte |
|---|---|---|
HTTP_PROXY / http_proxy | http://user:pass@ip:port | Servidor intermediari per a sol·licituds http:// |
HTTPS_PROXY / https_proxy | http://user:pass@ip:port | Servidor intermediari per a sol·licituds https://; les eines obren un túnel CONNECT a través del servidor intermediari HTTP |
NO_PROXY / no_proxy | localhost,127.0.0.1,.internal.local | Adreces 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ésexport https_proxy=$http_proxy,export HTTP_PROXY=$http_proxyiexport HTTPS_PROXY=$http_proxy. - Ometre adreces internes:
export no_proxy=localhost,127.0.0.1,.internal.localiexport NO_PROXY=$no_proxy. - Permanent per al vostre usuari: afegiu aquestes línies
exporta~/.bashrco~/.zshrci obriu un terminal nou. - Per a tot el sistema a Ubuntu: afegiu
http_proxy=http://user:pass@ip:port(senseexport) 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. sudoelimina la majoria de les variables d'entorn per defecte. Utilitzeusudo -E commando configureuenv_keepsi les ordres executades amb sudo també necessiten el servidor intermediari.aptno detecta sempre de manera fiable les variables d'entorn sota sudo; creeu/etc/apt/apt.conf.d/95proxyamb el contingutAcquire::http::Proxy "http://user:pass@ip:port/";i una línia coincident per aAcquire::https::Proxy.- Per eliminar-ho: executeu
unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXYi 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:portiset 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:portisetx 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.confamb una secció[Service]iEnvironment="HTTP_PROXY=http://user:pass@ip:port" "HTTPS_PROXY=http://user:pass@ip:port" "NO_PROXY=localhost,127.0.0.1", i després executeusudo systemctl daemon-reloadisudo systemctl restart docker. - Contenidors i construccions: afegiu un bloc
proxiesa~/.docker/config.jsonambhttpProxy,httpsProxyinoProxy; 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 imageodocker 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 utilitzeu127.0.0.1en 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.localsol coincidir amb tots els subdominis; moltes eines tracteninternal.localde la mateixa manera. - Els intervals CIDR com ara
10.0.0.0/8són compatibles amb algunes eines i amb d'altres no. Per seguretat, enumereu les adreces o utilitzeu noms d'amfitrió. - Incloeu sempre
localhosti127.0.0.1perquè 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 proxya Linux,Get-ChildItem Env: | Where-Object Name -like '*proxy*'a PowerShell. - Comproveu la IP de sortida amb
curl -s https://httpbin.org/ipi compareu-la amb la IP del servidor intermediari, o bé obriu quina és la meva IP des d'aquella màquina. Afegiu-vper 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