Ghid Directus CMS: CMS headless database-first pentru dezvoltatori

Ghid Directus CMS: CMS headless database-first pentru dezvoltatori

Majoritatea CMS-urilor headless îți cer să construiești modelul de date în interiorul sistemului lor. Directus răstoarnă acest lucru: învăluie baza ta de date SQL existentă și îți oferă API-uri REST și GraphQL instantanee, fără să îți atingă schema. Cu ~34,5k stele pe GitHub și adoptat de companii precum Tripadvisor, Adobe și Mercedes-Benz, este una dintre cele mai capabile opțiuni open-source printre cele mai bune opțiuni de CMS headless din 2026.

Ce este Directus CMS?

Directus este un CMS headless open-source care învăluie orice bază de date SQL existentă cu API-uri REST și GraphQL instantanee. Spre deosebire de Strapi sau Payload, Directus nu își creează propria schemă de bază de date, ci o oglindește pe a ta. Suportă 7 baze de date, inclusiv PostgreSQL, MySQL, MariaDB, SQLite, OracleDB, CockroachDB și MS-SQL, și este gratuit pentru organizațiile cu venituri sub 5 milioane de dolari, conform documentației oficiale Directus.

Gândește-te la el ca la un strat inteligent care se așază deasupra bazei tale de date. Aduci o bază de date PostgreSQL existentă cu 50 de tabele, îndrepți Directus către ea și în câteva minute ai o interfață de administrare completă, control al accesului bazat pe roluri, precum și endpoint-uri REST și GraphQL. Fără scripturi de migrare. Fără restructurarea datelor.

Asta înseamnă de fapt „database-first" în practică și este fundamental diferit de abordarea code-first folosită de Strapi (unde definești tipuri de conținut care generează tabele în baza de date) sau de abordarea încorporată în framework a Payload CMS (unde CMS-ul trăiește în interiorul aplicației tale Next.js).

Arhitectura „Database-First” explicată

Când am conectat pentru prima dată Directus la o bază de date PostgreSQL existentă, pentru proiectul unui client, ceea ce ne-a surprins a fost cât de puțină configurare a fost necesară. Directus inspectează schema bazei tale de date, tabelele devin „collections”, coloanele devin „fields” și își construiește interfața de administrare pe baza a ceea ce există deja.

Asta înseamnă că datele tale nu sunt niciodată blocate într-un format proprietar. Dacă decizi mâine să nu mai folosești Directus, baza ta de date rămâne o bază de date SQL standard. Încearcă să faci asta cu Contentful sau Sanity, unde conținutul tău se află pe serverele lor, în formatul lor.

De asemenea, Directus nu este doar un CMS. Echipa îl poziționează ca o platformă de date compozabilă — oamenii îl folosesc pentru BaaS (Backend as a Service), panouri de administrare interne și dashboard-uri personalizate. Cazul de utilizare CMS este cel mai popular, dar arhitectura suportă mult mai multe.

Caracteristicile principale ale Directus

Directus oferă API-uri REST și GraphQL duale, permisiuni granulare bazate pe roluri, automatizare Flows integrată, un Data Studio de tip drag-and-drop, gestionarea activelor digitale și suport nativ i18n pentru peste 50 de limbi. Începând cu versiunea 11.15, include editarea colaborativă și un Asistent AI ca funcționalități native, nu ca pluginuri terțe.

Iată ce contează cel mai mult dacă evaluezi Directus pentru un proiect:

API-uri REST și GraphQL în același timp

Ambele API-uri sunt disponibile simultan din aceleași date, fără nicio configurare. Nu trebuie să alegi unul sau altul — le obții pe amândouă. Echipa ta de mobil poate folosi REST, în timp ce frontend-ul web folosește GraphQL. API-ul REST urmează un tipar previzibil (/items/{collection}), iar endpoint-ul GraphQL se află la /graphql.

Fluxuri și automatizare

Fluxurile sunt sistemul de automatizare bazat pe evenimente al Directus, integrat direct în interfața Data Studio. Poți declanșa fluxuri de lucru la evenimente CRUD (element creat, actualizat, șters), programări (de tip cron) sau webhook-uri. Operațiunile includ trimiterea de e-mailuri, efectuarea de cereri HTTP, rularea de cod JavaScript personalizat și transformarea datelor.

