Průvodce Directus CMS: Database-First Headless CMS pro vývojáře

Průvodce Directus CMS: Headless CMS s prioritou databáze pro vývojáře

Většina headless CMS chce, abyste si datový model vytvořili přímo v jejich systému. Directus to obrací — napojí se na vaši stávající SQL databázi a okamžitě vám poskytne REST a GraphQL API, aniž byste se dotkli schématu. S ~34,5k hvězdičkami na GitHubu a využitím ve firmách jako Tripadvisor, Adobe a Mercedes-Benz patří mezi nejschopnější open-source možnosti v přehledu nejlepších headless CMS v roce 2026.

Co je Directus CMS?

Directus je open-source headless CMS, které obalí libovolnou existující SQL databázi okamžitě dostupnými REST a GraphQL API. Na rozdíl od Strapi nebo Payload si Directus nevytváří vlastní databázové schéma, ale zrcadlí to vaše. Podporuje 7 databází, včetně PostgreSQL, MySQL, MariaDB, SQLite, OracleDB, CockroachDB a MS-SQL, a podle oficiální dokumentace Directus je zdarma pro organizace s obratem do 5 milionů dolarů.

Představte si ho jako chytrou vrstvu, která leží nad vaší databází. Máte existující databázi PostgreSQL s 50 tabulkami, namíříte na ni Directus a během několika minut máte plnohodnotné administrační rozhraní, řízení přístupu na základě rolí a endpointy pro REST i GraphQL. Žádné migrační skripty. Žádná restrukturalizace dat.

Právě to v praxi znamená „database-first“ přístup a zásadně se liší od code-first přístupu, který používá Strapi (kde definujete typy obsahu, jež generují databázové tabulky), ani od přístupu Payload CMS integrovaného do frameworku (kde CMS žije uvnitř vaší Next.js aplikace).

Vysvětlení architektury Database-First

Když jsme poprvé připojili Directus k existující databázi PostgreSQL pro klientský projekt, překvapilo nás, jak málo konfigurace bylo potřeba. Directus introspektuje schéma vaší databáze, tabulky se stanou „kolekcemi“, sloupce se stanou „poli“ a z toho, co už existuje, si sestaví administrační rozhraní.

To znamená, že vaše data nejsou nikdy uzamčena v proprietárním formátu. Pokud se rozhodnete Directus zítra přestat používat, vaše databáze je stále standardní SQL databáze. Zkuste to samé s Contentful nebo Sanity, kde váš obsah žije na jejich serverech v jejich formátu.

Directus také není jen CMS. Tým ho popisuje jako kompozitní datovou platformu, lidé ho používají pro BaaS (Backend as a Service), interní administrační panely a vlastní dashboardy. Případ použití jako CMS je nejpopulárnější, ale architektura podporuje mnohem více.

Klíčové funkce Directus

Directus nabízí duální REST a GraphQL API, jemně odstupňovaná oprávnění na základě rolí, vestavěnou automatizaci Flows, Data Studio s funkcí drag-and-drop, správu digitálních aktiv a nativní podporu i18n pro více než 50 jazyků. Od verze 11.15 zahrnuje také spolupráci při úpravách a AI asistenta jako nativní funkce, nikoli jako pluginy třetích stran.

To nejdůležitější, pokud zvažujete nasazení Directus ve svém projektu:

Duální REST a GraphQL API

Obě API jsou k dispozici současně nad stejnými daty, a to bez jakékoli konfigurace. Nemusíte volit jedno nebo druhé — dostanete obě. Váš mobilní tým může používat REST, zatímco webový frontend může využívat GraphQL. REST API dodržuje předvídatelný vzor (/items/{collection}) a GraphQL endpoint se nachází na adrese /graphql.

Flows a automatizace

Flows je event-driven automatizační systém Directusu zabudovaný přímo do rozhraní Data Studio. Pracovní postupy můžete spouštět při událostech CRUD (vytvoření, aktualizace či smazání položky), na základě plánu (ve stylu cronu) nebo prostřednictvím webhooků. Mezi operace patří odesílání e-mailů, provádění HTTP požadavků, spouštění vlastního JavaScriptu i transformace dat.

