rsyncの使い方｜オプション一覧と目的別コピペ例（実行結果つき）

rsyncとは、フォルダやファイルを「差分だけ」コピーして、コピー元とコピー先を同じ状態にそろえるコマンドです。2回目以降は変わったファイルだけを送るので速く、ssh経由で別のサーバーとも同期できます。バックアップ、デプロイ、サーバー移行などで広く使われています。

この記事では、オプション一覧と目的別のコピペ例をまとめ、すべて実際に実行して出力を載せています（rsync 3.2.7 / Ubuntu 24.04）。つまずきやすい末尾スラッシュの有無を tree で比較し、--delete を dry-run で安全に確かめる手順、--exclude のパターンの落とし穴、ローカルに立てたsshサーバーへのssh経由の同期、転送が途中で切れたときの再開（--partial）の効果、--link-dest による世代バックアップの容量も実測しました。

rsyncのオプション一覧（早見表）

目的別コピペ

rsyncの基本の書き方

rsync [オプション] コピー元 コピー先

ssh経由で使う場合は、手元とサーバーの両方に rsync が入っている必要があります。サーバー側で rsync が見つからないと rsync: command not found のようなメッセージで止まるので、サーバーにもインストールします。

バージョンは rsync --version で確認できます。

$ rsync --version | head -1
rsync  version 3.2.7  protocol version 31

2026年9月時点の最新版は 3.4.4（2026年6月公開）です。3.4.0 で重要なセキュリティ修正が入っているので、特にrsyncデーモンを公開している環境では、OSの更新で新しい版にしておくと安心です。この記事のオプションは 3.2.7 と 3.4 系で共通です。

末尾スラッシュの有無で結果が変わる

rsyncでいちばん大切なルールは「コピー元の末尾に / を付けると中身だけ、付けないとフォルダごと」です。

rsync -a src dst1     # 末尾スラッシュなし
rsync -a src/ dst2    # 末尾スラッシュあり
tree -a -L 2 dst1 dst2

dst1
└── src              ← フォルダごとコピーされた
    ├── .git
    ├── README.md
    ├── cache
    ├── debug.log
    ├── docs
    └── images
dst2                 ← 中身だけがコピーされた
├── .git
│   └── HEAD
├── README.md
├── cache
│   └── a.tmp
├── debug.log
├── docs
│   ├── guide.md
│   └── spec.md
└── images
    └── logo.png

コピー先の末尾スラッシュは、結果に影響しません。迷ったら「コピー元もコピー先も / で終える」と決めておくと、毎回同じ結果になります。

-a（アーカイブモード）の中身

-a は次のオプションをまとめたものです。rsync --help にも archive mode is -rlptgoD (no -A,-X,-U,-N,-H) と表示されます。

-t で日時を保つことで、次回「日時とサイズが同じなら送らない」という判定ができます。-a を付けずに -r だけで同期すると、日時がそろわないため毎回すべてのファイルを送り直すことになります。

-H の有無で、ハードリンクを含むフォルダ（同じ10MBのファイルに2つの名前がある状態）をコピーしました。

$ du -sh hl
9.6M    hl
$ rsync -a hl/ hlA/ && du -sh hlA
20M     hlA         ← -a だけだと別々のファイルになり2倍に
$ rsync -aH hl/ hlH/ && du -sh hlH
9.6M    hlH

実行結果で見る：初回と2回目の違い

$ rsync -av src/ backup/
sending incremental file list
created directory backup
./
README.md
debug.log
.git/
.git/HEAD
cache/
cache/a.tmp
docs/
docs/guide.md
docs/spec.md
images/
images/logo.png

sent 200,716 bytes  received 209 bytes  401,850.00 bytes/sec
total size is 200,035  speedup is 1.00

変更せずにもう一度実行すると、何も送られません。

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

sent 313 bytes  received 16 bytes  658.00 bytes/sec
total size is 200,035  speedup is 608.01

speedup は「全体のサイズ ÷ 実際に送った量」です。2回目は313バイトのやり取りだけで済み、608倍の効率になりました。

-i（itemize）で「何が変わったか」を見る

ファイルを1つ変更、1つ追加、1つ削除して -i を付けました。

$ rsync -ai --delete src/ backup/
*deleting   debug.log
.d..t...... ./
.d..t...... docs/
>f+++++++++ docs/new.md
>f..t...... docs/spec.md

--delete を安全に使う手順

--delete は、コピー元にないファイルをコピー先から削除して、完全に同じ状態にするオプションです。便利な反面、コピー先を間違えると必要なファイルも消えるので、次の手順で確かめてから実行すると安心です。

手順1：-n（dry-run）で何が消えるか確認する