Pentru echipele care construiesc cu AI, Directus are chiar și un server nativ ghid Model Context Protocol (MCP), dar mai multe despre asta în secțiunea v11.

Extensii și personalizare

Sistemul de extensii acceptă hook-uri (gestoare de evenimente pe server), endpoint-uri personalizate, panouri UI, module complete și noduri de operațiuni pentru Flows. Extensiile sunt construite cu Vue.js pentru frontend și Node.js simplu pentru backend. Lansarea v11.0 a restructurat extensiile, trecând de la foldere bazate pe tip la un format bundled mai curat.

Iată cum se compară Directus cu concurența în ceea ce privește funcționalitățile:

Ce este nou în Directus v11 (2025–2026)

Directus v11 a introdus suportul nativ pentru serverul MCP (v11.13), un asistent AI care acceptă OpenAI, Anthropic și Gemini (v11.14), editarea colaborativă cu indicatori de prezență în timp real (v11.15) și versiuni de ciornă globale cu permisiuni de implementare bazate pe roluri (v11.16). Toate acestea sunt funcționalități integrate, nu extensii ale comunității.

Acesta este domeniul în care Directus a avansat cel mai rapid și este secțiunea pe care majoritatea competitorilor o omit complet. Doar unul dintre primele șase ghiduri din clasament acoperă vreunul dintre aceste aspecte.

Server MCP și asistent AI

Lansarea v11.13 a făcut din Directus unul dintre primele CMS-uri cu un server MCP nativ. Dacă folosești Claude, ChatGPT sau orice instrument AI compatibil MCP, acesta îți poate gestiona direct conținutul din Directus — citind colecții, creând elemente, actualizând câmpuri — respectând în același timp permisiunile tale RBAC. Dacă ești nou în MCP, ghidul nostru Model Context Protocol (MCP) explică protocolul în detaliu.

Asistentul AI (v11.14) este separat de MCP; este o interfață de chat integrată în Data Studio, care acceptă OpenAI, Anthropic, Gemini și chiar modele locale prin Ollama. Începând cu v11.16, a devenit multimodal: poți încărca imagini și PDF-uri direct în chatul AI pentru procesare.

Editare colaborativă și versiuni draft

Editarea colaborativă a fost lansată în v11.15 cu indicatori de prezență în timp real (poți vedea cine altcineva editează același element) și blocare la nivel de câmp pentru a preveni conflictele. Aceeași versiune a adăugat un modul de implementare Vercel cu permisiuni de implementare bazate pe roluri.

v11.16 a dus mai departe pregătirea conținutului (content staging) prin versiuni draft globale. Fiecare element cu versionare primește automat o copie draft. Editorii pot previzualiza modificările în raport cu versiunea live și pot promova drafturile atunci când sunt gata. Permisiunile de implementare bazate pe roluri înseamnă că echipa ta de conținut poate pregăti modificările fără a le trimite din greșeală în producție.

Primii pași cu Directus (Configurare Docker)

Poți rula Directus local cu Docker în mai puțin de 2 minute. Creează un fișier docker-compose.yml cu imaginea directus/directus, setează conexiunea la baza de date și credențialele de administrator ca variabile de mediu, apoi rulează docker compose up. Directus pornește la localhost:8055.

Configurarea Docker a durat mai puțin de 2 minute de la o pornire la rece. Iată un docker-compose.yml complet, cu PostgreSQL inclus — nu doar containerul Directus, ci întregul 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

Deschide http://localhost:8055, autentifică-te cu credențialele de administrator pe care le-ai setat și vei ajunge în Data Studio. De aici poți crea colecții (tabele), poți defini câmpuri (coloane) și poți începe să gestionezi conținut imediat. Variabilele de mediu KEY și SECRET sunt utilizate pentru generarea tokenurilor JWT — în producție folosește șiruri aleatorii, nu valorile de tip placeholder de mai sus.

Interogarea datelor cu SDK-ul Directus

SDK-ul JavaScript Directus oferă acces type-safe la datele tale atât prin REST, cât și prin GraphQL. Instalează @directus/sdk, creează un client cu createDirectus() și folosește readItems() pentru a prelua colecții cu filtrare, sortare și selectarea câmpurilor incluse.

