Directus:连接任意 SQL 数据库即时生成后台与 API

Directus：连接任意 SQL 数据库，瞬间得到完整的后台管理系统

Directus 是一个开源的数据后台工具，它的核心思路是：你已经有数据库了（Postgres、MySQL、SQLite 等都行），它直接包一层，立刻给你一个可视化管理界面和自动生成的 API。用大白话说，就是把你手头的数据库变成一个可以操作的后台系统，不用从头写代码。

这个项目在 GitHub 上已经积累了 38009 个 star，4960 个 fork，官方给出的下载量是 45M+，部署的项目数 500K+，说明它在开发者圈子里是被广泛验证过的方案。

适合谁

• 独立开发者：一个人要管前端、后端、数据库，Directus 可以省掉写管理后台这部分工作量，把精力放在业务逻辑上。
• 小团队技术负责人：团队里可能有人需要维护数据、管理内容，但不是每个成员都写代码。Directus 的图形界面让非技术人员也能直接操作数据库里的数据，不用每次改数据都来找你。
• 爱折腾的自托管玩家：不喜欢用 SaaS，习惯把东西部署在自己的服务器上。Directus 支持自托管，数据完全自己掌控。

能解决什么问题

• 省掉写管理后台的时间：大多数项目都需要一个管理界面来维护数据。假设你做一个内容网站，需要管理文章、用户、分类。传统做法是自己写个 admin 页面，涉及登录、权限、增删改查，前后端加起来要折腾不少天。用 Directus，数据库结构设计好后，管理界面自动生成，直接能用。
• 自动生成 API，前后端分离更顺畅：Directus 会根据你的数据库表结构，自动生成 REST 和 GraphQL 两种 API。前端调用数据不用你再手动写接口，数据库加个字段，API 同步更新。
• 给 AI 工具提供数据接口：Directus 带了原生的 MCP 服务器，可以让 Claude、Cursor 这些工具直接连到你的数据上，AI 读写数据走的是同一套权限控制。

怎么开始用

官方提供了多种部署方式，最简单的是用 Docker。

创建一个 docker-compose.yml 文件，内容大致如下（以官方文档为准）：

services:
  database:
    image: postgres:16
    environment:
      POSTGRES_DB: directus
      POSTGRES_USER: directus
      POSTGRES_PASSWORD: directus
    volumes:
      - ./data/database:/var/lib/postgresql/data

  directus:
    image: directus/directus:11
    ports:
      - 8055:8055
    environment:
      SECRET: "your-secret-key"
      DB_CLIENT: "pg"
      DB_HOST: "database"
      DB_PORT: "5432"
      DB_DATABASE: "directus"
      DB_USER: "directus"
      DB_PASSWORD: "directus"
    depends_on:
      - database

然后在终端运行：

docker compose up -d

等容器启动后，浏览器访问 http://localhost:8055，创建管理员账号，就可以开始用了。

除了 Docker，官方还提供了 Railway 的一键部署按钮，点一下就能在 Railway 上自动配置好 PostgreSQL、Redis 和 S3 存储，适合不想折腾服务器的人。

优点和坑

优点：

• 数据库无关：支持 Postgres、MySQL、MariaDB、MS SQL、SQLite、OracleDB、CockroachDB 等多种数据库。你可以继续用熟悉的数据库，不强制迁移。
• 权限控制细：可以控制到字段级别的权限，比如某些角色只能看某个表的某些列，不能看其他列。对数据安全要求高的项目有用。
• 扩展性不错：支持自定义接口、钩子（hooks）、界面和模块。官方社区活跃，遇到问题容易找到解决方案。

坑：

• 部署有技术门槛：虽然 Docker 方式不算难，但对完全没碰过命令行的朋友来说，Docker、端口、环境变量这些概念还是需要花时间学的。技术能力一般的话，建议直接用官方云服务，省心但收费。
• 官方版本并非完全开源：Directus 采用的许可证是 Monospace Sustainable Core License (MSCL)，属于源码可见但有限制的许可，不是传统意义上的 MIT 或 Apache 开源协议。
• 免费使用有门槛：官方说年收入低于 500万美元 且员工少于 50人 的组织可以免费申请许可。超了就需要购买商业授权。
• AI 相关功能需要额外配置：AI Assistant 和 MCP 服务器是内置功能，但要用好它们，需要理解 MCP 协议以及如何与外部 AI 工具对接，这部分对普通用户来说有个学习过程。

适合你吗

适合：

• 你正在做新项目，数据库设计好了，但不想花时间写管理后台。
• 你已经有现成的 SQL 数据库，想快速给它加一个操作界面。
• 你是开发者，愿意花半天时间看文档、尝试部署，并且希望数据掌控在自己手里。

不适合：

• 完全不懂技术、也不想碰命令行的非技术人员。
• 项目数据极其敏感，对安全合规要求极高，需要仔细评估自托管方案的运维能力。
• 需要一个开箱即用、带完整功能界面的 SaaS 后台 —— 这种情况用现成的 CMS 或云服务可能更省事。

---

常见问题

Directus 怎么连接我现有的数据库？

Directus 支持连接多种 SQL 数据库，包括 Postgres、MySQL、SQLite、MariaDB 等。你只需要在部署时（例如使用 Docker），在环境变量中配置好数据库类型（DB_CLIENT）、主机（DB_HOST）、端口、数据库名（DB_DATABASE）、用户名和密码，Directus 启动后就会自动连接并读取你的现有数据库结构，无需数据迁移。

Directus 是免费开源的吗？

Directus 采用 Monospace Sustainable Core License (MSCL) 许可证，属于源码可见但有使用限制的协议。对于年收入低于 500 万美元且员工少于 50 人的组织，可以免费申请许可使用。超过这个规模或用于商业项目，则需要购买商业授权。

Directus 的默认访问地址是什么？

如果你使用官方提供的 Docker 方式在本地部署，Directus 服务默认运行在 8055 端口。启动容器后，在浏览器中访问 http://localhost:8055 即可进入后台管理界面，并在此创建第一个管理员账号。

Directus 能自动生成 API 吗？

是的，这是 Directus 的核心功能之一。它会根据你连接的数据库表结构，自动生成完整的 REST 和 GraphQL API。前端开发者可以直接调用这些接口获取数据，当你修改数据库字段时，API 也会同步更新，极大简化了前后端协作流程。

完全不懂技术的新手能用 Directus 吗？

对于完全不懂技术、不想碰命令行的非技术人员，Directus 的自托管部署有一定门槛，涉及 Docker、环境变量等概念。官方也提供了云服务（Directus Cloud）可以一键使用，但需要付费。因此，它更适合愿意花时间看文档、尝试部署的开发者。

相关工具推荐

• 使用 ILLA Builder 低代码平台快速搭建管理后台
• 利用 Metabase 免费开源 BI 工具制作店铺数据看板
• 自托管开源发票管理应用 InvoicePlane 介绍