$ rsync -avn --delete src/ backup/
sending incremental file list
deleting debug.log
./
docs/
docs/new.md
docs/spec.md

sent 335 bytes  received 48 bytes  766.00 bytes/sec
total size is 200,035  speedup is 522.28 (DRY RUN)

最後に (DRY RUN) と表示され、実際には何も変わっていません。deleting の行が、実行すると消えるファイルです。

手順2：コピー先を1階層まちがえた例

archive/ の下に src/ のコピーと、別の other-project/ がある状態です。

archive
├── other-project
│   └── data.csv
└── src
    ├── .git
    ├── README.md
    ...

本当は archive/src/ と書くべきところを archive/ と書いて dry-run すると、次のように表示されました。

$ rsync -avn --delete src/ archive/ | grep -E 'deleting|DRY'
deleting src/images/logo.png
...（中略）
deleting src/
deleting other-project/data.csv
deleting other-project/
total size is 200,037  speedup is 254.50 (DRY RUN)

$ rsync -avn --delete src/ archive/src/ | grep -E 'deleting|DRY'
total size is 200,037  speedup is 480.86 (DRY RUN)     ← 正しい宛先なら削除なし

dry-run で deleting が思ったより多いときは、コピー先のパスと末尾スラッシュを見直します。

手順3：--max-delete=0 で「消すものがあれば止める」

$ rsync -a --delete --max-delete=0 src/ archive/src/
Deletions stopped due to --max-delete limit (1 skipped)
rsync error: the --max-delete limit stopped deletions (code 25) at main.c(1356) [sender=3.2.7]

--max-delete=0 は、削除対象があれば削除せずに終了コード25で知らせます。定期実行のスクリプトで「普段は削除が出ないはず」の同期に付けておくと、異常に気づけます。上限を件数で決めたいときは --max-delete=100 のように書きます（上限に達するまでは削除されます）。

手順4：--backup-dir で消えるファイルを退避しておく

$ rsync -a --delete --backup --backup-dir=../_trash/$(date +%Y%m%d) src/ archive/src/
$ tree -a archive/_trash
archive/_trash
└── 20260929
    ├── docs
    │   └── spec.md      ← 上書きされる前の古い版
    └── old.md           ← 削除されたファイル

$ cat archive/_trash/*/docs/spec.md
v2

--backup-dir の相対パスは、コピー先フォルダからの相対パスになります。上書き前の版と削除されたファイルが日付のフォルダに残るので、あとから取り戻せます。

--exclude / --include のつまずきポイント

パターンの書き方で、除外される範囲が変わります。src/cache/ と src/docs/cache/ の2つの cache があるフォルダで試しました。

$ rsync -a --exclude='/cache' src/ ex2/ && tree -a ex2 | grep -n cache
6:│   ├── cache           ← docs/cache は残る

$ rsync -a --exclude='src/cache' src/ ex4/ && tree -a ex4 | grep -n cache
5:├── cache
8:│   ├── cache           ← どちらも除外されていない

先頭の / は、ファイルシステムの / ではなく「コピー元のフォルダの直下」を指します。src/cache のようにコピー元の名前を含めると一致しないので注意します。

特定の拡張子だけをコピーする（include と exclude の順番）

rsyncは、パターンを上から順に見て最初に一致したものを使います。そのため --include を先に、--exclude='*' を最後に書きます。

$ rsync -a --exclude='*' --include='*.md' src/ ex7/ && tree -a ex7
ex7

0 directories, 0 files               ← 先に exclude '*' に一致して全部除外

$ rsync -a --include='*.md' --exclude='*' src/ ex6/ && tree -a ex6
ex6
└── README.md                         ← フォルダも除外されて、中の .md に届かない

$ rsync -a --include='*/' --include='*.md' --exclude='*' -m src/ ex8/ && tree -a ex8
ex8
├── README.md
└── docs
    ├── guide.md
    ├── new.md
    └── spec.md

--include='*/' でフォルダの中に入れるようにし、-m で空のフォルダを作らないようにするのが定番の書き方です。-m を付けないと、.git や cache のような空のフォルダも作られました。

ssh経由で同期する

ローカルに sshd を立て、~/.ssh/config と同じ書き方の設定ファイル（ssh.conf）で backup-server という名前を付けて試しました。

Host backup-server
    HostName 127.0.0.1
    Port 7273
    User root
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes

アップロード（push）

$ rsync -avz -e 'ssh -F ssh.conf' src/ backup-server:/tmp/t27rb/site/
sending incremental file list
created directory /tmp/t27rb/site
./
README.md
.git/
.git/HEAD
cache/
cache/a.tmp
docs/
docs/guide.md
docs/new.md
docs/spec.md
docs/cache/
docs/cache/c.tmp
images/
images/logo.png

