Hinweis: GitHub-gehostete Runner werden auf GitHub Enterprise Server derzeit nicht unterstützt. Weitere Informationen zur geplanten zukünftigen Unterstützung findest Du in der GitHub public roadmap.
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 Enterprise Server verläuft über HTTP (Port 80) oder HTTPS (Port 443). Um die Konnektivität über HTTPS sicherzustellen, konfiguriere TLS für Ihre GitHub Enterprise Server-Instance. Weitere Informationen findest du unter TLS konfigurieren.
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.