Domaine personnalisé pour projet GitHub pages
J'ai un gh-pages
branche dans un de mes http://github.com repos. Le projet GitHub pages fonctionne très bien si je vais à http://myuser.github.com/myrepo
Je veux la configuration d'un domaine personnalisé (myexample.com) qui va servir de ce projet pages. Je veux les deux myexample.com
et www.myexample.com
pour servir de ces pages du projet.
GitHub pages d'aide dit de faire Un enregistrement et un enregistrement CNAME dans votre DNS. L'enregistrement du bon sens, mais je ne sais pas ce que l'enregistrement CNAME faire dans mon DNS.
La gh-pages
docs-dire de faire un CNAME
record 'charlie.github.com" qui est la page d'un utilisateur du référentiel. Je n'ai pas la page d'un utilisateur du référentiel - je n'ai qu'un projet de référentiel et d'un gh-pages
direction que je veux utiliser pour myexample.com
et www.myexample.com
.
Je dois faire une page d'utilisateur référentiel juste pour que je puisse utiliser ma page de projet pour www.myexample.com et myexample.com?
Je viens de l'essayer, mais je veux être sûr que cela fonctionne comme je l'ai déjà www.myexample.com vivre et ne veux pas faire une erreur.
J'ai envoyé GitHub soutien et leur réponse a été
Vous ne pouvez pas avoir les deux points de la même gh-pages autant que je sache.
J'ai du mal à croire qu'elles seraient uniquement en charge les dossiers pour les pages du projet.
Quelqu'un a réussi à faire cela avant?
- J'ai mis en place lacewing-project.org avec juste Un enregistrement pointant vers 207.97.227.245 (pas d'enregistrements CNAME), et il fonctionne très bien. J'ai aussi mis un fichier appelé CNAME dans la racine de la gh-pages branche contenant le nom de domaine.
- Dans mon cas, il suffit de placer le fichier CNAME dans gh-pages branche a fait le tour, merci!
Vous devez vous connecter pour publier un commentaire.
1/23/19 mise à JOUR:
Les choses ont un peu changé (pour le mieux) depuis ma dernière réponse. Cette mise à jour de la réponse va vous montrer comment le configurer:
En fin de compte, toutes les demandes de
example.com
serez re-dirigé à https://www.example.com (ou http://si vous choisissez de ne PAS utiliser le protocole HTTPS). J'ai toujours utiliserwww
que ma destination finale. Pourquoi(Un,Deux), est une autre discussion.Cette réponse, c'est long, mais il est pas compliqué. J'ai été détaillé pour plus de clarté que le GitHub docs sur ce sujet ne sont pas claires ou linéaire.
Étape 1: Activer le GitHub pages GitHub paramètres
GitHub Pages
section. Vous avez deux options:master branch
permettra de traiter/README.md
que votre site webindex.html
. Le choix demaster branch /docs folder
permettra de traiter/docs/README.md
que votre site webindex.html
.Your site is ready to be published at
Étape 2: indiquer domaine personnalisé dans GitHub paramètres
Entrez votre nom de domaine personnalisé ici et frapper
save
:C'est une subtile, mais importante étape.
example.com
, puiswww.example.com
redirigeexample.com
www.example.com
, puisexample.com
redirigewww.example.com
.Comme mentionné avant, je recommande toujours à l'atterrissage à l'
www
je suis donc entréewww.example.com
comme sur la photo ci-dessus.Étape 3: Créer des entrées DNS
Dans votre DNS du fournisseur de la console web, la création de quatre
A
de disques et unCNAME
.A
Enregistrements pour@
(aka l'apex de la racine):Certains fournisseurs de DNS vous permettront de vous préciser
@
, d'autres (comme AWS Route35) vous quitter le sous-domaine vide pour indiquer@
. Dans les deux cas, ces sont lesA
enregistrements pour créer:CNAME
record de point http://www.example.com pourYOUR-GITHUB-USERNAME.github.io
.C'est la partie la plus déroutante.
Note le
YOUR-GITHUB-USERNAME
PAS le dépôt GitHub nom! La valeur deYOUR-GITHUB-USERNAME
est déterminé par ce tableau.Pour un pages Utilisateur site (plus probable que vous êtes),
CNAME
entrée serausername.github.io
, ex:Pour un Organisation des pages site,
CNAME
entrée seraorgname.github.io
, ex:Étape 5: Vérifiez les entrées DNS
Confirmer votre
A
enregistrements en cours d'exécutiondig +noall +answer example.com
. Il doit retourner les quatre185.x.x.x
les adresses IP que vous avez entré.Confirme votre
CNAME
record en cours d'exécutiondig www.example.com +nostats +nocomments +nocmd
. Il doit retourner unCNAME YOUR-GITHUB-USERNAME.github.io
Il peut prendre une heure ou deux de ces entrées DNS pour résoudre et de se multiplier. Une fois qu'ils font, ouvrez votre navigateur à
http://example.com
et il devrait re-diriger vershttp://www.example.com
Étape 6: le protocole SSL (HTTPS) de Configuration. Facultatif, mais fortement recommandé
Après vous avez la coutume domaine de travail, revenir à la repo paramètres. Si vous avez déjà la page des paramètres de l'ouvrir, rafraîchissement de la page.
Si il y a un message sous la
Enforce HTTPS
case, indiquant qu'il est toujours en cours de traitement, vous devrez attendre. Vous pouvez aussi avoir besoin de frapper lasave
bouton dans leCustom domain
section pour le coup d'envoi de laEnforce HTTPS
de traitement.Une fois le traitement terminé, il devrait ressembler à ceci:
Suffit de cliquer sur le
Enforce HTTPS
case, et pointez votre navigateur surhttps://example.com
. Il devrait re-directe et ouvertehttps://www.example.com
THATS IT!
GitHub sera automatiquement garder votre HTTPS cert up-to-date ET doit gérer l'apex de
www
rediriger sur HTTPS.Espérons que cette aide!!
...
Ancien (avant 1/23/19) réponse
J'ai donc pensé à elle. James McLaughlin m'a donné le coup de pouce dont j'avais besoin.
De Configuration d'un domaine personnalisé pour un gh-pages Pages du Projet repo qui gère http://www.yourdomain.com et yourdomain.com (suppose que vous avez déjà gh-pages branche sur votre repo):
yourdomain.com
. S'engager ensuite pousser.cname
enregistrements. L'un pour l'apex de la racine (@) et un pour www. Deux points deYOURusername.github.io
. Si votre fournisseur de DNS ne prend PAS en chargeALIAS
dossiers sur l'apex de la racine (@), il suffit de créerA
enregistrements de ce point de192.30.252.153
et192.30.252.154
Attendez jusqu'à ce que le nom de votre serveur de mise à jour:
dig yourdomain.com +nostats +nocomments +nocmd
204.232.175.78
que l'adresse IP.All Host Records
.https://vedantroy.github.io/my-repository-name/
, si mon enregistrement CNAME point devedantroy.github.io
ouvedantroy.github.io/my-repository-name
? Aussi les Domaines de Google donne l'option de nom de au nom de domaine. Je viens de nomméwww
. Savez-vous si c'est correct?Aperçu
La la documentation est un peu confus quand il s'agit de pages du projet, par opposition à pages utilisateur. Il se sent comme vous ne devrait avoir à faire plus, mais en réalité, le processus est très simple.
Qu'elle implique:
Ce que vous obtiendrez
Votre contenu sera servi à partir d'une URL de la forme http://nicholasjohnson.com.
Visite http://www.nicholasjohnson.com sera de retour une redirection 301 de la nu de domaine.
Le chemin sera respecté par la redirection, donc la circulation de http://www.nicholasjohnson.com/angular serez redirigé vers http://nicholasjohnson.com/angular.
Vous pouvez avoir une page de projet par dépôt, donc si votre repos sont ouverts, vous pouvez en avoir autant que vous le souhaitez.
Voici le processus:
1. Créer des enregistrements
Pour les enregistrements A, point @ pour les adresses ip suivantes:
Ce sont statiques Github adresses IP à partir de laquelle votre contenu sera servi.
2. Créer un Enregistrement CNAME
Pour l'enregistrement CNAME, point www à nomutilisateur.github.io. Remarque la fuite arrêt complet. A noter également, c'est le nom de l'utilisateur, pas le nom du projet. Vous n'avez pas besoin de spécifier le nom de projet encore. Github va utiliser le CNAME fichier pour déterminer quel projet pour servir de contenu.
par exemple
Le but de l'enregistrement CNAME est de rediriger tous les sous-domaine www trafic vers un GitHub page de redirection 301 de la nu de domaine.
Voici une capture d'écran de la configuration que j'utilise pour mon propre site http://nicholasjohnson.com:
3. Créer un enregistrement CNAME fichier
Ajouter un fichier CNAME pour votre projet racine dans le gh-pages de la branche. Cela devrait contenir le nom de domaine que vous souhaitez servir. Assurez-vous de vous engager et de pousser.
par exemple
Ce fichier indique à GitHub pour utiliser ce repo pour gérer le trafic vers ce domaine.
4. Attendre
Maintenant, attendez 5 minutes, votre projet page doit maintenant être en direct.
yourUserName.github.io.
forwardadvance.github.io.
?CNAME fichier sur gh-pages branche aura une ligne:
www.mydomain.com
(au lieu demydomain.com
)Peu importe votre préférence sur la redirection (en d'autres mots, peu importe ce qui est dans votre fichier CNAME sur le gs-pages branche), avec votre fournisseur de DNS, vous devez le configurer comme ceci:
Réponse courte
Ces explications détaillées sont grands, mais les OP (et mon) confusion pourrait être résolu par une phrase: "DNS Direct à votre GitHub nom d'utilisateur ou organisation, ignorant les spécificités du projet, et ajouter les CNAME fichiers dans votre projet dépôts GitHub vous enverrons le bon DNS vers la droite sur la base du projet fichiers dans le respository."
De Aug 29, 2013, De Github documentation affirment:
username.github.io/projectname
àwww.projectname.com
.Les choses sont beaucoup plus facile de nos jours!
Je viens de découvrir, après un peu de frustration, que si vous êtes en utilisant PairNIC, tout ce que vous avez à faire est d'activer le "Transfert Web" sous "DNS Personnalisés" et fournir le nom d'utilisateur.github.io/projet d'adresse et il sera automatiquement mis en place à la fois le sommet et de sous-domaine des documents pour vous. Il semble faire exactement ce qui est suggéré dans la accepté de répondre. Cependant, il ne vous laisse pas faire exactement la même chose en ajoutant manuellement des enregistrements. Très étrange. De toute façon, il m'a fallu un certain temps pour comprendre que, alors j'ai pensé que je devais partager pour sauver tout le monde la peine.
J'aimerais partager pas qui est un peu différent de ce que proposés par rynop et superluminary.
A
Enregistrement est exactement le même, maisCNAME
pourwww
je préfère le rediriger vers mon vide de domaine (non-www
)Cette configuration fait référence à l'orientation de domaine préféré. Le paramètre de domaine
www
ànon www
ou vice versa peut être différente sur chacun des fournisseurs de domaine. Depuis mon domaine est en vertu de GoDaddy, dans le cadre de la Paramètre de Domaine je l'ai installé à l'aide de la Sous-Domaine Redirection (301).Comme le résultat de pointer le domaine sur Github, il donnera alors toutes les Url pour les deux
master
etgh-pages
branche similaire comme ceux que j'ai énumérés ci-dessous va pour le domaine privilégié:maître
Par la création de
CNAME
fichier surmaster
branche (vérifier sur mon user repository).gh-pages
Par la création d'un même
CNAME
fichier surgh-pages
branche (vérifier sur mon référentiel de projet).Que plus de la
CNAME
fichier ci-dessus, vous devrez peut-être complètement bypass Jekyll traitement sur GitHub Pages en créant un fichier nommé.nojekyll
dans la racine de vos pages repo.