Verwalten einer benutzerdefinierten Domäne für Ihre GitHub Seitenwebsite

Personen mit Administratorberechtigungen für ein Repository können eine benutzerdefinierte Domäne für eine GitHub Pages-Website konfigurieren.

Informationen zur Konfiguration einer benutzerdefinierten Domäne

Nimm die benutzerdefinierte Domäne zunächst in die GitHub Pages Website auf, bevor du die benutzerdefinierte Domäne bei deinem DNS-Provider konfigurierst. Wenn du deine benutzerdefinierte Domäne bei deinem DNS-Anbieter konfigurierst, ohne sie zu GitHub hinzuzufügen, kann eine andere Person eine Website in einer deiner Unterdomänen hosten.

Eine Apex-Domäne konfigurieren

Zum Einrichten einer Apex-Domäne, z. B. example.com, musst du eine benutzerdefinierte Domäne in deinen Repositoryeinstellungen und mindestens einen ALIAS-, ANAME- oder A-Datensatz mit deinem DNS-Anbieter konfigurieren.

1. Navigiere auf GitHub zum Repository deiner Website.

2. Klicke unter dem Repositorynamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

   

3. Klicke im Abschnitt „Code and automation“ der Randleiste auf Pages.

4. Gib unter „Benutzerdefinierte Domäne“ den Namen deiner benutzerdefinierten Domäne ein, und klicke auf Speichern. Wenn Sie Ihre Website über eine Verzweigung veröffentlichen, wird dadurch ein Commit erstellt, der eine CNAME-Datei direkt dem Stamm Ihrer Quellverzweigung hinzufügt. Wenn du die Veröffentlichung über einen benutzerdefinierten GitHub Actions-Workflow vornimmst, wird keine CNAME-Datei erstellt. Außerdem werden alle bestehenden CNAME-Dateien ignoriert und sind nicht erforderlich. Weitere Informationen zu deiner Veröffentlichungsquelle findest du unter Eine Veröffentlichungsquelle für deine GitHub Pages-Website konfigurieren.

5. Navigiere zu deinem DNS-Anbieter, und erstelle entweder einen ALIAS-, ANAME- oder A-Eintrag. Du kannst auch AAAA-Einträge für die IPv6-Unterstützung erstellen. Wenn du die IPv6-Unterstützung implementierst, wird aufgrund der langsamen weltweiten Einführung von IPv6 dringend empfohlen, zusätzlich zu deinem A-Eintrag auch einen AAAA-Eintrag zu verwenden. Weitere Informationen zum Erstellen des richtigen Datensatzes findest Du in der Dokumentation Ihres DNS-Anbieters.

   • Um einen ALIAS- oder ANAME-Eintrag zu erstellen, verweise deine Apex-Domäne auf die Standarddomäne für deine Website. Weitere Informationen zur Standarddomäne für deine Website findest du unter Was ist GitHub Pages?.

   • Soll ein A-Eintrag erstellt werden, verweise deine Apex-Domäne auf die IP-Adressen für GitHub Pages.

     185.199.108.153
     185.199.109.153
     185.199.110.153
     185.199.111.153
     

   • Um AAAA-Einträge zu erstellen, leiten Sie Ihre Apex-Domäne auf die IP-Adressen für GitHub Pages weiter.

     2606:50c0:8000::153
     2606:50c0:8001::153
     2606:50c0:8002::153
     2606:50c0:8003::153
     

1. Öffne TerminalTerminalGit Bash.

