rsync入門｜差分だけを速くコピーする基本オプション

サーバーのファイルを手元へ持ってくるとき、cp や scp で済ませている人は多いと思います。

ところが同じディレクトリを何度も往復させるようになると、毎回まるごと転送する待ち時間がばかになりません。

rsync なら、2回目以降は変わったファイルだけを送るので、待ち時間がぐっと短くなります。

rsync は「前回との差分だけを送る」ことに特化したコピーコマンドです。

取り上げるのは日常の同期でよく使う範囲のオプションに絞ったので、実行結果と見比べれば、まず何を覚えればいいかが分かります。

検証環境は Ubuntu 22.04.5・rsync 3.2.7（protocol 31）でした。

2026年10月に Ubuntu 26.04.1・rsync 3.4.1 で上から通しで打ち直したところ、転送・削除されるファイル名は同じで、違ったのは ./ などの行の出方とバイト数だけでした。

1 まずは -av だけ覚える
2 いちばんの事故は、末尾スラッシュ
3 --delete と --exclude は意味を掴んでから
4 リモートを相手にするときの形
5 最後に

まずは -av だけ覚える

基本形は rsync に続けてオプション、コピー元、コピー先を並べるだけです。

最初に覚えるオプションは -a と -v の2つで足ります。

-a は archive の頭文字で、サブディレクトリ・パーミッション・タイムスタンプをまとめて保ったまま運ぶ指定になります。

-v は verbose、つまり何を転送したかを画面に出す指定です。

例では、次の 3 つのファイルを入れた src を使います。

$ mkdir -p src/sub
$ printf 'alpha\n' > src/a.txt
$ printf 'bravo\n' > src/b.log
$ printf 'charlie\n' > src/sub/c.txt

$ rsync -av src/ dst/
sending incremental file list
a.txt
b.log
sub/
sub/c.txt

sent 352 bytes  received 85 bytes  874.00 bytes/sec
total size is 20  speedup is 0.05

4つのエントリが転送され、サブディレクトリもそのまま再現されました。

おもしろいのは、続けてもう一度まったく同じコマンドを打ったときです。

$ rsync -av src/ dst/
sending incremental file list

sent 188 bytes  received 13 bytes  402.00 bytes/sec
total size is 20  speedup is 0.10

ファイル名が1つも並びません。

中身が変わっていないファイルは、まるごと読み飛ばされているわけです。

では a.txt だけ書き換えてから、三度目を実行してみます。

$ printf 'alpha-updated\n' > src/a.txt
$ rsync -av src/ dst/
sending incremental file list
a.txt

sent 249 bytes  received 36 bytes  570.00 bytes/sec
total size is 28  speedup is 0.10

変わった1ファイルだけが選ばれて流れました。

この挙動こそが、cp との決定的な違いになります。

いちばんの事故は、末尾スラッシュ

rsync で最初につまずくのは、オプションではなくコピー元の末尾スラッシュでした。

同じ src を指しているつもりでも、スラッシュの有無で結果が変わります。

$ rsync -a src/ d1/   # src の「中身」を d1 直下へ
$ rsync -a src  d2/   # src「ごと」d2 の下へ

$ find d1 | sort
d1
d1/a.txt
d1/b.log
d1/sub
d1/sub/c.txt

$ find d2 | sort
d2
d2/src
d2/src/a.txt
d2/src/b.log
d2/src/sub
d2/src/sub/c.txt

d2 のほうだけ、src という階層が1段よけいに増えました。

スラッシュを1つ落としただけで、コピー先の構造が変わってしまいます。

迷ったときは -n、つまり –dry-run を足して、転送されるはずのファイル名だけ先に眺めます。

$ printf 'delta\n' > src/d.txt
$ rsync -avn src/ dst/
sending incremental file list
./
d.txt

sent 224 bytes  received 23 bytes  494.00 bytes/sec
total size is 34  speedup is 0.14 (DRY RUN)

末尾に (DRY RUN) と出ているとおり、この実行ではコピー先に1バイトも書かれていません。

初めて扱うディレクトリが相手のときは、この -n 付きを一度はさんでおくと安心です。

–delete と –exclude は意味を掴んでから

コピー先をコピー元の鏡写しにしたいなら –delete の出番です。

$ rm src/b.log
$ rsync -av --delete src/ dst/
sending incremental file list
deleting b.log
./
d.txt

sent 254 bytes  received 55 bytes  618.00 bytes/sec
total size is 28  speedup is 0.09

コピー元から消したファイルが、コピー先でも削除されました。

–delete は取り消しのきかない削除を伴うので、–dry-run で確認してから本番に回してください。

逆に、そもそも送りたくないものは –exclude で外しておきます。

$ printf 'echo\n' > src/e.log
$ rsync -av --exclude='*.log' src/ dst2/
sending incremental file list
created directory dst2
./
a.txt
d.txt
sub/
sub/c.txt

拡張子 .log のファイルだけが候補から外れました。

ログやキャッシュを巻き込まずに済むので、覚えておくと出番の多いオプションです。