Pro týmy, které staví na AI, má Directus dokonce nativní server Model Context Protocol (MCP) — průvodce, ale o tom více až v sekci o verzi v11.

Rozšíření a přizpůsobení

Systém rozšíření podporuje hooky (serverové obslužné rutiny událostí), vlastní endpointy, panely uživatelského rozhraní, plnohodnotné moduly a operační uzly pro Flows. Rozšíření se vytvářejí pomocí Vue.js pro frontend a čistého Node.js pro backend. Vydání v11.0 přeorganizovalo rozšíření ze složek podle typu na čistší balíčkový formát.

Zde je přehled, jak si Directus stojí oproti konkurenci v oblasti funkcí:

Co je nového v Directus v11 (2025–2026)

Directus v11 přinesl nativní podporu serveru MCP (v11.13), AI asistenta s podporou OpenAI, Anthropic a Gemini (v11.14), společné úpravy s živými indikátory přítomnosti (v11.15) a globální verze konceptů s oprávněními pro nasazení na základě rolí (v11.16). To vše jsou vestavěné funkce, nikoli komunitní rozšíření.

Právě v této oblasti se Directus vyvíjí nejrychleji a právě tuto sekci většina konkurence zcela přehlíží. Pouze jeden z šesti nejlépe hodnocených průvodců se něčemu z toho věnuje.

Server MCP a AI asistent

Díky verzi 11.13 se Directus stal jedním z prvních CMS s nativním serverem MCP. Pokud používáte Claude, ChatGPT nebo jakýkoli nástroj AI kompatibilní s MCP, může přímo spravovat váš obsah v Directus — číst kolekce, vytvářet položky a aktualizovat pole, a to vše při respektování vašich oprávnění RBAC. Pokud je pro vás MCP novinkou, náš průvodce Model Context Protocol (MCP) tento protokol podrobně vysvětluje.

AI asistent (v11.14) je od MCP oddělený — jde o vestavěné chatové rozhraní uvnitř Data Studia, které podporuje OpenAI, Anthropic, Gemini a dokonce i lokální modely prostřednictvím Ollama. Od verze 11.16 se stalo multimodálním: můžete přímo do AI chatu nahrávat obrázky a soubory PDF ke zpracování.

Společné úpravy a koncepty verzí

Společné úpravy byly uvedeny ve verzi v11.15 spolu s živými indikátory přítomnosti (vidíte, kdo další upravuje stejnou položku) a se zamykáním na úrovni polí, které zabraňuje konfliktům. Stejné vydání přidalo modul pro nasazení na Vercel s oprávněními k nasazení na základě rolí.

Verze v11.16 posunula staging obsahu ještě dál díky globálním konceptům verzí. Každá verzovaná položka automaticky získá kopii ve formě konceptu. Editoři mohou zobrazit náhled změn oproti živé verzi a koncepty, jakmile jsou připravené, povýšit. Oprávnění k nasazení na základě rolí znamenají, že váš obsahový tým může připravovat změny, aniž by je omylem odeslal do produkce.

Začínáme s Directus (nastavení Dockeru)

Directus můžete spustit lokálně pomocí Dockeru za méně než 2 minuty. Vytvořte soubor docker-compose.yml s obrazem directus/directus, nastavte připojení k databázi a přihlašovací údaje správce jako proměnné prostředí a poté spusťte docker compose up. Directus se spustí na adrese localhost:8055.

Nastavení Dockeru nám od studeného startu zabralo méně než 2 minuty. Zde je kompletní docker-compose.yml včetně PostgreSQL, nejen kontejner Directus, ale celý stack:

