GitHub Pages mit eigener Domain: DNS, Verifizierung und HTTPS
Kurz gesagt: GitHub Pages eignet sich gut für schlanke, statische Websites, etwa eine Vereinsseite, eine Projektseite oder eine einfache Firmenpräsenz. Mit einer eigenen Domain wirkt das Ganze professionell, die Einrichtung hat aber einige Stolpersteine. Die Reihenfolge ist wichtig: Laut GitHub-Dokumentation tragen Sie die Domain zuerst in den Repository-Einstellungen ein und richten erst danach die DNS-Einträge bei Ihrem Domain-Anbieter ein. Für die Hauptdomain setzen Sie A-Einträge auf die vier IP-Adressen von GitHub Pages, für www einen CNAME auf Ihre github.io-Adresse. Verifizieren Sie die Domain, verzichten Sie auf Wildcard-Einträge und aktivieren Sie HTTPS, sobald die Option verfügbar ist.
Warum die Reihenfolge zählt
GitHub weist ausdrücklich darauf hin: Wer die DNS-Einträge bei seinem Anbieter setzt, ohne die Domain vorher in GitHub einzutragen, riskiert, dass jemand anderer eine Website auf einer Ihrer Subdomains betreibt. Die DNS-Einträge zeigen dann auf GitHub, aber GitHub weiss nicht, dass die Domain zu Ihrem Repository gehört.
Zusätzlich empfiehlt GitHub, die Domain zu verifizieren, bevor Sie sie im Repository eintragen. Damit kann niemand anderer die Domain in einem fremden Repository verwenden.
Passt GitHub Pages zu Ihrem Vorhaben?
Bevor Sie Zeit in die Domain investieren, lohnt sich eine kurze Prüfung. GitHub Pages liefert statische Dateien aus, also fertige HTML-Seiten, Bilder und Stildateien. Das passt gut zu:
- Vereins- und Projektseiten mit wenigen, selten geänderten Inhalten,
- Dokumentationen und Handbüchern für Kundinnen und Partner,
- einfachen Firmenpräsenzen, die mit einem Generator für statische Seiten erstellt werden.
Weniger geeignet ist es, wenn Sie serverseitige Funktionen brauchen, etwa einen Shop mit Warenkorb, ein Kundenkonto oder eine Datenbank. Kontaktformulare lassen sich nur über externe Dienste anbinden. Klären Sie ausserdem, wer im Team künftig Inhalte ändert. Wer mit Git und Markdown nicht vertraut ist, braucht eine einfache Anleitung oder eine Person, die Änderungen übernimmt.
Schritt 1: Domain verifizieren
Laut GitHub-Dokumentation funktioniert die Verifizierung über einen TXT-Eintrag:
- Öffnen Sie in den Einstellungen Ihres GitHub-Kontos oder Ihrer Organisation den Bereich für Pages.
- Fügen Sie die Domain hinzu. GitHub zeigt Ihnen einen TXT-Eintrag mit einem Namen, der mit _github-pages-challenge beginnt.
- Legen Sie diesen TXT-Eintrag bei Ihrem Domain-Anbieter an.
- Warten Sie, bis der Eintrag sichtbar ist. Laut GitHub kann das sofort gehen oder bis zu 24 Stunden dauern.
- Bestätigen Sie die Verifizierung in GitHub.
Lassen Sie den TXT-Eintrag danach stehen. Er belegt weiterhin, dass die Domain Ihnen gehört.
Schritt 2: Domain im Repository eintragen
Öffnen Sie das Repository Ihrer Website, gehen Sie in die Einstellungen und dort zu Pages. Tragen Sie unter „Custom domain“ Ihre Domain ein und speichern Sie.
Laut GitHub entsteht dabei eine Datei namens CNAME im Hauptverzeichnis des Zweigs, aus dem die Seite veröffentlicht wird. Wenn Sie stattdessen über einen eigenen GitHub-Actions-Workflow veröffentlichen, wird keine solche Datei erzeugt, und eine vorhandene wird ignoriert.
Schritt 3: DNS-Einträge setzen
Jetzt richten Sie die Einträge bei Ihrem Domain-Anbieter ein.
Für die Hauptdomain, also beispielhaft muster.ch: Laut GitHub legen Sie A-Einträge für diese vier Adressen an:
- 185.199.108.153
- 185.199.109.153
- 185.199.110.153
- 185.199.111.153
Optional kommen AAAA-Einträge für IPv6 dazu, die GitHub ebenfalls in der Dokumentation nennt. Alternativ erlauben manche Anbieter ALIAS- oder ANAME-Einträge. Hat Ihr Anbieter automatisch einen Standard-Eintrag angelegt, etwa für eine Parkseite, entfernen Sie ihn laut GitHub zuerst.
Für www: Legen Sie einen CNAME-Eintrag an, der www.muster.ch auf Ihre github.io-Adresse zeigt, also benutzername.github.io oder organisation.github.io. Laut GitHub muss er direkt dorthin zeigen, ohne den Namen des Repositorys.
GitHub empfiehlt, bei einer Hauptdomain zusätzlich www einzurichten. Sind beide Einträge korrekt, leitet GitHub Pages automatisch zwischen beiden Varianten um, und zwar auf die, die Sie im Repository eingetragen haben.
Schritt 4: Keine Wildcard-Einträge
GitHub rät dringend von Wildcard-Einträgen wie *.muster.ch ab. Sie bergen laut Dokumentation ein unmittelbares Risiko der Übernahme von Subdomains, auch wenn die Hauptdomain verifiziert ist. Prüfen Sie deshalb, ob Ihr Domain-Anbieter einen solchen Eintrag voreingestellt hat, und entfernen Sie ihn, wenn Sie ihn nicht ausdrücklich brauchen.
Schritt 5: HTTPS erzwingen
Sobald die DNS-Einträge greifen, können Sie in den Pages-Einstellungen „Enforce HTTPS“ aktivieren. Laut GitHub kann es bis zu 24 Stunden dauern, bis diese Option verfügbar ist. Ist sie nach dieser Zeit noch ausgegraut, liegt meist ein Fehler in den DNS-Einträgen vor.
Einträge prüfen
Mit dem Befehl dig können Sie prüfen, ob die Einträge korrekt gesetzt sind. Laut GitHub ist dig unter Windows nicht enthalten. Dort hilft der PowerShell-Befehl Resolve-DnsName. Prüfen Sie:
- Liefert die Hauptdomain genau die vier Adressen von GitHub?
- Zeigt www auf Ihre github.io-Adresse?
- Gibt es zusätzliche, alte Einträge, die stören, etwa noch vom früheren Hoster?
Bedenken Sie, dass DNS-Änderungen laut GitHub bis zu 24 Stunden brauchen können, bis sie überall sichtbar sind.
Typische Fehler
- DNS-Einträge gesetzt, bevor die Domain im Repository eingetragen wurde.
- Alte A-Einträge des früheren Hosters zusätzlich zu den neuen stehen gelassen.
- CNAME für www zeigt auf benutzername.github.io/repository statt nur auf benutzername.github.io.
- Wildcard-Eintrag vom Anbieter übernommen.
- Nach dem Wechsel auf einen Actions-Workflow erwartet, dass die CNAME-Datei weiterhin wirkt.
Ein Beispiel zur Veranschaulichung
Frei erfunden: Ein Ruderclub aus Luzern stellt seine Website auf eine statische Seite bei GitHub Pages um. Der Vorstand trägt beim Domain-Anbieter zuerst die A-Einträge ein und wundert sich, dass HTTPS nicht aktivierbar ist. Bei der Prüfung zeigt sich, dass ein alter A-Eintrag des früheren Hosters noch aktiv ist. Nach dem Entfernen, der Verifizierung über den TXT-Eintrag und einem Tag Wartezeit lässt sich HTTPS erzwingen, und muster.ch leitet sauber auf www weiter.
Häufige Fragen
Funktioniert GitHub Pages mit privaten Repositorys?
Laut GitHub steht Pages bei kostenlosen Konten für öffentliche Repositorys zur Verfügung. Für private Repositorys ist ein kostenpflichtiger Tarif nötig. Prüfen Sie die aktuellen Bedingungen bei GitHub.
Muss ich beide Varianten, mit und ohne www, einrichten?
GitHub empfiehlt es. So erreichen Besucher Ihre Seite unabhängig davon, welche Variante sie eintippen.
Kann ich die Domain später wieder entfernen?
Ja. Entfernen Sie zuerst die DNS-Einträge, die auf GitHub zeigen, oder richten Sie sie auf den neuen Hoster ein, und löschen Sie danach die Domain in den Pages-Einstellungen. So bleibt kein Eintrag zurück, der ins Leere zeigt.
Warum ist „Enforce HTTPS“ ausgegraut?
Meist sind die DNS-Einträge noch nicht vollständig sichtbar oder fehlerhaft. Laut GitHub kann es bis zu 24 Stunden dauern, bis die Option erscheint.
Wenn Sie Ihre statische Website mit eigener Domain sicher auf GitHub Pages bringen möchten, gehen wir die Einrichtung gerne gemeinsam durch: Domain-Einrichtung anfragen.