Modelul compozabil al SDK-ului mi s-a părut intuitiv după ce am lucrat cu biblioteci precum clientul Supabase. Pornești de la un client de bază și adaugi capabilități prin compunerea funcțiilor:

// 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
  })
);

Crearea elementelor urmează același model:

// 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'
  })
);

Pentru autentificare, alegi între staticToken() (pentru comunicarea server-la-server) și authentication() (pentru aplicații orientate către utilizator, cu fluxuri de autentificare):

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());

Exemple de API REST

Fiecare metodă SDK are un endpoint REST echivalent. Dacă preferi să lucrezi direct cu curl sau fetch:

# Preluarea articolelor publicate
curl "http://localhost:8055/items/articles?filter[status][_eq]=published&sort=-date_published&limit=10&fields=id,title,slug"
# Creează un element nou
curl -X POST "http://localhost:8055/items/articles" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "My Post", "status": "draft"}'

Interogări GraphQL

Aceleași date sunt disponibile prin GraphQL la /graphql:

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

Nu este nevoie să configurezi sau să activezi separat GraphQL, acesta fiind disponibil oricând alături de REST.

Directus cu Next.js (integrare cu framework-ul)

Conectarea Directus la Next.js necesită trei pași: instalezi @directus/sdk, creezi un client în lib/directus.ts și preiei datele în Server Components folosind readItems(). Directus returnează JSON brut, așa că ai control deplin asupra randării, fără componente specifice unui vendor.

Aceasta este cea mai curată parte a lucrului cu Directus. Nu există niciun adaptor special pentru framework, nici componente React specifice Directus, nici plugin de build. Este doar preluare de date. Dacă ai lucrat cu vreun API REST în Next.js, știi deja cum funcționează. Pentru context despre alegerea framework-ului, vezi comparația noastră Next.js vs Remix.

Mai întâi, creează clientul partajat (acesta este același fișier din secțiunea despre SDK, dar configurat pentru instanța ta publicată):

// 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 };

Apoi folosește-l într-un Server Component, fără useEffect, fără stări de încărcare, doar 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>
  );
}

Atât. Fără blocaj față de un vendor. Aceeași abordare funcționează cu Astro, Nuxt, SvelteKit sau orice framework care poate face cereri HTTP. Documentația oficială Directus include ghiduri specifice pentru Astro și Nuxt, dacă le dorești, dar tiparul este identic: creezi clientul, apelezi readItems(), randezi.

Prețuri și licențiere Directus CMS (2026)

Directus este gratuit pentru auto-găzduire (self-host) sub licența MIT pentru organizațiile cu venituri sau finanțări anuale mai mici de 5 milioane de dolari. Peste 5 milioane de dolari, este necesară o licență comercială pentru utilizarea în producție. Directus Cloud începe de la 25 USD/lună (Starter), cu planuri Professional de la 49 USD până la 499 USD/lună, conform paginii lor de prețuri.

Pragul de venit de 5 milioane de dolari

Acesta este cel mai important aspect de business legat de Directus, iar majoritatea ghidurilor fie îl îngroapă, fie îl omit complet. Iată cum funcționează:

• Sub 5 milioane de dolari venit anual sau finanțare totală: Gratuit pentru totdeauna. Licență MIT. Self-hosting oriunde. Fără restricții de funcționalități.
• Peste 5 milioane de dolari în producție: Ai nevoie de o licență comercială. Contactează echipa de vânzări Directus pentru prețuri.
• Dezvoltare și testare: Întotdeauna gratuit, indiferent de dimensiunea companiei. Pragul se aplică doar implementărilor de producție.

Pragul de 5 milioane de dolari include finanțarea de tip venture, nu doar veniturile. Așadar, un startup în faza seed cu 6 milioane de dolari finanțare se situează tehnic peste prag. În practică, Directus nu a fost agresiv în aplicarea acestei reguli pentru companiile aflate în faze incipiente, dar ar trebui să iei acest lucru în considerare în planificarea ta.

Planuri Cloud

Dacă nu dorești să gestionezi infrastructura, Directus Cloud se ocupă de găzduire, backup-uri și actualizări:

