NAS部署Directus全攻略：零代码自动生成API与可视化数据库管理

July 22, 2026

Directus 是一个开源后端系统，能将任何 SQL 数据库瞬间转化为可视化管理后台，并自动生成 REST 与 GraphQL API。它内置了 AI 助手和 MCP 协议，打通了开发、运营与 AI 工具之间的数据协作链路。

核心能力

自动生成 REST & GraphQL API
- 无需编写后端代码，自动支持 CRUD 操作
- 自动处理关系字段与权限控制
  这使得 Directus 非常适合快速构建前后端分离的应用。
可视化后台（Studio）
- 可视化管理数据，自定义界面组件
- 内容编辑体验类似 CMS，非技术人员也能直接操作生产数据
  它既可以作为 CMS 使用，也可以充当企业内部管理系统。
AI 与 MCP 原生支持
- 内置 AI Assistant，可直接在后台生成内容、翻译、执行工作流
- 内置 MCP Server，允许 Claude、ChatGPT、Cursor 等 AI 安全访问数据库
- 权限系统对 AI 与人类用户一视同仁
不强制绑定数据库类型
- 支持 PostgreSQL、MySQL/MariaDB、SQLite、MS SQL、OracleDB、CockroachDB 等
  这让 Directus 能轻松接入已有系统。
高度可扩展
- 自定义接口（Endpoints）、Hook、模块与界面组件
  适用于从简单 CMS 到复杂企业系统的各种场景。

📌 一句话总结：Directus 相当于一个数据库与后端合一的平台，支持多种数据库和可视化操作。开发者只需开发前端 UI 并调用 Directus 的 API，即可形成完整的前后端服务。对 NAS 用户来说，它更是一个无需写 SQL 的可视化数据库管理工具——建表、填数据、查数据一气呵成，还能通过 API 让其他应用读取数据。

安装部署

使用以下 Docker Compose 配置即可快速启动：

services:
  directus:
    image: directus/directus:latest
    container_name: directus
    ports:
      - 8055:8055
    environment:
      - ADMIN_EMAIL=admin@qq.com
      - ADMIN_PASSWORD=123456
      - SECRET=VsDuLgDHN5mQGRSwe9WQjH6
      - DB_CLIENT=sqlite3
      - DB_FILENAME=/directus/database/data.db
      - WEBSOCKETS_ENABLED=true
    volumes:
      - ./database:/directus/database
      - ./uploads:/directus/uploads
      - ./extensions:/directus/extensions
    restart: always

参数说明：

ADMIN_EMAIL：设置管理员邮箱
ADMIN_PASSWORD：设置管理员密码
SECRET：加密密钥，请自行生成替换
DB_CLIENT：数据库类型，此处使用 sqlite3
DB_FILENAME：SQLite 数据库文件的存储路径
WEBSOCKETS_ENABLED：启用 WebSocket
PUBLIC_URL（可选）：公共访问地址
/directus/database、/directus/uploads、/directus/extensions：分别持久化数据库、文件上传和扩展插件目录

初始化与基础设置

在浏览器中访问 http://NAS的IP:8055 即可看到登录界面。

使用前面配置的邮箱和密码登录。

登录后会弹出许可密钥对话框，选择“个人免费”即可。

💡 设置项目负责人可暂时跳过，日后有需要再配置也不迟。

系统默认语言为英文，需要先切换到中文。

用户可自定义站点外观，包括主题色和图标。

Directus 支持对接 AI 服务，方便随时提问或获得帮助。

扩展功能非常丰富，目前已超过 300+ 项目。

创建数据模型与 API 测试

侧边栏主要分为：内容、用户列表、文件管理、洞察分享、文档和设置六个模块。

第一步是创建数据模型（相当于数据库或表格，用于后续存放数据）。

这里演示创建一个 user 表，用来存储用户数据。

可选字段中，可以添加上创建时间和更新时间，点击保存即可完成创建。

接下来可按需添加更多字段。

选择 Input 类型。

填写字段名称，比如 username 用于记录用户名称。

新字段已显示在列表中（后续又添加了几个字段作为演示）。

进入 user 数据表，创建条目——相当于可视化填写数据信息。

这里又补充了几条示例数据。

💡 通常 Directus 是作为后端数据库接口使用，即前端通过 API 与它对接。调用 API 前需要先配置访问权限。

为演示方便，这里将所有权限全部打开（未做任何权限管理）。

⚠️ 注意：开放全部权限后，任何人都可以通过 API 直接读写或删除数据，仅限测试使用。测试完成后务必收回权限，生产环境请做好权限控制。

📎 以下 API 测试使用 Postman。

获取 user 表数据

GET http://IP:8055/items/数据模型名称

创建新数据（POST）

POST http://IP:8055/items/数据模型名称

刷新页面后即可看到刚创建的数据。

更新数据（PATCH）

PATCH http://IP:8055/items/数据模型名称/id

刷新后可见用户名已修改。

删除数据（DELETE）

DELETE http://IP:8055/items/数据模型名称/id

目标数据已成功删除。

总结与推荐

Directus 是一款成熟的开源后端平台，能将任意 SQL 数据库变成可视化后台，并自动生成 API。建表不用写 SQL，填数据像操作 Excel，API 接口自动创建，连权限控制也一并处理。对于想快速搭建小项目但不会写后端的开发者，或需要可视化数据库管理工具的 NAS 用户来说，都非常值得一试。不过其功能深入且偏向专业，上手虽易但精通较难，建议先试用再决定是否深度采用。官方文档十分详尽，大部分问题都能自行解决。

综合推荐：⭐⭐⭐⭐（无需后端也能拥有数据库+API，前后端分离项目的一站式方案）
使用体验：⭐⭐⭐⭐（可视化操作直观，API 自动生成大幅减少工作量）
部署难易：⭐⭐⭐（一般）