2. Um zu überprüfen, ob dein DNS-Eintrag korrekt konfiguriert ist, verwende den Befehl dig, wobei du EXAMPLE.COM durch deine Apex-Domäne ersetzt. Prüfe, ob die Ergebnisse mit den obigen IP-Adressen für GitHub Pages übereinstimmen.

   • Für A-Einträge:

     $ dig EXAMPLE.COM +noall +answer -t A
     > EXAMPLE.COM    3600    IN A     185.199.108.153
     > EXAMPLE.COM    3600    IN A     185.199.109.153
     > EXAMPLE.COM    3600    IN A     185.199.110.153
     > EXAMPLE.COM    3600    IN A     185.199.111.153
     

   • Für AAAA-Einträge:

     $ dig EXAMPLE.COM +noall +answer -t AAAA
     > EXAMPLE.COM     3600    IN AAAA     2606:50c0:8000::153
     > EXAMPLE.COM     3600    IN AAAA     2606:50c0:8001::153
     > EXAMPLE.COM     3600    IN AAAA     2606:50c0:8002::153
     > EXAMPLE.COM     3600    IN AAAA     2606:50c0:8003::153
     

3. Wenn du einen Generator für statische Websites verwendest, um deine Website lokal zu erstellen und die generierten Dateien zu GitHub zu pushen, pulle den Commit, durch den die CNAME-Datei zu deinem lokalen Repository hinzugefügt wurde. Weitere Informationen finden Sie unter Problembehandlung für benutzerdefinierte Domänen und GitHub Seiten.

4. Wenn du optional HTTPS-Verschlüsselung für deine Website erzwingen möchtest, wähle HTTPS erzwingen aus. Es kann bis zu 24 Stunden dauern, bis diese Option verfügbar ist. Weitere Informationen finden Sie unter Sichern Ihrer GitHub Seitenwebsite mit HTTPS.

Konfigurieren einer Apex-Domäne und der Unterdomänenvariante www

Wenn du eine Apex-Domäne als deine benutzerdefinierte Domäne verwendest, empfehlen wir, auch eine www-Unterdomäne einzurichten. Wenn Du über Deinen DNS-Anbieter die richtigen Datensätze für jeden Domänentyp konfigurierst, wird GitHub Pages automatisch Umleitungen zwischen den Domänen erstellen. Wenn du beispielsweise www.example.com als benutzerdefinierte Domäne für deine Website konfigurierst, und du GitHub Pages- DNS-Einträge für Apex und www-Domänen eingerichtet hast, wird example.com zu www.example.com umgeleitet. Wenn du stattdessen example.com als benutzerdefinierte Domäne konfigurierst, wird www.example.com zu example.com umgeleitet. Automatische Umleitungen gelten auch für andere Unterdomänen, da www.blog.example.com zu blog.example.com oder umgekehrt umgeleitet wird. Es ist nicht möglich, eine Domäne zu konfigurieren, die mit www.www. beginnt. Weitere Informationen finden Sie unter Konfigurieren einer Unterdomäne.

Navigieren Sie zu Ihrem DNS-Anbieter, und erstellen Sie einen CNAME-Eintrag für die Unterdomäne www, der auf die Standarddomäne von GitHub Pages verweist. Wenn sich Ihre Site z. B. unter <user>.github.io befindet, sollten Sie einen CNAME-Eintrag erstellen, der www.example.com auf <user>.github.io verweist. Desgleichen sollten Sie für eine Organisationssite unter <organization>.github.io einen CNAME-Eintrag erstellen, der www.example.com auf <organization>.github.io verweist. Stellen Sie sicher, dass der CNAME-Eintrag direkt auf <user>.github.io oder <organization>.github.io (ohne den Repositorynamen) verweist.

Weitere Informationen zum Erstellen des richtigen Datensatzes findest Du in der Dokumentation Ihres DNS-Anbieters. Weitere Informationen zur Standarddomäne für deine Website findest du unter Was ist GitHub Pages?.

Eine Subdomäne konfigurieren

Zum Einrichten einer www oder benutzerdefinierten Unterdomäne wie www.example.com oder blog.example.com musst du deine Domäne in den Repositoryeinstellungen hinzufügen. Konfiguriere danach einen CNAME-Eintrag mit deinem DNS-Anbieter.

1. Navigiere auf GitHub zum Repository deiner Website.

2. Klicke unter dem Repositorynamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

   

