Directus怎么用 开源数据后台管理工具教程

Directus是一个开源的数据后台管理工具，连接数据库后自动生成管理界面，不用写后台代码就能管理数据。它还能为数据提供REST和GraphQL API，适合做内容管理、内部系统或给已有网站搭建数据后台。下面按安装、连库、配置权限和调用API的顺序，带你从零跑通一个基础项目。

第一步：安装Directus

最省事的入门方式是用Docker Compose。先在电脑安装Docker Desktop，新建一个项目文件夹，并在里面创建docker-compose.yml。正式部署时建议固定Directus镜像版本，别长期依赖latest；同时准备好数据库、强随机SECRET和管理员密码，避免把示例口令直接用于线上环境。

如果只是本机体验，可以先用Docker启动一个Directus服务，并把8055端口映射出来。项目上线前，还要给数据库、上传文件等需要保留的数据配置持久化卷；容器重启后，没挂载卷的数据可能不会保留。启动完成后，在浏览器打开http://localhost:8055，按引导创建第一个管理员账号并登录后台。

使用Compose部署时，配置文件里需要填写数据库连接参数、SECRET、管理员账号等环境变量，再执行docker compose up -d启动服务。把SECRET和密码替换成自己的值，不要照抄教程中的占位内容；生产环境还应配置公网访问地址、备份和稳定存储，并保存好配置，方便之后维护与迁移。

第二步：连接数据库和配置

Directus支持多种SQL数据库。启动前先确认数据库服务可访问，并准备好数据库名、主机地址、端口、用户名和密码。在Compose里，数据库主机通常填写同一网络中的服务名，而不是localhost；随后按所选数据库类型填写DB_CLIENT及其他连接变量，保存配置并重启服务。

登录后打开数据模型区域，点击创建集合，为集合起一个清晰的名称，例如articles。接着添加标题、正文、发布时间、状态等字段，并选择合适的数据类型；例如标题用短文本，正文用长文本，发布时间用日期时间。保存后，后台会出现对应的数据管理界面，可以新增记录并检查字段是否符合预期。

创建角色和权限

不要让所有使用者都用管理员账号。进入用户与角色设置，创建编辑、审核或只读等角色，再按工作内容分配权限。为每个集合分别设置读取、创建、更新和删除权限；需要时还可限制字段和记录范围。配置后用相应角色账号登录测试，确认用户只能看到并操作获准的数据。

如果要让未登录访客读取公开内容，可以调整公共角色权限，但只开放确实需要的集合、字段与操作，不要顺手开放新增、修改或删除。后台管理账号也应单独设置，并定期检查权限范围。分清公开数据和内部数据，能减少误操作，也能避免敏感字段被接口意外返回。

第三步：通过API管理数据

Directus会根据集合生成API。比如集合名为articles，可用GET请求访问/api/items/articles读取记录。先在浏览器开发者工具或Postman里发送请求，观察返回的JSON；若出现权限错误，检查当前角色是否有读取权限、集合名称是否正确，以及服务端地址和端口是否能访问。

写入数据时，可通过POST请求把JSON发送到/api/items/articles，并在请求头中设置Content-Type: application/json。需要登录的接口还要附上有效的认证信息；不要把管理员令牌直接放进公开网页代码。更新和删除同样要核对记录ID及角色权限，先用测试数据验证，再接入正式业务。

日常使用时，可以先在管理界面确认数据模型与权限，再让前端调用API；接口地址、认证方式和访问范围应与实际角色相匹配。遇到字段未返回、写入失败或权限报错时，依次检查集合和字段设置、请求格式、登录状态及角色权限。若想了解国内替代方案，也可以看看墨刀AI：modao.cgref.cn。润灭建议先用小型测试项目跑通流程，再迁移真实业务数据。