# docker-compose.yml
version: "3"
services:
  database:
    image: postgis/postgis:16-3.4-alpine
    environment:
      POSTGRES_USER: directus
      POSTGRES_PASSWORD: directus
      POSTGRES_DB: directus
    volumes:
      - directus_data:/var/lib/postgresql/data

  directus:
    image: directus/directus:11.16
    ports:
      - "8055:8055"
    depends_on:
      - database
    environment:
      KEY: "your-random-key-here"
      SECRET: "your-random-secret-here"
      ADMIN_EMAIL: "[email protected]"
      ADMIN_PASSWORD: "change-me-please"
      DB_CLIENT: "pg"
      DB_HOST: "database"
      DB_PORT: "5432"
      DB_DATABASE: "directus"
      DB_USER: "directus"
      DB_PASSWORD: "directus"
    volumes:
      - directus_uploads:/directus/uploads

volumes:
  directus_data:
  directus_uploads:

Run it:

docker compose up -d

Otevřete http://localhost:8055, přihlaste se jako správce pomocí údajů, které jste nastavili, a ocitnete se v Data Studiu. Odtud můžete vytvářet kolekce (tabulky), definovat pole (sloupce) a ihned začít spravovat obsah. Proměnné prostředí KEY a SECRET slouží ke generování JWT tokenů – v produkčním prostředí použijte náhodné řetězce, nikoli výše uvedené zástupné hodnoty.

Dotazování na data pomocí Directus SDK

Directus JavaScript SDK poskytuje typově bezpečný přístup k vašim datům prostřednictvím REST i GraphQL. Nainstalujte @directus/sdk, vytvořte klienta pomocí createDirectus() a použijte readItems() k načítání kolekcí s vestavěným filtrováním, řazením a výběrem polí.

Kompozitní vzor SDK mi po práci s knihovnami, jako je klient Supabase, přišel intuitivní. Začnete se základním klientem a přidáváte možnosti skládáním funkcí:

// lib/directus.ts
import { createDirectus, rest, readItems, createItem } from '@directus/sdk';

const client = createDirectus('http://localhost:8055').with(rest());

// Fetch published articles with specific fields
const articles = await client.request(
  readItems('articles', {
    fields: ['id', 'title', 'slug', 'content', 'author.name'],
    filter: {
      status: { _eq: 'published' }
    },
    sort: ['-date_published'],
    limit: 10
  })
);

Vytváření položek se řídí stejným vzorem:

// Create a new article
const newArticle = await client.request(
  createItem('articles', {
    title: 'My New Post',
    slug: 'my-new-post',
    content: '<p>Hello from Directus.</p>',
    status: 'draft'
  })
);

Pro ověřování volíte mezi staticToken() (pro komunikaci server-to-server) a authentication() (pro uživatelské aplikace s přihlašovacím tokem):

import { createDirectus, rest, staticToken } from '@directus/sdk';

// Server-side with static token
const client = createDirectus('http://localhost:8055')
  .with(staticToken('your-api-token'))
  .with(rest());

Příklady REST API

Každá metoda SDK má svůj ekvivalentní REST endpoint. Pokud preferujete práci přímo s curl nebo fetch:

# Fetch published articles
curl \"http://localhost:8055/items/articles?filter[status][_eq]=published&sort=-date_published&limit=10&fields=id,title,slug\"
# Vytvoření nové položky
curl -X POST "http://localhost:8055/items/articles" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "My Post", "status": "draft"}'

GraphQL dotazy

Stejná data jsou dostupná i přes GraphQL na adrese /graphql:

query {
  articles(
    filter: { status: { _eq: "published" } }
    sort: ["-date_published"]
    limit: 10
  ) {
    id
    title
    slug
    content
    author {
      name
    }
  }
}

GraphQL nemusíte nijak konfigurovat ani povolovat, je vždy k dispozici společně s REST.

Directus s Next.js (integrace frameworku)

Připojení Directusu k Next.js zabere tři kroky: nainstalujte @directus/sdk, vytvořte klienta lib/directus.ts a načítejte data ve svých Server Components pomocí readItems(). Directus vrací čistý JSON, takže máte nad vykreslováním plnou kontrolu bez komponent specifických pro dodavatele.

