Einen Proxyserver mithilfe von Umgebungsvariablen konfigurieren
Wenn Dein selbst-gehosteten Runner über einen Proxy-Server kommunizieren soll, verwendet die Anwendung für selbst-gehostete Runner die Proxy-Konfigurationen in den folgenden Umgebungsvariablen:
https_proxy
: Proxy-URL für HTTPS-Datenverkehr. Sie können bei Bedarf auch Anmeldeinformationen zur einfachen Authentifizierung angeben. Beispiel:http://proxy.local
http://192.168.1.1:8080
http://username:password@proxy.local
http_proxy
: Proxy-URL für HTTPS-Datenverkehr. Sie können bei Bedarf auch Anmeldeinformationen zur einfachen Authentifizierung angeben. Beispiel:http://proxy.local
http://192.168.1.1:8080
http://username:password@proxy.local
no_proxy
: Durch Kommas getrennte Liste von Hosts, die keinen Proxy verwenden sollten. Nur Hostnamen sind inno_proxy
zulässig, Sie können keine IP-Adressen verwenden. Beispiel:example.com
example.com,myserver.local:443,example.org
Die Proxy-Umgebungsvariablen werden beim Starten der Anwendung für selbst-gehostete Runner gelesen. Daher musst Du die Umgebungsvariablen festlegen, bevor Du die Anwendung für selbst-gehostete Runner konfigurierst oder startest. Wenn sich Ihre Proxykonfiguration ändert, müssen Sie die selbstgehostete Runneranwendung neu starten.
Hinweis: Um Probleme zu vermeiden, empfiehlt es sich, Umgebungsvariablen unabhängig vom Verhalten des verwendeten Betriebssystems und der verwendeten Shell als Groß-/Kleinschreibung zu behandeln.
Auf Windows-Rechnern wird bei den Namen der Proxy-Umgebungsvariablen zwischen Groß- und Kleinschreibung unterschieden. Auf Linux- und macOS-Rechnern wird empfohlen, alle Umgebungsvariablen in Kleinbuchstaben zu schreiben. Wenn eine Umgebungsvariable sowohl in Kleinbuchstaben als auch in Großbuchstaben unter Linux oder macOS vorhanden ist (z. B. https_proxy
und HTTPS_PROXY
), verwendet die selbstgehostete Runneranwendung die Umgebungsvariable in Kleinbuchstaben.
Die Verbindung zwischen selbstgehosteten Runnern und GitHub verläuft über HTTPS (Port 443).
Eine .env-Datei zur Proxykonfiguration verwenden
Wenn das Festlegen von Umgebungsvariablen nicht praktisch ist, können Sie die Proxy-Konfigurationsvariablen in einer Datei mit dem Namen .env
im selbstgehosteten Runner-Anwendungsverzeichnis festlegen (d. h. dem Verzeichnis, in das Sie die Runner-Software heruntergeladen und entpackt haben). Dies kann z. B. erforderlich sein, wenn Du die Runner-Anwendung als Dienst unter einem Systemkonto konfigurieren möchtest. Wenn die Runner-Anwendung startet, liest sie die in .env
festgelegten Variablen für die Proxy-Konfiguration.
Beispiel .env
-Proxykonfiguration
https_proxy=http://proxy.local:8080
no_proxy=example.com,myserver.local:443
Festlegen der Proxy-Konfiguration für Docker-Container
Wenn Du Docker-Container-Aktionen oder Service-Container in Deinen Workflows verwendest, musst Du möglicherweise zusätzlich zur Einstellung der oben genannten Umgebungsvariablen auch Docker so konfigurieren, dass er Deinen Proxy-Server verwendet.
Informationen zur erforderlichen Docker-Konfiguration finden Sie in der Docker-Dokumentation unter Konfigurieren von Docker zum Verwenden eines Proxyservers.