Мульти домены
Вы можете прикрепить домены и поддомены к своему сайту и управлять тем, какие заметки где будут видны. Для этого нужно прописать route в свойствах заметки.
Допустим, у вас портфолио, блог и лендинг для клиента. Без кастомных доменов всё это живёт на одном адресе и выглядит как папки одного сайта. С маршрутами каждый проект получает собственный домен, а вы управляете всем из одного места.
Если нужно назначить маршрут сразу целой папке, используйте frontmatter-патчи. Одно правило вместо ручной правки каждой заметки:
docs/**.md → { route: "docs.mysite.com" }
Все заметки в docs/ автоматически окажутся на поддомене docs.mysite.com.
Кому подходит
- Фрилансерам, у которых есть портфолио и отдельный блог
- Агентствам, которые ведут несколько сайтов клиентов
- Авторам, которым нужен брендированный лендинг на своём домене
Как это работает
Укажите 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
- Укажите
route: yourdomain.com/в frontmatter нужной заметки - У регистратора домена добавьте CNAME-запись:
yourdomain.com → ваш-сервер - После обновления 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.