rsyncコマンドでファイルを同期・転送する方法｜--deleteの安全な使い方やリモートバックアップも

「rsync先でファイルが消えた...どのオプションを付ければよかったんだ？」
「scpで毎回全ファイルをコピーしていて、転送に時間がかかりすぎる...」
Linuxでファイルやディレクトリを効率的に同期・転送するなら、rsync コマンドが最適です。差分だけを転送するため、scpやcpと比べて圧倒的に高速で、バックアップの定番ツールとして現場で広く使われています。

この記事では、rsync コマンド の実践的な使い方を解説します。
基本的なローカルコピーからリモートサーバーへのファイル転送、--delete の安全な使い方、cronと組み合わせた自動バックアップまで、現場で使えるテクニックをまとめました。

rsyncとは？（差分転送で高速にファイルを同期するコマンド）

rsync は「remote sync」の略で、ファイルやディレクトリを同期するためのコマンドです。

最大の特徴は差分転送です。転送元と転送先を比較して、変更があったファイルだけを転送します。そのため、2回目以降のコピーが劇的に速くなります。
cp コマンドとの最大の違いは、rsync が「変更されたファイルだけ」を転送する点です。数GBのディレクトリでも、変更が数ファイルだけなら一瞬で同期が完了します。

基本的な使い方（ローカルでのファイルコピー・同期）

まずはローカル環境でのコピーから見ていきましょう。rsyncはリモート転送だけでなく、ローカルのファイルコピーにも使えます。

1. ファイルを1つコピーする

この時点では cp コマンドとほぼ同じ動作です。rsyncの真価は、ディレクトリ単位の同期で発揮されます。

2. ディレクトリを同期する（-aオプション）

ディレクトリごと同期する場合は、-a（archive）オプションを使います。パーミッション・所有者・タイムスタンプを保持したまま再帰的にコピーします。
-a は -rlptgoD の省略形で、以下をまとめて指定しています。

・-r：再帰的にコピー（サブディレクトリを含む）
・-l：シンボリックリンクをリンクのままコピー
・-p：パーミッションを保持
・-t：タイムスタンプを保持
・-g：グループを保持
・-o：所有者を保持（root権限が必要）
・-D：デバイスファイル・特殊ファイルを保持

実務では rsync -a をベースに、必要なオプションを追加していくのが定番です。

3. 進捗を表示する（-vと--progress）

転送状況を確認したい場合は、-v（verbose）や --progress を追加します。
大量のファイルを転送する際は、どこまで進んでいるかが一目でわかるので安心です。

4. 末尾のスラッシュに注意（重要な落とし穴）

rsyncでは、転送元パスの末尾にスラッシュがあるかどうかで動作が変わります。これを知らないと意図しないディレクトリ構造になります。
実務でよくあるミスなので、転送元のパスは意識的にスラッシュの有無を確認してください。

リモートサーバーへの転送（SSH経由のrsync）

rsyncの本領はリモートサーバーとのファイル同期です。SSH経由で安全にファイルを転送できます。

1. ローカルからリモートへ転送する

-z オプションは転送データを圧縮します。ネットワーク越しの転送では、帯域の節約になるため付けるのが一般的です。

2. リモートからローカルへ取得する

転送元と転送先を逆にするだけです。バックアップサーバーからログを引っ張ってくる場合などに使います。

3. SSHポートを指定する（-eオプション）

SSHのポート番号がデフォルトの22以外の場合は、-e オプションで指定します。
セキュリティ上、SSHポートを変更しているサーバーは多いため、覚えておくと便利です。

実務で使うオプション一覧

rsyncのオプションは非常に多いですが、実務で使うものは限られています。よく使うオプションをまとめます。

・-a：アーカイブモード（パーミッション・所有者・タイムスタンプ保持）
・-v：転送ファイル名を表示する
・-z：転送データを圧縮する（リモート転送時に有効）
・--progress：転送の進捗を表示する
・--delete：転送元にないファイルを転送先から削除する
・--exclude：指定したパターンのファイルを除外する
・--dry-run（-n）：実際には転送せず、何が起こるかだけ表示する
・--backup：上書きされるファイルのバックアップを作成する
・-e：リモートシェルを指定する（SSHポート変更時など）

特に --delete と --dry-run は使い方を間違えるとデータを失う可能性があるため、次のセクションで詳しく解説します。

--deleteの安全な使い方（転送先の不要ファイルを削除する）

