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。潤滅建議先用小型測試專案跑通流程，再遷移真實業務資料。