Eine benutzerdefinierte Domain für Ihre GitHub Pages-Website verwalten

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

Informationen zur Konfiguration einer benutzerdefinierten Domain

Nehmen Sie die benutzerdefinierte Domain zunächst in die GitHub Pages-Website auf, bevor Sie die benutzerdefinierte Domain bei Ihrem DNS-Provider konfigurieren. 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 Subdomain konfigurieren

Zum Einrichten einer www- oder benutzerdefinierten Subdomain wie www.example.com oder blog.example.com erstellen Sie eine CNAME-Datei im Repository Ihrer Website, und konfigurieren Sie einen CNAME-Datensatz bei Ihrem 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. Navigieren Sie zu Ihrem DNS-Provider, und erstellen Sie einen CNAME Datensatz, mit dem Ihre Subdomain auf die Standarddomain Ihrer Website verweist. Soll beispielsweise die Subdomain www.example.com für Ihre Benutzer-Website verwendet werden, erstellen Sie einen CNAME-Datensatz, mit dem www.example.com auf <user>.github.io 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 „Über GitHub Pages."
5. Öffne TerminalTerminalGit Bash.
6. Prüfen Sie die korrekte Konfiguration des DNS-Datensatzes mit dem Befehl dig, und ersetzen Sie WWW.EXAMPLE.COM dabei durch Ihre Subdomain.

   $ 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 findest Du unter „Deine GitHub Pages-Website mit HTTPS schützen.“
   

Eine Apex-Domain konfigurieren

Zum Einrichten einer Apex-Domain, beispielsweise example.com, müssen Sie eine CNAME-Datei in Ihrem GitHub Pages-Repository sowie einen ALIAS-, ANAME- oder A-Eintrag bei Ihrem 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. Navigieren Sie zu Ihrem DNS-Provider, und erstellen Sie 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, verweisen Sie Ihre Apex-Domain auf die Standarddomain Ihrer 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üfen Sie die korrekte Konfiguration des DNS-Datensatzes mit dem Befehl dig, und ersetzen Sie EXAMPLE.COM dabei durch Ihre Apex-Domain. Prüfen Sie, 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 findest Du unter „Deine GitHub Pages-Website mit HTTPS schützen.“
   

Weiterführende Informationen

• „Fehlerbehebung bei benutzerdefinierten Domains und GitHub Pages“