Konfigurieren eines ausgehenden Webproxyservers

Informationen zur Konfiguration eines Proxys für GitHub Enterprise Server

Wenn ein Proxyserver für deine GitHub Enterprise Server-Instanz aktiviert ist, werden ausgehende Nachrichten, die von GitHub Enterprise Server gesendet wurden, zunächst über den Proxyserver geleitet, sofern der Zielhost nicht als HTTP-Proxyausschluss hinzugefügt wurde. Zu den Typen ausgehender Nachrichten zählen ausgehende Webhooks, das Hochladen von Bundles und das Abrufen von veralteten Avataren. Die URL des Proxyservers ist die Protokoll-, Domänen- oder IP-Adresse plus die Portnummer, also beispielsweise http://127.0.0.1:8123.

Wenn GitHub Actions für dein Unternehmen aktiviert ist, werden nur HTTP-Proxys unterstützt. SOCKS5- und HTTPS-Proxys werden nicht unterstützt. Weitere Informationen zur Verwendung von GitHub Actions mit GitHub Enterprise Server findest du unter Erste Schritte mit GitHub Actions für GitHub Enterprise Server.

Konfigurieren eines ausgehenden Webproxyservers

Du kannst einen ausgehenden Proxyserver in deine GitHub Enterprise Server-Instanz und Ausnahmen für Verbindungen mit bestimmten Domänen konfigurieren.

1. Klicke in einem Verwaltungskonto auf GitHub Enterprise Server und dann in der rechten oberen Ecke einer beliebigen Seite auf „“.

2. Wenn du dich nicht bereits auf der Seite „Websiteadministrator“ befindest, klicke in der oberen linken Ecke auf Websiteadministrator.

3. Wähle auf der Randleiste „ Websiteadministrator“ die Option Verwaltungskonsole aus.

4. Klicke auf der Randleiste unter „Einstellungen“ auf Datenschutz.

5. Gib unter HTTP-Proxyserver die URL deines Proxyservers ein.

6. Gib optional unter HTTP-Proxyausschluss die Hosts ein, für die kein Proxyzugriff erforderlich ist, und trenne dabei die Hosts durch Kommas voneinander. Die folgenden Regeln gelten für Domänen der obersten Ebene (Top-Level Domains, TLDs) und IP-Adressen, die du vom Proxy ausschließt.

   • Wenn du eine TLD ausschließt, kannst du alle Hosts in einer Domäne von der Anforderung des Proxyzugriffs ausschließen, indem du . als Platzhalterpräfix verwendest, z. B. .octo-org.tentacle.
   • In VersionGitHub Enterprise Server 3.7.8 und höher überprüft deine Instanz die Hostnamen anhand der IANA-Liste der registrierten TLDs. Weitere Informationen findest du in der Liste der TLDs auf der IANA-Website. Wenn du eine nicht registrierte TLD ausschließen möchtest, findest du weitere Informationen unter Ausschließen zusätzlicher nicht registrierter TLDs vom Proxy.
     • Wenn du zusätzliche nicht registrierte TLDs ausschließt, musst du . als Platzhalterpräfix verwenden. Wenn die TLD tentacle heißt, musst du .tentacle ausschließen. Eine nicht registrierte TLD kann nicht ohne das Präfix . ausgeschlossen werden.
   • Du kannst eine vollständige, gültige IPv4- oder IPv6-Adresse ausschließen.
   • Du kannst eine IPv4- oder IPv6-Adresse nicht ausschließen, indem du einen vorangestellten oder einen nachstehenden Punkt als Platzhalterzeichen verwendest.

7. Klicke auf der Randleiste unter „Einstellungen“ auf Einstellungen speichern.

   Hinweis: Durch das Speichern von Einstellungen in der Verwaltungskonsole werden Systemdienste neu gestartet, was zu einer für den Benutzer feststellbaren Downtime führen könnte.

8. Warten Sie auf den Abschluss der Konfigurationsausführung.

Ausschließen zusätzlicher nicht registrierter TLDs vom Proxy

In GitHub Enterprise Server 3.7.8 und höher kannst du die Proxyeinstellungen deiner Instanz so konfigurieren, dass nicht registrierte TLDs, die sich nicht auf der Liste der TLDs auf der IANA-Website befinden, ausgeschlossen werden.

1. Melde dich über SSH bei deine GitHub Enterprise Server-Instanz an. Wenn deine Instanz mehrere Knoten umfasst, wenn z. B. Hochverfügbarkeit oder Georeplikation konfiguriert ist, wird SSH im primären Knoten konfiguriert. Wenn du einen Cluster verwendest, kannst du SSH in einen beliebigen Knoten einfügen. Weitere Informationen zum SSH-Zugriff findest du unter Auf die Verwaltungsshell (SSH) zugreifen.

   ssh -p 122 admin@HOSTNAME
   

2. Gib den folgenden Befehl ein, und ersetze dabei COMMA-SEPARATED-TLD-LIST durch eine durch Trennzeichen getrennte Liste der TLDs.

   ghe-config noproxy.exception-tld-list "COMMA-SEPARATED-TLD-LIST"
   

3. Führe den folgenden Befehl aus, um die Konfiguration anzuwenden.

   Hinweis: Während einer Konfigurationsausführung können die Dienste auf deine GitHub Enterprise Server-Instanz neu gestartet werden, was zu kurzen Ausfallzeiten für Benutzer führen kann.

   Shell

   ghe-config-apply
   

4. Warte auf den Abschluss der Konfigurationsausführung.