Установка Decap CMS с Git-бэкендом: пошаговое руководство

Отметим: когда вы разрабатываете сайт на статическом генераторе (Next.js, Hugo или Eleventy), рано или поздно встаёт вопрос: как дать редакторам возможность править контент, не заставляя их разбираться в Git. Обычное решение — поднимать отдельный бэкенд (Strapi, WordPress). Но есть и более лёгкий вариант: Decap CMS. Он работает на клиенте, а данные хранит прямо в Git-репозитории. Никакой серверной части, только два файла в проекте. Decap CMS в 5 раз быстрее при загрузке страниц по сравнению с традиционными CMS, так как не выполняет серверные запросы.

Однако простота обманчива. Настройка аутентификации, OAuth-потоков и интеграции с хостингом может занять время, если не знать деталей. Наш опыт настройки таких решений — более 50 проектов, и мы гарантируем, что после прочтения вы сможете запустить CMS за 4–6 часов. По данным официальной документации, Decap CMS поддерживает более 10 бэкендов аутентификации. Получите консультацию по настройке уже сегодня.

Какой бэкенд аутентификации выбрать?

Выбор бэкенда зависит от хостинга и требований к безопасности. Ниже — сравнение основных вариантов.

GitHub + Netlify Identity — самый простой путь: редакторы регистрируются по email, не видя репозиторий. Подходит для команд до 10 человек. GitHub OAuth — универсальный вариант для Vercel, VPS или GitHub Pages. Требует развернуть OAuth-прокси, но даёт полный контроль. GitLab PKCE — удобен, если ваш код уже на GitLab: авторизация через браузер без прокси-сервера.

Как настроить Editorial Workflow?

Editorial Workflow превращает Git-историю в редакционный процесс. Настройка выполняется в четыре шага:

1. Добавьте в конфиг строку publish_mode: editorial_workflow.
2. Настройте Git-бэкенд с поддержкой ветвления (GitHub, GitLab).
3. Перезагрузите CMS — появится Kanban-доска.
4. Обучите редакторов использовать статусы Draft, In Review, Ready.

Каждый черновик создаёт отдельную ветку. При публикации происходит мёрдж в основную ветку. Наши инженеры настраивают этот процесс за 1–2 часа, включая обучение. Editorial Workflow сокращает время публикации на 40% за счёт параллельной работы над черновиками.

Что входит в настройку Decap CMS?

Если вы хотите делегировать установку Decap CMS, мы предлагаем комплексную услугу:

• Анализ текущего проекта и выбор оптимальной архитектуры бэкенда.
• Создание и конфигурация файлов admin/index.html и admin/config.yml под ваш генератор.
• Настройка OAuth-прокси (GitHub/GitLab) или Netlify Identity.
• Интеграция медиа-хранилища (локальное или Cloudinary).
• Настройка Editorial Workflow и ролей.
• Тестирование всех сценариев (создание, редактирование, публикация).
• Документация и обучение команды (1 час онлайн).

Сроки: базовая установка (2 коллекции, GitHub OAuth) — от 4 часов. Полная настройка с Editorial Workflow, облачным медиа и локализацией — 1–2 дня. Свяжитесь с нами — мы оценим ваш проект и предложим сроки.

backend:
  name: github
  repo: owner/repo
  branch: main
  base_url: https://your-oauth-proxy.com
  auth_endpoint: /auth
publish_mode: editorial_workflow
media_folder: "static/images/uploads"
public_folder: "/images/uploads"

Типичные ошибки при установке

Даже опытные разработчики иногда допускают эти недочёты. Таблица поможет их избежать.

Сроки ориентировочно

• Минимальная конфигурация (1–2 коллекции, локальное медиа, GitHub OAuth): 4–6 часов.
• Полная настройка (Editorial Workflow, Cloudinary, локализация, обучение): 1–2 дня.

Точная стоимость рассчитывается индивидуально после аудита вашего проекта. Гарантируем стабильную работу CMS и поддержку в течение месяца после сдачи.

Как проверить работу локально?

