GitHub Pages: безплатен сайт от хранилище и собствен домейн

01Какво позволява безплатният план

С GitHub Free можете да публикувате Pages само от публични хранилища. За частни трябват планове Pro, Team или Enterprise. Ограниченията по документацията:

„Мек лимит“ значи, че GitHub може да ви пише или да ограничи сайта, ако го надхвърляте трайно, а не че спира веднага. Колко тежи сайтът ви, вижте с теглото на сайта.

02За какво не е позволено

Документацията казва, че GitHub Pages не е предвиден и не е позволен като безплатна уеб хостинг услуга за онлайн бизнес, електронна търговия или сайтове, създадени главно за търговски сделки или софтуер като услуга. Не е и за чувствителни данни като пароли или номера на карти.

Сайт-визитка на фирма, документация на продукт или лично портфолио са в рамките на предназначението. Онлайн магазин с количка и плащания не е – за него вижте споделен хостинг, VPS или облак.

03Публично хранилище: какво значи това за вас

Щом хранилището е публично, всеки може да види не само сайта, но и изходния код и цялата история на промените. Ако веднъж качите файл с парола или ключ, изтриването му в следваща промяна не стига – той остава в историята. Затова пазете в хранилището само това, което и без това ще е публично на сайта.

Има два вида сайтове. Личен сайт е хранилище с име потребител.github.io и се отваря на https://потребител.github.io/. Сайт на проект е всяко друго хранилище и се отваря на https://потребител.github.io/хранилище/. И двата могат да получат собствен домейн.

04Собствен домейн: кои записи

Препоръчително е първо да потвърдите домейна в настройките на профила (Profile settings → Pages, не в хранилището): GitHub ви дава TXT запис с име _github-pages-challenge-ПОТРЕБИТЕЛ. Потвърждението пречи на друг потребител да заеме домейна, ако например изтриете хранилището. Оставете TXT записа и след проверката.

После в хранилището, в Settings → Pages → Custom domain, въвеждате домейна и записвате. При DNS доставчика си добавяте:

• за www.example.bg: CNAME към потребител.github.io (без името на хранилището);
• за example.bg: ALIAS/ANAME към потребител.github.io, ако доставчикът ви го поддържа, или четири A записа: 185.199.108.153, 185.199.109.153, 185.199.110.153, 185.199.111.153;
• по желание AAAA записи за IPv6: 2606:50c0:8000::153 до 2606:50c0:8003::153.

Не ползвайте wildcard записи (*.example.bg) – GitHub предупреждава, че те оставят поддомейните отворени за превземане. Промените в DNS може да отнемат до 24 часа. Проверете записите с DNS проверката.

05HTTPS и пренасочванията

След като домейнът е записан, GitHub проверява DNS и сам иска сертификат от Let's Encrypt. Отметката Enforce HTTPS може да се появи до 24 часа по-късно – включете я, за да се пренасочва http:// към https://. Пълното име на домейна трябва да е под 64 знака.

Ако сте задали и A записите за голия домейн, и CNAME за www, GitHub сам пренасочва между двата към този, който сте въвели като собствен домейн. Файл за собствени пренасочвания като _redirects при Cloudflare Pages или Netlify в документацията на GitHub Pages не е описан. Възможностите са:

• плъгинът jekyll-redirect-from, който е сред поддържаните от GitHub Pages плъгини, ако сайтът се строи с Jekyll;
• страница с <meta http-equiv="refresh" content="0;url=https://example.bg/novo/"> на стария адрес – MDN предупреждава, че автоматичното пренасочване може да обърка хора с екранни четци, затова сложете и видима връзка;
• ако ви трябват много истински пренасочвания с код 301, сайтът е по-подходящ за Cloudflare Pages или Netlify.

→Стъпка по стъпка

1. Създайте публично хранилище

   За личен сайт го кръстете потребител.github.io (с малки букви). За сайт на проект името може да е всякакво – адресът ще е потребител.github.io/хранилище/.

2. Качете файловете

   Сложете index.html (или index.md, README.md) най-горе в папката за публикуване. Ако нямате страница, направете я с генератора на index.html.

3. Включете Pages

   В Settings → Pages, в „Build and deployment“, изберете като източник публикуване от клон, после клона и папката (/ или /docs).

4. Изчакайте и отворете сайта

   Промените се публикуват до 10 минути след изпращане. Отворете адреса от бутона „Visit site“.

5. Потвърдете домейна

   В настройките на профила, в Pages, добавете домейна и публикувайте TXT записа _github-pages-challenge-ПОТРЕБИТЕЛ. След проверката не го изтривайте.

6. Задайте собствения домейн

   В хранилището, в Custom domain, въведете домейна и запишете. При DNS доставчика добавете CNAME за www и A записите (или ALIAS) за голия домейн.

7. Включете Enforce HTTPS

   Когато сертификатът е издаден, отметнете Enforce HTTPS. Проверете с проверката на SSL и пренасочванията.

?Чести въпроси