Benutzerdefinierte Domain für GitHub-Projektseiten

Überblick

Die Dokumentation ist ein wenig verwirrend, wenn es um Projektseiten geht , im Gegensatz zu Benutzerseiten . Es fühlt sich an, als müssten Sie mehr tun, aber der Prozess ist sehr einfach.

Es involviert:

1. Einrichten von 2 statischen A-Einträgen für die Naked-Domain (kein WWW).
2. Erstellen eines CNAME-Eintrags für www, der auf eine GitHub-URL verweist. Dies erledigt die WWW-Umleitung für Sie.
3. Erstellen Sie eine Datei mit dem Namen CNAME (mit Großbuchstaben) in Ihrem Projektstamm im Zweig gh-pages. Dies teilt Github mit, auf welche URL zu antworten ist.
4. Warten Sie, bis sich alles verbreitet hat.

Was du bekommen wirst

Ihr Inhalt wird über eine URL der Form http://nicholasjohnson.com bereitgestellt.

Wenn Sie http://www.nicholasjohnson.com besuchen, wird eine 301-Weiterleitung an die nackte Domain zurückgegeben.

Der Pfad wird von der Umleitung beachtet, sodass der Verkehr zu http://www.nicholasjohnson.com/angular zu http://nicholasjohnson.com/angular umgeleitet wird .

Sie können eine Projektseite pro Repository haben. Wenn Ihre Repos also geöffnet sind, können Sie so viele haben, wie Sie möchten.

Hier ist der Prozess:

1. Erstellen Sie einen Datensatz

Zeigen Sie für die A-Datensätze mit @ auf die folgenden IP-Adressen:

@: 185.199.108.153
@: 185.199.109.153
@: 185.199.110.153
@: 185.199.111.153

Dies sind die statischen Github-IP-Adressen, über die Ihre Inhalte bereitgestellt werden.

2. Erstellen Sie einen CNAME-Eintrag

Zeigen Sie für den CNAME-Eintrag www auf yourusername.github.io. Beachten Sie den nachlaufenden Punkt. Beachten Sie auch, dass dies der Benutzername ist, nicht der Projektname . Sie müssen den Projektnamen noch nicht angeben. Github verwendet die CNAME-Datei , um zu bestimmen, aus welchem ​​Projekt Inhalte bereitgestellt werden sollen.

z.B.

www: forwardadvance.github.io.

Der Zweck des CNAME besteht darin, den gesamten Datenverkehr der WWW-Subdomain auf eine GitHub-Seite umzuleiten, die 301 zur nackten Domain umleitet.

Hier ist ein Screenshot der Konfiguration, die ich für meine eigene Site verwende http://nicholasjohnson.com :

3. Erstellen Sie eine CNAME-Datei

Fügen Sie Ihrem Projektstamm im Zweig gh-pages eine Datei mit dem Namen CNAME hinzu. Dies sollte die Domain enthalten, die Sie bedienen möchten. Stellen Sie sicher, dass Sie festschreiben und Push.

z.B.

nicholasjohnson.com

Diese Datei weist GitHub an, dieses Repo zu verwenden, um den Datenverkehr zu dieser Domain zu verarbeiten.

4. Warten Sie

Warten Sie nun 5 Minuten, Ihre Projektseite sollte nun online sein.

Wenn Sie sich fragen, wie Ihre Domain als www.mydomain.com Angezeigt werden soll, anstatt die www -Anforderung an mydomain.com Umzuleiten, versuchen Sie Folgendes:

CNAME-Datei auf gh-pages Zweig wird eine Zeile haben:

www.mydomain.com (Anstelle von mydomain.com)

Egal, wie Sie die Umleitung bevorzugen (mit anderen Worten, egal, was sich in Ihrer CNAME-Datei im gs-pages-Zweig befindet), mit Ihrem DNS-Provider sollten Sie dies folgendermaßen einrichten:

A      @    192.30.252.154
A      @    192.30.252.153
CNAME  www  username.github.io

Kurze Antwort

Diese detaillierten Erklärungen sind großartig, aber die (und meine) Verwirrung des OP könnte mit einem Satz behoben werden: "Direktes DNS zu Ihrem GitHub -Nutzernamen oder Organisation, Ignorieren des spezifischen Projekts und Hinzufügen der entsprechenden CNAME -Dateien in Ihren Projekt-Repositorys: GitHub sendet das richtige DNS an das richtige Projekt basierend auf Dateien im -Repository. "

Ab dem 29. August 2013 Githubs Dokumentation behaupten, dass:

Warnung: Projektseiten-Unterpfade wie http://username.github.io/projectname werden nicht an die benutzerdefinierte Domäne eines Projekts umgeleitet.

Heutzutage ist es viel einfacher!

1. Aktualisieren Sie Ihren Apex-Domain-Eintrag (@) so, dass er anzeigt

192.30.252.154

192.30.252.153

2. Bearbeiten Sie Ihr Custome-Domain-Feld in Ihren Github-Repo-Einstellungen.

3. www und andere Subdomains können als CNAME auf die Apex-Domain aktualisiert werden.

Nach einigem Frust habe ich festgestellt, dass Sie bei Verwendung von PairNIC lediglich die Einstellung "Web Forwarding" unter "Custom DNS" aktivieren und den Benutzernamen.github angeben müssen. io/project address und es werden automatisch sowohl die Apex- als auch die Subdomain-Datensätze für Sie eingerichtet. Es scheint genau das zu tun, was in der akzeptierten Antwort vorgeschlagen wird. Sie können jedoch nicht genau dasselbe tun, indem Sie Datensätze manuell hinzufügen. Sehr eigenartig. Wie auch immer, es dauerte eine Weile, bis ich das herausgefunden hatte, also dachte ich, ich würde es teilen, um allen anderen die Mühe zu ersparen.

Ich möchte meine Schritte mitteilen, was ein bisschen anders ist als das, was rynop und superluminary bieten .

• für A Record ist aber genau das gleiche
• anstatt CNAME für www zu erstellen, würde ich es vorziehen, es auf meine leere Domain umzuleiten (non-www)

Diese Konfiguration bezieht sich auf die Anleitung von Bevorzugte Domain . Die Domain-Einstellung von www auf non www Oder umgekehrt kann bei jedem Domain-Provider unterschiedlich sein. Da sich meine Domain unter GoDaddy befindet, setze ich sie unter Domain Setting mit Subdomain Forwarding (301).

Als Ergebnis des Verweises der Domain auf das Github-Repository werden dann alle URLs für die beiden Zweige master und gh-pages Angegeben, ähnlich wie die, die ich unten aufgeführt habe, für die bevorzugte Domain:

Meister

Indem Sie eine CNAME -Datei in der master-Verzweigung erstellen (überprüfen Sie diese in meinem user repository ).

http://hyipworld.github.io/
http://www.hyip.world/
http://hyip.world/

gh-pages

Indem Sie dieselbe CNAME -Datei in der gh-pages - Verzweigung erstellen (überprüfen Sie sie in meinem Projekt-Repository ).

http://hyipworld.github.io/maps/
http://www.hyip.world/maps/
http://hyip.world/maps/

Zusätzlich zu der obigen CNAME -Datei müssen Sie möglicherweise Jekyll-Verarbeitung umgehen auf GitHub-Seiten erstellen, indem Sie eine Datei mit dem Namen .nojekyll im Stammverzeichnis Ihrer Seiten repo.