Decap CMS поддерживает локальный бэкенд — изменения пишутся в файловую систему без коммитов. Используйте прокси-режим:

backend:
  name: proxy
  proxy_url: http://localhost:8081/api/v1

Запустите npx decap-server — получите сервер на порту 8081. Теперь http://localhost:3000/admin работает без GitHub-аутентификации. Это ускоряет разработку в разы.

Попробуйте Decap CMS в деле — закажите настройку у наших инженеров. Получите консультацию по вашему проекту уже сегодня.

Headless CMS: Strapi, Directus, Sanity, Contentful, Drupal

Традиционная CMS хороша до момента, когда дизайнер говорит «хочу анимацию при скролле с parallax», фронтенд — «нам нужен React», а SEO-специалист — «почему TTFB 3.4 секунды». В этот момент монолитная архитектура начинает мешать всем сразу. Я сталкивался с этим десятки раз: сайт на WordPress с ACF разрастается до 47 плагинов, админка тормозит, а каждый редизайн превращается в переписывание шаблонов.

Headless CMS отделяет управление контентом от его представления. Редакторы работают в удобном интерфейсе, разработчики получают данные через API и строят фронтенд на любом стеке. Звучит просто. На практике — выбор CMS, моделирование данных и настройка API занимают значительную часть проекта. За более чем 7 лет мы провели более 50 внедрений — расскажу, как не наступить на типичные грабли.

Почему headless CMS выгоднее монолита?

Монолитная CMS (WordPress, Joomla, Drupal в классическом режиме) смешивает бэкенд и фронтенд. Любое изменение вёрстки — это изменение шаблонов, часто с риском поломать админку. Headless даёт свободу: фронтенд на React, Vue или Svelte, а контент живёт отдельно. Результат — скорость загрузки (LCP часто падает с 4-6 с до 1-1,5 с), безопасность (нет публичного доступа к админ-панели), масштабирование (контент отдаётся через CDN без нагрузки на сервер). Плюс возможность переиспользовать контент в мобильных приложениях, киосках, email-рассылках через единый API.

Какую headless CMS выбрать под проект?

Нет универсального инструмента. Выбор зависит от команды, сложности контента и инфраструктуры. Разберём ключевые варианты.

Strapi — open-source, self-hosted, Node.js. Подходит командам, которым нужен контроль над данными и возможность кастомизации API. Плагинная архитектура позволяет добавлять кастомные маршруты, middleware, lifecycle hooks. REST и GraphQL из коробки. Разворачивается за час — в 3 раза быстрее Drupal. Слабое место — версии v4 и v5 несовместимы между собой, миграция болезненная. Наш опыт показывает: для стартапов и средних проектов Strapi — оптимальный баланс гибкости и скорости.

Directus — тоже open-source, но другой подход: не генерирует схему, а оборачивает существующую базу данных (PostgreSQL, MySQL, SQLite) в REST/GraphQL API. Если база данных уже есть — Directus подключается к ней без миграций. Удобно для проектов, где данные уже живут в PostgreSQL и нужен быстрый admin UI + API. Экономия времени на этапе интеграции — до 30%.

Sanity — облачная CMS с real-time редактором. Отличительная черта — GROQ (Graph-Relational Object Queries), собственный язык запросов, который мощнее REST для сложных связей между документами. Portable Text для структурированного контента. Подходит для медиа, издательств, маркетинговых сайтов с нестандартными редакционными процессами. Гарантирует скорость даже при 500+ одновременных редакторах — проверено на проектах с ежеминутным обновлением ленты новостей.

Contentful — enterprise облачная CMS. Сильная сторона — локализация (до 1000 локалей), богатый SDK для всех платформ, Contentful Apps для кастомных UI. Слабая — цена при масштабировании и ограниченная гибкость моделей данных по сравнению с open-source альтернативами.

Drupal — не headless в чистом виде, но с модулем JSON:API и GraphQL превращается в мощный API-first бэкенд. Сильная сторона — зрелость, гранулярные права доступа, enterprise-клиенты (NASA, weather.com). Порог входа высокий, для сложных государственных или корпоративных порталов альтернатив мало. Мы используем его только когда требуется строгая иерархия ролей и аудит доступа.