3. Klicke im Abschnitt „Code and automation“ der Randleiste auf Pages.

4. Gib unter „Benutzerdefinierte Domäne“ den Namen deiner benutzerdefinierten Domäne ein, und klicke auf Speichern. Wenn Sie Ihre Website über eine Verzweigung veröffentlichen, wird dadurch ein Commit erstellt, der eine CNAME-Datei direkt dem Stamm Ihrer Quellverzweigung hinzufügt. Wenn du die Veröffentlichung über einen benutzerdefinierten GitHub Actions-Workflow vornimmst, wird keine CNAME-Datei erstellt. Außerdem werden alle bestehenden CNAME-Dateien ignoriert und sind nicht erforderlich. Weitere Informationen zu deiner Veröffentlichungsquelle findest du unter Eine Veröffentlichungsquelle für deine GitHub Pages-Website konfigurieren.

   Hinweis

   Wenn es sich bei deiner benutzerdefinierten Domäne um einen internationalisierten Domänenname handelt, musst du die mit Punycode programmierte Version eingeben.

   Weitere Informationen zu Punycodes findest du unter Internationalisierter Domänenname.

5. Navigiere zu deinem DNS-Anbieter, und erstelle einen CNAME-Eintrag, der deine Unterdomäne auf die Standarddomäne für deine Website verweist. Wenn du beispielsweise die Unterdomäne www.example.com für deine Benutzerwebsite verwenden möchtest, erstelle einen CNAME-Eintrag, der www.example.com auf <user>.github.io verweist. Wenn du die Unterdomäne another.example.com für deine Unternehmenswebsite verwenden möchtest, erstelle einen CNAME-Eintrag, der another.example.com auf <organization>.github.io verweist. Der CNAME-Eintrag sollte immer auf <user>.github.io oder <organization>.github.io verweisen, ohne den Repositorynamen. Weitere Informationen zum Erstellen des richtigen Datensatzes findest Du in der Dokumentation Ihres DNS-Anbieters. Weitere Informationen zur Standarddomäne für deine Website findest du unter Was ist GitHub Pages?.

   Warnung

   Es wird dringend empfohlen, keine Platzhalter-DNS-Einträge wie z. B. *.example.com zu verwenden. Diese Einträge setzen dich dem unmittelbaren Risiko von Domänenübernahmen aus, selbst wenn du die Domäne überprüft hast. Wenn du beispielsweise example.com überprüfst, verhindert dies die Verwendung von a.example.com, eine Übernahme von b.a.example.com wäre aber (aufgrund des Platzhalter-DNS-Eintrags) weiterhin möglich.

6. Öffne TerminalTerminalGit Bash.

7. Um zu überprüfen, ob dein DNS-Eintrag korrekt konfiguriert ist, verwende den Befehl dig, wobei du WWW.EXAMPLE.COM durch deine Unterdomäne ersetzt.

   $ dig WWW.EXAMPLE.COM +nostats +nocomments +nocmd
   > ;WWW.EXAMPLE.COM.                    IN      A
   > WWW.EXAMPLE.COM.             3592    IN      CNAME   YOUR-USERNAME.github.io.
   > YOUR-USERNAME.github.io.      43192   IN      CNAME   GITHUB-PAGES-SERVER .
   > GITHUB-PAGES-SERVER .         22      IN      A       192.0.2.1
   

8. Wenn du einen Generator für statische Websites verwendest, um deine Website lokal zu erstellen und die generierten Dateien zu GitHub zu pushen, pulle den Commit, durch den die CNAME-Datei zu deinem lokalen Repository hinzugefügt wurde. Weitere Informationen finden Sie unter Problembehandlung für benutzerdefinierte Domänen und GitHub Seiten.

