Мульти домены

Любая заметка может быть доступна на своём домене или по кастомному пути — без изменения основного permalink.

Без кастомных доменов все заметки живут на одном адресе. Это неудобно, если вы ведёте несколько проектов: портфолио, блог и лендинг для клиента не должны выглядеть как папки одного сайта. Кастомные домены позволяют каждому проекту иметь собственный адрес — и при этом управлять всем из одного trip2g-аккаунта.

Кому подходит

  • Фрилансерам, у которых есть портфолио и отдельный блог
  • Агентствам, которые ведут несколько сайтов клиентов
  • Авторам, которым нужен брендированный лендинг на своём домене

Как это работает

Укажите route или routes в frontmatter заметки:

---
route: mysite.com/
---

После этого заметка откроется на указанном URL. Основной permalink остаётся без изменений.

Варианты

Корень кастомного домена — заметка становится главной страницей домена:

route: mysite.com/

Страница на кастомном домене:

route: mysite.com/about

Несколько URL одновременно:

routes:
  - mysite.com/
  - mysite.com/home
  - /alias-на-основном-домене

Алиас на основном домене — дополнительный URL без изменения permalink:

route: /blog

Домен без слеша — заметка будет доступна на кастомном домене по своему обычному permalink, а не на корне:

route: mysite.com

www.mysite.com и mysite.com — одно и то же. Регистр букв не важен. Порт сохраняется: localhost:8081.

Настройка DNS

  1. Укажите route: yourdomain.com/ в frontmatter нужной заметки
  2. У регистратора домена добавьте CNAME-запись: yourdomain.com → ваш-сервер
  3. После обновления DNS заметка откроется на домене

Отличие от slug

slug route / routes
Меняет permalink Да Нет
Кастомный домен Нет Да
Несколько URL Нет Да
Алиасы Нет Да

slug и route можно использовать вместе — они работают независимо.

Изоляция доменов

Домены изолированы:

  • Заметки на mysite.com не появляются на основном домене по этому пути
  • Алиасы основного домена (route: /blog) не работают на кастомных доменах

Это позволяет один trip2g-сайт использовать как несколько независимых сайтов с разным контентом.

Ссылки между доменами

Викиссылки автоматически подстраиваются под домен читателя.

Допустим, заметка A на mysite.com ссылается на заметку B. Куда поведёт ссылка — зависит от того, где живёт B:

Заметка B доступна на... Ссылка будет
Том же домене mysite.com Относительный путь: /about
Другом кастомном домене other.com Полный URL: https://other.com/path
Только на основном домене Канонический permalink

На основном домене — наоборот. Если целевая заметка живёт только на кастомном домене, ссылка ведёт на полный URL этого домена. Если у заметки есть алиас на основном домене (route: /about), ссылка использует алиас.

Вставки ![[заметка]] всегда используют канонический permalink — домены на них не влияют.

RSS-лента, GraphQL API, MCP и Telegram тоже используют канонические ссылки. Кастомные домены на них не распространяются.

Что может пойти не так

DNS ещё не обновился. После добавления CNAME-записи домен начинает работать через несколько часов, иногда до 48 часов. Проверьте через dig yourdomain.com или сервис вроде dnschecker.org.

Забыли слеш в конце. mysite.com и mysite.com/ — разные маршруты. Без слеша заметка будет доступна по своему обычному permalink на этом домене. Со слешем — станет главной страницей. Для корня нужен слеш: route: mysite.com/.

HTTPS-сертификат ещё не выпустился. После первого обращения к домену сертификат выпускается автоматически, это занимает до нескольких минут. Если браузер показывает предупреждение — подождите и обновите страницу.

Авторизация не работает на кастомном домене. Cookies привязаны к домену и не передаются между yoursite.trip2g.ru и mysite.com. Если заметка закрытая, пользователь должен войти отдельно на каждом домене. Для открытого контента добавьте free: true.

Sitemap

Каждый кастомный домен получает отдельный /sitemap.xml только со своими заметками.

Авторизация

Cookies ограничены браузером и не передаются между доменами. Для заметок на кастомных доменах используйте free: true если контент открытый.

Нюансы

Каноническая ссылка не работает на кастомном домене. Если заметка доступна на mysite.com/about, открыть её по обычному permalink на mysite.com не получится — будет 404. Кастомный домен отдаёт только заметки с явным route.

route: / перекрывает главную страницу. Если указать route: / на основном домене, эта заметка заменит _index.md на корневом пути.

Две заметки с одинаковым route. Победит последняя загруженная. Избегайте дублирования маршрутов.

Заметка на нескольких доменах. Укажите все маршруты явно:

routes:
  - mysite.com/
  - other.com/

Маршруты через API

Маршруты можно добавлять не только в файле заметки, но и через API — с помощью frontmatter-патчей. Патч добавляет route или routes в метаданные заметки. Результат тот же, что при ручном указании в frontmatter.

Демо

extra