sent 200,836 bytes  received 241 bytes  402,154.00 bytes/sec
total size is 200,037  speedup is 0.99

~/.ssh/config に書いたホスト名は、rsync でもそのまま使えます。普段は -e を付けずに rsync -avz src/ backup-server:/srv/site/ と書けます（今回は検証用の設定ファイルを読ませるために -e 'ssh -F ssh.conf' を付けています）。

ダウンロード（pull）

$ rsync -av -e 'ssh -F ssh.conf' backup-server:/tmp/t27rb/site/docs/ pulled2/
receiving incremental file list
created directory pulled2
./
guide.md
new.md
spec.md
cache/
cache/c.tmp

ポートや鍵を直接指定する

rsync -av -e 'ssh -p 7273 -i ~/.ssh/id_ed25519' src/README.md root@127.0.0.1:/srv/site/

コピー先のフォルダが深くて存在しないとき（--mkpath）

$ rsync -a -e 'ssh -F ssh.conf' src/ backup-server:/nonexistent/deep/dir/
rsync: [Receiver] mkdir "/nonexistent/deep/dir" failed: No such file or directory (2)
rsync error: error in file IO (code 11) at main.c(800) [Receiver=3.2.7]

$ rsync -a --mkpath -e 'ssh -F ssh.conf' src/ backup-server:/tmp/t27rb/deep/new/dir/
（成功）

rsyncが自動で作るのはコピー先の最後の1階層だけです。途中の階層もまとめて作るには --mkpath を付けます。

接続できないときのエラー

$ rsync -a -e 'ssh -F ssh.conf -p 7274' src/ backup-server:/srv/x/
ssh: connect to host 127.0.0.1 port 7274: Connection refused
rsync: connection unexpectedly closed (0 bytes received so far) [sender]
rsync error: unexplained error (code 255) at io.c(232) [sender=3.2.7]

connection unexpectedly closed が出たら、その上の行（ssh のメッセージ）に本当の原因があります。まず ssh backup-server 単体で接続できるかを確かめます。

大きなファイルを送る：進捗・帯域制限・再開

全体の進捗を表示する

