dry-run)

▶

この記事の要点

基本: rsync -av src/ dst/ で同期。末尾スラッシュの有無で挙動が変わる (src/ は中身、src はディレクトリごと)
SSH 経由: rsync -avz src/ user@host:/path/ でリモート同期、-z は転送時圧縮
差分のみ転送: cp と違い、変更されたファイルのみコピー。大量ファイルのバックアップで爆速
便利オプション: --delete (削除も同期) / --exclude="*.log" (除外) / --dry-run (リハーサル) / -P (進捗 + 部分再開)
cron でバックアップ運用が定番、Windows 側は WSL2 か DeltaCopy / cwRsync

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 <<EOF
*.log
*.tmp
.git/
node_modules/
vendor/
.env
EOF
rsync -av --exclude-from=/tmp/exclude.list src/ dst/

# 特定ファイルだけは除外を解除
rsync -av --include='*.log' --include='access.log' --exclude='*' src/ dst/

--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件超なら abort

cp との違い (差分のみ転送)

項目	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.0

Windows での利用

方法	説明
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 実行も可能。

編集

子ページ

子ページはありません

同階層のページ

2026-06-11 07:12:00 atom 476

最近更新/作成されたページ

IPv6とは｜128bitアドレス・コロン16進表記/::省略・リンクローカル・SLAAC・デュアルスタック NEW 2026-06-22 12:34:44
VPNとは｜暗号トンネル・サイト間/リモートアクセス・IPsec/SSL-VPN/WireGuardを解説 NEW 2026-06-22 12:19:10
MAC アドレスフィルタリングの仕組みと限界 | ネットワーク入門 NEW 2026-06-22 12:19:10
WebRTC とはブラウザ間 P2P の音声・映像・データ通信 | ネットワーク入門 NEW 2026-06-22 12:17:25
gRPC とは HTTP/2 + Protocol Buffers の高速 RPC | ネットワーク入門 NEW 2026-06-22 12:17:25
HTTP/3 (QUIC) とは UDP ベースの低遅延 Web 通信 | ネットワーク入門 NEW 2026-06-22 12:17:25
HTTP/2 とは多重化・HPACK・バイナリフレーム | ネットワーク入門 NEW 2026-06-22 12:17:25
Web通信プロトコル入門 HTTP/2・HTTP/3・WebSocket・gRPC・WebRTC | ネットワーク入門 NEW 2026-06-22 12:17:25
WebSocket とは全二重リアルタイム通信 ws/wss | ネットワーク入門 NEW 2026-06-22 12:17:25
ファイアウォールとは｜パケットフィルタ・ステートフル・DMZ・次世代FW(L4/L7)を解説 NEW 2026-06-22 12:17:24
iptables/nftablesとは｜テーブル・チェーン・ルール例・永続化をLinux視点で解説 NEW 2026-06-22 12:17:24
HAProxy とは frontend/backend と設定例 | ネットワーク入門 NEW 2026-06-22 12:17:24
証明書と認証局(CA)とは｜X.509・信頼チェーン・DV/OV/EV・失効(CRL/OCSP)を解説 NEW 2026-06-22 12:17:24
CDN とはエッジキャッシュ・TTL・Cloudflare/CloudFront | ネットワーク入門 NEW 2026-06-22 12:17:24
TLS/SSLの仕組み｜ハンドシェイク・暗号スイート・前方秘匿性・証明書検証をわかりやすく解説 NEW 2026-06-22 12:17:24

ページ一覧

その他