Tohle je nejčistší část práce s Directusem. Žádný speciální adaptér pro framework, žádné React komponenty specifické pro Directus, žádný build plugin. Je to jen načítání dat. Pokud jste v Next.js pracovali s jakýmkoli REST API, už víte, jak to funguje. Pro kontext k výběru frameworku se podívejte na naše srovnání Next.js vs Remix.

Nejprve vytvořte sdíleného klienta (je to stejný soubor jako v sekci o SDK, ale nakonfigurovaný pro vaši nasazenou instanci):

// lib/directus.ts
import { createDirectus, rest, staticToken, readItems } from '@directus/sdk';

const directus = createDirectus(process.env.DIRECTUS_URL!)
  .with(staticToken(process.env.DIRECTUS_TOKEN!))
  .with(rest());

export default directus;
export { readItems };

Poté ho použijte v Server Component — žádné useEffect, žádné stavy načítání, jen async/await:

// app/blog/page.tsx
import directus, { readItems } from '@/lib/directus';

export default async function BlogPage() {
  const posts = await directus.request(
    readItems('posts', {
      fields: ['id', 'title', 'slug', 'excerpt', 'date_published'],
      filter: { status: { _eq: 'published' } },
      sort: ['-date_published'],
    })
  );

  return (
    <main>
      <h1>Blog</h1>
      {posts.map((post) => (
        <article key={post.id}>
          <h2><a href={`/blog/${post.slug}`}>{post.title}</a></h2>
          <p>{post.excerpt}</p>
          <time>{post.date_published}</time>
        </article>
      ))}
    </main>
  );
}

A to je vše. Žádné uzamčení u dodavatele. Stejný přístup funguje s Astro, Nuxt, SvelteKit nebo jakýmkoli frameworkem, který umí dělat HTTP požadavky. Oficiální dokumentace Directusu obsahuje návody specifické pro Astro a Nuxt, pokud je chcete, ale vzor je stejný: vytvořit klienta, zavolat readItems(), vykreslit.

Ceny a licence Directus CMS (2026)

Directus je zdarma k vlastnímu hostování pod licencí MIT pro organizace s ročním příjmem nebo financováním nižším než 5 milionů USD. Nad hranicí 5 milionů USD je pro produkční použití vyžadována komerční licence. Directus Cloud začíná na 25 USD měsíčně (Starter) a plány Professional se pohybují od 49 do 499 USD měsíčně, podle jejich ceníku.

Hranice tržeb 5 milionů dolarů

Toto je zdaleka nejdůležitější obchodní fakt o Directusu a většina průvodců ho buď zahrabe, nebo úplně vynechá. Funguje to takto:

• Roční tržby nebo celkové financování pod 5 miliony dolarů: Navždy zdarma. Licence MIT. Vlastní hosting kdekoli. Žádná omezení funkcí.
• Nad 5 milionů dolarů v produkci: Potřebujete komerční licenci. Ohledně cen se obraťte na obchodní oddělení Directusu.
• Vývoj a testování: Vždy zdarma, bez ohledu na velikost společnosti. Hranice se vztahuje pouze na produkční nasazení.

Částka 5 milionů dolarů zahrnuje i rizikové financování, nejen tržby. Takže startup v seed fázi s financováním 6 milionů dolarů technicky spadá nad tuto hranici. V praxi Directus u raných společností s vymáháním nijak netlačí, ale měli byste s tím při plánování počítat.

Cloudové plány

Pokud nechcete spravovat infrastrukturu, Directus Cloud se postará o hosting, zálohy a aktualizace:

• Starter: 25 $/měsíc, vhodné pro malé projekty a osobní weby
• Professional: 49–499 $/měsíc, škáluje se podle úložiště, přenosu dat a transformací assetů
• Enterprise: individuální cenová nabídka, SLA, dedikovaná infrastruktura, prioritní podpora