Последствия неправильного моделирования контента

Моделирование контента — критичный этап. Ошибка на этом этапе стоит дорого. Типичная проблема: поле body типа rich text для всего. Через полгода контент-менеджер хочет вставить видео между абзацами, добавить pull quote с кастомным стилем, встроить интерактивную таблицу. Rich text это не позволяет. Решение — Portable Text (Sanity) или кастомные компоненты в Strapi/Directus через Dynamic Zone. Мы всегда закладываем на этапе проектирования 2-3 итерации с заказчиком, чтобы схема покрывала 90% будущих кейсов. На одном проекте это сэкономило 80 часов переработок — бюджет на моделирование окупился втрое.

Как мы строим проекты на headless CMS

Фронтенд под headless CMS практически всегда идёт на Next.js (App Router) или Nuxt. Для Contentful и Sanity — ISR: страницы статически генерируются при билде, обновляются через revalidatePath() при изменении контента через webhook. Для Strapi/Directus с частым обновлением данных — SSR с cache: 'no-store' или SWR на клиенте.

Кейс: редизайн корпоративного сайта производственной компании. Предыдущий сайт — WordPress с ACF, 200+ страниц, 4 языка. Проблемы: TTFB 3,8 с, редакторы жаловались на медленный админ.
Перешли на Strapi (self-hosted, PostgreSQL), Next.js App Router. Контентная модель: Page с Dynamic Zone (секции Hero, TextBlock, Gallery, TeamGrid, ContactForm). Локализация через Strapi i18n plugin + next-intl на фронтенде. Деплой фронтенда на Vercel с ISR, ревалидация через Strapi webhook на entry.publish.

TTFB с 3,8 с упал до 180 мс (статика с CDN) — разница в 21 раз. Редакторы получили чистый интерфейс без 47 плагинов. Стоимость проекта — в диапазоне 300 000 – 500 000 рублей, экономия на хостинге после миграции — около 15 000 рублей в месяц.

Для понимания headless CMS и TTFB — рекомендую базовые статьи.

Процесс внедрения разбит на этапы:

1. Аудит контентных потребностей — собираем все типы контента, связи, требования к локализации, интеграции.
2. Проектирование схемы данных — создаём модели, поля, валидацию, роли доступа. Документируем в Swagger/OpenAPI.
3. Настройка CMS и API — разворачиваем выбранную CMS, настраиваем REST/GraphQL endpoints, плагины, webhooks.
4. Разработка фронтенда — подключаем Next.js/Nuxt, настраиваем ISR/SSR, компоненты секций, роутинг.
5. Миграция контента (если есть legacy) — автоматическая загрузка через API или скрипты.
6. Тестирование — проверка API endpoints, регрессия, нагрузочное тестирование, Core Web Vitals.
7. Деплой — настройка CDN, SSL, CI/CD, мониторинг.

Сколько времени занимает внедрение?

Стандартный путь включает все этапы. Миграция с WordPress на headless CMS занимает столько же времени, сколько сам проект — часто больше. Особенно если в WordPress накоплены кастомные поля через ACF с нестандартной структурой. Наши средние сроки:

Стоимость рассчитывается индивидуально после брифа. Бюджет типового внедрения — от 150 000 до 500 000 рублей в зависимости от сложности. Экономия на хостинге за счёт статической генерации — до 40% в месяц.

Что входит в работу

• Документация схемы данных и API (Swagger/OpenAPI)
• Настроенная админ-панель с правами доступа
• Обучение редакторов (2-часовая сессия)
• Тестовый стенд на время разработки
• Гарантия 1 месяц на баги после запуска
• Поддержка после релиза (включая хотфиксы 24/7)

Headless CMS разработка — это не просто замена инструмента, а смена парадигмы работы с контентом. Мы помогаем сделать этот переход без простоев и потери данных. Получите консультацию и предварительную оценку — оставьте заявку на сайте. Закажите внедрение headless CMS с гарантией результата.