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

Хитрость: поддомен для папки

Если нужно назначить маршрут сразу целой папке, используйте frontmatter-патчи. Одно правило вместо ручной правки каждой заметки:

docs/** → { route: "docs.mysite.com" }

Все заметки из docs/ теперь открываются на docs.mysite.com по своему обычному permalink: docs/intro.md станет docs.mysite.com/docs/intro.

Главную страницу домена отдайте ровно одной заметке. Патч перезаписывает собственный route заметки, поэтому внутри папки с патчем используйте routes:

routes:
  - docs.mysite.com/

Не ставьте слеш в конце маршрута в патче. С 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

1. Укажите route: yourdomain.com/ в frontmatter заметки, которая станет главной, и маршруты для остальных страниц домена
2. У DNS-провайдера направьте домен на ваш сервер: запись A/AAAA с IP-адресом сервера или CNAME на имя сервера для поддомена вроде docs.yourdomain.com. На голом домене (yourdomain.com) CNAME быть не может: используйте A/AAAA или запись ALIAS/ANAME (CNAME flattening) вашего провайдера
3. После обновления DNS заметка откроется на домене

Сначала добавьте маршруты, потом переключайте DNS. Домен без маршрутов показывает весь основной сайт (см. ниже).

Отличие от slug

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

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

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

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

При этом сама заметка по-прежнему открывается по своему permalink на основном домене. См. раздел «Дубли страниц» ниже.

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

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

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

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

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

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

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

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

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

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

Нет HTTPS-сертификата. Встроенный в trip2g клиент Let's Encrypt выпускает сертификаты только для хостов из списка ACME-доменов (флаг -acme-domain, по одному на хост; www.mysite.com — отдельный хост). Маршрут не добавляет домен в этот список. На своём сервере либо добавьте домен в список и перезапустите trip2g, либо завершайте TLS в reverse proxy перед ним. См. Self-hosting.

Домен показывает весь основной сайт. Хост, который доходит до trip2g, но не имеет ни одного маршрута, считается основным доменом — под этим именем открываются все страницы основного сайта. Сначала добавьте маршруты, потом переключайте DNS. То же самое происходит, если удалить последний маршрут домена.

Страница отдаёт 404, хотя маршрут указан. Если frontmatter заметки — невалидный YAML, trip2g игнорирует весь блок: маршрут не регистрируется, а вместе с ним теряются free и все остальные свойства. Частая причина — двоеточие внутри значения без кавычек, например title: Тарифы: цены. Возьмите значение в кавычки: title: "Тарифы: цены".

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

SEO на кастомном домене

Sitemap. Каждый кастомный домен отвечает на /sitemap.xml своим sitemap. В нём только заметки с маршрутом на этот домен, открытые (free) и без noindex. Добавляйте его в панель вебмастера каждого домена отдельно.

robots.txt и llms.txt. Заметка со slug: /robots.txt отвечает только на основном домене. Кастомному домену нужна своя заметка:

---
route: mysite.com/robots.txt
content_type: text/plain; charset=utf-8
free: true
noindex: true
search: false
---
User-agent: *
Disallow:

Sitemap: https://mysite.com/sitemap.xml

noindex: true не пускает сам файл в sitemap домена. Строку Sitemap: пишите абсолютным URL на том же домене. llms.txt делается так же, с route: mysite.com/llms.txt. См. robots.txt и llms.txt.

Авторизация

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.

if std.objectHas(meta, "route") then
  if std.startsWith(meta.route, "/") then
    { route: "landing.example" + meta.route }
  else
    {}
else
  { route: "landing.example" }

route: landing.example/