Directus CMS 指南：開發者適用的資料庫優先無頭 CMS

Directus CMS 指南：開發者的資料庫優先無頭 CMS

大多數無頭 CMS 都希望你將資料模型建在它們的系統內。Directus 反其道而行，它直接包覆你現有的 SQL 資料庫，在不更動 schema 的情況下，立即為你提供 REST 與 GraphQL API。憑藉約 34.5k GitHub 星數，以及 Tripadvisor、Adobe、Mercedes-Benz 等公司的採用，它是2026 年最佳無頭 CMS 選項中功能最強大的開源方案之一。

什麼是 Directus CMS？

Directus 是一個開源的無頭 CMS，能為任何現有的 SQL 資料庫即時提供 REST 與 GraphQL API。與 Strapi 或 Payload 不同，Directus 不會自行建立資料庫 schema，而是直接對應你既有的結構。根據 Directus 官方文件，它支援 7 種資料庫，包括 PostgreSQL、MySQL、MariaDB、SQLite、OracleDB、CockroachDB 與 MS-SQL，且營收低於 500 萬美元的組織均可免費使用。

你可以把它想像成位於資料庫之上的一層智慧層。假設你有一個包含 50 張資料表的現有 PostgreSQL 資料庫，只要將 Directus 指向它，幾分鐘內就能擁有完整的管理介面、基於角色的存取控制，以及 REST 與 GraphQL 端點。不需要遷移腳本，也不用重組資料。

這就是「資料庫優先」在實務上的真正意涵，它與 Strapi 採用的「程式碼優先」方式（由你定義內容類型，再產生資料庫資料表）有著根本上的差異，也不同於 Payload CMS 的「框架內嵌」方式（將 CMS 直接嵌入你的 Next.js 應用程式中）。

資料庫優先架構說明

當我們第一次在客戶專案中將 Directus 連接到現有的 PostgreSQL 資料庫時，令我們驚訝的是所需的設定竟然這麼少。Directus 會探索你的資料庫結構描述，資料表會變成「集合（collections）」，資料欄會變成「欄位（fields）」，並根據既有的內容建立其管理介面。

這意味著你的資料永遠不會被鎖定在專有格式中。如果你決定明天就停止使用 Directus，你的資料庫仍然是一個標準的 SQL 資料庫。換成 Contentful 或 Sanity 試試看——你的內容可是存放在他們的伺服器上、使用他們的格式。

Directus 也不只是一個 CMS。團隊將其定位為一個可組合的資料平台，人們用它來做 BaaS（後端即服務）、內部管理後台，以及自訂儀表板。CMS 是最熱門的使用情境，但這套架構所能支援的遠不止於此。

Directus 的主要功能

Directus 提供 REST 與 GraphQL 雙重 API、精細的角色權限控管、內建的 Flows 自動化流程、拖拉式 Data Studio、數位資產管理，以及支援超過 50 種語言的原生 i18n 國際化功能。自 v11.15 起，協同編輯與 AI 助理已成為原生功能，而非第三方外掛。

如果你正在評估 Directus 是否適合你的專案，以下是你最需要關注的重點：

REST 與 GraphQL 雙 API

兩個 API 可同時使用，共用同一份資料，且完全無需設定。你無須二選一，兩者皆可同時使用。行動端團隊可以使用 REST，網頁前端則使用 GraphQL。REST API 遵循可預測的模式（/items/{collection}），GraphQL 端點則位於 /graphql。

Flows 與自動化

Flows 是 Directus 的事件驅動自動化系統，直接內建於 Data Studio 使用者介面中。你可以在 CRUD 事件（項目建立、更新、刪除）、排程（cron 風格）或 webhook 上觸發工作流程。可執行的操作包括寄送電子郵件、發送 HTTP 請求、執行自訂 JavaScript，以及轉換資料。

對於使用 AI 進行開發的團隊，Directus 甚至提供了原生的 Model Context Protocol（MCP）指南伺服器，不過這部分會在 v11 章節中進一步說明。

擴充功能與自訂

擴充系統支援掛鉤（伺服器端事件處理程式）、自訂端點、UI 面板、完整模組，以及用於 Flows 的操作節點。擴充功能的前端以 Vue.js 打造，後端則使用純 Node.js。v11.0 版本將擴充功能從以類型劃分的資料夾，重構為更簡潔的捆綁格式。

以下是 Directus 在功能方面與競爭對手的比較：

Directus v11 有什麼新功能（2025-2026）

Directus v11 推出了原生 MCP 伺服器支援（v11.13）、支援 OpenAI、Anthropic 與 Gemini 的 AI 助理（v11.14）、具備即時在線狀態指示的協同編輯（v11.15），以及具有基於角色的部署權限的全域草稿版本（v11.16）。這些都是內建功能，而非社群擴充功能。

