Создание серверного бэкенда для веб-сервисов, интернет-магазинов и мобильных приложений по традиционной схеме отнимает недели рутинной работы: проектирование схем, написание CRUD-контроллеров, генерация документации Swagger, настройка JWT-авторизации, ролей доступа (RBAC), загрузки медиафайлов и разработка панели администратора. Облачные платформы вроде Firebase или Strapi Cloud создают жёсткую привязку к проприетарным форматам данных и требуют зарубежных карт. Directus предлагает принципиально иной инженерный подход: это открытая Data Platform на TypeScript, которая подключается к чистой базе данных PostgreSQL и мгновенно генерирует строго типизированный REST и GraphQL API с поддержкой WebSockets в реальном времени, сохраняя 100% контроль над структурой таблиц. В этом руководстве разбираем, как развернуть отказоустойчивый стек актуальной версии Directus 12, PostgreSQL 16 и Redis 7 на собственном VDS в Docker Compose с подключением к российским S3-хранилищам и защитой Nginx SSL.
Архитектура Directus: трансформация существующей PostgreSQL в REST и GraphQL API
Directus (проект с более чем 38 600 звёзд на GitHub) кардинально отличается от классических Headless CMS вроде WordPress или Strapi. В его основе лежит парадигма Database-First: Directus не использует тяжёлые абстрактные ORM со скрытыми метатаблицами, а работает как прозрачный реактивный слой поверх вашей СУБД. Начиная с поколения v12 платформа перешла на лицензию Monospace Sustainable Core License (MSCL 1.0), пришедшую на смену прежней BSL 1.1. Для независимых разработчиков, агентств и компаний с годовым оборотом до $5 млн и штатом до 50 сотрудников Directus полностью бесплатен для любого коммерческого использования (в рамках Innovation Grant), а каждый релиз ядра через 4 года автоматически становится свободным ПО под лицензией GPLv3.
Ключевые архитектурные особенности Directus:
- Прямое зеркалирование схемы данных: Каждая коллекция в Directus — это обычная таблица в PostgreSQL, а каждое поле — стандартная колонка с нативным типом данных (
VARCHAR,INTEGER,JSONB,TIMESTAMP,GEOMETRY). Если вы уже имеете работающую базу данных или параллельно подключаете к ней аналитические микросервисы на Go или Python, Directus не нарушит их работу. - Двухголовый API из коробки: Для каждой таблицы автоматически поднимаются полнофункциональные эндпоинты REST API и GraphQL API с поддержкой глубокой фильтрации, сортировки, пагинации, агрегаций и поиска по связям (relational deep queries).
- Real-Time подписки через WebSockets: Встроенный шлюз WebSockets позволяет клиентам подписываться на мутации данных без постоянного HTTP-поллинга, что критично для чатов, систем трекинга заказов и совместной работы.
- Модульная панель Data Studio: Готовый интерфейс на Vue 3 с конструктором форм, табличными и канбан-представлениями, встроенным просмотром аналитических дашбордов и управлением файлами.
| Критерий | Directus 12 (Node/TS) | Strapi v5 (Node/JS) | PocketBase (Go) |
|---|---|---|---|
| Архитектура БД | Database-First (чистый SQL без вендор-лока) | Code-First (своя структура таблиц через ORM) | Встроенная SQLite база данных |
| API протоколы | REST + GraphQL + WebSockets | REST + плагин GraphQL | REST + Server-Sent Events (SSE) |
| Работа с готовой БД | Мгновенно подключается к существующей схеме | Требует импорта и создания моделей заново | Только встроенная схема SQLite |
| Файловое хранилище | Локальное, S3, MinIO, Cloudflare R2 | Локальное или плагины провайдеров | Локальный диск или S3 |
| Потребление памяти | 200–400 МБ RAM в простое (Node.js) | 250–500 МБ RAM (Node.js) | 30–70 МБ RAM (компилированный Go) |
Для сравнения с ультралегковесными альтернативами рекомендуем также прочитать наш разбор развертывания автономного SQLite-бэкенда PocketBase на VDS, а для организации надёжного резервного копирования базы — руководство по шифрованным дедуплицированным бэкапам в Kopia Server.
Подготовка VDS на Ubuntu 24.04 LTS и сетевая изоляция
Для стабильной работы стека Directus, PostgreSQL и Redis достаточно виртуального сервера с 2 vCPU и 4 ГБ оперативной памяти под управлением Ubuntu 24.04 LTS. Поскольку базы данных активно используют дисковые операции записи WAL-логов и буферного кэширования, критически важно выбирать хостинг с быстрыми накопителями NVMe.
Перед установкой контейнеров обновите систему, настройте фаервол UFW и установите актуальный Docker Compose Plugin:
# Обновление индекса пакетов и системы
sudo apt-get update && sudo apt-get upgrade -y
sudo apt-get install -y curl ca-certificates ufw
# Установка официального репозитория Docker
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu noble stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker
Для защиты сервера от несанкционированного сканирования настройте брандмауэр UFW, разрешив только стандартные порты SSH (22), HTTP (80) и HTTPS (443). Для проверки открытых портов используйте онлайн-утилиту сканера портов SysKit:
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp comment 'SSH'
sudo ufw allow 80/tcp comment 'HTTP'
sudo ufw allow 443/tcp comment 'HTTPS'
sudo ufw --force enable
sudo ufw status verbose
ports. Они общаются с Directus исключительно во внутренней изолированной Docker-сети, что полностью защищает СУБД от внешних атак и автоматических брутфорс-ботов.
Манифест Docker Compose: связка Directus 12, PostgreSQL 16 и Redis 7
Для развертывания продакшен-окружения создадим изолированный кластер из трёх сервисов: приложения Directus 12 (актуальная стабильная ветка 12.6.x), реляционной СУБД PostgreSQL 16 и высокоскоростного кэша Redis 7 для хранения сессий, инвалидации токенов и кэширования частых SQL-запросов.
Создайте рабочую директорию проекта и сгенерируйте файл с защищёнными переменными окружения:
sudo mkdir -p /opt/directus/{uploads,extensions}
cd /opt/directus
# Генерация криптографических солей и паролей
RAND_KEY=$(openssl rand -hex 16)
RAND_SECRET=$(openssl rand -hex 16)
DB_PASS=$(openssl rand -hex 16)
ADMIN_PASS=$(openssl rand -hex 16)
echo "Пароль администратора Directus: $ADMIN_PASS"
# Запись файла переменных окружения .env
cat <<EOF | sudo tee /opt/directus/.env > /dev/null
KEY=${RAND_KEY}
SECRET=${RAND_SECRET}
ADMIN_EMAIL=admin@example.com
ADMIN_PASSWORD=${ADMIN_PASS}
DB_USER=directus
DB_PASSWORD=${DB_PASS}
DB_DATABASE=directus
PUBLIC_URL=https://directus.example.com
EOF
# Защита файла прав доступа
sudo chmod 600 /opt/directus/.env
Для генерации надёжных случайных паролей и криптографических ключей вы также можете воспользоваться бесплатным онлайн генератором паролей SysKit.
Создайте манифест /opt/directus/docker-compose.yml:
services:
database:
image: postgres:16-alpine
container_name: directus-postgres
restart: unless-stopped
environment:
POSTGRES_USER: ${DB_USER}
POSTGRES_PASSWORD: ${DB_PASSWORD}
POSTGRES_DB: ${DB_DATABASE}
volumes:
- postgres_data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ${DB_USER} -d ${DB_DATABASE}"]
interval: 10s
timeout: 5s
retries: 5
mem_limit: 1024m
cpus: 1.0
cache:
image: redis:7-alpine
container_name: directus-redis
restart: unless-stopped
command: redis-server --save 60 1 --loglevel warning
volumes:
- redis_data:/data
mem_limit: 256m
cpus: 0.5
directus:
image: directus/directus:12
container_name: directus-app
restart: unless-stopped
ports:
# Порт привязан строго к 127.0.0.1 для работы через реверс-прокси Nginx
- "127.0.0.1:8055:8055"
environment:
KEY: ${KEY}
SECRET: ${SECRET}
ADMIN_EMAIL: ${ADMIN_EMAIL}
ADMIN_PASSWORD: ${ADMIN_PASSWORD}
PUBLIC_URL: ${PUBLIC_URL}
# Доверие заголовкам Reverse Proxy (обязательно в Directus 12 за Nginx)
IP_TRUST_PROXY: "true"
# Параметры подключения к PostgreSQL
DB_CLIENT: "pg"
DB_HOST: "database"
DB_PORT: "5432"
DB_DATABASE: ${DB_DATABASE}
DB_USER: ${DB_USER}
DB_PASSWORD: ${DB_PASSWORD}
# Кэширование запросов и сессий в Redis
CACHE_ENABLED: "true"
CACHE_STORE: "redis"
REDIS: "redis://cache:6379"
# Настройки WebSockets и CORS для мобильных и веб-клиентов
WEBSOCKETS_ENABLED: "true"
CORS_ENABLED: "true"
CORS_ORIGIN: "true"
# Локальное хранилище файлов (с возможностью подключения S3)
STORAGE_LOCATIONS: "local"
STORAGE_LOCAL_DRIVER: "local"
STORAGE_LOCAL_ROOT: "./uploads"
volumes:
- ./uploads:/directus/uploads
- ./extensions:/directus/extensions
depends_on:
database:
condition: service_healthy
cache:
condition: service_started
mem_limit: 1536m
cpus: 2.0
volumes:
postgres_data:
redis_data:
IP_TRUST_PROXY: "true"): В поколении Directus 12 доверие прокси-заголовкам по умолчанию выключено. Если вы разворачиваете сервис за Nginx без параметра IP_TRUST_PROXY: "true", Directus видит все входящие соединения как локальные (127.0.0.1). В результате встроенный Rate Limiter воспринимает всех посетителей сайта как одного пользователя и блокирует доступ для всех при превышении лимита запросов. Установка IP_TRUST_PROXY: "true" гарантирует корректное извлечение реальных IP-адресов клиентов из заголовка X-Forwarded-For.
Запустите контейнеры в фоновом режиме:
cd /opt/directus
sudo docker compose up -d
sudo docker compose ps
# Проверка успешного выполнения миграций БД
sudo docker compose logs --tail=50 directus
Настройка Nginx Reverse Proxy: SSL Let's Encrypt, WebSockets и лимиты загрузки
Для безопасной передачи учетных данных, авторизационных токенов и медиафайлов настроим Nginx в качестве шлюза Reverse Proxy с поддержкой постоянных WebSocket-соединений и отключением ограничений на размер передаваемых файлов.
Если вам требуется настроить обратный прокси для других технологических стеков, рекомендуем использовать наш онлайн-генератор Nginx Reverse Proxy конфигураций.
Создайте конфигурацию виртуального хоста /etc/nginx/sites-available/directus.conf:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
server {
listen 80;
server_name directus.example.com;
# Блокировка скрытых файлов
location ~ /\. {
deny all;
}
location / {
proxy_pass http://127.0.0.1:8055;
proxy_http_version 1.1;
# Проброс заголовков для WebSockets и Real-time событий
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
# Разрешение загрузки медиафайлов до 100 МБ
client_max_body_size 100M;
# Таймауты для длительных операций экспорта и файловых загрузок
proxy_connect_timeout 60s;
proxy_send_timeout 300s;
proxy_read_timeout 300s;
}
}
Активируйте виртуальный хост и выпустите бесплатный SSL-сертификат Let's Encrypt:
sudo ln -sf /etc/nginx/sites-available/directus.conf /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
# Автоматический выпуск сертификата с перенаправлением трафика на HTTPS
sudo apt-get install -y certbot python3-certbot-nginx
sudo certbot --nginx -d directus.example.com --non-interactive --agree-tos -m admin@example.com --redirect
# Проверка автопродления сертификата
sudo certbot renew --dry-run
После выпуска сертификата обязательно протестируйте статус защищенного соединения с помощью нашего сканера SSL-сертификатов.
Системные требования к VDS и оптимизация ресурсов
Directus на базе Node.js и TypeScript отличается высокой производительностью благодаря асинхронному вводу-выводу и кэшированию в Redis. Однако при одновременной работе десятков менеджеров в Data Studio, массовом ресайзинге графики (Sharp) и выполнении аналитических SQL-запросов требования к железу возрастают.
Рекомендуемые параметры виртуального сервера:
- Процессор (vCPU): 2 ядра с высокой тактовой частотой (от 3.0 ГГц). Это обеспечивает быструю генерацию превью изображений и мгновенную обработку JSON-ответов.
- Оперативная память (RAM): Минимум 2 ГБ для небольших проектов, оптимально 4 ГБ RAM для средних нагрузок (1.5 ГБ под Directus, 1 ГБ под буферы PostgreSQL, 256 МБ под Redis и остаток для кэша ОС).
- Дисковая подсистема: От 40–50 ГБ высокоскоростного NVMe. Быстрый диск критически важен для низких задержек записи в PostgreSQL и мгновенной генерации кэша превью.
- Сетевой интерфейс: от 100 Мбит/с с неограниченным трафиком для комфортной отдачи тяжелого медиаконтента пользователям.
Рекомендуемые VDS-провайдеры
Отказоустойчивые сервера с быстрыми NVMe и каналом до 1 Гбит/с
Timeweb Cloud — Быстрые NVMe VDS для Directus
Идеально для связки Directus + PostgreSQL: сверхбыстрые накопители NVMe, встроенное S3-хранилище и локальная приватная сеть.
Selectel — Корпоративная инфраструктура и S3
Сертифицированные дата-центры в РФ, поддержка 152-ФЗ, стабильная изоляция БД и выделенный канал до 1 Гбит/с.
Beget — Серверы и хранилище для проектов
Интуитивная панель управления, моментальная генерация S3-бакетов и удобный доступ для системных администраторов.
Первичный вход в Data Studio, структура коллекций и гранулярный RBAC в Directus 12
После успешного запуска перейдите в веб-браузере по адресу https://directus.example.com. Перед вами откроется лаконичная форма входа в Directus Data Studio. Введите email администратора admin@example.com и сгенерированный пароль из файла .env.
Панель управления Directus полностью русифицирована (выбрать язык можно в настройках профиля). Сразу после входа доступны следующие ключевые разделы:
- Коллекции (Content): Рабочее пространство для контент-менеджеров и редакторов. Каждая коллекция представляет собой таблицу базы данных с настраиваемыми представлениями (таблица, канбан-доска, календарь или галерея карточек).
- Конструктор моделей данных (Data Model): Визуальный инструмент архитектора базы. Здесь можно создавать новые таблицы, добавлять связи Many-to-One, One-to-Many или Many-to-Many, выбирать интерфейсы полей (WYSIWYG, Markdown, загрузчик файлов, JSON-редактор, геолокация) без ручного написания миграций.
- Управление доступом (Access Control & Policies): В Directus 12 действует гранулярная архитектура политик безопасности (Policies). Вы можете создавать изолированные роли (например,
Content Manager,Customer Support,Mobile Client) и назначать им политики с точностью до отдельных полей (Field-level Security).
Настройка публичного доступа (Public Role) для фронтенда
По умолчанию Directus блокирует все неавторизованные запросы. Чтобы ваше клиентское приложение (сайт на Next.js, мобильное приложение или каталог) могло читать статьи или товары без авторизации, перейдите в Settings → Access Control → Public:
- Выберите нужную коллекцию (например,
articlesилиproducts). - Установите разрешение на действие Read (Чтение).
- Настройте правило фильтрации (Permissions Rule): например, отдавать только записи со статусом
status = "published"и датойpublished_at <= $NOW. - Ограничьте список доступных полей (Fields), исключив служебные колонки внутренней себестоимости или черновиков.
Подключение российского S3-хранилища для медиафайлов (Timeweb / Selectel)
Хранение сотен гигабайт фотографий товаров, видео и пользовательских документов на локальном диске VDS быстро исчерпывает дорогой NVMe-накопитель и многократно усложняет процесс резервного копирования базы. Directus из коробки поддерживает нативную загрузку медиаконтента в объектные хранилища S3.
Создайте бакет в панели вашего российского провайдера (например, directus-media-bucket в Timeweb Cloud S3 или Selectel) и скорректируйте блок переменных в /opt/directus/docker-compose.yml:
environment:
# Переключение драйвера на объектное хранилище S3
STORAGE_LOCATIONS: "s3"
STORAGE_S3_DRIVER: "s3"
STORAGE_S3_KEY: "ВАШ_ACCESS_KEY"
STORAGE_S3_SECRET: "ВАШ_SECRET_KEY"
STORAGE_S3_BUCKET: "directus-media-bucket"
# Обязательный регион для российских провайдеров (ru-1)
STORAGE_S3_REGION: "ru-1"
# Эндпоинт провайдера: Timeweb (s3.timeweb.cloud) или Selectel (s3.ru-1.storage.selcloud.ru)
STORAGE_S3_ENDPOINT: "https://s3.timeweb.cloud"
STORAGE_S3_ROOT: ""
Перезапустите контейнер для применения изменений:
cd /opt/directus && sudo docker compose up -d directus
Динамическая трансформация изображений «на лету»
Одной из мощнейших функций Directus является встроенный движок ресайзинга на базе библиотеки Sharp. Вам больше не нужно генерировать десятки миниатюр при загрузке: достаточно передать параметры размера и формата прямо в URL файла:
# Получение оптимизированного WebP изображения шириной 600px с качеством 80%
https://directus.example.com/assets/<FILE_ID>?width=600&format=webp&quality=80
Directus автоматически генерирует запрошенную миниатюру при первом обращении, сохраняет её в локальный кэш и мгновенно отдаёт клиенту, существенно экономя интернет-трафик мобильных пользователей.
Автоматизация бизнес-логики: вебхуки, потоки Flows и кэширование в Redis
Directus содержит собственный визуальный движок автоматизации Flows, который полностью устраняет потребность во внешних сервисах вроде Zapier или Make для базовых серверных сценариев.
Автоматическая отправка уведомления в Telegram при новом заказе
Создадим поток автоматизации, который будет мгновенно присылать детали нового заказа в корпоративный Telegram-чат:
- В боковом меню выберите Settings → Flows и нажмите Create Flow (назовите его «Новый заказ в Telegram»).
- В качестве триггера выберите Event Hook (тип действия:
action, события:items.create, коллекция:orders). - Добавьте операцию Webhook / Request URL:
- Метод:
POST - URL:
https://api.telegram.org/botВАШ_ТОКЕН/sendMessage - Заголовки:
Content-Type: application/json - Тело запроса:
{ "chat_id": "ВАШ_CHAT_ID", "parse_mode": "Markdown", "text": "🛍 *Новый заказ на сайте!*\nНомер: `{{$trigger.payload.order_number}}`\nСумма: {{ $trigger.payload.total_price }} ₽\nТелефон: {{ $trigger.payload.customer_phone }}" }
- Метод:
- Сохраните и активируйте поток. Теперь при любом добавлении заказа через сайт, мобильное приложение или REST API уведомление придёт в Telegram за доли секунды.
Тюнинг производительности и кэширование в Redis
При высоких нагрузках Directus позволяет кэшировать ответы API на уровне оперативной памяти Redis. Добавьте в конфигурацию Directus следующие директивы для снижения нагрузки на PostgreSQL:
# Время жизни кэша запросов по умолчанию
CACHE_TTL: "5m"
CACHE_AUTO_PURGE: "true"
# Встроенный Rate Limiting для защиты от перегрузок и спама
RATE_LIMITER_ENABLED: "true"
RATE_LIMITER_STORE: "redis"
RATE_LIMITER_POINTS: "100"
RATE_LIMITER_DURATION: "60"
Параметр CACHE_AUTO_PURGE: "true" гарантирует автоматический сброс закэшированного ответа ровно в тот момент, когда редактор изменяет запись в админке или через API, исключая отдачу устаревших данных.
Итоговый чек-лист надежной эксплуатации Directus на сервере
Перед запуском проекта в коммерческую эксплуатацию сверьтесь с чек-листом инженеров SysKit:
- Изоляция портов: Порт Directus (8055) привязан строго к
127.0.0.1, а порты PostgreSQL (5432) и Redis (6379) скрыты во внутренней сети Docker и недоступны извне. - Доверие прокси (IP_TRUST_PROXY): Переменная
IP_TRUST_PROXY: "true"включена в Directus 12 для корректной работы Rate Limiter и логирования реальных IP-адресов за Nginx. - Надежные криптографические ключи: Переменные
KEYиSECRETсгенерированы случайным образом черезopenssl rand -hex 16и сохранены в защищённом месте. - Защита учетных данных: Права на файл
.envвыставлены вchmod 600. - HTTPS и актуальный SSL: Настроен Nginx Reverse Proxy с бесплатным сертификатом Let's Encrypt и автообновлением.
- Поддержка WebSockets: В Nginx настроены заголовки
UpgradeиConnectionдля работы real-time подписок. - Хранилище медиа: Загрузка тяжелых файлов переведена в S3-бакет с отечественным хранилищем, не расходуя диск VDS.
- Лимиты ресурсов: В Docker Compose заданы директивы
mem_limitиcpusдля предотвращения падения сервера по OOM. - Политика прав (RBAC): Публичной роли (Public) открыт доступ только к необходимым полям опубликованных записей.
- Кэш и защита от перегрузок: Включены Redis-кэширование и встроенный Rate Limiter.
- Автоматизированное резервное копирование: Настроен регулярный ночной дамп базы PostgreSQL с выгрузкой зашифрованных копий во внешний S3.