Auf einem Linux-Server oder in einem Container gibt es keinen System-Proxy-Dialog; es gibt drei Mechanismen, und welchen Sie benötigen, hängt davon ab, wie gut sich die Software verhält. Umgebungsvariablen (http_proxy, https_proxy, no_proxy) werden von curl, wget, pip, apt, git, den meisten HTTP-Bibliotheken und Docker selbst beachtet — und von einigen Tools stillschweigend ignoriert. Prozessbezogene Wrapper wie proxychains zwingen ein einzelnes Programm auf Bibliotheksebene durch einen Proxy. Transparente Weiterleitung mit iptables und einem Helfer wie redsocks erfasst jede ausgehende TCP-Verbindung vom Host oder Container, unabhängig davon, was das Programm zu tun glaubt. Dieser Leitfaden behandelt alle drei, die Fallstricke in jedem und wie man das Ergebnis überprüft.
Ebene 1: Umgebungsvariablen
Die Konvention, älter als Linux: Wenn http_proxy / https_proxy gesetzt sind, verwende sie; überspringe Hosts, die in no_proxy aufgeführt sind.
export http_proxy="http://user:pass@proxy.example.com:8080"
export https_proxy="http://user:pass@proxy.example.com:8080"
export no_proxy="localhost,127.0.0.1,::1,.internal,10.0.0.0/8"
curl https://api.ipify.org # geht durch den Proxy
curl http://localhost:9000/health # direkt, dank no_proxy
Punkte, die Leute Stunden kosten:
- Groß-/Kleinschreibung. Setzen Sie sowohl Klein- als auch Großschreibung (
HTTP_PROXY,HTTPS_PROXY,NO_PROXY); Tools sind sich uneinig, welche sie lesen. Beachten Sie, dasshttps_proxyeinehttp://-URL akzeptiert — es benennt den Proxy für HTTPS-Ziele, und der Proxy selbst ist normalerweise einfaches HTTP mitCONNECT. - Sonderzeichen im Passwort müssen prozentkodiert sein.
- Geltungsbereich. Die Variablen gelten für Prozesse, die nach dem Setzen in dieser Shell gestartet werden. Von systemd gestartete Dienste sehen Ihre Shell nicht; setzen Sie sie in die
Environment=-Zeile der Unit oder in eineEnvironmentFile. Cron-Jobs haben ebenfalls eine minimale Umgebung. sudoentfernt die Umgebung standardmäßig; verwenden Siesudo -Eoder konfigurieren Sieenv_keep.- Wer ignoriert sie. Go-Programme beachten sie (über
net/http'sProxyFromEnvironment); Pythons requests beachten sie; Nodes eingebautesfetchund viele Node-HTTP-Clients tun dies nicht, es sei denn, ein Helfer wird verwendet; Java benötigt-Dhttp.proxyHost-JVM-Flags; Datenbanken und benutzerdefinierte TCP-Protokolle schauen nie darauf. Wenn der Datenverkehr eines Programms nach dem Setzen der Variablen immer noch Ihre echte IP zeigt, gehört es zu diesen — wechseln Sie zu Ebene 2 oder 3.
Paketmanager haben ihre eigenen Stellschrauben
# apt
echo 'Acquire::http::Proxy "http://user:pass@proxy.example.com:8080";' | sudo tee /etc/apt/apt.conf.d/95proxy
echo 'Acquire::https::Proxy "http://user:pass@proxy.example.com:8080";' | sudo tee -a /etc/apt/apt.conf.d/95proxy
# pip
pip config set global.proxy http://user:pass@proxy.example.com:8080
# git
git config --global http.proxy http://user:pass@proxy.example.com:8080
# npm
npm config set proxy http://user:pass@proxy.example.com:8080
npm config set https-proxy http://user:pass@proxy.example.com:8080
Ebene 1b: Docker speziell
Docker hat zwei getrennte Proxy-Bereiche, und sie zu verwechseln ist der klassische Container-Fehler.
Der Daemon (Image-Pulls)
Image-Pulls werden vom Docker-Daemon durchgeführt, einem systemd-Dienst — er sieht Ihre Shell nicht. Konfigurieren Sie ihn in einem Drop-in:
sudo mkdir -p /etc/systemd/system/docker.service.d
cat <<'EOF' | sudo tee /etc/systemd/system/docker.service.d/http-proxy.conf
[Service]
Environment="HTTP_PROXY=http://user:pass@proxy.example.com:8080"
Environment="HTTPS_PROXY=http://user:pass@proxy.example.com:8080"
Environment="NO_PROXY=localhost,127.0.0.1,registry.internal"
EOF
sudo systemctl daemon-reload && sudo systemctl restart docker
Container (Datenverkehr Ihrer Anwendungen)
Prozesse in einem Container haben ihre eigene Umgebung. Entweder übergeben Sie die Variablen zur Laufzeit:
docker run -e HTTP_PROXY=http://user:pass@proxy.example.com:8080 \
-e HTTPS_PROXY=http://user:pass@proxy.example.com:8080 \
-e NO_PROXY=localhost,127.0.0.1 myimage
oder Sie setzen Standardwerte für alle Container, die Sie von diesem Client starten, in ~/.docker/config.json:
{ "proxies": { "default": {
"httpProxy": "http://user:pass@proxy.example.com:8080",
"httpsProxy": "http://user:pass@proxy.example.com:8080",
"noProxy": "localhost,127.0.0.1" } } }
Der Client injiziert diese in die Umgebung jedes Containers (und in Builds). Innerhalb des Containers gelten dieselben Einschränkungen: Die Anwendung muss eine sein, die die Variablen beachtet. In Compose verwenden Sie den environment:-Block pro Dienst, und denken Sie daran, dass Dienste, die miteinander über den Dienstnamen kommunizieren, in NO_PROXY aufgeführt sein müssen, sonst versucht jeder interne Aufruf, über den Proxy zu gehen und schlägt fehl.
Builds
docker build erhält den Proxy aus ~/.docker/config.json oder aus --build-arg HTTP_PROXY=…. Backen Sie keine Anmeldedaten mit ENV in das Image; sie landen in der Layer-Historie für jeden, der es zieht.
Ebene 2: Prozessbezogene Wrapper
Für ein Programm, das die Umgebung ignoriert, lädt proxychains (der gepflegte Fork ist proxychains-ng, Paket proxychains4) eine gemeinsame Bibliothek vor, die die Socket-Aufrufe des Programms abfängt und sie durch eine von Ihnen definierte Proxy-Kette leitet:
sudo apt install proxychains4
# /etc/proxychains4.conf, am Ende:
# [ProxyList]
# http proxy.example.com 8080 user pass
# oder: socks5 proxy.example.com 1080 user pass
proxychains4 -q ./my-binary --that-ignores-env
Setzen Sie proxy_dns in der Konfiguration, damit auch Hostnamen-Auflösungen über den Proxy laufen (das DNS-Leck-Problem aus How to test a proxy). Grenzen: Es funktioniert nur mit dynamisch gelinkten Binärdateien, die die Standard-Socket-Bibliothek verwenden — statisch gelinkte Go-Programme und alles, was rohe Sockets verwendet, entgeht ihm. Es ist ein Werkzeug für einen Prozess nach dem anderen, ideal zum Testen und für das eine oder andere fehlverhaltende Binärprogramm, nicht für einen ganzen Host.
Alternativen in derselben Klasse: tsocks, graftcp (verwendet ptrace, fängt also auch statische Binärdateien, auf Kosten der Leistung), und für Container, die den Prozess unter einem dieser als Entrypoint ausführen.
Ebene 3: Transparente Weiterleitung mit iptables und redsocks
Wenn Sie alles von einem Host oder Container durch einen Proxy leiten müssen — einschließlich Software, die Sie nicht konfigurieren können — leiten Sie auf Kernel-Ebene um. iptables kann ausgehende TCP-Verbindungen auf einen lokalen Port umschreiben; ein kleiner Daemon, der dort lauscht, verpackt jede Verbindung im Proxy-Protokoll und leitet sie weiter. redsocks ist der Standard-Daemon dafür.
sudo apt install redsocks
# /etc/redsocks.conf
base { log_debug = off; log_info = on; daemon = on; redirector = iptables; }
redsocks {
local_ip = 127.0.0.1; local_port = 12345;
ip = PROXY_IP; port = 8080;
type = http-connect; # oder socks5
login = "user"; password = "pass";
}
sudo systemctl restart redsocks
# Leiten Sie alle ausgehenden TCP-Verbindungen um, außer zum Proxy selbst und zu lokalen/privaten Bereichen
sudo iptables -t nat -N REDSOCKS
sudo iptables -t nat -A REDSOCKS -d PROXY_IP -j RETURN
sudo iptables -t nat -A REDSOCKS -d 127.0.0.0/8 -j RETURN
sudo iptables -t nat -A REDSOCKS -d 10.0.0.0/8 -j RETURN
sudo iptables -t nat -A REDSOCKS -d 172.16.0.0/12 -j RETURN
sudo iptables -t nat -A REDSOCKS -d 192.168.0.0/16 -j RETURN
sudo iptables -t nat -A REDSOCKS -p tcp -j REDIRECT --to-ports 12345
sudo iptables -t nat -A OUTPUT -p tcp -j REDSOCKS # eigener Datenverkehr dieses Hosts
# für Datenverkehr von Containern/anderen Hosts, die über diese Box geleitet werden, verwenden Sie stattdessen PREROUTING
Drei Dinge sollten Sie wissen, bevor Sie dies tun. Die RETURN-Regel für die eigene IP des Proxys ist nicht optional — ohne sie wird die Verbindung von redsocks zum Proxy selbst wieder zu redsocks umgeleitet, und die Box schleift. UDP wird nicht umgeleitet durch dieses Rezept: DNS wird weiterhin direkt gehen, es sei denn, Sie leiten auch Port 53 an einen vertrauenswürdigen Resolver um oder verwenden den redudp-Abschnitt von redsocks; und QUIC/HTTP/3 wird einfach nicht durch den Proxy funktionieren (siehe HTTP/3 through proxies), was in Ordnung ist, weil Clients auf TCP zurückfallen. Testen Sie die Regeln mit einem Timeout (sudo timeout 60 iptables … gibt es nicht, aber halten Sie eine zweite SSH-Sitzung offen und seien Sie bereit, iptables -t nat -F auszuführen) — eine falsche Regel kann Sie von einem entfernten Server abschneiden.
Dasselbe Muster funktioniert für einen Container, indem Sie die iptables-Regeln darin ausführen (benötigt --cap-add=NET_ADMIN) oder, sauberer, auf dem Host, wobei der Datenverkehr des Containers durch einen dedizierten Netzwerk-Namespace geleitet wird. Kubernetes-Benutzer erkennen dies als genau das, wie Service-Mesh-Seitencarrier Datenverkehr erfassen.
Welche Ebene für welche Situation
| Situation | Verwendung | Warum |
|---|---|---|
| Skripte, CLI-Tools, Paketmanager, gut erzogene Dienste | Umgebungsvariablen (+ toolspezifische Konfiguration) | Einfach, umkehrbar, prozessbezogener Geltungsbereich |
| Docker-Image-Pulls | Daemon-Drop-in | Der Daemon hat seine eigene Umgebung |
| Anwendungen in Containern | ~/.docker/config.json oder -e | Wird in die Umgebung des Containers injiziert |
| Ein Binärprogramm, das die Umgebung ignoriert | proxychains / graftcp | Fängt auf Socket-Ebene ab; keine hostweite Änderung |
| Alles von einem Host oder Namespace, bedingungslos | iptables + redsocks | Auf Kernel-Ebene; nichts kann sich abmelden |
| Verschiedene Proxies für verschiedene Ziele | PAC-ähnliche Logik: env no_proxy oder iptables-Regeln pro Zielbereich | Nach Ziel routen |
Immer verifizieren
curl -s https://api.ipify.org # beachtet env: sollte die Proxy-IP zeigen
curl -s --noproxy '*' https://api.ipify.org # umgeht env: zeigt die Proxy-IP NUR wenn Ebene 3 aktiv ist
python3 -c "import urllib.request;print(urllib.request.urlopen('https://api.ipify.org').read())"
dig +short myip.opendns.com @resolver1.opendns.com # von welcher IP sieht DNS Sie?
Die zweite Zeile ist der nützliche Trick: Mit --noproxy '*' ignoriert curl die Umgebung. Wenn es trotzdem die IP des Proxys meldet, funktioniert die transparente Weiterleitung; wenn es Ihre echte IP meldet, ist nur die Umgebungsebene aktiv und nicht konforme Software wird leaken. Überprüfen Sie auch DNS separat — es ist das häufigste Leck auf Servern, da Resolver systemweit konfiguriert sind und nichts in den drei Ebenen oben UDP umleitet, es sei denn, Sie tun es.
Für die Wahl des Proxy-Typs hinter all dem — Datacenter für die meisten Serverarbeiten, ISP für eine stabile Identität, Residential, wo das Ziel es verlangt — siehe den Proxy-Typen-Vergleich; anbieterseitige Hinweise für Linux-Workloads finden Sie in unserem Linux-Proxy-Ranking.
Häufig gestellte Fragen
Wie setze ich einen Proxy für den gesamten Linux-Server?
Für konforme Software exportieren Sie http_proxy/https_proxy/no_proxy systemweit (z. B. /etc/environment) und konfigurieren Dienste über systemd Environment=. Für wirklich alles verwenden Sie iptables-Umleitung zu redsocks.
Wie bringe ich Docker dazu, einen Proxy zu verwenden?
Zwei Stellen: den Daemon (für Pulls) über ein systemd-Drop-in mit HTTP_PROXY und Container über ~/.docker/config.json proxies oder -e-Variablen. Sie sind unabhängig; setzen Sie beide, wenn Sie beide benötigen.
Warum ignoriert mein Programm http_proxy?
Nicht alle Software liest es — Nodes fetch, Java, Datenbanken und benutzerdefinierte Protokolle tun dies nicht. Verwenden Sie eine toolspezifische Einstellung, einen Wrapper wie proxychains oder transparente Weiterleitung.
Was ist redsocks?
Ein Daemon, der TCP-Verbindungen akzeptiert, die von iptables an ihn umgeleitet werden, und sie über einen HTTP-CONNECT- oder SOCKS-Proxy weiterleitet, wodurch Sie einen transparenten Proxy für jede Anwendung erhalten, ohne die Anwendung zu konfigurieren.
Behandelt die transparente Weiterleitung DNS und UDP?
Nicht durch das Basisrezept — es leitet TCP um. Leiten Sie DNS explizit um (oder zeigen Sie den Resolver auf einen vertrauenswürdigen Server) und erwarten Sie, dass UDP-basierte Protokolle wie QUIC auf TCP zurückfallen.
Sollten Container SOCKS5- oder HTTP-Proxies verwenden?
HTTP mit CONNECT deckt HTTPS-Ziele ab und ist das, was Umgebungsvariablen erwarten; SOCKS5 wird nur für Nicht-HTTP-TCP-Datenverkehr benötigt, und dann über proxychains oder redsocks im socks5-Modus.