備份、重啟與故障處理
cd knowledge-server/delivery/server./knowledgectl status./knowledgectl logs knowledge-backend./knowledgectl stop./knowledgectl start停止後重新啟動會保留 state 資料。不要執行刪除資料目錄的指令，也不要把不明清理指令貼到正式伺服器。
建立一致性備份
Section titled “建立一致性備份”./knowledgectl backup此命令開啟 Nextcloud 維護模式，停止 cron 與 Rust 寫入，對 PostgreSQL 做邏輯匯出，再保存 Nextcloud 與知識庫資料及設定。結束時恢復服務。
備份包含密碼與授權資料，須加密並移到不同故障範圍。下載安裝包不包含這些檔案。備份檔存在不代表已驗證可還原。
目前試用包尚未提供一鍵還原命令。IT 應在隔離的新主機先部署相同版本，停止所有應用寫入，還原設定、Nextcloud 與知識庫資料，再透過 psql 匯入 PostgreSQL 邏輯備份。不要複製運作中的 PostgreSQL 資料目錄。
啟動後核對文件、條目、版本、來源與群組權限，再測查詢。核對完成前，不切換正式 DNS。授權資料跨主機的處理，需遵守模型服務的主機身分與重新授權規則。
參考 Nextcloud 官方備份指南。完整客戶還原演練仍列為正式交付前的驗收項目。
| 狀況 | 先檢查 |
|---|---|
| 本機有檔案，雲端沒有 | Nextcloud 桌面同步錯誤、所選目錄與磁碟空間 |
| 雲端有檔案，沒有處理工作 | 是否在已連接來源範圍、格式與大小、排程 |
| 等待模型授權 | 部門收錄者是否已連接生成模型 |
| 處理未完成／重試 | 顯示的原因、模型限制、來源是否處理途中被修改 |
| 引用數每篇都相同 | 檢查逐篇引用資料，不能直接當成範圍來源總數 |
| MCP 查不到 | 個人授權部門、全部來源讀取權、Token 狀態及關鍵字 |
| HTTP 502 | 入口連線、Nextcloud、背景服務及主機網路；保存發生時間 |