Eine benutzerdefinierte Domäne für Deine GitHub Pages-Website verwalten

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 Sie Ihre benutzerdefinierte Domain bei Ihrem DNS-Provider konfigurieren, ohne Ihre benutzerdefinierte Domain zu GitHub hinzuzufügen, könnte ein Dritter eine Website auf einer Ihrer Subdomains hosten.

Eine Subdomäne konfigurieren

Zum Einrichten einer www- oder benutzerdefinierten Subdomäne wie www.example.com oder blog.example.com erstelle eine CNAME-Datei im Repository Deiner Website, und konfiguriere einen CNAME-Datensatz bei Deinem DNS-Provider.

1. Navigiere in GitHub zum Repository Deiner Website.
2. Klicke unter Deinem Repository-Namen auf Settings (Einstellungen).
   
3. Unter „Custom domain" (Benutzerdefinierte Domäne) gibst Du Deine benutzerdefinierte Domäne ein, dann klicke auf Save (Speichern). Dadurch wird eine Commit erzeugt, der eine CNAME-Datei im Stammverzeichnis Deiner Veröffentlichungsquelle hinzufügt.
   
4. Navigiere zu Deinem DNS-Provider, und erstelle einen CNAME Datensatz, welcher Deine Subdomäne auf die Standarddomäne Deiner Website verweist. Soll beispielsweise die Subdomäne www.example.com für Deine Benutzer-Website verwendet werden, erstelle einen CNAME-Datensatz, mit dem www.example.com auf <user>.github.io verweist. If you want to use the subdomain www.anotherexample.com for your organization site, create a CNAME record that points www.anotherexample.com to <organization>.github.io. The CNAME file should always point to <user>.github.io or <organization>.github.io, excluding the repository name. 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 „Über GitHub Pages."
5. Öffne TerminalTerminalGit Bash.
6. Prüfe die korrekte Konfiguration des DNS-Datensatzes mit dem Befehl dig, und ersetze WWW.EXAMPLE.COM dabei durch Deine Subdomäne.

   $ 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

7. Wenn Du einen Generator für statische Websites verwendest, um Deine Website lokal zu erstellen und die erstellen Dateien nach GitHub zu veröffentlichen, rufe den Commit ab, der die CNAME Datei zu Deinem lokalen Repository hinzugefügt hat. Weitere Informationen findest Du unter „Problembehandlung benutzerdefinierter Domänen und GitHub Pages."
8. Um die HTTPS-Verschlüsselung für Ihre Website zu erzwingen, wähle optional Enforce HTTPS (HTTPS erzwingen) aus. Es kann bis zu 24 Stunden dauern, bis diese Option verfügbar ist. Weitere Informationen finden Sie unter „Ihre GitHub Pages-Website mit HTTPS schützen“.
   

Eine Apex-Domäne konfigurieren

Zum Einrichten einer Apex-Domäne, beispielsweise example.com, musst Du eine CNAME-Datei in Deinem GitHub Pages-Repository sowie einen ALIAS-, ANAME- oder A-Eintrag bei Deinem DNS-Provider konfigurieren.

Wenn Du eine Apex-Domäne als Deine benutzerdefinierte Domäne verwendest, empfehlen wir, auch eine www-Subdomä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 Deine benutzerdefinierte Domäne für Deine Website konfigurierst und ALIAS- and CNAME-Datensätze für die apex- and www-Domänen eingerichtet hast, dann wird example.com auf www.example.com umleiten. Weitere Informationen findest Du unter „Verwalten einer benutzerdefinierten Domäne für Deine GitHub Pages-Website."

1. Navigiere in GitHub zum Repository Deiner Website.
2. Klicke unter Deinem Repository-Namen auf Settings (Einstellungen).
   
3. Unter „Custom domain" (Benutzerdefinierte Domäne) gibst Du Deine benutzerdefinierte Domäne ein, dann klicke auf Save (Speichern). Dadurch wird eine Commit erzeugt, der eine CNAME-Datei im Stammverzeichnis Deiner Veröffentlichungsquelle hinzufügt.
   
4. Navigiere zu Deinem DNS-Provider, und erstelle entweder einen ALIAS-, einen ANAME- oder einen A-Datensatz. Weitere Informationen zum Erstellen des richtigen Datensatzes findest Du in der Dokumentation Ihres DNS-Anbieters.
   • Soll ein ALIAS- oder ANAME-Datensatz erstellt werden, verweise Deine Apex-Domäne auf die Standarddomäne Deiner Website. Weitere Informationen zur Standarddomäne für Deine Website findest Du unter „Über GitHub Pages."
   • Soll ein A-Datensatz erstellt werden, verweisen Sie Ihre Apex-Domain auf die IP-Adressen für GitHub Pages.

     185.199.108.153
     185.199.109.153
     185.199.110.153
     185.199.111.153

5. Öffne TerminalTerminalGit Bash.
6. Prüfe die korrekte Konfiguration des DNS-Datensatzes mit dem Befehl dig, und ersetze EXAMPLE.COM dabei durch Deine Apex-Domäne. Prüfe, ob die Ergebnisse mit den obigen IP-Adressen für GitHub Pages übereinstimmen.

   $ dig EXAMPLE.COM +noall +answer
   > 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

7. Wenn Du einen Generator für statische Websites verwendest, um Deine Website lokal zu erstellen und die erstellen Dateien nach GitHub zu veröffentlichen, rufe den Commit ab, der die CNAME Datei zu Deinem lokalen Repository hinzugefügt hat. Weitere Informationen findest Du unter „Problembehandlung benutzerdefinierter Domänen und GitHub Pages."
8. Um die HTTPS-Verschlüsselung für Ihre Website zu erzwingen, wähle optional Enforce HTTPS (HTTPS erzwingen) aus. Es kann bis zu 24 Stunden dauern, bis diese Option verfügbar ist. Weitere Informationen finden Sie unter „Ihre GitHub Pages-Website mit HTTPS schützen“.
   

Weiterführende Informationen

• „Fehlerbehebung bei benutzerdefinierten Domänen und GitHub Pages“