這是 Directus 發展最快的領域，也是大多數競爭對手完全忽略的部分。排名前六的指南中，只有一份有涵蓋到這其中的任何內容。

MCP 伺服器與 AI 助理

v11.13 版本讓 Directus 成為首批內建原生 MCP 伺服器的 CMS 之一。如果你使用 Claude、ChatGPT 或任何相容 MCP 的 AI 工具，它們可以直接管理你的 Directus 內容——讀取集合、建立項目、更新欄位，同時完全遵循你的 RBAC 權限設定。如果你剛接觸 MCP，我們的 Model Context Protocol（MCP）指南有詳細的協定說明。

AI 助理（v11.14）與 MCP 不同，它是 Data Studio 內建的聊天介面，支援 OpenAI、Anthropic、Gemini，甚至可透過 Ollama 使用本機模型。到了 v11.16，它已支援多模態：你可以直接將圖片和 PDF 上傳至 AI 聊天中進行處理。

協作編輯與草稿版本

協作編輯於 v11.15 正式推出，具備即時在線狀態指示（你可以看到還有誰正在編輯同一個項目）以及欄位層級的鎖定機制，以防止衝突。同一版本也新增了 Vercel 部署模組，並支援基於角色的部署權限。

v11.16 透過全域草稿版本，讓內容暫存功能更進一步。每個啟用版本控制的項目都會自動取得一份草稿副本。編輯者可以針對線上版本預覽變更，並在準備就緒時將草稿正式發佈。基於角色的部署權限，代表你的內容團隊可以暫存變更，而不會意外推送到正式環境。

Directus 快速上手（Docker 設定）

你可以在 2 分鐘內用 Docker 在本機執行 Directus。建立一個使用 directus/directus 映像檔的 docker-compose.yml 檔案，將資料庫連線與管理員帳密設為環境變數，然後執行 docker compose up。Directus 會啟動於 localhost:8055。

從冷啟動開始，Docker 設定只花了我們不到 2 分鐘。這是一份完整的 docker-compose.yml，當中包含 PostgreSQL，不只是 Directus 容器，而是完整的堆疊：

# 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

開啟 http://localhost:8055，使用你設定的管理員帳號密碼登入，即可進入 Data Studio。在這裡你可以建立 collections（資料表）、定義 fields（欄位），並立即開始管理內容。KEY 和 SECRET 環境變數用於產生 JWT token，在正式環境中請使用隨機字串，而非上方的預設值。

使用 Directus SDK 查詢資料

Directus JavaScript SDK 透過 REST 與 GraphQL 提供對資料的型別安全存取。安裝 @directus/sdk、使用 createDirectus() 建立用戶端，並使用 readItems() 來擷取集合，內建篩選、排序與欄位選取功能。

在使用過 Supabase 用戶端這類函式庫之後，SDK 的可組合模式讓我覺得相當直覺。你先從一個基礎用戶端開始，再透過組合函式來加入各種功能：

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

建立項目也遵循相同的模式：

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

在驗證方面，你可以在 staticToken()（用於伺服器對伺服器的通訊）與 authentication()（用於具有登入流程、面向使用者的應用程式）之間做選擇：

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

REST API 範例

每個 SDK 方法都有對應的 REST 端點。如果你偏好直接使用 curl 或 fetch：

# 取得已發佈的文章
curl \"http://localhost:8055/items/articles?filter[status][_eq]=published&sort=-date_published&limit=10&fields=id,title,slug\"
# 建立新項目
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 查詢

相同的資料也可透過 /graphql 上的 GraphQL 取得：

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

您不需要另外設定或啟用 GraphQL，它始終與 REST 同時可用。

Directus 與 Next.js（框架整合）

將 Directus 連接到 Next.js 只需三個步驟：安裝 @directus/sdk、建立 lib/directus.ts 客戶端，然後在伺服器元件中使用 readItems() 取得資料。Directus 回傳的是原始 JSON，因此你可以完全掌控渲染方式，不需要依賴任何廠商專屬的元件。

這是使用 Directus 最乾淨俐落的部分。沒有特殊的框架適配器、沒有 Directus 專屬的 React 元件、也沒有建置外掛，純粹就是資料取得。如果你曾在 Next.js 中串接過任何 REST API，你已經知道怎麼做了。關於框架選型的背景資訊，請參考我們的 Next.js 與 Remix 比較。

首先，建立共用的客戶端（這與 SDK 章節中的檔案相同，但已針對你的部署環境進行設定）：

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

