---
title: "升級與備份 · Comma 文件"
description: "讓執行個體保持最新，資料保持安全。"
url: https://comma.surf/zh-tw/docs/self-host/operations
language: zh-TW
---

自架

# 升級與備份

讓自架 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` 磁碟區或重新產生密鑰：以原密鑰加密的資料將無法讀取。
