Directus - headless CMS a Backend as a Service

Open-source BaaS platforma s REST a GraphQL API. Elegantní admin panel, správa oprávnění. Nasazení v Dockeru.

, Infrastruktura a provoz, 3 min čtení
Seriál Vlastní digitální svět, díl 10

Úvod: Proč Directus?

Directus je open-source headless CMS a BaaS platforma, která vám umožní spravovat data přes elegantní admin rozhraní a přistupovat k nim přes REST nebo GraphQL API.

Podporuje:

  • Automatické REST a GraphQL API pro vaše data
  • Elegantní admin panel s WYSIWYG editorem
  • Napojení na existující databázi (PostgreSQL, MySQL, SQLite…)
  • Správa uživatelů, rolí a oprávnění

V tomto článku si ukážeme, jak nasadit Directus v Dockeru a vytvořit první datový model.


Licence a cena

AspektDetail
LicenceBSL 1.1 → GPL 3.0 (po 3 letech)
Self-hostingAno, zdarma a bez omezení funkcí
Komerční použitíAno, lze používat komerčně
Cloud verzeDirectus Cloud (od $99/měsíc)
Zdrojový kódgithub.com/directus/directus

Directus používá Business Source License (BSL) – můžete ho zdarma self-hostovat i pro komerční projekty. Po 3 letech se kód stává GPL. Jediné omezení: nemůžete nabízet Directus jako konkurenční managed službu.


Instalace v Dockeru

version: '3.8'
services:
  directus:
    image: directus/directus:latest
    container_name: directus
    restart: always
    ports:
      - "8055:8055"
    environment:
      KEY: 'your-unique-key-here'
      SECRET: 'your-unique-secret-here'
      DB_CLIENT: 'pg'
      DB_HOST: 'postgres_db'
      DB_PORT: '5432'
      DB_DATABASE: 'directus'
      DB_USER: 'admin'
      DB_PASSWORD: 'your_secure_password'
      ADMIN_EMAIL: 'admin@example.com'
      ADMIN_PASSWORD: 'your_admin_password'
    volumes:
      - directus_uploads:/directus/uploads
      - directus_extensions:/directus/extensions
    networks:
      - selfhosted_network
    depends_on:
      - postgres_db

volumes:
  directus_uploads:
  directus_extensions:

networks:
  selfhosted_network:
    external: true

Directus je dostupný na http://IP_ADRESA:8055 Doporučuji PostgreSQL jako databázi pro produkční nasazení


Konfigurace

Základní nastavení

  1. Přihlaste se pomocí admin credentials
  2. Vytvořte první kolekci (tabulku)
  3. Definujte pole a jejich typy
  4. Nastavte oprávnění pro API přístup

Napojení na existující databázi

  • Directus umí pracovat s existující databází
  • Automaticky vytvoří admin rozhraní pro vaše tabulky
  • Nemodifikuje vaše data, pouze přidá metadata tabulky

Praktické použití

Use case 1: Backend pro mobilní aplikaci typu Airbnb

Situace: Startup vyvíjí aplikaci pro sdílené ubytování. Potřebuje backend s API, ale nemá rozpočet na backend tým.

Řešení s Directus:

  • Kolekce: properties, bookings, users, reviews, messages
  • Relace: Property → Owner (user), Booking → Guest + Property, Review → Property
  • Media: Obrázky nemovitostí automaticky resizované
  • API: REST/GraphQL pro React Native aplikaci
  • Webhooks: Při nové rezervaci → notifikace majiteli (n8n)
  • Flows: Automatické schvalování ověřených hostů

Výsledek: Plnohodnotný backend za víkend, ne měsíce.

Use case 2: Interní znalostní báze firmy

Situace: Firma má dokumenty roztroušené v Google Docs, Confluence, emailech. Nový zaměstnanec se ztrácí.

Řešení s Directus:

  • Kolekce: articles, categories, departments, faqs
  • WYSIWYG editor: Formátovaný obsah s obrázky
  • Verzování: Historie změn každého článku
  • Oprávnění: Marketing vidí jen své, HR jen své, vedení vše
  • Fulltext search: Hledání napříč všemi dokumenty
  • Frontend: Next.js staticky generovaný web

Výsledek: Centrální místo pro veškeré firemní know-how.

Use case 3: Headless e-shop s vlastním frontendem

Situace: E-shop potřebuje custom design, který Shopify/WooCommerce neumožňuje. Zároveň marketing chce snadno editovat obsah.

Řešení s Directus:

  • Kolekce: products, categories, orders, customers, pages
  • Custom fields: Velikosti, barvy, varianty jako JSON pole
  • Relationships: Product ↔ Categories (M2M), Product → Variants (O2M)
  • Webhooks: Nová objednávka → Fakturoid, Zásilkovna, email
  • Frontend: Next.js/Nuxt s ISR (Incremental Static Regeneration)
  • Platby: Stripe/PayPal integrace ve frontendu

Výsledek: Rychlý, SEO-friendly e-shop s krásným adminem pro marketing.

Use case 4: Centrální hub pro IoT data

Situace: Firma má desítky senzorů (teplota, vlhkost, spotřeba). Data končí v různých systémech.

Řešení s Directus:

  • Kolekce: devices, readings, alerts, locations
  • API ingest: Senzory posílají data přes REST API
  • Realtime: WebSocket subscriptions pro live dashboardy
  • Agregace: Custom endpoints pro hodinové/denní průměry
  • Alerting: Flow spustí webhook když hodnota překročí limit
  • Vizualizace: Grafana napojená na stejnou PostgreSQL

Výsledek: Single source of truth pro všechna IoT data.


Directus vs Strapi

AspektDirectusStrapi
LicenceBSL 1.1MIT
Přístup k DBNapojí existujícíVytváří vlastní
Admin UIModernější, intuitivnějšíFunkční, ale starší
Flows (automation)Built-inVyžaduje plugin
RealtimeWebSocketsPlugin
Ideální proExistující DB, aplikaceNové projekty, blogy

Závěr a další kroky

  • Directus je výkonné headless CMS s automatickým API.
  • Elegantní admin panel pro správu obsahu.
  • Napojení na existující databázi bez migrace dat.
  • BSL licence umožňuje komerční self-hosting zdarma.