如何備份和恢復您的 Docker Desktop 資料

使用此過程備份和恢復您的映象和容器資料。這在您希望重置 VM 磁碟、將 Docker 環境移動到新計算機,或從 Docker Desktop 更新或安裝失敗中恢復時非常有用。

重要

如果您使用卷或繫結掛載來儲存容器資料,則可能不需要備份您的容器,但請務必記住建立容器時使用的選項,或者如果您想在重新安裝後以相同的配置重新建立容器,請使用 Docker Compose 檔案

如果 Docker Desktop 正常執行

儲存您的資料

  1. 使用 docker container commit 將您的容器提交到映象。

    提交容器會將檔案系統更改和一些容器配置(如標籤和環境變數)儲存為本地映象。請注意,環境變數可能包含敏感資訊,如密碼或代理認證,因此在將生成的映象推送到登錄檔時請務必小心。

    另請注意,附加到容器的卷中的檔案系統更改不包含在映象中,必須單獨備份。

    如果您使用 命名卷 來儲存容器資料(例如資料庫),請參閱儲存部分中的 備份、恢復或遷移資料卷 頁面。

  2. 使用 docker push 將您在本地構建並希望保留的任何映象推送到 Docker Hub 登錄檔

    提示

    或者,使用 docker image save -o images.tar image1 [image2 ...] 將您希望保留的任何映象儲存到本地 .tar 檔案。

備份資料後,您可以解除安裝當前版本的 Docker Desktop 並安裝其他版本或將 Docker Desktop 重置為出廠預設設定。

恢復您的資料

  1. 載入您的映象。

    • 如果您已推送到 Docker Hub

      $ docker pull <my-backup-image>
      
    • 如果您儲存了 .tar 檔案

      $ docker image load -i images.tar
      
  2. 如果需要,使用 docker runDocker Compose 重新建立容器。

要恢復卷資料,請參閱 備份、恢復或遷移資料卷

如果 Docker Desktop 啟動失敗

如果 Docker Desktop 無法啟動並且必須重新安裝,您可以直接從磁碟備份其 VM 磁碟和映象資料。在備份這些檔案之前,Docker Desktop 必須完全停止。

  1. 備份 Docker 容器/映象。

    備份以下檔案

    %LOCALAPPDATA%\Docker\wsl\data\docker_data.vhdx
    

    將其複製到安全位置。

  2. 備份 WSL 分發。

    如果您正在執行任何 WSL Linux 分發(Ubuntu、Alpine 等),請使用 Microsoft 的指南 備份它們。

  3. 恢復。

    重新安裝 Docker Desktop 後,將 docker_data.vhdx 恢復到相同位置,並根據需要重新匯入您的 WSL 分發。

  1. 備份 Docker 容器/映象。

    備份以下檔案

    ~/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw
    

    將其複製到安全位置。

  2. 恢復。

    重新安裝 Docker Desktop 後,將 Docker.raw 恢復到相同位置。

  1. 備份 Docker 容器/映象

    備份以下檔案

    ~/.docker/desktop/vms/0/data/Docker.raw
    

    將其複製到安全位置。

  2. 恢復。

    重新安裝 Docker Desktop 後,將 Docker.raw 恢復到相同位置。