Keystone Admin UI怎麼用 內容管理介面教程

Keystone Admin UI是KeystoneJS自帶的內容管理後臺，可以透過視覺化介面建立、編輯和刪除內容，適合做快速開發和原型驗證。它不是獨立的拖拽式建站工具：開發者先在專案程式碼裡定義內容型別、欄位和權限，啟動服務後，後臺就會依據這些配置生成列表與編輯表單。換句話說，日常錄入可以在介面裡完成，結構和規則則由程式碼控制。

第一步：啟動Admin介面

先準備好Node.js環境，再進入Keystone專案目錄安裝依賴。新建專案時可使用官方腳手架；已有專案則確認配置檔案、資料庫連線和列表定義都已準備好。開發階段執行專案的開發命令，終端會顯示本地服務地址。開啟瀏覽器訪問該地址，通常就能看到Admin UI；實際命令以專案的package.json指令碼為準。

第一次開啟時，按頁面提示建立或登入管理員帳戶。若專案尚未配置身份驗證，先在程式碼中設定使用者列表、認證和會話，再啟動後臺；否則不應把管理入口直接暴露給公眾。遇到空白頁面時，先看終端和瀏覽器控制檯報錯，再檢查資料庫是否可連線、依賴是否安裝，以及當前執行的命令是否對應開發環境。

成功進入後臺後，左側導航會列出已配置且可見的內容列表。點進列表，可以搜尋、篩選、排序和翻頁；選擇建立按鈕新增記錄，開啟已有條目修改內容，儲存後再檢查結果。開發時建議先用少量測試資料熟悉流程，確認欄位表現和權限符合預期，再開始錄入正式內容。

第二步：配置列表和欄位

Keystone的內容結構透過程式碼定義。每種內容對應一個list，例如文章Post、作者Author；欄位則決定表單裡可以填寫什麼。常見型別包括text文字、integer整數、checkbox勾選、timestamp時間、select單選、document富文字，以及relationship關聯。先列出內容需要儲存的資訊，再挑合適的型別，避免把所有資料都塞進一個文字框。

編輯列表配置時，把欄位放進fields物件，併為必填內容設定驗證規則。比如文章標題設為必填，正文使用富文字，釋出時間使用時間欄位。儲存程式碼後重啟或等待開發伺服器重新載入，再回到後臺檢視錶單；如果欄位沒有出現，檢查欄位是否寫在正確的列表中、型別是否正確匯入，以及配置是否有語法錯誤。

接著整理列表頁的顯示方式。可以為列表設定labelField，讓後臺用標題或名稱標識每條記錄；透過searchFields指定搜尋欄位，透過listView.initialColumns安排初始列，也可設定initialSort和pageSize，讓常用內容更容易查詢。若欄位不適合出現在列表頁，可在欄位UI配置中調整顯示模式。

使用關係和選項

文章通常要關聯作者或分類，這時使用relationship欄位，並在相關列表中配置對應關係。單條關係適合“一篇文章對應一位作者”，多條關係適合“一個分類下有多篇文章”。定義ref時要核對列表名和欄位名；完成後在後臺表單中選擇關聯記錄，並檢查另一側是否能正確顯示。關聯項太多時，設定合適的標籤和搜尋欄位會更好找。

狀態、等級等固定取值，可以用select欄位列出選項，例如草稿、審核中、已釋出。選項值應穩定且便於程式碼判斷，介面標籤則寫得直觀。儲存後分別測試新增和編輯：確認預設值合理、必選項有提示、切換狀態後資料能正確儲存。若選項會重複多處使用或需要單獨維護，考慮將它們建成獨立列表並用關係欄位連線。

第三步：自定義介面和權限

後臺的介面配置可以控制列表名稱、導航可見性、預設列、排序和分頁，也能按登入使用者動態隱藏導航、建立或刪除入口。欄位則可設定介面標籤、表單模式和位置，讓管理人員看到更清楚的填寫流程。先從最影響日常操作的部分改起，例如把關鍵欄位放在前面、隱藏不常用欄位，再用實際帳號檢查呈現效果。

權限不要只靠“隱藏按鈕”。應配置身份驗證與會話，再在列表和欄位層分別限制讀取、建立、更新、刪除等操作。比如普通編輯只能修改自己負責的文章，管理員才能刪除內容；郵箱或密碼等敏感欄位也應單獨設定訪問規則。介面顯示控制主要改善操作體驗，真正的資料保護要由訪問控制規則完成，並同時檢查Admin UI和API的行為。

配置完成後，分別用管理員、編輯人員和未登入狀態測試：能否看見正確列表、執行允許的操作、被拒絕時是否無法繞過介面直接修改資料。上線前再檢查初始管理員建立流程、資料庫備份和部署環境變數。若團隊還需要快速梳理頁面流程或製作介面原型，可把墨刀AI作為國內替代工具之一瞭解；它適合輔助原型設計，不能直接替代Keystone的內容模型、資料庫和權限邏輯。官網：modao.cgref.cn。潤滅。