Собственный домен для портала

Как открыть портал и статьи вашего проекта по домену, которым вы владеете, например example.ru или blog.example.ru, вместо адреса на papera.dev.

Перед началом

Собственный домен доступен на тарифах Pro и Ultimate. Ещё вам понадобится доступ к настройкам DNS вашего домена у регистратора или DNS-провайдера, где вы им управляете.

Откройте Настройки → Адрес проекта и нажмите кнопку изменения рядом с Собственный домен. Настройка проведёт вас через пять шагов и покажет точные записи, которые нужно создать. Держите её открытой, пока работаете у DNS-провайдера. Если закрыть настройку, она откроется на том же шаге, с вашим выбором и введённым именем.

Выбор адреса

Первый шаг настройки, Выберите адрес, спрашивает, какой домен вам нужен:

• Корневой домен, например example.ru, вместе с которым подключается www.example.ru. Страницы открываются на корневом домене, а www.example.ru ведёт каждого читателя на ту же страницу корневого домена, так что читатели найдут вас, как бы они ни набрали адрес. Выберите его, если портал станет вашим основным сайтом. Ему нужны запись A для корневого домена и запись CNAME для www, и он заменит сайт, который сейчас открывается на example.ru.
• Поддомен, ваше собственное имя под доменом, например blog.example.ru или docs.example.ru. Ему нужна одна запись CNAME, а на корневом домене остаётся ваш сайт. Выберите его, если на example.ru уже работает ваш сайт. Имя www подключается вместе с корневым доменом, поэтому, чтобы открывать проект на www.example.ru, выберите Корневой домен.

Заранее ничего не выбрано, и ни один вариант не лучше другого по умолчанию: всё решает ваш собственный сайт на корневом домене. Выберите вариант, и настройка перейдёт к следующему шагу. Любой пройденный шаг можно открыть снова, нажав на его заголовок.

Ввод домена

Шаг Введите домен спрашивает имя. Введите его и нажмите Продолжить, чтобы заявить его. Если введённое имя относится к другому виду, настройка скажет об этом и назовёт подходящий вариант: нажмите стрелку Назад вверху настройки, чтобы сменить вид. Какие имена считаются корневыми, решает общедоступный список доменных окончаний, поэтому example.co.uk такой же корневой домен, как example.ru.

Для корневого домена введите только сам домен, например example.ru. Настройка покажет имя www, которое подключается вместе с ним, и одна запись владения подтверждает оба имени.

У проекта может быть только один собственный домен.

Запись владения

Шаг Добавьте запись владения показывает запись TXT, которая подтверждает, что домен принадлежит вам. Создайте у DNS-провайдера запись с такими полями:

• Тип (Type): TXT
• Хост или Имя (Host, Name): хост, который показывает настройка
• Значение или Цель (Value, Target): значение, которое показывает настройка

Большинство провайдеров сами добавляют ваш домен к хосту, поэтому настройка показывает хост без него, например _papera-challenge или _papera-challenge.blog, а для самого домена @. Если ваш провайдер просит полное имя, настройка показывает его под хостом. У каждого значения есть кнопка копирования, так что ничего не придётся перепечатывать. Нажмите Продолжить, чтобы перейти дальше.

Запись, направляющая домен

Шаг Направьте домен сюда показывает запись, которая ведёт посетителей на ваш проект. Она зависит от выбранного вида домена.

Для варианта Поддомен создайте одну запись:

• Тип (Type): CNAME
• Имя или Хост (Name, Host): ваше имя, например blog или news
• Значение или Цель (Value, Target): edge.papera.dev

Для варианта Корневой домен создайте две записи. Первая ведёт корневой домен на ваш проект:

• Тип (Type): A
• Имя или Хост (Name, Host): ваш домен, часто его записывают как @
• Значение или Цель (Value, Target): значение записи A, которое показывает настройка

Если ваш DNS-провайдер поддерживает записи ALIAS, ANAME или CNAME flattening, вместо записи A подойдёт и такая запись для корневого домена, указывающая на edge.papera.dev.

Вторая ведёт имя www на Papera, которая перенаправляет его на корневой домен:

• Тип (Type): CNAME
• Имя или Хост (Name, Host): www
• Значение или Цель (Value, Target): edge.papera.dev

Удалите записи AAAA для тех же имён, если они есть, и отключите прокси перед доменом. Нажмите Продолжить, чтобы перейти дальше.

Проверка

Шаг Проверьте домен показывает три результата:

• Запись владения найдена: запись TXT содержит значение этого проекта.
• Домен указывает на этот проект: направляющая запись ведёт на Papera.
• Отвечает по защищённому соединению: у домена есть доверенный сертификат, и он отвечает для этого проекта.

