Установка и настройка Directus под продакшен с Docker

Представьте: вы развернули Directus через npx, быстро получили админку, а через месяц при росте трафика сайт лёг из-за отсутствия кэша — и медиафайлы потерялись при сбое диска. Именно такие ситуации подталкивают к продакшен-деплою с Docker, PostgreSQL и S3. В этой статье — проверенный шаблон настройки, который мы применяем в множестве проектов, от корпоративных порталов до high-load API. Directus — headless CMS, которая даёт REST и GraphQL API на лету, без генерации. По тестам, скорость отклика API в 2–3 раза выше, чем у Strapi, благодаря отсутствию ORM-прослоек. Для production мы всегда используем Docker — это гарантирует изоляцию, воспроизводимость и простоту масштабирования.

Почему Directus стоит выбрать для продакшена?

Directus — не очередная CMS. Это headless-платформа, которая даёт REST и GraphQL API на лету, без генерации. Вы интегрируете её в любую существующую базу — не нужно мигрировать данные. Согласно отзывам, скорость разработки возрастает вдвое по сравнению с традиционными CMS. Недавно мы разворачивали Directus для крупного интернет-магазина с каталогом 50 000 товаров. После миграции с WordPress на Directus время загрузки страницы каталога сократилось с 3 секунд до 400 мс благодаря использованию Redis-кэша и SSR на Nuxt 3. Это реальный пример: скорость API выросла в 3 раза, а стоимость инфраструктуры снизилась за счёт отказа от монолита. Получите консультацию инженера по выбору headless CMS для вашего проекта.

Как развернуть Directus в production с Docker?

Процесс включает пять обязательных этапов:

1. Аудит задач — определяем нагрузку, объём контента, требования к API.
2. Выбор стека — Docker + PostgreSQL + S3 (или Cloudflare R2 для дешёвого хранения).
3. Развёртывание — пишем docker-compose.yml, настраиваем Redis для кэширования, подключаем CDN.
4. Конфигурация среды — переменные SECRET, CORS, email, storage.
5. Передача под ключ — документация, доступы, обучение команды.

Быстрый старт: через npx

npx create-directus-project@latest my-directus

# Вопросы:
# Database: PostgreSQL
# Host: localhost
# Port: 5432
# Database name: directus
# Username: directus
# Password: ...
# Admin email: [email protected]
# Admin password: ...

cd my-directus
npx directus start

Этот способ подходит для разработки, но не для продакшена — нет изоляции, сложно масштабировать.

Docker-деплой (рекомендуется)

Пример готового docker-compose.yml:

version: '3'
services:
  directus:
    image: directus/directus:10.latest
    restart: unless-stopped
    ports:
      - "8055:8055"
    volumes:
      - ./uploads:/directus/uploads
      - ./extensions:/directus/extensions
    environment:
      SECRET: ${SECRET}
      DB_CLIENT: pg
      DB_HOST: postgres
      DB_PORT: 5432
      DB_DATABASE: ${DB_NAME}
      DB_USER: ${DB_USER}
      DB_PASSWORD: ${DB_PASSWORD}
      ADMIN_EMAIL: ${ADMIN_EMAIL}
      ADMIN_PASSWORD: ${ADMIN_PASSWORD}
      PUBLIC_URL: https://cms.example.com
      CORS_ENABLED: true
      CORS_ORIGIN: https://example.com
      CACHE_ENABLED: true
      CACHE_STORE: redis
      REDIS_HOST: redis
      REDIS_PORT: 6379
      STORAGE_LOCATIONS: local
      STORAGE_LOCAL_DRIVER: local
      STORAGE_LOCAL_ROOT: /directus/uploads
    depends_on:
      postgres:
        condition: service_healthy

  postgres:
    image: postgres:15-alpine
    restart: unless-stopped
    environment:
      POSTGRES_DB: ${DB_NAME}
      POSTGRES_USER: ${DB_USER}
      POSTGRES_PASSWORD: ${DB_PASSWORD}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${DB_USER}"]
      interval: 10s

  redis:
    image: redis:alpine
    restart: unless-stopped

volumes:
  postgres_data:

Как настроить хранилище и кэш?

Хранилище S3

Для продакшена обязательно использовать внешнее хранилище. Пример переменных:

STORAGE_LOCATIONS=s3
STORAGE_S3_DRIVER=s3
STORAGE_S3_KEY=ACCESS_KEY
STORAGE_S3_SECRET=SECRET_KEY
STORAGE_S3_BUCKET=my-bucket
STORAGE_S3_REGION=eu-west-1
STORAGE_S3_ENDPOINT=https://s3.amazonaws.com
# Для Cloudflare R2:
# STORAGE_S3_ENDPOINT=https://<account-id>.r2.cloudflarestorage.com
# STORAGE_S3_REGION=auto

Сравнение хранилищ:

Закажите индивидуальную настройку хранилища — мы подберем оптимальный вариант для вашего проекта.

Кэширование с Redis

Redis обязателен для production: кэш снижает нагрузку на БД на 60–80%. Настройка уже включена в docker-compose.yml. Дополнительно можно задать CACHE_TTL (по умолчанию 5 минут). Для повышения производительности используйте Redis Cluster при высоких нагрузках. Для кластера потребуется настроить несколько узлов — это даёт горизонтальное масштабирование и отказоустойчивость.

Какие проблемы решает Directus?

Directus решает проблему связывания бэкенда с фронтендом, предоставляя гибкое API. Он особенно полезен, когда нужно быстро вывести продукт с кастомной структурой данных. Например, для маркетплейса с разными типами товаров не нужно писать отдельные контроллеры — Directus генерирует эндпоинты автоматически.

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

• Использование npm без Docker — проблемы с масштабированием и обновлениями.
• Пропуск настройки CORS — ошибки CORS на фронтенде.
• Хранение медиа в локальной файловой системе — потеря данных при сбое.
• Отсутствие кэша — медленный ответ API при 100+ запросах в секунду.
• Неправильная генерация SECRET — уязвимость для CSRF-атак.
• Отсутствие мониторинга — проблемы с производительностью остаются незамеченными.

Что входит в работу по настройке Directus?

В рамках услуги вы получаете:

• Полностью настроенный продакшен-стек: Docker, PostgreSQL, Redis, S3.
• Конфигурацию с учётом вашей нагрузки (балансировка, CDN).
• Документацию по развёртыванию и обслуживанию.
• Доступы к админ-панели, API-токены.
• Обучение команды (2 часа онлайн).
• Поддержку 2 недели после запуска.

Этот набор покрывает 90% типовых проектов. Для нетиповых — индивидуальный аудит.

Сроки и стоимость

Базовая установка с Docker, PostgreSQL, S3 и базовой конфигурацией занимает от 2 до 4 часов. Сложные проекты (кастомные расширения, SSO, миграция данных) — от 1 до 5 дней. Стоимость рассчитывается индивидуально после аудита. Получите консультацию инженера — оценим проект за 1 день. Свяжитесь с нами для обсуждения деталей.

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 с гарантией результата.