Verwenden eines Proxyservers mit selbstgehosteten Runnern

Sie können selbst gehostete Runner so konfigurieren, dass sie einen Proxy-Server verwenden, um mit GitHub zu kommunizieren.

In diesem Artikel

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 in no_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.