タイトル: rsync ファイル/ディレクトリの同期
SEOタイトル: rsync 完全ガイド — ファイル/ディレクトリ同期の決定版 (SSH/cron/exclude/dry-run)
| この記事の要点 |
|
rsync とは
rsync (remote sync) は差分のみを高速転送するファイル同期ツールです。ローカル間 / SSH 経由のリモート間、どちらでも使えます。バックアップ・デプロイ・大量ファイルのミラーリングで cp や scp よりも圧倒的に速く、中断時の再開やパーミッション保持・除外パターン指定ができます。
# インストール
sudo apt install -y rsync # Debian/Ubuntu
sudo yum install -y rsync # RHEL
brew install rsync # macOS (標準は古い 2.x, brew で 3.x 推奨)
# バージョン確認
rsync --version基本: ローカル間の同期
# src の中身を dst の中身として同期 (末尾スラッシュ重要)
rsync -av src/ dst/
# src というディレクトリごと dst の下にコピー
rsync -av src dst/
# → dst/src/... が出来る
# よく使うオプション組み合わせ
rsync -avh --progress src/ dst/
# -a : アーカイブモード (-rlptgoD と同等)
# -v : verbose
# -h : human-readable サイズ
# --progress : 進捗表示末尾スラッシュの罠
| コマンド | 結果 |
|---|---|
rsync -av src/ dst/ | src の中身を dst の下にコピー (dst/file1, dst/file2 ...) |
rsync -av src dst/ | src というディレクトリごとコピー (dst/src/file1 ...) |
rsync -av src dst | dst が存在しなければ dst を作って中身を入れる |
主要オプション
| オプション | 意味 |
|---|---|
-a | アーカイブモード (再帰 + パーミッション/タイムスタンプ保持) |
-v | 詳細表示 |
-z | 転送時に圧縮 (SSH/低速回線で有効) |
-P | --partial --progress 相当 (部分再開 + 進捗) |
--delete | 送信元にないファイルを送信先からも削除 |
--dry-run / -n | 実行せず動作を表示 |
--exclude=PAT | 除外パターン |
--exclude-from=FILE | 除外パターンをファイルから |
--include=PAT | 除外を上書きして含める |
--bwlimit=KB | 帯域制限 (KB/s) |
-e ssh | SSH 経由 (3.x ではデフォルト) |
--checksum | サイズ/時刻でなくチェックサムで比較 |
--link-dest=DIR | 差分ハードリンク (世代バックアップ) |
SSH 経由のリモート同期
# ローカル → リモート (アップロード)
rsync -avz -P src/ user@host:/var/www/app/
# リモート → ローカル (ダウンロード)
rsync -avz -P user@host:/var/log/ ./logs/
# SSH ポート / 鍵を指定
rsync -avz -e "ssh -p 2222 -i ~/.ssh/deploy_key" src/ user@host:/path/
# rsync デーモン経由 (高速 LAN 内バックアップ向け)
rsync -av rsync://host/module/ ./dest/除外と包含 (exclude / include)
# 単発除外
rsync -av --exclude='*.log' --exclude='tmp/' src/ dst/
# パターンを外部ファイルから
cat > /tmp/exclude.list <--delete: 削除も同期
送信元から削除されたファイルを送信先からも削除するには --delete を付けます。取り扱い注意 (意図しない巻き添え削除を防ぐため --dry-run でリハーサル必須):
# 危険: 必ず --dry-run で確認してから本番
rsync -av --delete --dry-run src/ dst/
# 出力で deleting xxx が想定通りなら実行
rsync -av --delete src/ dst/
# 削除をログに記録
rsync -av --delete --log-file=/var/log/rsync.log src/ dst/
# 削除しすぎ防止: --max-delete
rsync -av --delete --max-delete=10 src/ dst/ # 10件超なら abortcp との違い (差分のみ転送)
| 項目 | cp | rsync |
|---|---|---|
| 差分転送 | 毎回全コピー | 変更分のみ (タイムスタンプ + サイズで比較) |
| 大量ファイル時の速度 | 遅い | 2 回目以降は爆速 |
| 中断後の再開 | 最初から | -P で部分再開 |
| SSH 経由 | 不可 | 標準対応 |
| 除外指定 | find と組み合わせ必要 | --exclude 一発 |
| パーミッション/timestamp | オプション要 | -a で全保持 |
cron で定期バックアップ
# crontab -e で編集
# 毎日 3:00 に DB ダンプ + ファイルをバックアップ
0 3 * * * /usr/bin/rsync -az --delete /var/www/ backup@nas:/backup/web/ >> /var/log/rsync.log 2>&1
# 1 時間ごとに静的サイトをミラー
0 * * * * /usr/bin/rsync -az --exclude='*.tmp' /home/site/ user@mirror:/srv/site/
# 世代バックアップ (hard link で容量節約)
#!/bin/bash
DATE=$(date +%Y%m%d)
rsync -a --delete --link-dest=/backup/latest /var/www/ /backup/$DATE/
ln -snf /backup/$DATE /backup/latest帯域制限と進捗表示
# 1000 KB/s (= 約 8 Mbps) に制限
rsync -avz --bwlimit=1000 src/ user@host:/path/
# 進捗表示
rsync -avz -P src/ dst/
# sending incremental file list
# foo.zip
# 1,234,567 45% 12.34MB/s 0:00:05 (xfr#1, to-chk=10/15)
# 統計サマリ
rsync -avz --stats src/ dst/
# Number of files: 100
# Total file size: 50,000 bytes
# Total transferred file size: 5,000 bytes
# Speedup is 10.0Windows での利用
| 方法 | 説明 |
|---|---|
| WSL2 + rsync (最推奨) | sudo apt install rsync で Linux と同じ操作 |
| cwRsync | Windows ネイティブの rsync ポート |
| DeltaCopy | cwRsync を GUI 化、Windows サービスとして常駐可能 |
| Cygwin | Cygwin パッケージマネージャから rsync 追加 |
FAQ
Q: rsync と scp はどう違う？
A: scp は単純な SSH コピー (全コピー)。rsync は差分転送・部分再開・除外パターン対応。大量ファイルや 2 回目以降の同期では rsync が圧倒的に速い。
Q: 「same as the source」と言われ転送されない
A: タイムスタンプ + サイズが一致しているため。強制再転送は --checksum (時間かかる) または --ignore-times。
Q: Permission denied エラー
A: 送信先に書き込み権限がない / SSH 鍵が違う。--rsync-path="sudo rsync" で sudo 実行も可能。