Отметим: когда вы разрабатываете сайт на статическом генераторе (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 | Низкая | 30–60 минут | Хостинг на Netlify, включение Identity и Git Gateway |
| GitHub OAuth (без Netlify) | Средняя | 2–3 часа | OAuth-прокси (Node.js), домен HTTPS |
| GitLab PKCE | Низкая | 1–2 часа | GitLab-аккаунт, настройка OAuth в приложении |
GitHub + Netlify Identity — самый простой путь: редакторы регистрируются по email, не видя репозиторий. Подходит для команд до 10 человек. GitHub OAuth — универсальный вариант для Vercel, VPS или GitHub Pages. Требует развернуть OAuth-прокси, но даёт полный контроль. GitLab PKCE — удобен, если ваш код уже на GitLab: авторизация через браузер без прокси-сервера.
Как настроить Editorial Workflow?
Editorial Workflow превращает Git-историю в редакционный процесс. Настройка выполняется в четыре шага:
- Добавьте в конфиг строку
publish_mode: editorial_workflow. - Настройте Git-бэкенд с поддержкой ветвления (GitHub, GitLab).
- Перезагрузите CMS — появится Kanban-доска.
- Обучите редакторов использовать статусы 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 дня. Свяжитесь с нами — мы оценим ваш проект и предложим сроки.
Пример конфигурации для GitHub OAuth
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" Типичные ошибки при установке
Даже опытные разработчики иногда допускают эти недочёты. Таблица поможет их избежать.
| Ошибка | Описание | Решение |
|---|---|---|
| Неправильный путь к папке admin | Файлы не копируются в статику | Размещайте admin в public/ (Next.js) или static/ (Hugo) |
| Пропущен passthrough в Eleventy | Файлы не попадают в сборку | Добавьте addPassthroughCopy('admin') в .eleventy.js |
| Нефиксированная версия скрипта | Использование ^3.0.0 может сломать CMS |
Укажите конкретную версию, например, 3.1.2 |
| Отсутствие CORS-заголовков | OAuth-прокси не отвечает на запросы с другого домена | Настройте Access-Control-Allow-Origin |
Сроки ориентировочно
- Минимальная конфигурация (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 в деле — закажите настройку у наших инженеров. Получите консультацию по вашему проекту уже сегодня.