Wie verbinde ich meine Domain mit GitHub Pages?

Was brauche ich, bevor ich eine Domain mit GitHub Pages verbinde?

DotAlmanac ist ein Ratgeber für Domain-Endungen und Registrar: Vergleichen Sie jede Endung und registrieren Sie sie dann ohne KYC mit Krypto bezahlt. Für diese Anleitung brauchen Sie drei Dinge.

• Eine Domain auf den Nameservern von DotAlmanac. Im Tab Nameserver der Domain muss „Unsere Nameserver“ stehen. Nutzt die Domain andere Nameserver, tragen Sie dieselben Einträge bei diesem DNS-Anbieter ein.
• Ein Repository mit aktiviertem GitHub Pages. Es kann aus einem Branch oder aus einem GitHub-Actions-Workflow veröffentlichen.
• Ihren GitHub-Benutzer- oder Organisationsnamen. Er kommt in den www-Eintrag. Der Repository-Name niemals.

Viele Entwickler wählen .dev oder .app für eine Projektseite. Prüfen Sie zuerst die Verlängerung: Laut dem Preisraster von DotAlmanac liegt die Verlängerung von .dev 44 % über dem Erstjahrespreis und die von .app 67 % darüber, Stand 29. Oktober 2026. Eine .dev kostet 8,99 $/Jahr, dann 12,99 $/Jahr. Beide Endungen benötigen HTTPS, das GitHub Pages bereitstellt. Vergleichen Sie sie auf .app vs .dev.

Kann ich die Einträge stattdessen als Zonendatei einfügen?

Ja. Öffnen Sie DNS › Import / Export › Zonendatei importieren, wählen Sie „Zu vorhandenen Einträgen hinzufügen“ und fügen Sie die untenstehenden Zeilen ein. Ersetzen Sie octocat durch Ihren eigenen Benutzernamen. Der Import liest die Standard-BIND-Syntax, zeigt eine Vorschau an und sendet nichts, bevor Sie speichern.

@    3600  IN  A      185.199.108.153
@    3600  IN  A      185.199.109.153
@    3600  IN  A      185.199.110.153
@    3600  IN  A      185.199.111.153
@    3600  IN  AAAA   2606:50c0:8000::153
@    3600  IN  AAAA   2606:50c0:8001::153
@    3600  IN  AAAA   2606:50c0:8002::153
@    3600  IN  AAAA   2606:50c0:8003::153
www  3600  IN  CNAME  octocat.github.io.

Soll ich die Domain ohne www oder www mit GitHub Pages verwenden?

Richten Sie beides ein und tragen Sie die Variante, die Sie bevorzugen, im Repository ein. Wenn die Einträge der Apex-Domain und von www korrekt sind, leitet GitHub Pages die jeweils andere dorthin weiter.

GitHub unterstützt eine Apex-Domain oder einen www-Namen pro Website. Es unterstützt nicht zwei Apex-Domains, zwei www-Namen oder eine Apex-Domain zusammen mit einer anderen benutzerdefinierten Subdomain. Für ein Projekt auf einer Subdomain wie docs.example.com fügen Sie einen CNAME von docs nach USERNAME.github.io hinzu und lassen die A-Einträge weg.

Wie lange dauert es, bis meine Domain auf GitHub Pages funktioniert?

Das hängt von der TTL der Einträge ab, die Resolver vor Ihrer Änderung gesehen haben. Die TTL ist die Anzahl der Sekunden, die ein Resolver eine Antwort im Cache behält.

• Ein Name ohne vorherigen Eintrag löst auf, sobald Sie speichern.
• Ein ersetzter Eintrag behält seinen alten Wert in manchen Caches, bis seine alte TTL abläuft. Die Vorlagen-Einträge verwenden 3600 Sekunden, also eine Stunde.
• Planen Sie einen Umzug voraus: Senken Sie die TTL der alten Einträge einen Tag vor der Änderung auf 300 Sekunden.

Die Dokumentation von GitHub selbst besagt, dass DNS-Änderungen bis zu 24 Stunden zur Verbreitung brauchen können. Das HTTPS-Zertifikat kommt erst, nachdem die DNS-Prüfung erfolgreich war.

Warum meldet GitHub, dass meine Domain nicht richtig konfiguriert ist?

Meistens antwortet noch ein alter Eintrag für denselben Namen. Prüfen Sie diese Punkte der Reihe nach:

• Übrig gebliebene Einträge. Ein alter A-, AAAA- oder ALIAS-Eintrag bei @ oder ein Parking-Eintrag konkurriert mit denen von GitHub. Die Vorlage entfernt sie; bei manuellen Änderungen bleibt oft einer übrig.
• Repository-Name im CNAME. Das www-Ziel ist ausschließlich USERNAME.github.io.
• Wildcard-Eintrag. GitHub warnt, dass ein Eintrag wie *.example.com das Risiko einer Domain-Übernahme schafft. Löschen Sie ihn.
• Andere Nameserver. Wenn die Domain einen anderen DNS-Anbieter nutzt, werden die Einträge im DNS-Tab von DotAlmanac nicht ausgeliefert.
• CAA-Einträge. Wenn Sie CAA-Einträge veröffentlichen, verlangt GitHub mindestens einen mit dem Wert letsencrypt.org für HTTPS.

Testen Sie das Ergebnis mit dig example.com +short oder einer beliebigen Online-DNS-Abfrage.