Когда все три пройдены, домен подключён. Все адреса проекта начинают указывать на него, а адрес на papera.dev продолжает открывать те же страницы.

Для корневого домена шаг показывает и то, указывает ли имя www на этот проект. Оно проверяется отдельно и никогда не задерживает корневой домен: корневой домен подключается и без него, а www начинает вести на корневой домен, как только его запись на месте. Строка Собственный домен в настройках показывает имя www под корневым доменом и то, добавлена ли уже его запись.

После того как вы заявили домен, Papera проверяет его сама: каждые 5 минут в первый час, каждые 30 минут до конца первых суток, затем каждые 6 часов, пока не пройдёт неделя. Когда обе записи найдены, Papera проверяет защищённое соединение каждые 15 минут в течение двух часов, каждый час до конца этих суток, затем каждые 6 часов в течение недели. Подключённый домен проверяется каждые 6 часов, пока он остаётся подключённым.

Пока домен не подключён, нажмите Проверить записи на этом шаге, чтобы проверить сразу, даже если до автоматической проверки ещё далеко. Когда автоматические проверки заканчиваются, остаётся только эта кнопка. У подключённого домена Продолжить закрывает настройку, а Проверить снова проверяет его сразу.

Устранение неполадок

Проверка сообщает, что запись оказалась по удвоенному имени, например _papera-challenge.example.com.example.com. Провайдер добавил ваш домен к хосту, который уже им заканчивался. Измените запись и укажите хост, который называет сообщение.

Домен отвечает не для этого проекта или указывает на другой адрес. Обычно причина в прокси перед доменом. Отключите его для обеих записей.

Cloudflare: переключите каждую запись в режим DNS only, серое облако. Cloudflare по умолчанию проксирует новые записи, а запись через прокси не проходит проверку.

Проверка сообщает о записи AAAA. У домена есть ещё и адрес IPv6, а Papera обслуживает собственные домены только по IPv4. Удалите запись AAAA для этого имени.

Проверка сообщает, что имя www ещё не направлено. Корневой домен всё равно подключается, но читатели, которые набирают www, никуда не попадут, пока запись не на месте. Создайте запись CNAME для www на edge.papera.dev, удалите все остальные записи A, AAAA или CNAME для www и отключите для него прокси. Некоторые регистраторы добавляют свою запись для www или переадресуют www куда-то ещё, поэтому уберите и это. Затем подождите несколько минут и проверьте снова.

Корневой домен по-прежнему указывает на другой адрес, хотя вы добавили запись A. Многие регистраторы паркуют новый домен своей записью A или правилом переадресации. Проверка называет каждый адрес помимо адреса Papera, для самого домена или для его имени www:

example.com также указывает на 34.120.5.9. Удалите эту запись A. DNS кеширует ответы, поэтому только что изменённая запись может обновиться не сразу.

Удалите все записи A, которые называет сообщение, и отключите страницу парковки или переадресацию.

Обе записи найдены, но защищённое соединение так и не проходит. Проверка читает записи CAA вашего домена, затем каждого родительского домена, и останавливается на первом, у которого они есть. Если в этих записях нет Let's Encrypt, центра сертификации, выпускающего сертификат, проверка называет домен, на котором они находятся:

Записи CAA на example.com не разрешают Let's Encrypt, поэтому домен не может получить сертификат. Добавьте на example.com запись CAA со значением 0 issue "letsencrypt.org". DNS кеширует ответы, поэтому только что изменённая запись может обновиться не сразу.

Добавьте эту запись CAA на домен, который называет сообщение:

0 issue "letsencrypt.org"

Только что добавленная запись отмечена как отсутствующая. Ответы DNS какое-то время хранятся в кэше, поэтому новая или изменённая запись может появиться через несколько минут, а иногда и позже. Подождите и снова нажмите Проверить записи.

Защищённое соединение всё ещё ожидает. Сертификат выпускается, когда записи на месте, и это может занять несколько минут. Papera продолжает проверять сама, так что можно закрыть настройку кнопкой Отмена и вернуться позже.

Удаление или смена домена

Чтобы отказаться от домена, откройте настройку и нажмите Удалить домен. Домен сразу перестанет принадлежать проекту, а адрес проекта на papera.dev продолжит открывать его страницы. Вместе с корневым доменом удаляется и его имя www.

У проекта может быть только один собственный домен, поэтому, чтобы сменить его, сначала удалите текущий домен, а затем заявите новый. Старые записи DNS после этого можно удалить.