• Starter: 25 $/lună, potrivit pentru proiecte mici și site-uri personale
• Professional: 49–499 $/lună, scalează în funcție de stocare, lățime de bandă și transformarea resurselor
• Enterprise: prețuri personalizate, SLA, infrastructură dedicată, suport prioritar

Fără licențiere per utilizator. Întreaga echipă folosește același plan. Compară cu Contentful, care taxează per utilizator (vezi analiza noastră a prețurilor Contentful), sau Sanity, care taxează în funcție de utilizarea API-ului și lățimea de bandă a dataset-ului.

Directus vs. Strapi vs. Payload: Cum se compară

Directus învăluie bazele de date existente fără migrare, Strapi generează propria schemă din tipurile de conținut, iar Payload se încorporează direct în aplicația ta Next.js. Directus suportă 7 baze de date, Strapi suportă 2, iar Payload suportă 2. Toate trei sunt open-source, dar filozofiile lor sunt destul de diferite.

După ce am construit proiecte atât cu Strapi, cât și cu Directus, cea mai mare diferență este modul în care se gândesc la baza ta de date. În cazul Strapi, definești tipurile de conținut în interfața de administrare sau în cod, iar Strapi creează și gestionează tabelele bazei de date pentru tine. În cazul Directus, baza de date este sursa de adevăr, Directus o citește și se adaptează.

Când să alegi Directus: Ai o bază de date existentă, vrei REST+GraphQL dual din start sau ai nevoie să suporte baze de date mai puțin comune, precum OracleDB sau CockroachDB.

Când să alegi Strapi: Vrei cel mai mare ecosistem și cea mai mare comunitate, preferi să definești tipurile de conținut printr-o interfață sau începi de la zero fără o bază de date existentă. Citește ghidul nostru complet pentru Strapi pentru detalii.

Când să alegi Payload: Vrei ca CMS-ul să fie încorporat direct în aplicația ta Next.js, preferi configurarea TypeScript-first sau ai nevoie de un API local care să ocolească complet HTTP. Vezi analiza noastră aprofundată a Payload CMS pentru imaginea completă.

Când să NU folosești Directus

Directus nu este alegerea potrivită dacă ai nevoie de un constructor vizual de pagini, de un framework Next.js strâns integrat sau de un backend NoSQL. De asemenea, adaugă complexitate suplimentară pentru proiectele simple, unde un CMS flat-file sau WordPress ar fi suficiente.

Am văzut echipe alegând Directus când nu ar fi trebuit, iar tiparul este de obicei unul dintre următoarele:

• Ai nevoie de un constructor vizual de pagini. Data Studio de la Directus este excelent pentru gestionarea datelor structurate, dar nu este un constructor de site-uri de tip drag-and-drop. Dacă editarea vizuală este prioritatea ta, ia în considerare Storyblok — vezi ghidul nostru Storyblok pentru o comparație.
• Ești hotărât să folosești NoSQL. Directus este exclusiv SQL prin design. Dacă datele tale se află în MongoDB, Payload CMS este potrivirea naturală.
• Proiectul tău este un blog simplu. Să pornești Docker, PostgreSQL și Directus pentru un blog personal este o exagerare serioasă. WordPress, Astro cu fișiere markdown sau chiar Ghost te vor ajuta să publici într-o fracțiune din timp.
• Vrei un CMS integrat în framework. Dacă vrei ca CMS-ul tău să locuiască în interiorul bazei de cod Next.js ca un cetățean de primă clasă, Payload face acest lucru nativ. Directus este întotdeauna un serviciu separat.
• Ești o organizație mare. Dacă compania ta depășește pragul de venit de 5 milioane de dolari, vei avea nevoie de o licență comercială pentru producție. Cântărește acest cost în raport cu alternativele complet open-source, precum Strapi sau Payload, unde self-hosting-ul este gratuit indiferent de venit.

Niciuna dintre acestea nu este un defect — sunt decizii de design. Directus este o platformă de date, nu un constructor de site-uri web. Înțelegerea acestei diferențe îți economisește luni de frustrare.

Întrebări frecvente

Ce este Directus CMS?

