Konfigurieren des Hostnamens für deine Instanz

Informationen zum Hostnamen für GitHub Enterprise Server

Um einen zuverlässigen Zugriff auf Ihre GitHub Enterprise Server-Instance über einen bekannten Namen im Netzwerk zu ermöglichen, kannst du einen Hostnamen konfigurieren. Wenn du einen Hostnamen konfigurierst, anstatt eine hartcodierte IP-Adresse zu verwenden, kannst du die physische Hardware ändern, auf der Ihre GitHub Enterprise Server-Instance ausgeführt wird, ohne dass sich dies auf die Benutzer*innen oder auf die Clientsoftware auswirkt.

Die Einstellung des Hostnamens in der Verwaltungskonsole sollte auf einen geeigneten vollqualifizierten Domainnamen (FQDN) gesetzt werden, der im Internet oder in deinem internen Netzwerk auflösbar ist. Deine Hostnameneinstellung könnte beispielsweise github.companyname.com. sein. Web- und API-Anforderungen werden automatisch an den in der Verwaltungskonsole konfigurierten Hostnamen weitergeleitet. Beachte, dass localhost keine gültige Hostnameneinstellung ist.

Hostnamen müssen gemäß Abschnitt 2.3.4 des RFC für Domänennamenspezifikation weniger als 63 Zeichen lang sein.

Nachdem du einen Hostnamen konfiguriert hast, kannst du die Unterdomänenisolation aktivieren, um die Sicherheit von Ihre GitHub Enterprise Server-Instance weiter zu steigern. Weitere Informationen findest du unter Subdomain-Isolation aktivieren.

GitHub empfiehlt dringend, den Hostnamen für eine vorhandene GitHub Enterprise Server-Instanz nicht zu ändern. Das Ändern des Hostnamens wird zu unerwartetem Verhalten führen, bis hin zu Instanzausfällen. Konfiguriere stattdessen eine neue Instanz mit dem gewünschten Hostnamen, und stelle dann Einstellungen und Daten aus der ursprünglichen Instanz in der neuen Instanz wieder her.

Weitere Informationen zu den unterstützten Hostnamentypen findest du im Abschnitt 2.1 des HTTP-RFC.

Konfigurieren des Hostnamens

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 Hostname.

5. Gib unter „Hostname“ den Hostnamen ein, den du für Ihre GitHub Enterprise Server-Instance festlegen möchtest.

6. Klicke zum Testen der DNS- und SSL-Einstellungen für den neuen Hostnamen auf Domäneneinstellungen testen.

7. Wenn nicht neben allen Einträgen ein grünes Häkchen angezeigt wird, solltest Du Deine Konfiguration auf die fehlgeschlagene Einstellung überprüfen. Weitere Informationen findest du unter DNS-Nameserver konfigurieren.

8. 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.

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

Um verschiedenen Cross-Site-Scripting-Sicherheitsrisiken vorzubeugen, solltest du die Unterdomänenisolation für Ihre GitHub Enterprise Server-Instance aktivieren, nachdem du einen Hostnamen konfiguriert hast. Weitere Informationen findest du unter Subdomain-Isolation aktivieren.

Ändern des Hostnamens

Wenn du den Hostnamen für Ihre GitHub Enterprise Server-Instance ändern musst, musst du eine Sicherung deiner vorhandenen Instanz in einer neuen Instanz mit dem gewünschten Hostnamen wiederherstellen. Weitere Informationen findest du unter Ändern des Hostnamens für deine Instanz.