自架

升級與備份

讓自架 Comma 執行個體保持最新,並確保資料可完整還原。

升級

升級時請使用與首次啟動相同的 Compose 專案名稱;不同的名稱會建立新的空資料磁碟區。

  1. 執行 docker compose down 停止服務。這會保留所有命名磁碟區,除非要刪除執行個體,否則切勿加上 -v。
  2. 更新程式碼前先一併備份五個資料磁碟區。
  3. 在 Git 中切換至目標版本。
  4. 執行 docker compose up -d --build 重建並啟動。
  5. 檢查 docker compose ps 與 docker compose logs migrate comma,並驗證登入、歷史對話、模型回覆與裝置連線。

備份

先停止堆疊,再將五個命名磁碟區——config、postgres、objects、clickhouse 與 redis——連同對應的 Git 版本一併備份,確保還原至同一時間點。正式依賴備份前,請先在獨立 Compose 專案中測試還原。

切勿為了解決啟動問題而刪除 config 磁碟區或重新產生密鑰:以原密鑰加密的資料將無法讀取。