9. Wenn du optional HTTPS-Verschlüsselung für deine Website erzwingen möchtest, wähle HTTPS erzwingen aus. Es kann bis zu 24 Stunden dauern, bis diese Option verfügbar ist. Weitere Informationen finden Sie unter Sichern Ihrer GitHub Seitenwebsite mit HTTPS.

   Hinweis

   Wenn du mit deiner benutzerdefinierten Unterdomäne auf deine Apex-Domäne verweist, treten Probleme beim Erzwingen von HTTPS für deine Website auf, und eventuell erreicht deine Unterdomäne deine GitHub Pages-Site überhaupt nicht.

DNS-Datensätze für Ihre benutzerdefinierte Domäne

Wenn Sie mit dem Konfigurieren Ihrer Domain für eineGitHub Pages-Website vertraut sind, können Sie die nachstehende Tabelle verwenden, um die DNS-Werte für Ihr bestimmtes Szenario und die von Ihrem DNS-Anbieter unterstützten DNS-Eintragstypen zu finden. Weitere Informationen, einschließlich der Konfiguration deiner GitHub Pages-Website auf GitHub und wie du die Konfiguration mit dem Befehl dig überprüfst, findest du in den Abschnitten oben.

Um eine Apex-Domäne zu konfigurieren, füge alle der A- und AAAA-Datensätze aus der nachstehenden Tabelle hinzu, oder füge alternativ nur den Datensatz ALIAS/ANAME aus der Tabelle hinzu. Zum Konfigurieren einer Apex-Domäne und einer www Subdomäne (z. B. example.com und www.example.com) konfigurieren Sie erst die Apex-Domäne und dann die Subdomäne. Weitere Informationen findest du unter Konfigurieren einer Apex-Domäne und der www Variante der Subdomäne.

Szenario	DNS-Eintragstyp	Name des DNS-Eintrags	Wert(e) des DNS-Eintrags
Apex-Domäne (example.com)	A	@	185.199.108.153 185.199.109.153 185.199.110.153 185.199.111.153
Apex-Domäne (example.com)	AAAA	@	2606:50c0:8000::153 2606:50c0:8001::153 2606:50c0:8002::153 2606:50c0:8003::153
Apex-Domäne (example.com)

          `ALIAS` oder `ANAME` | `@` | 
          `USERNAME.github.io` oder<br /> `ORGANIZATION.github.io` |

| Unterdomäne
(www.example.com,
blog.example.com) | CNAME | SUBDOMAIN.example.com. | USERNAME.github.io oder
ORGANIZATION.github.io |

Entfernen einer benutzerdefinierten Domäne

Wenn du die Fehlermeldung erhältst, dass die benutzerdefinierte Domäne bereits woanders existiert, musst du sie möglicherweise aus einem anderen Repository entfernen.

1. Navigiere auf GitHub zum Repository deiner Website.

2. Klicke unter dem Repositorynamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

   

3. Klicke im Abschnitt „Code and automation“ der Randleiste auf Pages.

4. Klicke unter „Benutzerdefinierte Domäne“ auf Entfernen.

   

Sichern deiner benutzerdefinierten Domäne

Wenn deine GitHub Pages-Website deaktiviert ist, aber über eine benutzerdefinierte Domäne verfügt, besteht die Gefahr einer Domänenübernahme. Wenn Du eine benutzerdefinierte Domäne bei Deinem DNS-Provider konfigurierst, während Deine Website deaktiviert ist, könnte ein Dritter eine Website auf einer Deiner Subdomänen hosten.

Durch eine Überprüfung deiner benutzerdefinierten Domäne wird verhindert, dass andere GitHub-Benutzer deine Domäne für ihre Repositorys verwenden. Wenn deine Domäne nicht überprüft wurde und deine GitHub Pages-Website deaktiviert ist, solltest du die DNS-Einträge bei deinem DNS-Anbieter umgehend aktualisieren oder entfernen. Weitere Informationen finden Sie unter Überprüfen Ihrer benutzerdefinierten Domäne für GitHub Seiten.

Weiterführende Lektüre

•         [AUTOTITLE](/pages/configuring-a-custom-domain-for-your-github-pages-site/troubleshooting-custom-domains-and-github-pages)