接著在伺服器元件中使用它，不需要 useEffect、不需要載入狀態，只要 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>
  );
}

就是這樣。沒有廠商鎖定。同樣的做法適用於 Astro、Nuxt、SvelteKit，或任何能發出 HTTP 請求的框架。Directus 官方文件包含 Astro 和 Nuxt 的專屬指南，如果你需要的話可以參考，但模式是一樣的：建立客戶端、呼叫 readItems()、渲染。

Directus CMS 價格與授權（2026）

Directus 採用 MIT 授權條款，對於年收入或資金低於 500 萬美元的組織，可自行託管且完全免費。超過 500 萬美元者，在生產環境使用時須取得商業授權。根據官方價格頁面，Directus Cloud 的 Starter 方案起價為每月 25 美元，Professional 方案則介於每月 49 至 499 美元之間。

500 萬美元營收門檻

這是關於 Directus 最重要的商業事實，而多數指南不是把它草草帶過，就是完全略過不提。運作方式如下：

• 年營收或累計募資低於 500 萬美元： 永久免費。MIT 授權。隨處自架。無功能限制。
• 生產環境超過 500 萬美元： 需要商業授權。請聯繫 Directus 業務團隊取得報價。
• 開發與測試： 無論公司規模，一律免費。此門檻僅適用於生產環境部署。

500 萬美元的計算包含創投資金，而非僅限營收。因此，一家募得 600 萬美元的種子輪新創，嚴格來說已超過門檻。實務上，Directus 並未對早期公司積極執法，但你仍應將此納入規劃考量。

雲端方案

如果你不想自行管理基礎設施，Directus Cloud 會替你處理託管、備份與更新：

• Starter： 每月 $25 美元，適合小型專案、個人網站
• Professional： 每月 $49–$499 美元，可隨儲存空間、頻寬與素材轉換量擴充
• Enterprise： 客製化報價、SLA、專用基礎設施、優先支援

沒有按席位計費的授權方式。你的整個團隊都使用同一個方案。相較之下，Contentful 是按使用者計費（參見我們的 Contentful 價格解析），而 Sanity 則是根據 API 使用量與資料集頻寬來收費。

Directus vs Strapi vs Payload：三者比較

Directus 直接包裝現有資料庫而無需遷移，Strapi 從內容型別產生自己的架構，Payload 則直接嵌入你的 Next.js 應用程式中。Directus 支援 7 種資料庫，Strapi 支援 2 種，Payload 支援 2 種。三者皆為開源專案，但設計理念截然不同。

在分別使用 Strapi 和 Directus 建置專案後，我發現最大的差異在於它們如何看待你的資料庫。使用 Strapi 時，你在管理介面或程式碼中定義內容型別，Strapi 會為你建立並管理資料庫資料表。使用 Directus 時，資料庫才是唯一的真相來源，Directus 會讀取資料庫並自動適應。

適合選擇 Directus 的情境： 你已經有現有的資料庫、希望開箱即用的 REST+GraphQL 雙重支援，或需要支援 OracleDB、CockroachDB 等較少見的資料庫。

適合選擇 Strapi 的情境： 你希望擁有最大的生態系與社群、偏好透過介面定義內容型別，或從零開始且沒有現有資料庫。詳情請參閱我們的 Strapi 完整指南。

適合選擇 Payload 的情境： 你希望將 CMS 直接嵌入 Next.js 應用程式中、偏好 TypeScript 優先的設定方式，或需要完全跳過 HTTP 的 Local API。完整內容請參閱我們的 Payload CMS 深度解析。

什麼時候不該使用 Directus

如果你需要視覺化頁面建立工具、緊密整合的 Next.js 框架，或是 NoSQL 後端，那麼 Directus 並不適合你。對於使用扁平檔案 CMS 或 WordPress 就足夠的簡單專案，它也會帶來不必要的額外負擔。

我們見過不少團隊在不該選擇 Directus 的時候選了它，而情況通常不出以下幾種：

• 你需要視覺化頁面建立工具。 Directus 的 Data Studio 在結構化資料管理方面表現出色，但它並不是拖放式的網站建立工具。如果視覺化編輯是你的首要需求，可以看看 Storyblok，參閱我們的 Storyblok 指南了解兩者的比較。
• 你已經決定使用 NoSQL。 Directus 在設計上僅支援 SQL。如果你的資料存放在 MongoDB，那麼 Payload CMS 才是自然的選擇。
• 你的專案只是一個簡單的部落格。 為了個人部落格而啟動 Docker、PostgreSQL 和 Directus，實在是殺雞用牛刀。WordPress、搭配 markdown 檔案的 Astro，甚至 Ghost，都能讓你在更短的時間內開始發佈內容。
• 你想要框架內建的 CMS。 如果你希望 CMS 作為一等公民存在於 Next.js 程式碼庫中，Payload 原生就能做到這一點。Directus 始終是一個獨立的服務。
• 你是大型組織。 如果你的公司營收超過 500 萬美元的門檻，在正式環境使用就需要商業授權。請將這筆成本與 Strapi 或 Payload 等完全開源的替代方案相比較——後者無論營收多寡，自架都是免費的。

