directus / directus

directus/directus

open_in_new前往仓库

Directus 是一个灵活的后端平台，可将数据库快速转换为无头 CMS、管理面板或自定义应用，提供即时 API、身份验证和自定义 UI 等功能。

项目概览

项目概述

Directus 是一个开源的、可组合的后端即服务（BaaS）平台，旨在将任何 SQL 数据库快速转换为无头 CMS、管理面板或自定义应用。它提供即时生成的 REST 和 GraphQL API、可视化数据管理界面（Studio）、内置 AI 助手和原生 MCP 服务器，支持自托管或云部署。项目使用 TypeScript 和 Vue 构建，拥有超过 4500 万次下载和 50 万个已部署项目。

核心功能

  • 即时 API：根据数据库 schema 自动生成 REST 和 GraphQL API，无需额外配置。
  • 可视化 Studio：为技术与非技术用户提供完整的数据管理界面，支持内容创建、编辑和翻译。
  • AI 助手：内置于 Studio，可创建内容、执行翻译并触发工作流。
  • 原生 MCP 服务器：允许 Claude、Cursor、ChatGPT 等 MCP 兼容工具直接连接数据，并遵循相同的权限策略。
  • 基于策略的访问控制：支持字段级细粒度权限，适用于人类用户和 AI 代理。
  • 自带数据库：支持 PostgreSQL、MySQL、MariaDB、MS SQL、SQLite、OracleDB、CockroachDB 等。
  • 完全可扩展：支持自定义端点、钩子、界面和模块。
  • 自托管或云：可本地运行、部署在自己的基础设施上，或使用 Directus Cloud。

适用与不适用场景

适用场景：

  • 需要快速为现有数据库构建 API 和后台管理界面的项目。
  • 希望非技术团队成员直接管理实时数据的场景。
  • 需要将 AI 代理安全接入业务数据的应用。
  • 需要无头 CMS 或可组合后端的企业应用。

不适用场景：

  • 需要非 SQL 数据库（如 MongoDB）支持的项目（Directus 仅支持 SQL 数据库）。
  • 需要完全离线、无网络依赖的本地应用（Directus 需要服务器运行）。
  • 对许可证有严格限制的商业组织（年收入超过 500 万美元或员工超过 50 人，使用高级功能需商业许可）。

技术架构与依赖

  • 语言：TypeScript（后端）、Vue（前端 Studio）。
  • 数据库：支持 PostgreSQL、MySQL、MariaDB、MS SQL、SQLite、OracleDB、CockroachDB 等 SQL 数据库。
  • API：REST 和 GraphQL。
  • AI 集成：内置 AI 助手和 MCP 服务器。
  • 部署：支持自托管（Node.js 环境）和云部署（Directus Cloud）。
  • 依赖：具体依赖列表未在仓库资料中提供，但可预期包括 Express、Knex 等常见 Node.js 库。

安装与快速开始

仓库资料未提供详细的安装命令。通常，Directus 可以通过 npm 或 Docker 安装。建议参考官方文档（https://directus.com/docs）获取最新安装指南。快速开始可能包括：

  1. 创建项目目录并初始化 npm。
  2. 安装 Directus 包。
  3. 配置数据库连接。
  4. 启动 Directus 服务。

具体步骤请查阅官方文档。

典型使用方法

  • 作为无头 CMS：连接数据库，通过 Studio 管理内容，通过 REST/GraphQL API 提供给前端应用。
  • 作为管理面板：为非技术团队提供数据管理界面，无需编写代码。
  • AI 集成：使用内置 MCP 服务器，让 AI 代理直接操作数据，同时受权限控制。
  • 自定义扩展：开发自定义端点、钩子或界面，满足特定业务需求。

配置与部署要点

  • 数据库配置：需要指定数据库连接信息（如主机、端口、用户名、密码）。
  • 环境变量：Directus 使用环境变量进行配置，如 DB_CLIENT、DB_HOST、DB_PORT 等。
  • 部署方式：支持自托管（Node.js 或 Docker）和云部署。
  • 安全：建议配置 HTTPS、设置强密码、启用访问控制策略。
  • 扩展：可通过自定义模块和接口扩展功能。

限制、风险与许可证

  • 限制：仅支持 SQL 数据库；高级功能可能需要商业许可。
  • 风险：作为开源项目，可能存在安全漏洞，需及时更新；依赖第三方服务（如云部署）可能带来可用性风险。
  • 许可证：Directus 使用 Monospace Sustainable Core License (MSCL) 1.0，这是一个源代码可用的许可证。年收入低于 500 万美元且员工少于 50 人的组织可免费使用（Open Innovation Grant）。其他组织使用高级或企业功能需购买商业许可。

官方链接

信息来源和分析时间

  • 信息来源：GitHub 仓库 directus/directus（README、contributing.md、最新发布信息）。
  • 分析时间：2026年7月29日（基于最新发布 v12.2.0 的日期）。