Žádné licencování podle počtu uživatelů. Celý váš tým používá stejný plán. Porovnejte to s Contentful, který účtuje za každého uživatele (viz náš rozbor cen Contentful), nebo Sanity, který účtuje na základě využití API a přenosu dat datasetu.

Directus vs Strapi vs Payload: Jak se liší

Directus obaluje existující databáze bez nutnosti migrace, Strapi si generuje vlastní schéma z obsahových typů a Payload se vkládá přímo do vaší Next.js aplikace. Directus podporuje 7 databází, Strapi podporuje 2 a Payload podporuje 2. Všechny tři jsou open-source, ale jejich filozofie se značně liší.

Když jsme stavěli projekty se Strapi i Directus, největší rozdíl je v tom, jak přistupují k vaší databázi. U Strapi definujete obsahové typy v admin UI nebo v kódu a Strapi za vás vytváří a spravuje databázové tabulky. U Directus je databáze zdrojem pravdy – Directus ji přečte a přizpůsobí se.

Kdy zvolit Directus: Máte existující databázi, chcete duální REST+GraphQL bez další konfigurace, nebo potřebujete podporovat méně obvyklé databáze jako OracleDB nebo CockroachDB.

Kdy zvolit Strapi: Chcete největší ekosystém a komunitu, preferujete definování obsahových typů přes UI, nebo začínáte od nuly bez existující databáze. Podrobnosti najdete v našem kompletním průvodci Strapi.

Kdy zvolit Payload: Chcete mít CMS vložené přímo ve vaší Next.js aplikaci, preferujete TypeScript-first konfiguraci, nebo potřebujete Local API, které zcela obejde HTTP. Kompletní přehled najdete v našem detailním rozboru Payload CMS.

Kdy Directus nepoužívat

Directus není správnou volbou, pokud potřebujete vizuální nástroj pro tvorbu stránek, úzce propojený framework Next.js nebo NoSQL backend. U jednoduchých projektů, kde by stačil flat-file CMS nebo WordPress, také přidává zbytečnou režii.

Viděli jsme týmy zvolit Directus, přestože neměly, a obvykle se jednalo o jeden z těchto scénářů:

• Potřebujete vizuální nástroj pro tvorbu stránek. Data Studio od Directusu je skvělé pro správu strukturovaných dat, ale nejde o drag-and-drop nástroj pro tvorbu webů. Pokud je pro vás vizuální editace prioritou, podívejte se na Storyblok, srovnání najdete v našem průvodci Storyblokem.
• Vsadili jste na NoSQL. Directus je z principu pouze SQL. Pokud vaše data žijí v MongoDB, přirozenou volbou je Payload CMS.
• Váš projekt je jednoduchý blog. Spouštět Docker, PostgreSQL a Directus kvůli osobnímu blogu je zbytečný přehnaný zásah. S WordPress, Astrem s markdown soubory nebo klidně Ghostem budete publikovat za zlomek času.
• Chcete CMS uvnitř frameworku. Pokud chcete, aby bylo vaše CMS prvotřídní součástí vaší kódové báze v Next.js, Payload to umí nativně. Directus je vždy samostatná služba.
• Jste velká organizace. Pokud vaše firma překročí hranici tržeb 5 milionů dolarů, budete pro produkční nasazení potřebovat komerční licenci. Zvažte tyto náklady oproti plně open-source alternativám jako Strapi nebo Payload, kde je self-hosting zdarma bez ohledu na výši tržeb.

Nic z toho nejsou nedostatky, jsou to záměrná designová rozhodnutí. Directus je datová platforma, ne nástroj pro tvorbu webů. Pochopení tohoto rozdílu vám ušetří měsíce frustrace.

Často kladené dotazy

Co je Directus CMS?

Directus je open-source headless CMS, které obalí libovolnou existující SQL databázi okamžitými REST a GraphQL API. Podporuje PostgreSQL, MySQL, MariaDB, SQLite, OracleDB, CockroachDB a MS-SQL. Na rozdíl od tradičních CMS nevytváří Directus vlastní schéma – automaticky načítá a zrcadlí strukturu vaší stávající databáze.