這些都不是缺陷，而是設計上的取捨。Directus 是一個資料平台，而非網站建立工具。了解兩者的差異，能為你省下數月的挫折與困擾。

常見問題

什麼是 Directus CMS？

Directus 是一個開源的無頭 CMS，能為任何現有的 SQL 資料庫即時產生 REST 與 GraphQL API。它支援 PostgreSQL、MySQL、MariaDB、SQLite、OracleDB、CockroachDB 和 MS-SQL。與傳統 CMS 不同，Directus 不會建立自己的資料結構，而是自動讀取並鏡像你現有的資料庫架構。

Directus 真的免費嗎？

Directus 採用 MIT 授權，對於年收入或總募資金額低於 500 萬美元的組織，可自行託管並免費使用。超過此門檻者，在生產環境中使用則需取得商業授權。開發與測試環境則一律免費。Directus 提供的託管服務 Directus Cloud，每月費用自 25 美元起。

Directus 和 Strapi 有什麼不同？

Directus 採用資料庫優先的設計，它會封裝你現有的 SQL 資料庫，且不會修改其結構描述（schema）。Strapi 則是程式碼優先，你需要自行定義內容型別，再由 Strapi 產生對應的資料表。Directus 支援 7 種資料庫，而 Strapi 僅支援 2 種。兩者都提供 REST API，但 Directus 內建原生 GraphQL 支援，Strapi 則需要透過外掛才能使用。

Directus 支援哪些資料庫？

Directus 支援七種 SQL 資料庫：PostgreSQL、MySQL、MariaDB、SQLite、OracleDB、CockroachDB 和 MS-SQL。它能連接您現有的資料庫，並自動對結構描述進行內省。這種多資料庫支援在無頭 CMS 中獨樹一幟，大多數競爭對手僅支援一到兩種資料庫引擎。

Directus 能取代 WordPress 嗎？

Directus 能夠取代 WordPress 用於內容管理，尤其適合無頭（headless）或以 API 驅動的專案。不過，Directus 並沒有內建的前端、佈景主題或頁面建構器。你需要使用 Next.js 或 Astro 這類框架自行打造前端。對於簡單的部落格，或需要視覺化編輯的網站而言，WordPress 仍然是更務實的選擇。

Directus 有視覺化編輯器嗎？

Directus 內建了 Data Studio，這是一個功能強大的管理介面，可用於管理結構化資料、建立儀表板以及設定權限。然而，它並不具備像 Storyblok 或 WordPress 那樣的視覺化頁面編輯器或 WYSIWYG 網站編輯器。Directus 的設計目標是資料管理，而非拖放式的頁面排版。

Directus 適合用於電子商務嗎？

Directus 作為產品資訊管理系統表現相當出色，你可以建立產品目錄、管理屬性，並透過 API 提供資料。然而，它並非電子商務平台。你無法獲得購物車、結帳流程或金流處理功能。建議搭配 Shopify、Saleor 或 Medusa 來處理交易層。

Directus 可以搭配 Next.js 使用嗎？

可以。安裝 @directus/sdk 套件，建立指向你的 Directus 執行個體的用戶端，並在 Server Components 中使用 readItems() 取得資料。Directus 回傳純 JSON，因此不需要任何廠商專屬的 React 元件。同樣的做法也適用於任何 JavaScript 框架，包括 Astro、Nuxt 和 SvelteKit。

Directus 是否支援協作編輯？

是的，自 11.15 版本（2026 年 2 月）起已支援。Directus 原生提供協作編輯功能，具備即時編輯狀態指示，可顯示誰正在編輯什麼內容，並透過欄位級鎖定防止衝突。這是內建功能，而非外掛。搭配 v11.16 的全域草稿版本，團隊能在正式發佈前暫存並預覽變更。

什麼是 Directus MCP 伺服器？

Directus 在 v11.13（2025 年 11 月）推出了原生的 Model Context Protocol 伺服器。MCP 讓 Claude 和 ChatGPT 等 AI 工具能夠直接與你的 Directus 內容互動，透過自然語言讀取、建立和更新項目。MCP 伺服器會遵循你現有的 RBAC 權限設定，因此 AI 的存取與人類使用者遵循相同的規則。