Dockerボリュームのバックアップと復元｜named volumeのデータを別サーバーへ移行する実践手順

この記事のポイント

・named volumeのバックアップは docker run --rm -v で一時コンテナを使うのが定石
・本番DBは必ず停止バックアップ。停止できない場合は pg_dump / mysqldump を使う
・別サーバーへの移行は tar + rsync/scp の2ステップで完結する
・cronで夜間に自動バックアップすれば、誤削除・障害時に数分で復元できる

# named volumeの一覧
$ docker volume ls

DRIVER    VOLUME NAME
local     myapp_pgdata
local     myapp_redis_data
local     wordpress_db_data

# ボリュームの詳細確認
$ docker volume inspect myapp_pgdata

[
    {
        "CreatedAt": "2026-07-15T10:23:45Z",
        "Driver": "local",
        "Labels": {
            "com.docker.compose.project": "myapp",
            "com.docker.compose.version": "2.27.0",
            "com.docker.compose.volume": "pgdata"
        },
        "Mountpoint": "/var/lib/docker/volumes/myapp_pgdata/_data",
        "Name": "myapp_pgdata",
        "Options": {},
        "Scope": "local"
    }
]

# Composeを使っている場合（upで起動したサービス全体を停止）
$ docker compose -f /opt/myapp/docker-compose.yml stop

# 個別コンテナを指定して停止
$ docker stop myapp_postgres_1

# バックアップ保存先ディレクトリを作成
$ mkdir -p /backup/docker

# named volumeをtarでバックアップ
$ docker run --rm     -v myapp_pgdata:/data:ro     -v /backup/docker:/backup     alpine     tar czf /backup/myapp_pgdata_20260810.tar.gz -C /data .

# 保存確認
$ ls -lh /backup/docker/myapp_pgdata_20260810.tar.gz
-rw-r--r-- 1 root root 184M Aug 10 02:00 /backup/docker/myapp_pgdata_20260810.tar.gz

# Composeを使っている場合
$ docker compose -f /opt/myapp/docker-compose.yml start

# 個別コンテナの場合
$ docker start myapp_postgres_1

# コンテナ稼働中でもバックアップ可能（ただし整合性は保証されない）
$ docker run --rm     -v myapp_pgdata:/data:ro     -v /backup/docker:/backup     alpine     tar czf /backup/myapp_pgdata_dirty_20260810.tar.gz -C /data .

# scp で転送（新サーバーのIPが 192.168.10.20 の場合）
$ scp /backup/docker/myapp_pgdata_20260810.tar.gz     user@192.168.10.20:/backup/

# rsync を使う場合（差分転送・再開可能）
$ rsync -avz --progress     /backup/docker/myapp_pgdata_20260810.tar.gz     user@192.168.10.20:/backup/

# 新サーバー側の作業
# 同名のnamed volumeを事前に作成する
$ docker volume create myapp_pgdata

# 一時コンテナでtarを展開してvolumeへ復元
$ docker run --rm     -v myapp_pgdata:/data     -v /backup:/backup     alpine     tar xzf /backup/myapp_pgdata_20260810.tar.gz -C /data

# 復元確認（ファイルが展開されているか確認）
$ docker run --rm     -v myapp_pgdata:/data:ro     alpine     ls -la /data

total 44
drwx------ 19 systemd-coredump root 4096 Aug 10 01:55 .
drwxr-xr-x  1 root             root 4096 Aug 10 02:05 ..
drwx------  5 systemd-coredump root 4096 Aug 10 01:55 base
drwx------  2 systemd-coredump root 4096 Aug 10 01:55 global
drwx------  2 systemd-coredump root 4096 Aug 10 01:55 pg_commit_ts

# 新サーバーでdocker compose up
$ docker compose -f /opt/myapp/docker-compose.yml up -d

# PostgreSQLへ接続してデータを確認
$ docker compose exec postgres psql -U postgres -c "\l"
$ docker compose exec postgres psql -U postgres -d mydb -c "SELECT count(*) FROM users;"

 count
-------
  1234
(1 row)

# /opt/scripts/docker-volume-backup.sh として保存
#!/bin/bash
set -euo pipefail

BACKUP_DIR="/backup/docker"
DATE=$(date +%Y%m%d_%H%M%S)
COMPOSE_FILE="/opt/myapp/docker-compose.yml"
VOLUME_NAME="myapp_pgdata"
RETAIN_DAYS=7

mkdir -p "${BACKUP_DIR}"

# コンテナを一時停止
docker compose -f "${COMPOSE_FILE}" stop

# バックアップ実行
docker run --rm     -v "${VOLUME_NAME}:/data:ro"     -v "${BACKUP_DIR}:/backup"     alpine     tar czf "/backup/${VOLUME_NAME}_${DATE}.tar.gz" -C /data .

# コンテナを再起動
docker compose -f "${COMPOSE_FILE}" start

# 7日より古いバックアップを削除
find "${BACKUP_DIR}" -name "${VOLUME_NAME}_*.tar.gz" -mtime +"${RETAIN_DAYS}" -delete

echo "[$(date)] Backup completed: ${BACKUP_DIR}/${VOLUME_NAME}_${DATE}.tar.gz"

# 実行権限付与
$ chmod 755 /opt/scripts/docker-volume-backup.sh

# crontabを編集（rootで実行）
$ sudo crontab -e

# 毎日午前2時にバックアップ実行（結果をログに記録）
0 2 * * * /opt/scripts/docker-volume-backup.sh >> /var/log/docker-backup.log 2>&1

# PostgreSQLコンテナからSQLダンプを取得（コンテナ稼働中でも可）
$ docker compose exec postgres pg_dump     -U postgres     -Fc     mydb > /backup/docker/mydb_20260810.dump

# gzip 形式で保存する場合
$ docker compose exec postgres pg_dump     -U postgres     mydb | gzip > /backup/docker/mydb_20260810.sql.gz

# バックアップサイズ確認
$ ls -lh /backup/docker/mydb_20260810.dump
-rw-r--r-- 1 user user 42M Aug 10 02:05 /backup/docker/mydb_20260810.dump

# ダンプファイルを新サーバーへ転送
$ scp /backup/docker/mydb_20260810.dump user@192.168.10.20:/backup/

# 新サーバーでPostgreSQLコンテナを起動（DBは空の状態で）
$ docker compose up -d postgres

# pg_restoreでリストア（-Fcカスタム形式の場合）
$ cat /backup/mydb_20260810.dump |     docker compose exec -T postgres pg_restore     -U postgres     -d mydb

# gzip形式の場合は gunzip で展開しながらパイプ
$ gunzip -c /backup/mydb_20260810.sql.gz |     docker compose exec -T postgres psql -U postgres -d mydb

# データ確認
$ docker compose exec postgres psql -U postgres -d mydb -c "SELECT count(*) FROM users;"

# --user rootを明示してtarを実行する
$ docker run --rm     --user root     -v myapp_pgdata:/data:ro     -v /backup/docker:/backup     alpine     tar czf /backup/myapp_pgdata_20260810.tar.gz -C /data .

# エラー例
Error response from daemon: invalid mount config for type "volume": 
no such volume: myapp_pgdata

# 対処：volumeを先に作成してから復元コマンドを実行する
$ docker volume create myapp_pgdata
$ docker run --rm     -v myapp_pgdata:/data     -v /backup:/backup     alpine     tar xzf /backup/myapp_pgdata_20260810.tar.gz -C /data