Хостинг Docusaurus в России

Деплой документации на Docusaurus из Git: сборка, раздача с edge, домен с SSL. Оплата в рублях.

Docusaurus — стандарт для документации проектов: версии, боковая навигация, поиск и блог из коробки. Платформа определяет его по docusaurus.config, собирает и раздаёт с edge. Документация обновляется тем же способом, что и код, — коммитом в репозиторий.

Что Татнет делает с проектом на Docusaurus

Определяется по docusaurus.config

Поддерживаются .js, .ts и .mjs. Вторая версия и новее используют пресет docusaurus-2, первая — отдельный пресет.

Документация рядом с кодом

Push в ветку с правкой Markdown запускает сборку и выкатывает новую версию. Ревью документации проходит через тот же Pull Request.

Preview для правок

Каждый Pull Request получает свой адрес — можно вычитывать текст на живой странице, а не в диффе.

Свой домен и SSL

docs.вашдомен подключается в настройках, сертификат выпускается и продлевается автоматически.

Настройки сборки

Фреймворк в панели
docusaurus-2
Команда сборки
docusaurus build
Папка с результатом
build
Как работает в проде
Статические файлы с edge-раздачей
Версии Node.js
22 и 24
Пакетный менеджер
npm, yarn, pnpm или bun — по локфайлу и полю packageManager

Как задеплоить Docusaurus

01

Подключите репозиторий

GitHub App, GitLab OAuth или наш Gitea. Платформа прочитает конфиги и определит фреймворк — в вашем случае Docusaurus.

02

Проверьте команду сборки

Команда сборки и папка с результатом подставляются из пресета. Здесь же задаются переменные окружения и ветка для продакшена.

03

Деплой

Сборка идёт в одноразовой микро-VM, готовые файлы уезжают на edge. Сайт доступен на поддомене *.tatnet.app или вашем домене.

Возможности Docusaurus на Татнет

Автоопределение при подключении репозитория

Есть

GitHub, GitLab и Gitea

Есть

Кастомный домен и бесплатный SSL

Есть

Переменные окружения и секреты

Есть

Preview для Pull Request

Есть

Логи сборки и рантайма в панели

Есть

Монорепозиторий (Root Directory)

Есть

Заголовки, редиректы и rewrites на edge

Через vercel.json или tatnet.json

Docusaurus 2 и 3

Есть

Docusaurus 1

Отдельный пресет docusaurus

Версионирование документации

Есть

Локальный поиск и Algolia

Есть

MDX и React-компоненты в статьях

Есть

Частые вопросы про Docusaurus

Как задать baseUrl, если документация живёт в подпапке?

В docusaurus.config, поле baseUrl. Если документация лежит на отдельном домене, оставьте значение по умолчанию.

Сборка падает на битых ссылках. Это можно отключить?

Docusaurus по умолчанию считает битую внутреннюю ссылку ошибкой сборки. Поведение меняется в конфиге через onBrokenLinks, но чинить ссылки полезнее — иначе читатель найдёт их вместо вас.

Работает ли поиск?

Да. И встроенный локальный плагин поиска, и Algolia DocSearch — ключи задаются переменными окружения.

Можно ли держать документацию в монорепозитории?

Да, укажите Root Directory — например docs или website.

Другие фреймворки в категории «Статические сайты»

Полный список — каталог фреймворков.

Задеплойте Docusaurus на Татнет

Подключите репозиторий — платформа определит фреймворк и соберёт проект. Регистрация без карты.