Je Directus opravdu zdarma?

Directus je pod licencí MIT zdarma pro vlastní hostování pro organizace s ročním příjmem nebo celkovým financováním nižším než 5 milionů USD. Nad touto hranicí potřebujete pro produkční použití komerční licenci. Vývojová a testovací prostředí jsou vždy zdarma. Directus Cloud, jejich spravovaný hosting, začíná na 25 USD měsíčně.

Jak se Directus liší od Strapi?

Directus je database-first — obalí vaši stávající SQL databázi, aniž by měnil její schéma. Strapi je code-first — definujete typy obsahu a Strapi vygeneruje databázové tabulky. Directus podporuje 7 databází, zatímco Strapi pouze 2. Oba nabízejí REST API, ale Directus obsahuje nativní GraphQL, kdežto Strapi vyžaduje plugin.

Jaké databáze Directus podporuje?

Directus podporuje sedm SQL databází: PostgreSQL, MySQL, MariaDB, SQLite, OracleDB, CockroachDB a MS-SQL. Připojí se k vaší stávající databázi a automaticky zanalyzuje její schéma. Tato podpora více databází je mezi headless CMS jedinečná – většina konkurenčních řešení podporuje pouze jeden nebo dva databázové enginy.

Může Directus nahradit WordPress?

Directus může nahradit WordPress pro správu obsahu, zejména u headless projektů nebo projektů řízených API. Directus však nemá vestavěný frontend, šablony ani nástroj pro tvorbu stránek. Budete si muset vytvořit vlastní frontend pomocí frameworku, jako je Next.js nebo Astro. Pro jednoduché blogy nebo weby vyžadující vizuální úpravy zůstává WordPress praktičtější.

Má Directus vizuální editor?

Directus obsahuje Data Studio, výkonné administrační rozhraní pro správu strukturovaných dat, tvorbu dashboardů a konfiguraci oprávnění. Nemá však vizuální nástroj pro tvorbu stránek ani WYSIWYG editor webu jako Storyblok nebo WordPress. Directus je navržen pro správu dat, nikoli pro skládání stránek metodou drag-and-drop.

Je Directus vhodný pro e-commerce?

Directus funguje dobře jako systém pro správu produktových informací (Product Information Management) — můžete v něm modelovat produktové katalogy, spravovat atributy a poskytovat data přes API. Nejedná se však o e-commerce platformu. Nenajdete v něm nákupní košík, pokladní proces ani zpracování plateb. Pro transakční vrstvu jej zkombinujte se Shopify, Saleor nebo Medusa.

Mohu používat Directus s Next.js?

Ano. Nainstalujte balíček @directus/sdk, vytvořte klienta odkazujícího na vaši instanci Directus a načítejte data v Server Components pomocí readItems(). Directus vrací čistý JSON, takže nejsou potřeba žádné React komponenty specifické pro daného dodavatele. Stejný postup funguje s jakýmkoli JavaScriptovým frameworkem, včetně Astro, Nuxt a SvelteKit.

Podporuje Directus kolaborativní úpravy?

Ano, od verze 11.15 (únor 2026). Directus nabízí nativní kolaborativní úpravy s ukazateli živé přítomnosti, které zobrazují, kdo co upravuje, a se zamykáním na úrovni polí, jež zabraňuje konfliktům. Jedná se o vestavěnou funkci, nikoli o plugin. V kombinaci s globálními verzemi konceptů ve v11.16 mohou týmy změny připravit a zobrazit jejich náhled před publikováním.

Co je server Directus MCP?

Directus představil ve verzi 11.13 (listopad 2025) nativní server Model Context Protocol. MCP umožňuje AI nástrojům, jako jsou Claude a ChatGPT, přímo pracovat s vaším obsahem v Directusu – číst, vytvářet a aktualizovat položky prostřednictvím přirozeného jazyka. Server MCP respektuje vaše stávající oprávnění RBAC, takže přístup AI se řídí stejnými pravidly jako přístup lidských uživatelů.