--delete オプションは、転送元に存在しないファイルを転送先から削除します。完全なミラーリングを行いたい場合に使いますが、使い方を誤ると転送先のファイルが消えます。

1. まず--dry-runで確認する（鉄則）

--delete を使う前に、必ず --dry-run（または -n）で何が削除されるか確認してください。
「deleting」と表示されたファイルが削除対象です。意図しないファイルが含まれていないか、必ず目視で確認しましょう。

2. --deleteを実行する

--dry-run で問題がなければ、-n を外して実行します。

【重要】--deleteの危険性

--delete で転送元のパスを間違えると、転送先のファイルが全て削除される可能性があります。
このコマンドを実行すると、/backup/html/ 内の全ファイルが削除されます。--delete は必ず --dry-run とセットで使うことを習慣にしてください。

除外設定（--excludeで特定ファイルをスキップする）

ログファイルやキャッシュなど、同期不要なファイルを除外する方法です。

1. パターンで除外する

2. 除外リストをファイルで管理する（--exclude-from）

除外パターンが多い場合は、ファイルにまとめて管理すると便利です。
プロジェクトごとに除外リストを用意しておくと、毎回オプションを打つ手間が省けます。

cronと組み合わせた自動バックアップ（定期実行の設定方法）

rsyncの真価は、cronと組み合わせて自動バックアップを構築したときに発揮されます。手動で毎回コマンドを打つ必要がなくなり、深夜帯に差分だけを転送する運用が実現できます。

1. バックアップスクリプトを作成する

まず、rsyncコマンドをシェルスクリプトにまとめます。直接crontabにコマンドを書くより、スクリプト化しておく方が管理しやすく、ログ出力も柔軟に設定できます。
ログファイルに日時と転送結果を記録しておくと、バックアップが正常に動いているか後から確認できます。

2. crontabに登録する

スクリプトが動作することを確認したら、crontabに登録して定期実行を設定します。
crontabの書式は「分 時 日 月 曜日 コマンド」です。上の例では毎日午前3時0分にスクリプトが実行されます。

3. SSH鍵認証を設定する（パスワード入力なしで接続）

cronで自動実行する場合、パスワード入力ができません。SSH鍵認証を事前に設定しておく必要があります。
バックアップスクリプト内で鍵ファイルを明示的に指定する場合は、-e オプションを使います。

【重要】cron実行時の注意点

cronで実行する場合、ログイン時とは環境変数が異なります。以下の点に注意してください。

・PATHが通っていない：rsyncのフルパス（/usr/bin/rsync）を使うか、スクリプト冒頭でPATHを明示する
・ログを必ず残す：cronはデフォルトで標準出力を捨てるため、スクリプト内でログファイルに出力する
・動作確認を先にする：crontabに登録する前に、手動でスクリプトを実行して正常に動くことを確認する

トラブルシュート・エラー対処

rsyncで遭遇しやすいエラーと対処法をまとめます。

「Permission denied」が出た時の対処法

リモートサーバーへの転送時に権限エラーが出る場合は、以下を確認してください。
・SSH鍵ファイルの権限が600（所有者のみ読み書き）になっているか
・転送先ディレクトリへの書き込み権限があるか
・-a オプションで所有者を保持する場合はroot権限が必要

「rsync: connection unexpectedly closed」の対処法

転送中に接続が切れる場合は、以下が原因であることが多いです。

・リモートサーバーにrsyncがインストールされていない
・ファイアウォールでSSHポートがブロックされている
・転送先のディスク容量が不足している

「rsync error: some files could not be transferred」の対処法

一部のファイルだけ転送に失敗する場合は、読み取り権限がないファイルが含まれている可能性があります。

本記事のまとめ

やりたいこと	コマンド
ディレクトリを同期する（基本）	rsync -av 転送元/ 転送先/
リモートサーバーに転送する	rsync -avz 転送元/ user@host:転送先/
リモートからファイルを取得する	rsync -avz user@host:転送元/ 転送先/
転送先の不要ファイルを削除する	rsync -av --delete 転送元/ 転送先/
実行前に確認する（ドライラン）	rsync -avn --delete 転送元/ 転送先/
特定ファイルを除外する	rsync -av --exclude="*.log" 転送元/ 転送先/
SSHポートを指定して転送する	rsync -avz -e "ssh -p 2222" 転送元/ user@host:転送先/
cronで毎日自動バックアップする	0 3 * * * /usr/local/bin/backup-web.sh