$ rsync -a --info=progress2 big.bin out_big.bin
     30,000,000 100%  583.24MB/s    0:00:00 (xfr#1, to-chk=0/1)

帯域を制限する（--bwlimit）

$ rsync -aP --bwlimit=5m big.bin out_big.bin
     16,744,448  55%    5.00MB/s    0:00:02
     22,315,008  74%    5.00MB/s    0:00:01
     27,885,568  92%    5.00MB/s    0:00:00
     30,000,000 100%    5.08MB/s    0:00:05 (xfr#1, to-chk=0/1)

--bwlimit=5m で、ほぼ5MB/秒に抑えられました。日中に共有の回線を使うときに役立ちます。

途中で切れても続きから送る（--partial）

30MBのファイルを5MB/秒で送り、3秒で強制終了してから、もう一度送りました。

$ timeout 3 rsync -a --partial --bwlimit=5m -e 'ssh -F ssh.conf' big.bin backup-server:/tmp/t27rb/big/
$ ls -l /tmp/t27rb/big/
-rw-r--r-- 1 root root 15040512 Jan  1  1970 big.bin       ← 途中までのファイルが残る

$ rsync -a --partial --stats -e 'ssh -F ssh.conf' big.bin backup-server:/tmp/t27rb/big/ | grep -E 'Literal|Matched'
Literal data: 14,961,152 bytes      ← 実際に送った量
Matched data: 15,038,848 bytes      ← 途中までのファイルを再利用できた量

--partial を付けると、途中まで送った約15MBが再利用され、残りの約15MBだけが送られました。--partial なしで同じように止めると、コピー先には何も残りませんでした。大きなファイルは -P（--partial --progress）を付けて送るのがおすすめです。

-u と --checksum：比べ方を変える

-u：コピー先の方が新しければ上書きしない

$ rsync -aiu src/ archive/src/
（何も表示されない：コピー先の README.md が新しいので飛ばした）

$ rsync -ai src/ archive/src/
>f.st...... README.md               ← -u なしでは上書き

--checksum：日時とサイズが同じでも中身で比べる

中身は違うが、サイズと更新日時が同じファイルを用意しました。

$ rsync -ai c1.txt cs/
（何も表示されない：日時とサイズが同じなので同一とみなした）

$ rsync -aic c1.txt cs/
>fc........ c1.txt                  ← チェックサムの違いを検出して送った

rsyncは既定で「更新日時とサイズ」で判定するため、とても速い反面、この2つが同じだと中身の違いを見逃します。確実に中身をそろえたいときは -c を付けます。全ファイルを読むので時間はかかります。

--link-dest で世代バックアップ（容量を実測）

--link-dest を使うと、前回から変わっていないファイルはハードリンク（同じデータに別の名前を付ける仕組み）になり、日付ごとの完全なフォルダを少ない容量で残せます。

#!/bin/bash
# snapshot.sh：毎日の世代バックアップ
set -eu
SRC=/srv/data/
DEST=/backup/snapshots
TODAY=$(date +%F)

mkdir -p "$DEST"
rsync -a --delete --link-dest="$DEST/latest" "$SRC" "$DEST/$TODAY/"
ln -sfn "$DEST/$TODAY" "$DEST/latest"

約54MB・1,200ファイルほどのフォルダで、1日に1〜2ファイルずつ変更しながら3世代作りました。

$ du -sh snapshots/*
54M     snapshots/2026-09-27
432K    snapshots/2026-09-28
404K    snapshots/2026-09-29

$ du -sh snapshots
55M     snapshots

3世代とも中身がそろった完全なフォルダなのに、合計は55MBでした。2世代目以降は、変わったファイルとフォルダの情報のぶんだけ増えています。変わっていないファイルは同じ inode（ファイルの実体の番号）を共有しています。

$ ls -li snapshots/*/abc.py | awk '{print $1, $3, $NF}'
2622023 3 snapshots/2026-09-27/abc.py      ← 同じ番号、リンク数3
2622023 3 snapshots/2026-09-28/abc.py
2622023 3 snapshots/2026-09-29/abc.py

古い世代を削除しても、ほかの世代のファイルは残ります。

$ rm -rf snapshots/2026-09-27 && du -sh snapshots/*
54M     snapshots/2026-09-28
404K    snapshots/2026-09-29

--link-dest の相対パスに注意

$ rsync -a --link-dest=2026-09-28 data/ snapshots/bad/
--link-dest arg does not exist: 2026-09-28
$ du -sh snapshots/bad
54M     snapshots/bad          ← リンクされず、全部コピーされた

--link-dest の相対パスは、コピー先フォルダからの相対パスです。snapshots/bad/ から見た前回分は ../2026-09-28 になります。迷ったら上のスクリプトのように絶対パスで書きます。初回（前回分がまだない）は同じメッセージが出ますが、通常のコピーとして完了します。

cp・scp との違い

1回だけ数ファイルを送るなら scp、繰り返し同じフォルダをそろえるなら rsync、と使い分けると便利です。

macOS・Windowsでの注意

rsync --version を実行し、1行目に rsync version 3.x と表示されるかを確認すると、どの実装が動いているかわかります。

よくあるエラーと終了コード

よくある質問

Q. rsyncでファイルを「移動」できますか？ A. --remove-source-files を付けると、転送が終わったファイルをコピー元から削除します。フォルダは残るので、空のフォルダは別途削除します。まず -n で対象を確認してから使うと安心です。

Q. -z（圧縮）はいつも付けたほうがよいですか？ A. ssh越しでテキストが多いときに効果があります。ローカルのコピーや、画像・動画・圧縮ファイルが中心のときは効果が小さいので、付けなくてかまいません。

Q. 同期の前に何が起きるか確かめたいです。 A. -n（--dry-run）を付けます。-i も付けると、ファイルごとに「新規・更新・削除」が記号でわかります。特に --delete を使うときは、先に dry-run で deleting の行を確認します。

Q. 定期的に自動で実行したいです。 A. cron や systemd タイマーに登録します。ssh経由の場合はパスフレーズなしの専用鍵を用意し、サーバー側の authorized_keys で使えるコマンドを制限すると安全です。スクリプトには --max-delete を付けておくと、想定外の削除を防げます。

まとめ

• rsyncは差分だけを送って、コピー元とコピー先をそろえるコマンド。基本は rsync -av src/ dst/
• コピー元の末尾 / ありは「中身だけ」、なしは「フォルダごと」
• -a は -rlptgoD。ハードリンク・ACL・拡張属性は -H -A -X を追加
• --delete の前に -n で dry-run。--max-delete=0 と --backup-dir で安全に
• 除外パターンの先頭 / はコピー元の直下、末尾 / はフォルダだけ。特定の拡張子だけなら --include='*/' --include='*.md' --exclude='*' -m
• ssh経由は ~/.ssh/config のホスト名がそのまま使える。大きなファイルは -P で再開可能に
• --link-dest の世代バックアップは、3世代でもほぼ1世代分の容量で済んだ

株式会社RJCでは、バックアップや同期のような縁の下の作業も、実際に試して安全な手順を仲間と共有しています。こうした知識を共有しながら、日々技術を磨いています。

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。