Directus este un CMS headless open-source care acoperă orice bază de date SQL existentă cu API-uri REST și GraphQL instantanee. Suportă PostgreSQL, MySQL, MariaDB, SQLite, OracleDB, CockroachDB și MS-SQL. Spre deosebire de CMS-urile tradiționale, Directus nu își creează propria schemă, ci citește și oglindește automat structura bazei tale de date existente.

Este Directus cu adevărat gratuit?

Directus este gratuit pentru auto-găzduire sub licență MIT pentru organizațiile cu venituri anuale sau finanțare totală mai mici de 5 milioane USD. Peste acest prag, ai nevoie de o licență comercială pentru utilizarea în producție. Mediile de dezvoltare și testare sunt întotdeauna gratuite. Directus Cloud, serviciul lor de găzduire gestionată, începe de la 25 USD pe lună.

Cum se diferențiază Directus de Strapi?

Directus este orientat către baza de date: acesta învăluie baza ta de date SQL existentă fără a-i modifica schema. Strapi este orientat către cod: definești tipurile de conținut, iar Strapi generează tabelele bazei de date. Directus suportă 7 baze de date, în timp ce Strapi suportă 2. Ambele oferă API-uri REST, dar Directus include GraphQL nativ, în timp ce Strapi necesită un plugin.

Ce baze de date acceptă Directus?

Directus acceptă șapte baze de date SQL: PostgreSQL, MySQL, MariaDB, SQLite, OracleDB, CockroachDB și MS-SQL. Se conectează la baza ta de date existentă și analizează automat schema. Acest suport pentru mai multe baze de date este unic printre CMS-urile headless, majoritatea competitorilor acceptând doar unul sau două motoare de baze de date.

Poate Directus să înlocuiască WordPress?

Directus poate înlocui WordPress pentru gestionarea conținutului, în special pentru proiecte headless sau bazate pe API. Cu toate acestea, Directus nu dispune de un frontend integrat, teme sau un page builder. Va trebui să îți construiești propriul frontend folosind un framework precum Next.js sau Astro. Pentru bloguri simple sau site-uri care necesită editare vizuală, WordPress rămâne mai practic.

Are Directus un editor vizual?

Directus include Data Studio, o interfață de administrare puternică pentru gestionarea datelor structurate, crearea de tablouri de bord și configurarea permisiunilor. Cu toate acestea, nu dispune de un constructor vizual de pagini sau de un editor de site WYSIWYG precum Storyblok sau WordPress. Directus este conceput pentru gestionarea datelor, nu pentru compunerea paginilor prin drag-and-drop.

Este Directus potrivit pentru e-commerce?

Directus funcționează bine ca sistem de gestionare a informațiilor despre produse (Product Information Management): poți modela cataloage de produse, poți administra atribute și poti livra date prin API-uri. Totuși, nu este o platformă de e-commerce. Nu vei primi un coș de cumpărături, un flux de finalizare a comenzii (checkout) sau procesare de plăți. Asociază-l cu Shopify, Saleor sau Medusa pentru stratul tranzacțional.

Pot folosi Directus cu Next.js?

Da. Instalează pachetul @directus/sdk, creează un client care indică către instanța ta Directus și preia datele în Server Components folosind readItems(). Directus returnează JSON simplu, astfel încât nu sunt necesare componente React specifice unui furnizor. Aceeași abordare funcționează cu orice framework JavaScript, inclusiv Astro, Nuxt și SvelteKit.

Acceptă Directus editarea colaborativă?

Da, începând cu versiunea 11.15 (februarie 2026). Directus oferă editare colaborativă nativă, cu indicatori de prezență în timp real care arată cine editează ce, precum și blocare la nivel de câmp pentru a preveni conflictele. Aceasta este o funcționalitate integrată, nu un plugin. Combinată cu versiunile draft globale din v11.16, echipele pot pregăti și previzualiza modificările înainte de publicare.

Ce este serverul MCP Directus?

Directus a introdus un server nativ Model Context Protocol în v11.13 (noiembrie 2025). MCP permite instrumentelor de IA precum Claude și ChatGPT să interacționeze direct cu conținutul tău Directus, citind, creând și actualizând elemente prin limbaj natural. Serverul MCP respectă permisiunile RBAC existente, astfel încât accesul IA urmează aceleași reguli ca utilizatorii umani.