「Rsync」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(校正(でき・出来))
 
(2人の利用者による、間の30版が非表示)
3行目: 3行目:
 
[[Category:バックアップ]]
 
[[Category:バックアップ]]
 
[[Category:コマンド]]
 
[[Category:コマンド]]
  +
[[de:Rsync]]
 
[[en:Rsync]]
 
[[en:Rsync]]
 
[[es:Rsync]]
 
[[es:Rsync]]
  +
[[fr:Rsync]]
  +
[[ru:Rsync]]
 
[[zh-hans:Rsync]]
 
[[zh-hans:Rsync]]
 
{{Related articles start}}
 
{{Related articles start}}
{{Related|rsync によるフルシステムバックアップ}}
+
{{Related|システムバックアップ}}
{{Related|バックアッププログラム}}
+
{{Related|同期およびバックアッププログラム}}
 
{{Related articles end}}
 
{{Related articles end}}
 
[https://rsync.samba.org/ rsync] は高速な差分ファイル転送を行うオープンソースのユーティリティです。
 
[https://rsync.samba.org/ rsync] は高速な差分ファイル転送を行うオープンソースのユーティリティです。
14行目: 17行目:
 
== インストール ==
 
== インストール ==
   
[[公式リポジトリ]]から {{Pkg|rsync}} を[[インストール]]してください。
+
{{Pkg|rsync}} パッケージを[[インストール]]してください。
   
 
​''rsync'' をソースマシンと転送先マシンの両方にインストールする必要があります。
 
​''rsync'' をソースマシンと転送先マシンの両方にインストールする必要があります。
21行目: 24行目:
   
 
* {{App|Grsync|GTK フロントエンド|http://www.opbyte.it/grsync/|{{Pkg|grsync}}}}
 
* {{App|Grsync|GTK フロントエンド|http://www.opbyte.it/grsync/|{{Pkg|grsync}}}}
* {{App|gutback|シェルで書かれた rsync ラッパー|https://github.com/gutenye/gutbackup|{{Aur|gutbackup}}}}
 
 
* {{App|JotaSync|​スケジューラ内蔵の rsync 用 Java Swing GUI|https://trixon.se/projects/jotasync/|{{Aur|jotasync}}}}
 
* {{App|JotaSync|​スケジューラ内蔵の rsync 用 Java Swing GUI|https://trixon.se/projects/jotasync/|{{Aur|jotasync}}}}
 
* {{App|luckyBackup|​C++ で書かれた Qt フロントエンド|http://luckybackup.sourceforge.net/index.html|{{Aur|luckybackup}}}}
 
* {{App|luckyBackup|​C++ で書かれた Qt フロントエンド|http://luckybackup.sourceforge.net/index.html|{{Aur|luckybackup}}}}
   
​その他ツールは以下の通りです {{Pkg|rdiff-backup}} {{AUR|osync}}
+
​その他に rsync を使っているツールは以下の通りです: {{Pkg|rdiff-backup}} 、{{AUR|osync}} および {{AUR|yarsync}}
   
  +
== cp/mv の代わりとして使う ==
== 使用方法 ==
 
   
  +
{{Note|1=cp/mv の代わりに rsync を使う事は異なるファイルシステム間では効果的ですが、同じファイルシステム上でコピーや移動する場合効果はありません。詳しくは [https://bbs.archlinux.org/viewtopic.php?id=271953] を参照してください。}}
さらに多くのサンプルを見たい場合は、[https://bbs.archlinux.org/viewforum.php?id=27 Community Contributions] や [https://bbs.archlinux.org/viewforum.php?id=33 General Programming] フォーラムを検索してください。
 
 
=== cp/mv の代わりとして使う ===
 
   
 
rsync は {{ic|cp}} または {{ic|mv}} コマンドの上位互換として使うことができ、特に大きなファイルのコピーに役立ちます:
 
rsync は {{ic|cp}} または {{ic|mv}} コマンドの上位互換として使うことができ、特に大きなファイルのコピーに役立ちます:
39行目: 39行目:
 
{{ic|-P}} オプションは {{Ic|--partial --progress}} と同じで、一部ずつファイルを転送して、転送中にプログレスバーを表示します。
 
{{ic|-P}} オプションは {{Ic|--partial --progress}} と同じで、一部ずつファイルを転送して、転送中にプログレスバーを表示します。
   
ディレクトリを再帰的にコピーしたいときは {{ic|-r --recursive}} オプションを使用し、相対パス名を使いたい時は {{ic|-R}} を使います (転送先のフォルダでフォルダ全体の階層を再生成します)
+
ディレクトリを再帰的にコピーしたいときは {{ic|-r --recursive}} オプションを使用し、相対パス名を使いたい時は {{ic|-R}} を使います (転送先のフォルダでフォルダ全体の階層を再生成します。)
  +
  +
{{ic|cp}} と同様にローカルにコピーする事に使えるだけでなく、例えば異なるホスト間といった、リモート同士でファイルをコピーする事にも使えます。リモートの場所はホスト-コロンシンタックスを使って指示できます:
  +
  +
$ rsync source host:destination
  +
  +
あるいは
  +
  +
$ rsync host:source destination
  +
  +
ネットワークを利用したファイルのやりとりには [[SSH]] をデフォルトで使い、{{ic|host}} は実際のホスト名かもしくは {{ic|.ssh/config}} で定義されたプロファイルやエイリアスで指示できます。
  +
  +
ローカルかリモートでのファイルのやりとりに関わらず、 rsync はまず始めにファイル情報を含むファイルリストを作成します (デフォルトでは、ファイル情報はサイズと最後に修正したタイムスタンプから成ります。) このファイルリストは次にファイルを構築する必要があるか否かの判断に利用されます。それぞれのファイルを構築する際には、それぞれのブロックが長さ '''S''' バイトでオーバーラップがなくまた長さ '''S''' で分割可能なようなオフセットを持つようにブロックに分けられ、弱いチェックサムと強いチェックサムを生成します。これら情報によって、rsync はファイル全体をやりとりすることなく巨大なファイルを構築することができます。実用的かつ数学的な詳細な説明は、こちらを参照してください: [https://rsync.samba.org/how-rsync-works.html rsync がどのように動作するか]、[https://rsync.samba.org/tech_report/tech_report.html rsync のアルゴリズム]
  +
  +
実用的なデフォルトの設定を手早く使いたい場合は、次の様にしてエイリアスを定義できます:
  +
{{bc|1=
  +
cpr() {
  +
rsync --archive -hh --partial --info=stats1,progress2 --modify-window=1 "$@"
  +
}
  +
mvr() {
  +
rsync --archive -hh --partial --info=stats1,progress2 --modify-window=1 --remove-source-files "$@"
  +
} }}
  +
  +
* {{ic|-hh}}: 数を読み易いフォーマット (human-readable format) で出力します
  +
* {{ic|1=--info=stats1,progress2}}: {{ic|stats1}} は rsync のファイル移行の統計を verbosity level 1 で出力します。{{ic|progress2}} は全やりとりの進捗を出力し、{{ic|progress1}} はファイル毎に進捗を出力します。
  +
* {{ic|1=--modify-window=1}}: 2つのファイルのタイムスタンプを比較する際に 1秒以下の違いがあっても同じタイムスタンプとして処理します。
  +
* {{ic|--remove-source-files}}: 正常にファイルのやりとりができた後に、ソースディレクトリからファイルを削除します。
  +
  +
{{Note|ここでの「チェックサム」は {{ic|--checksum}} オプションでの振る舞いとは互換性がありません。{{ic|--checksum}} オプションはファイルの転送前に使用されるファイルスキップヒューリスティックに影響します。{{ic|--checksum}} とは無関係に、「チェックサム」は、rsync がファイルを転送する方法であるブロックベースのファイル構築で常に使用されます。}}
   
 
=== ​末尾のスラッシュに関する注意事項 ===
 
=== ​末尾のスラッシュに関する注意事項 ===
   
Arch はデフォルトで GNU cp (GNU {{Pkg|coreutils}} の一部) を使用します。 ただし、rsync は BSD cp の規則に従います。これは、末尾にスラッシュ 「/」 が付いたソースディレクトリに特別な処理を与えます。 しかし
+
Arch はデフォルトで GNU cp (GNU {{Pkg|coreutils}} の一部) を使用します。 ただし、rsync は BSD cp の規則に従います。これは、末尾にスラッシュ 「/」 が付いたソースディレクトリに特別な処理を与えます。
   
 
$ rsync -r source destination
 
$ rsync -r source destination
   
ディレクトリ "転送先/source" を "source" の内容で作成しま
+
ディレクトリ "destination/source" を "source" の内容で作成するのに対して、
   
 
$ rsync -r source/ destination
 
$ rsync -r source/ destination
   
​は "source/" 内のすべてのファイルを "転送先" に直接コピーするが、その間にサブディレクトリは置かない
+
​は "source/" 内のすべてのファイルを "destination" にコピーしてその間にサブディレクトリは置きませんもし次を実行した様になります
   
 
$ rsync -r source/. destination
 
$ rsync -r source/. destination
   
​この動作は GNU cp の動作とは異なります。GNU cp は "source" と "source/" を同じように扱います( "source/" ありせん)。​また、シェルによっては、タブを補完するディレクトリ名の末尾にスラッシュを自動的に付加するものもあります。​これらの要因のために、 rsync を初めて使う、あるいは時々使うユーザの間では、 rsync の異なる動作を忘れてしまい、コマンドラインの最後にあるスラッシュを忘れてしまうことで、混乱を招いたり、重要なファイルを上書きしたりする傾向があります。
+
GNU cp は "source" と "source/" を同じように扱うので ("source/." は違い) ​これらの動作は GNU cp の動作とは異なります。​また、シェルによっては、タブを補完するディレクトリ名の末尾にスラッシュを自動的に付加するものもあります。​これらの要因のために、 rsync を初めて使う、あるいは時々使うユーザの間では、 rsync の異なる動作を忘れてしまい、コマンドラインの最後にあるスラッシュを忘れてしまうことで、混乱を招いたり、重要なファイルを上書きしたりする傾向があります。
 
   
したがって、rsync を呼び出す前に、ラッパースクリプトを使用して、末尾のスラッシュを自動的に削除することをお勧めします:
+
したがって、ラッパースクリプトを使用して、rsync を呼び出す前に末尾のスラッシュを自動的に削除することが賢明です:
   
#!/bin/zsh
+
#!/bin/bash
new_args=();
+
new_args=()
for i in "$@"; do
+
for i in "${@}"; do
case $i in /) i=/;; */) i=${i%/};; esac
+
case "${i}" in
new_args+=$i;
+
/)
  +
i="/"
  +
;;
  +
*/)
  +
i="${i%/}"
  +
;;
  +
esac
  +
new_args+=("${i}")
 
done
 
done
exec rsync "${(@)new_args}"
+
exec rsync "${new_args[@]}"
   
このスクリプトをパスの通った場所に置き、シェルの init ファイル内で rsync というエイリアス付けられます。
+
このスクリプトをパスの通った場所に置き、シェルの init ファイル内で rsync というエイリアス付けられます。
   
=== バックアップユーティリティとして使う ===
+
== バックアップユーティリティとして使う ==
   
rsync プロトコルは簡単なバックアップ用途に使うことができ、最後にバックアップた時から変更がったファイルだけを転送しまのセクションは rsync を使用するシンプルな定期バックアップスクリプトを説明します。基本的にリムーバルディスクコピーに利用しま。もっ詳しンプルやシステムファイルを保持するために必要オプションは、[[rsync によるフルシステムバックアップ]]見て下さい
+
rsync プロトコルは最後にバックアップされた時から変更がったファイルだけを転送すとがき、簡単にバックアップの為に使う事ができます。この節では、リムーバルディへコピーすといった、シンプルな定期的なバックアップスクリプト紹介します
   
==== 自動バックアップ ====
+
=== 自動バックアップ ===
   
このサンプルを使うには、スクリプトを {{ic|/etc/cron.daily}} ディレクトリに作成して、インストール・設定がれてcron [[デーモン]]によっ定期的スクリプトは実行されます。[[cron]] の設定や使用方法はの記事は割愛します。
+
このサンプルを使うには、スクリプトを {{ic|/etc/cron.daily}} ディレクトリに作成してさいcron [[デーモン]] をインストールし適切に設定する毎日実行せせるようになります。
   
まず、適なコマンドオプションを含んだスクリプトを作成:
+
まず、適なコマンドオプションを含んだスクリプトを作成:
   
 
{{hc|/etc/cron.daily/backup|
 
{{hc|/etc/cron.daily/backup|
#!/bin/bash
+
#!/bin/sh
rsync -a --delete /folder/to/backup /location/of/backup &> /dev/null}}
+
rsync -a --delete --quiet /path/to/backup /location/of/backup}}
   
; {{ic|-a}} : ファイルをアーカイブする。ファイルの属性も保存 (ただし ACL やハードリンク、ケイパビリティなどの拡張属性は除外)
+
* {{ic|-a}} : ファイルをアーカイブする。ファイルの属性も保存 (ただし ACL やハードリンク、ケイパビリティなどの拡張属性は除外)
; {{ic|--delete}} : バックアップ元で削除されたファイルはバックアップ先でも同じように削除する
+
* {{ic|--delete}} : バックアップ元で削除されたファイルはバックアップ先でも同じように削除する
   
ここで、{{ic|/folder/to/backup}} はバックアップしたいものに (例えば {{ic|/home}})、{{ic|/location/to/backup}} はバックアップの保存先に変更します (例えば {{ic|/media/disk}})
+
ここで、{{ic|/path/to/backup}} はバックアップしたいものに (例えば {{ic|/home}})、{{ic|/location/of/backup}} はバックアップの保存先に変更します (例えば {{ic|/media/disk}})
   
最後に、スクリプトを実行可能にします:
+
最後に、スクリプトを [[ヘルプ:読み方#実行可能属性の付与|実行可能]] にします:
   
  +
=== SSH を使った自動バックアップ ===
# chmod +x /etc/cron.daily/backup
 
 
==== SSH を使った自動バックアップ ====
 
   
 
[[SSH]] を使ってリモートホストにバックアップする場合、以下のスクリプトを使用:
 
[[SSH]] を使ってリモートホストにバックアップする場合、以下のスクリプトを使用:
   
 
{{hc|/etc/cron.daily/backup|
 
{{hc|/etc/cron.daily/backup|
#!/bin/bash
+
#!/bin/sh
rsync -a --delete -e ssh /folder/to/backup remoteuser@remotehost:/location/to/backup &> /dev/null}}
+
rsync -a --delete --quiet -e ssh /path/to/backup remoteuser@remotehost:/location/of/backup
  +
}}
  +
  +
* {{ic|-e ssh}} : rsync に SSH を使うことを教える
  +
* {{ic|remoteuser}} : ホスト {{ic|remotehost}} のユーザー
  +
* {{ic|-a}} : {{ic|-rlptgoD}} オプションと同義 (recursive, links, perms, times, group, owner, devices)
   
  +
{{Note|Rsync は、インクリメンタルバックアップでもってソース元のマシンでの状態と合うようにターゲットマシンのファイルを更新しようとします。つまり、SSH を越えてルートユーザがオーナーであるファイルをバックアップする場合 (あるいは {{ic|-a}} などによってパーミッションやオーナシップを保とうとする場合) はターゲットマシンのルートアクセスが必要になります。自動的にこれを実行しようとする場合、SSH デーモンに [https://unix.stackexchange.com/a/92397 パスワード無しの公開鍵] を使ってルートユーザにログインすることを許可するように設定して、rsync をルート権限で実行することが良いでしょう。}}
; {{ic|-e ssh}} : rsync に SSH を使うことを教える
 
; {{ic|remoteuser}} : ホスト {{ic|remotehost}} のユーザー
 
; {{ic|-a}} : {{ic|-rlptgoD}} オプションと同義 (recursive, links, perms, times, group, owner, devices)
 
   
==== NetworkManager を使った自動バックアップ ====
+
=== NetworkManager を使った自動バックアップ ===
   
 
以下のスクリプトはケーブルを接続した時にバックアップを開始します。
 
以下のスクリプトはケーブルを接続した時にバックアップを開始します。
112行目: 147行目:
   
 
{{hc|/etc/NetworkManager/dispatcher.d/backup|2=
 
{{hc|/etc/NetworkManager/dispatcher.d/backup|2=
#!/bin/bash
+
#!/bin/sh
   
 
if [ x"$2" = "xup" ] ; then
 
if [ x"$2" = "xup" ] ; then
rsync --force --ignore-errors -a --delete --bwlimit=2000 --files-from=files.rsync /folder/to/backup /location/to/backup
+
rsync --force --ignore-errors -a --delete --bwlimit=2000 --files-from=files.rsync /path/to/backup /location/of/backup
fi}}
+
fi
  +
}}
   
; {{ic|-a}} : {{ic|-rlptgoD}} オプションと同義 (recursive, links, perms, times, group, owner, devices)
+
* {{ic|-a}} : {{ic|-rlptgoD}} オプションと同義 (recursive, links, perms, times, group, owner, devices)
; {{ic|--files-from}} : ファイルから ''/folder/to/backup'' の相対パスを読み込み
+
* {{ic|--files-from}} : ファイルから {{ic|/path/to/backup}} の相対パスを読み込み
; {{ic|--bwlimit}} : I/O 帯域を制限、キロバイト毎秒
+
* {{ic|--bwlimit}} : I/O 帯域を制限、単位はキロバイト毎秒
   
また、書き込み権限は所有者 (root) だけ制限して下さい (詳しくは [[NetworkManager#ネットワークサービスと NetworkManager dispatcher|NetworkManager dispatcher]] を参照)
+
このスクリプトの所有者をルートユーザにして下さい (詳しくは [[NetworkManager#ネットワークサービスと NetworkManager dispatcher|NetworkManager dispatcher]] を参照)
   
==== systemd と inotify を使った自動バックアップ ====
+
=== systemd と inotify を使った自動バックアップ ===
   
 
{{Note|
 
{{Note|
* inotify と systemd の制限により ([http://www.quora.com/Linux-Kernel/Inotify-monitoring-of-directories-is-not-recursive-Is-there-any-specific-reason-for-this-design-in-Linux-kernel この質問と答え] を参照)再帰的なファイルシステムの監視は不可能です。ディレクトリとその中身を監視することはできますが、サブディレクトリにまで再帰的に実行してその中身を監視することはされません。監視するディレクトリは全て明示的に指定する必要があります (ディレクトリが既に指定した監視ディレクトリの下にあっても記述する必要がある)
+
* inotify と systemd の制限により ([http://www.quora.com/Linux-Kernel/Inotify-monitoring-of-directories-is-not-recursive-Is-there-any-specific-reason-for-this-design-in-Linux-kernel この質問と答え] を参照) 再帰的なファイルシステムの監視は不可能です。ディレクトリとその中身を監視することはできますが、サブディレクトリにまで再帰的に実行してその中身を監視することはされません。監視するディレクトリは全て明示的に指定する必要があります (ディレクトリが既に指定した監視ディレクトリの下にあっても記述する必要があります)
* このセットアップは [[systemd/ユーザー]]インスタンスをベースにしています。
+
* このセットアップは [[systemd/ユーザー]] インスタンスをベースにしています。
 
}}
 
}}
   
[[cron]] の実装など、スケジュールによって適宜バックアップを実行するのではなく、バックアップするファイルに変更があった度にバックアップを実行することが可能です。{{ic|systemd.path}} ユニットは {{ic|inotify}} を使ってファイルシステムを監視し、{{ic|systemd.service}} と一緒に使うことでファイルシステムのイベントに合わせてあらゆるプロセスを開始することができます (この場合は ''rsync'' のバックアップ)
+
[[cron]] の実装など、スケジュールによって適宜バックアップを実行するのではなく、この方法ではバックアップするファイルに変更があった度にバックアップを実行することが可能です。{{ic|systemd.path}} ユニットは {{ic|inotify}} を使ってファイルシステムを監視し、{{ic|systemd.service}} と一緒に使うことでファイルシステムのイベントに合わせてあらゆるプロセスを開始することができます (この場合は ''rsync'' のバックアップ。)
   
 
まず、バックアップするファイルを監視する {{ic|systemd.path}} ファイルを作成:
 
まず、バックアップするファイルを監視する {{ic|systemd.path}} ファイルを作成:
146行目: 182行目:
 
WantedBy=default.target</nowiki>}}
 
WantedBy=default.target</nowiki>}}
   
そして変更を検出した時に実行される {{ic|systemd.service}} ファイルを作成します。デフォルトで、パスユニット (ここでは {{ic|backup.path}}) と同じ名前の、拡張子が {{ic|.path}} ではなく {{ic|.service}} のサービスファイルが実行されます (ここでは {{ic|backup.service}})
+
そして変更を検出した時に実行される {{ic|systemd.service}} ファイルを作成します。デフォルトで、パスユニット (ここでは {{ic|backup.path}}) と同じ名前の、拡張子が {{ic|.path}} ではなく {{ic|.service}} のサービスファイルが実行されます (ここでは {{ic|backup.service}})
   
 
{{Note|rsync コマンドを複数実行する必要がある場合は、{{ic|1=Type=oneshot}} を使って下さい。実行する ''rsync'' ごとに、複数の {{ic|1=ExecStart=}} パラメータを指定することができます。もしくは、[[cron]] スクリプトなど、バックアップ作業を全て実行するスクリプトを書いても良いでしょう。}}
 
{{Note|rsync コマンドを複数実行する必要がある場合は、{{ic|1=Type=oneshot}} を使って下さい。実行する ''rsync'' ごとに、複数の {{ic|1=ExecStart=}} パラメータを指定することができます。もしくは、[[cron]] スクリプトなど、バックアップ作業を全て実行するスクリプトを書いても良いでしょう。}}
157行目: 193行目:
 
ExecStart=/usr/bin/rsync %h/./documents %h/./music -CERrltm --delete ubuntu:</nowiki>}}
 
ExecStart=/usr/bin/rsync %h/./documents %h/./music -CERrltm --delete ubuntu:</nowiki>}}
   
これで後は通常の systemd サービスと同じように {{ic|backup.path}} 起動有効化するだけです。ファイルの変更監視を始めて {{ic|backup.service}} 自動的に起動します:
+
これで通常の systemd サービスように {{ic|backup.path}} [[起動/有効化]] を実行するだけでファイルの変更監視され、{{ic|backup.service}} 自動的に開始されます
   
  +
=== 一週間ごとに差分バックアップ ===
{{bc|systemctl --user start backup.path
 
systemctl --user enable backup.path}}
 
   
  +
実行毎の完全なバックアップを作成して、ファイルに変更があったものだけの差分バックアップのコピーを分かれたディレクトリに保持しつつ、一週間ごとに差分バックアップを行う便利な rsync のオプションです。
==== 一週間ごとに差分バックアップ ====
 
 
完全なバックアップを作成して一週間ごとに差分バックアップを行う rsync のオプションです。
 
   
 
まず、適当なコマンドオプションを含むスクリプトを作成:
 
まず、適当なコマンドオプションを含むスクリプトを作成:
   
 
{{hc|/etc/cron.daily/backup|2=
 
{{hc|/etc/cron.daily/backup|2=
#!/bin/bash
+
#!/bin/sh
   
 
DAY=$(date +%A)
 
DAY=$(date +%A)
177行目: 210行目:
 
fi
 
fi
   
rsync -a --delete --inplace --backup --backup-dir=/location/to/backup/incr/$DAY /folder/to/backup/ /location/to/backup/full/ &> /dev/null}}
+
rsync -a --delete --quiet --inplace --backup --backup-dir=/location/to/backup/incr/$DAY /path/to/backup/ /location/to/backup/full/
  +
}}
   
; {{ic|--inplace}} : {{ic|--partial}} で指定先のファイルを直接更新
+
{{ic|--inplace}} オプションは {{ic|--partial}} を伴ない、転送先のファイルを所定の場所に更新します。
   
==== スナップショットバックアップ ====
+
=== スナップショットバックアップ ===
   
 
同じアイデアを使ってファイルのスナップショットのツリーを作ることができます。言い換えれば、ファイルのコピーが含まれる日付順のディレクトリです。コピーはハードリンクで作られ、変更があったファイルだけが場所を取ります。これは Apple の TimeMachine で使われているアイデアです。
 
同じアイデアを使ってファイルのスナップショットのツリーを作ることができます。言い換えれば、ファイルのコピーが含まれる日付順のディレクトリです。コピーはハードリンクで作られ、変更があったファイルだけが場所を取ります。これは Apple の TimeMachine で使われているアイデアです。
   
  +
次の基本的なスクリプトは簡単な実装であり、変更がないファイルへハードリンクさせる {{ic|--link-dest}} オプションを使って素早くインクリメンタルスナップショットを生成します:
シンプルに実装したのが以下のスクリプトになります:
 
  +
  +
{{hc|/usr/local/bin/snapbackup.sh|<nowiki>
  +
#!/bin/sh
  +
  +
# Basic snapshot-style rsync backup script
  +
  +
# Config
  +
OPT="-aPh"
  +
LINK="--link-dest=/snapshots/username/last/"
  +
SRC="/home/username/files/"
  +
SNAP="/snapshots/username/"
  +
LAST="/snapshots/username/last"
  +
date=`date "+%Y-%b-%d:_%T"`
  +
  +
# Run rsync to create snapshot
  +
rsync $OPT $LINK $SRC ${SNAP}$date
  +
  +
# Remove symlink to previous snapshot
  +
rm -f $LAST
  +
  +
# Create new symlink to latest snapshot for the next backup to hardlink
  +
ln -s ${SNAP}$date $LAST
  +
</nowiki>}}
  +
  +
{{ic|--link-dest}} のために既にターゲットに存在しているフルバックアップへのシンボリックリンクが必須です。最新のスナップショットが削除された場合、最新のスナップショットへのシンボリックリンクを再生成する必要があります。{{ic|--link-dest}} が動作しているシンボリックリンクを見付けられなかった場合、rsync は差分だけでなくソースファイルの全てをコピーします。
  +
  +
より洗練されたバージョンは、{{ic|$SNAP/lates}} の最新のフルバックアップと最後のバックアップからの数回分の変更を保持します。現在のフルバックアップのスナップショット {{ic|$SNAP/$DATETAG}} を、変更がないファイルへハードリンクさせるために {{ic|cp -al}} を使って生成します:
   
 
{{hc|/usr/local/bin/rsnapshot.sh|<nowiki>
 
{{hc|/usr/local/bin/rsnapshot.sh|<nowiki>
#!/bin/bash
+
#!/bin/sh
   
 
## my own rsync-based snapshot-style backup procedure
 
## my own rsync-based snapshot-style backup procedure
224行目: 285行目:
 
</nowiki>}}
 
</nowiki>}}
   
このスクリプトを systemd の[[systemd/タイマー|タイマー]]ユニットから実行することで、ぐっとシンプルにできます。
+
このスクリプトを systemd の[[systemd/タイマー|タイマー]] ユニットから実行することで、よりシンプルにできます。
   
==== システムのフルバックアップ ====
+
=== システムのフルバックアップ ===
   
このセクションでは、 ''rsync'' を使用して、選択したいくつかのディレクトリを除く {{ic|/}} ツリー全体のコピーを転送する方法について説明します。 このアプローチは、 {{ic|dd}} を使用した [[ディスクのクローン]] よりも優れていると考えられます。これは、異なるサイズ、パーティションテーブル、およびファイルシステムを使用できるため、 {{ic|cp-aを使用したコピーよりも優れているためです}} も同様です。これにより、ファイルのアクセス許可、属性、 [[アクセス制御リスト]] および [https://wiki.archlinux.jp/index.php/%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%AE%E3%83%91%E3%83%BC%E3%83%9F%E3%83%83%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%A8%E5%B1%9E%E6%80%A7#.E6.8B.A1.E5.BC.B5.E5.B1.9E.E6.80.A7 拡張属性] をより細かく制御できるようになります。
+
このセクションでは、 ''rsync'' を使用して、選択したいくつかのディレクトリを除く {{ic|/}} ツリー全体のコピーを転送する方法について説明します。 このアプローチは、 {{ic|dd}} を使用した [[ディスクのクローン]] よりも優れていると考えられます。これは、異なるサイズ、パーティションテーブル、およびファイルシステムを使用できるためであり、 {{ic|cp-a}} を使用したコピーよりも優れているためです。これにより、ファイルのアクセス許可、属性、 [[アクセス制御リスト]] および [[ファイルのパーミッションと属性#拡張属性|拡張属性]] をより細かく制御できるようになります。
   
 
''rsync'' はシステムの実行中でも機能しますが、転送中に変更されたファイルは転送される場合とされない場合があり、転送されたファイルを使用する一部のプログラムの未定義の動作を引き起こす可能性があります。
 
''rsync'' はシステムの実行中でも機能しますが、転送中に変更されたファイルは転送される場合とされない場合があり、転送されたファイルを使用する一部のプログラムの未定義の動作を引き起こす可能性があります。
   
このアプローチは、既存のインストールを新しい HDD または [[SSD]] に移行する場合に適しています。
+
このアプローチは、既存の環境を新しい HDD または [[SSD]] に移行する場合に適しています。
   
rootとして次のコマンドを実行してrsyncがすべてのシステムファイルにアクセスし、所有権を保持できることを確認します:
+
rootとして次のコマンドを実行して下さい。root権限で実行することで rsync がすべてのシステムファイルにアクセスし、所有権を保持できます:
   
 
# rsync -aAXHv --exclude={"/dev/*","/proc/*","/sys/*","/tmp/*","/run/*","/mnt/*","/media/*","/lost+found"} / ''/path/to/backup''
 
# rsync -aAXHv --exclude={"/dev/*","/proc/*","/sys/*","/tmp/*","/run/*","/mnt/*","/media/*","/lost+found"} / ''/path/to/backup''
240行目: 301行目:
 
{{ic|-aAX}} のオプションセットを使用することにより、ファイルはアーカイブモードで転送され、シンボリックリンク、デバイス、アクセス許可、所有権、変更時間、 [[ACL]]、 および拡張属性が保持されます。 ターゲット [[ファイルシステム]] がこの機能をサポートしていると仮定します。 オプション {{ic|-H}} はハードリンクを保持しますが、より多くのメモリを使用します。
 
{{ic|-aAX}} のオプションセットを使用することにより、ファイルはアーカイブモードで転送され、シンボリックリンク、デバイス、アクセス許可、所有権、変更時間、 [[ACL]]、 および拡張属性が保持されます。 ターゲット [[ファイルシステム]] がこの機能をサポートしていると仮定します。 オプション {{ic|-H}} はハードリンクを保持しますが、より多くのメモリを使用します。
   
​{{ic|--exclude}} オプションを指定すると、指定したパターンに一致するファイルが除外されます。​ディレクトリ {{ic|/dev}}}、 {{ic|/proc}}、 {{ic|/sys}}、 {{ic|/tmp}}、 {{ic|/run}} は上記のコマンドに含まれますが、これらのディレクトリの ''内容'' は除外されます。​これは、起動時にはディレクトリが作成されますが、ディレクトリ自体は作成されないためです。​{{ic|/lost+found}}はファイルシステム固有です。​上記のコマンドは、 [https://www.gnu.org/software/bash/manual/html_node/Brace-Expansion.html bash]および [http://zsh.sourceforge.net/Doc/Release/Expansion.html#Brace-Expansion zsh] シェルの両方で使用できるブレース展開に依存します。​別の [[シェル]] を使用する場合は、 {{ic|--exclude}} パターンを手動で繰り返す必要があります。​除外パターンを引用符で囲むと、 [[シェル]] による展開が回避されます。これは、たとえば [[SSH]] のバックアップ時に必要です。​除外パスの最後に {{ic|*}} を指定すると、ディレクトリ自体がまだ存在しない場合でも作成されます。
+
​{{ic|--exclude}} オプションを指定すると、指定したパターンに一致するファイルが除外されます。​ディレクトリ {{ic|/dev}}、 {{ic|/proc}}、 {{ic|/sys}}、 {{ic|/tmp}}、 {{ic|/run}} は上記のコマンドに含まれますが、これらのディレクトリの ''内容'' は除外されます。​これは、起動時にはディレクトリが作成されますが、ディレクトリ自体は作成されないためです。​{{ic|/lost+found}}はファイルシステム固有です。​上記のコマンドは、 [https://www.gnu.org/software/bash/manual/html_node/Brace-Expansion.html bash]および [http://zsh.sourceforge.net/Doc/Release/Expansion.html#Brace-Expansion zsh] シェルの両方で使用できるブレース展開に依存します。​別の [[シェル]] を使用する場合は、 {{ic|--exclude}} パターンを手動で繰り返す必要があります。​除外パターンを引用符で囲むと、 [[シェル]] による展開が回避されます。これは、たとえば [[SSH]] のバックアップ時に必要です。​除外パスの最後に {{ic|*}} を指定すると、ディレクトリ自体がまだ存在しない場合でも作成されます。
   
 
{{Note|
 
{{Note|
 
* {{ic|/mnt}} または {{ic|/media}} 以外の場所でシステムをバックアップする場合は、無限ループを回避するために、除外パターンのリストにシステムを追加することを忘れないでください。
 
* {{ic|/mnt}} または {{ic|/media}} 以外の場所でシステムをバックアップする場合は、無限ループを回避するために、除外パターンのリストにシステムを追加することを忘れないでください。
 
*システムにバインドマウントがある場合は、それらも除外して、バインドマウントされたコンテンツが1回だけコピーされるようにする必要があります。
 
*システムにバインドマウントがある場合は、それらも除外して、バインドマウントされたコンテンツが1回だけコピーされるようにする必要があります。
[[スワップファイル]] を使用る場合は、必ず除外してください。
+
*[[スワップファイル]] を使用している場合は、必ず除外してください。
 
* {{ic|/home/}} ディレクトリをバックアップするかどうかを検討してください。 データが含まれている場合は、システムよりもかなり大きくなる可能性があります。 それ以外の場合は、 {{ic|/home/*/.thumbnails/*}}, {{ic|/home/*/.cache/mozilla/*}}, {{ic|/home/*/.cache/chromium/*}}, と {{ic|/home/*/.local/share/Trash/*}} などの重要でないサブディレクトリを除外することを検討してください。 {{ic|/home/*/.local/share/Trash/*}} は、システムにインストールされているソフトウェアによって異なります。
 
* {{ic|/home/}} ディレクトリをバックアップするかどうかを検討してください。 データが含まれている場合は、システムよりもかなり大きくなる可能性があります。 それ以外の場合は、 {{ic|/home/*/.thumbnails/*}}, {{ic|/home/*/.cache/mozilla/*}}, {{ic|/home/*/.cache/chromium/*}}, と {{ic|/home/*/.local/share/Trash/*}} などの重要でないサブディレクトリを除外することを検討してください。 {{ic|/home/*/.local/share/Trash/*}} は、システムにインストールされているソフトウェアによって異なります。
 
* [[GVFS]] がインストールされている場合、 rsync エラーを防ぐために、 {{ic|/home/*/.gvfs}} を除外する必要があります。
 
* [[GVFS]] がインストールされている場合、 rsync エラーを防ぐために、 {{ic|/home/*/.gvfs}} を除外する必要があります。
253行目: 314行目:
 
追加の [[rsync]] オプションを含めるか、次のようないくつかを削除することをお勧めします。 完全なリストについては、 {{man|1|rsync}} を参照してください。
 
追加の [[rsync]] オプションを含めるか、次のようないくつかを削除することをお勧めします。 完全なリストについては、 {{man|1|rsync}} を参照してください。
   
*メモリが非常に少ないシステムで実行している場合は、 {{ic|-H}} オプションを削除することを検討してください。ただし、最近のほとんどのマシンでは問題ありません。使用するソフトウェアによっては、ファイルシステムに多くのハードリンクが存在する可能性があります(たとえば、 [[Flatpak]] を使用している場合)。多くのハードリンクは {{ic|/usr/}} ディレクトリの下にあります。
+
* メモリが非常に少ないシステムで実行している場合は、 {{ic|-H}} オプションを削除することを検討してください。ただし、最近のほとんどのマシンでは問題ありません。使用するソフトウェアによっては、ファイルシステムに多くのハードリンクが存在する可能性があります(たとえば、 [[Flatpak]] を使用している場合)。多くのハードリンクは {{ic|/usr/}} ディレクトリの下にあります。
*これを同じバックアップディレクトリで複数回実行している場合は、rsync の {{ic|--delete}} オプションを追加することをお勧めします。この場合、ソースパスが {{ic|/*}} で終わっていないことを確認してください。そうでない場合、このオプションはソースディレクトリのサブディレクトリ内のファイルにのみ影響しますが、存在するファイルには影響しません。ソースディレクトリ内に直接
+
* これを同じバックアップディレクトリで複数回実行している場合は、rsync の {{ic|--delete}} オプションを追加することをお勧めします。この場合、ソースパスが {{ic|/*}} で終わっていないことを確認してください。そうでない場合、このオプションはソースディレクトリのサブディレクトリ内のファイルにのみ影響しますが、存在するファイルには影響しません。
*仮想ディスク、 [[Docker]] イメージなどのスパースファイルを使用する場合は、 {{ic|-S}} オプションを追加する必要があります。
+
* 仮想ディスク、 [[Docker]] イメージなどのスパースファイルを使用する場合は、 {{ic|-S}} オプションを追加する必要があります。
 
* {{ic|--numeric-ids}} オプションは、ユーザー名とグループ名のマッピングを無効にします。代わりに、数値のグループ ID とユーザー ID が転送されます。これは、 [[SSH]] を介してバックアップする場合、またはライブシステムを使用して別のシステムディスクをバックアップする場合に役立ちます。
 
* {{ic|--numeric-ids}} オプションは、ユーザー名とグループ名のマッピングを無効にします。代わりに、数値のグループ ID とユーザー ID が転送されます。これは、 [[SSH]] を介してバックアップする場合、またはライブシステムを使用して別のシステムディスクをバックアップする場合に役立ちます。
 
* {{ic|-v}} の代わりに {{ic|1=-info=progress2}} オプションを選択すると、転送されるファイルのリストではなく、全体的な進行状況情報と転送速度が表示されます。
 
* {{ic|-v}} の代わりに {{ic|1=-info=progress2}} オプションを選択すると、転送されるファイルのリストではなく、全体的な進行状況情報と転送速度が表示されます。
*再帰時にファイルシステムの境界を越えないようにするには、オプション {{ic|-x}}/{{ic|--one-file-system}} を追加します。これにより、階層内のマウントポイントをバックアップできなくなります。
+
* 再帰時にファイルシステムの境界を越えないようにするには、オプション {{ic|-x}}/{{ic|--one-file-system}} を追加します。これにより、階層内のマウントポイントをバックアップできなくなります。
   
==== バックアップを復元する ====
+
=== バックアップを復元する ===
   
 
バックアップを復元する場合は、実行されたのと同じ rsync コマンドを使用しますが、ソースと宛先を逆にします。
 
バックアップを復元する場合は、実行されたのと同じ rsync コマンドを使用しますが、ソースと宛先を逆にします。
  +
  +
=== フィルター規則の高度な使用法 ===
  +
  +
包含ルールと除外ルールを個別に指定する代わりに、rsync は単一のフィルター ファイルからこれらすべてを読み取ることができます。次に、rsync はルールを上から順に処理します。最初に一致したルールが優先されます。
  +
  +
{{hc|backup.filter|
  +
# Exclude patterns
  +
  +
- .thumbnails/***
  +
- node_modules/***
  +
- venv/***
  +
  +
# Include patterns
  +
  +
+ /Documents/***
  +
+ /Books/***
  +
+ /Music/***
  +
  +
# Exclude everything else
  +
- /**
  +
}}
  +
  +
{{ic|***}} は、フォルダーとそのすべてのコンテンツを再帰的に照合する特別な rsync パターンです。
  +
  +
詳細については、{{man|1|rsync|PATTERN MATCHING RULES}} および {{man|1|rsync|FILTER RULES IN DEPTH}} を確認してください。
  +
  +
次に、以下のように rsync を実行します。
  +
  +
$ rsync -aAXHv --filter="merge backup.filter" $SRC $DEST
  +
  +
キーワードは {{ic|--filter "merge ..."}} パラメータで、フィルタファイルを受け取り、同期された各ファイルのルールを順番に解析します。
  +
  +
=== パスのリストからコピー ===
  +
  +
[[#フィルター規則の高度な使用法]] 方法の代わりに、{{ic|--files-from}} オプションを使用することもできます。これは、各エントリが改行で区切られたディレクトリまたはファイルパスのリストを含むテキストファイルから入力を受け取ることができます、ユーザーが再帰的なディレクトリのコピーを望む場合は、{{ic|-a}} がすでに含まれている場合でも、このオプションに {{ic|-r}} フラグを手動で指定する必要があることに注意してください。
  +
  +
たとえば、ディレクトリのリストとすべての再帰ディレクトリは、次のようにアーカイブできます:
  +
  +
$ rsync -aAXHvr --files-from="dir_list.txt" $SRC $DEST
   
 
== ファイルシステムのクローニング ==
 
== ファイルシステムのクローニング ==
274行目: 374行目:
 
それらの意味は (manpageから):
 
それらの意味は (manpageから):
   
--hard-links, -H preserve hard links
+
--hard-links, -H ハードリンクを保持する
--acls, -A preserve ACLs (implies --perms)
+
--acls, -A ACLを保持する(--perms を意味します)
--xattrs, -X preserve extended attributes
+
--xattrs, -X 拡張属性を保持する
--sparse, -S turn sequences of nulls into sparse blocks
+
--sparse, -S null シーケンスを疎らなブロックに変換する
   
 
さらに、コピーから除外するツリーの下に他のファイルシステムがマウントされている場合は、 {{ic|-x}} を使用します。
 
さらに、コピーから除外するツリーの下に他のファイルシステムがマウントされている場合は、 {{ic|-x}} を使用します。
生成されたコピーは、 {{ic|diff}} の再帰オプションを使用して、ファイルシステムレベルで簡単に再読み取りおよびチェックできます(たとえば、データ回復の試行後)
+
生成されたコピーは、 {{ic|diff}} の再帰オプションを使用して、ファイルシステムレベルで簡単に再読み取りおよびチェックできます(たとえば、データ回復の試行後)
  +
  +
{{Note|rsync を使用して Arch インストールを新しいドライブに移行する場合は、[[Rsync#​末尾のスラッシュに関する注意事項|​末尾のスラッシュに関する注意事項]] で述べたように、{{ic|SOURCE_DIR}} の最後に末尾のスラッシュを含めることを忘れないでください。}}
  +
  +
生成されたコピーは、{{ic|diff}} の再帰オプションを使用して、ファイルシステムレベルで単純に再読み取りおよびチェックできます (たとえば、データ リカバリの試行後)
   
 
diff -r SOURCE_DIR DESTINATION_DIR
 
diff -r SOURCE_DIR DESTINATION_DIR
   
rsync を使用し、 [[新しいハードウェアに移行する]] で説明されているように [[fstab]] と [https://wiki.archlinux.jp/index.php/Arch_%E3%83%96%E3%83%BC%E3%83%88%E3%83%97%E3%83%AD%E3%82%BB%E3%82%B9 ブートローダー] を更新することで、ファイルシステムの移行を成功させることができます。 これは基本的に、ルートファイルシステムを別のルートファイルシステムに変換する時にも適しています。
+
rsync を使用し、 [[新しいハードウェアに移行する]] で説明されているように [[fstab]] と [[ブートローダー]] を更新することで、ファイルシステムの移行を成功させることができます。 これは基本的に、ルートファイルシステムを別のルートファイルシステムに変換する時にも適しています。
   
== rsync デーモン ==
+
== デーモンとして ==
   
 
''rsync'' は、ポート {{ic|873}} で待機しているサーバー上でデーモンとして実行できます。
 
''rsync'' は、ポート {{ic|873}} で待機しているサーバー上でデーモンとして実行できます。
   
​テンプレート {{ic|/etc/rsyncd.conf}} を編集して共有を構成し、 {{ic|rsyncd.service}} を [https://wiki.archlinux.jp/index.php/Systemd#.E3.83.A6.E3.83.8B.E3.83.83.E3.83.88.E3.82.92.E4.BD.BF.E3.81.86 スタート] します。
+
​テンプレート {{ic|/etc/rsyncd.conf}} を編集して共有を設定し、{{ic|rsyncd.service}} を [[systemd#ユニットを使う|スタート]] します。
 
{{Note| {{Pkg|rsync}} 3.2.0-1 の時点で、パッケージはアップストリーム systemd ユニットファイル {{ic|rsyncd.service}} と {{ic|rsyncd@.service}} を採用しました。 {{ic|1=ProtectHome}} の変更についてコメントがあり、 {{ic|[Service]}} セクションのセキュリティ機能 {{ic|1=ProtectSystem=full}} は引き続きアクティブです。 これにより、 {{ic|/boot/}}、 {{ic|/etc/}}、 および {{ic|/usr/}} ディレクトリが読み取り専用になります。 rsyncd 書き込みシステムディレクトリが必要な場合は、ユニットを [https://wiki.archlinux.jp/index.php/Systemd#.E3.83.A6.E3.83.8B.E3.83.83.E3.83.88.E3.83.95.E3.82.A1.E3.82.A4.E3.83.AB.E3.81.AE.E7.B7.A8.E9.9B.86 編集] して、オーバーライドするスニペットの {{ic|[Service]}} セクションで {{ic|1=ProtectSystem=off}} を設定できます。}}
 
   
  +
{{Note|{{Pkg|rsync}} 3.2.0-1 の時点で、パッケージはアップストリーム systemd ユニットファイル {{ic|rsyncd.service}} と {{ic|rsyncd@.service}} を採用しました。{{ic|1=ProtectHome}} の変更についてコメントがあり、{{ic|[Service]}} セクションのセキュリティ機能 {{ic|1=ProtectSystem=full}} は引き続きアクティブです。これにより、{{ic|/boot/}}、{{ic|/etc/}}、および {{ic|/usr/}} ディレクトリが読み取り専用になります。rsyncd によるシステムディレクトリの書き込みが必要な場合は、ユニットを [[systemd#ユニットファイルの編集|編集]] して、スニペットの {{ic|[Service]}} セクションで {{ic|1=ProtectSystem=off}} を設定します。}}
クライアントからの使用
 
   
例:サーバーコンテンツの一覧表示:
+
クライアントからの使用法 (例:サーバーコンテンツリスト):
   
 
$ rsync rsync://''server/share''
 
$ rsync rsync://''server/share''
304行目: 406行目:
 
$ rsync ''local-file'' rsync://''server/share/''
 
$ rsync ''local-file'' rsync://''server/share/''
   
ポート {{ic|873}} ユーザー認証を開くための iptables を検討してください。
+
[[ファイアウォール]] で TCP ポート {{ic|873}} を開き、ユーザー認証を使用することを検討してください。
   
 
{{Note|ユーザー認証を含むすべての転送データは暗号化されていません。}}
 
{{Note|ユーザー認証を含むすべての転送データは暗号化されていません。}}
341行目: 443行目:
   
 
* その他の使用例は、こちらで検索できます。 [https://bbs.archlinux.org/viewforum.php?id=27 Community Contributions] , [https://bbs.archlinux.org/viewforum.php?id=33 General Programming] フォーラム
 
* その他の使用例は、こちらで検索できます。 [https://bbs.archlinux.org/viewforum.php?id=27 Community Contributions] , [https://bbs.archlinux.org/viewforum.php?id=33 General Programming] フォーラム
  +
* [https://www.pointsoftware.ch/2012/09/12/howto-local-and-remote-snapshot-backup-using-rsync-with-hard-links/ Howto – local and remote snapshot backup using rsync with hard links] ハードリンクによるファイル重複排除、MD5 完全性署名、"chattr" 保護、フィルタールール、ディスククォータ、指数分布による保持ポリシー (古いバックアップより新しいバックアップを保存しながらローテーションする) を含みます。
 
* [https://stackoverflow.com/questions/5527068/how-do-you-use-an-identity-file-with-rsync Using SSH keys/identity files with rsync]
 
* [https://stackoverflow.com/questions/5527068/how-do-you-use-an-identity-file-with-rsync Using SSH keys/identity files with rsync]
* [https://www.fosslinux.com/41713/top-20-rsync-examples-in-linux.htm Linuxでのトップ20のRsyncサンプル]
 

2024年7月10日 (水) 21:09時点における最新版

関連記事

rsync は高速な差分ファイル転送を行うオープンソースのユーティリティです。

インストール

rsync パッケージをインストールしてください。

rsync をソースマシンと転送先マシンの両方にインストールする必要があります。

フロントエンド

  • Grsync — GTK フロントエンド
http://www.opbyte.it/grsync/ || grsync
  • JotaSync — ​スケジューラ内蔵の rsync 用 Java Swing GUI
https://trixon.se/projects/jotasync/ || jotasyncAUR
  • luckyBackup — ​C++ で書かれた Qt フロントエンド
http://luckybackup.sourceforge.net/index.html || luckybackupAUR

​その他に rsync を使っているツールは以下の通りです: rdiff-backuposyncAUR および yarsyncAUR

cp/mv の代わりとして使う

ノート: cp/mv の代わりに rsync を使う事は異なるファイルシステム間では効果的ですが、同じファイルシステム上でコピーや移動する場合効果はありません。詳しくは [1] を参照してください。

rsync は cp または mv コマンドの上位互換として使うことができ、特に大きなファイルのコピーに役立ちます:

$ rsync -P source destination

-P オプションは --partial --progress と同じで、一部ずつファイルを転送して、転送中にプログレスバーを表示します。

ディレクトリを再帰的にコピーしたいときは -r --recursive オプションを使用し、相対パス名を使いたい時は -R を使います (転送先のフォルダでフォルダ全体の階層を再生成します。)

cp と同様にローカルにコピーする事に使えるだけでなく、例えば異なるホスト間といった、リモート同士でファイルをコピーする事にも使えます。リモートの場所はホスト-コロンシンタックスを使って指示できます:

$ rsync source host:destination

あるいは

$ rsync host:source destination

ネットワークを利用したファイルのやりとりには SSH をデフォルトで使い、host は実際のホスト名かもしくは .ssh/config で定義されたプロファイルやエイリアスで指示できます。

ローカルかリモートでのファイルのやりとりに関わらず、 rsync はまず始めにファイル情報を含むファイルリストを作成します (デフォルトでは、ファイル情報はサイズと最後に修正したタイムスタンプから成ります。) このファイルリストは次にファイルを構築する必要があるか否かの判断に利用されます。それぞれのファイルを構築する際には、それぞれのブロックが長さ S バイトでオーバーラップがなくまた長さ S で分割可能なようなオフセットを持つようにブロックに分けられ、弱いチェックサムと強いチェックサムを生成します。これら情報によって、rsync はファイル全体をやりとりすることなく巨大なファイルを構築することができます。実用的かつ数学的な詳細な説明は、こちらを参照してください: rsync がどのように動作するかrsync のアルゴリズム

実用的なデフォルトの設定を手早く使いたい場合は、次の様にしてエイリアスを定義できます:

cpr() {
  rsync --archive -hh --partial --info=stats1,progress2 --modify-window=1 "$@"
} 
mvr() {
  rsync --archive -hh --partial --info=stats1,progress2 --modify-window=1 --remove-source-files "$@"
}
  • -hh: 数を読み易いフォーマット (human-readable format) で出力します
  • --info=stats1,progress2: stats1 は rsync のファイル移行の統計を verbosity level 1 で出力します。progress2 は全やりとりの進捗を出力し、progress1 はファイル毎に進捗を出力します。
  • --modify-window=1: 2つのファイルのタイムスタンプを比較する際に 1秒以下の違いがあっても同じタイムスタンプとして処理します。
  • --remove-source-files: 正常にファイルのやりとりができた後に、ソースディレクトリからファイルを削除します。
ノート: ここでの「チェックサム」は --checksum オプションでの振る舞いとは互換性がありません。--checksum オプションはファイルの転送前に使用されるファイルスキップヒューリスティックに影響します。--checksum とは無関係に、「チェックサム」は、rsync がファイルを転送する方法であるブロックベースのファイル構築で常に使用されます。

​末尾のスラッシュに関する注意事項

Arch はデフォルトで GNU cp (GNU coreutils の一部) を使用します。 ただし、rsync は BSD cp の規則に従います。これは、末尾にスラッシュ 「/」 が付いたソースディレクトリに特別な処理を与えます。

$ rsync -r source destination

ディレクトリ "destination/source" を "source" の内容で作成するのに対して、

$ rsync -r source/ destination

​は "source/" 内のすべてのファイルを "destination" にコピーしてその間にサブディレクトリは置きません。もし次を実行した様になります

$ rsync -r source/. destination

GNU cp は "source" と "source/" を同じように扱うので ("source/." は違います) ​これらの動作は GNU cp の動作とは異なります。​また、シェルによっては、タブを補完するディレクトリ名の末尾にスラッシュを自動的に付加するものもあります。​これらの要因のために、 rsync を初めて使う、あるいは時々使うユーザの間では、 rsync の異なる動作を忘れてしまい、コマンドラインの最後にあるスラッシュを忘れてしまうことで、混乱を招いたり、重要なファイルを上書きしたりする傾向があります。

したがって、ラッパースクリプトを使用して、rsync を呼び出す前に末尾のスラッシュを自動的に削除することが賢明です:

#!/bin/bash
new_args=()
for i in "${@}"; do
    case "${i}" in
        /)
            i="/"
        ;;
        */)
            i="${i%/}"
        ;;
        esac
    new_args+=("${i}")
done
exec rsync "${new_args[@]}"

このスクリプトをパスの通った場所に置き、シェルの init ファイル内で rsync というエイリアスを付けられます。

バックアップユーティリティとして使う

rsync プロトコルは最後にバックアップされた時点から変更があったファイルだけを転送することができ、簡単にバックアップの為に使う事ができます。この節では、リムーバルメディアへコピーするといった、シンプルな定期的なバックアップスクリプトを紹介します。

自動バックアップ

このサンプルを使うには、スクリプトを /etc/cron.daily ディレクトリに作成して下さい。cron デーモン をインストールして適切に設定することで毎日実行せせるようになります。

まず、適切なコマンドオプションを含んだスクリプトを作成:

/etc/cron.daily/backup
#!/bin/sh
rsync -a --delete --quiet /path/to/backup /location/of/backup
  • -a : ファイルをアーカイブする。ファイルの属性も保存 (ただし ACL やハードリンク、ケイパビリティなどの拡張属性は除外)
  • --delete : バックアップ元で削除されたファイルはバックアップ先でも同じように削除する

ここで、/path/to/backup はバックアップしたいものに (例えば /home)、/location/of/backup はバックアップの保存先に変更します (例えば /media/disk)

最後に、スクリプトを 実行可能 にします:

SSH を使った自動バックアップ

SSH を使ってリモートホストにバックアップする場合、以下のスクリプトを使用:

/etc/cron.daily/backup
#!/bin/sh
rsync -a --delete --quiet -e ssh /path/to/backup remoteuser@remotehost:/location/of/backup
  • -e ssh : rsync に SSH を使うことを教える
  • remoteuser : ホスト remotehost のユーザー
  • -a : -rlptgoD オプションと同義 (recursive, links, perms, times, group, owner, devices)
ノート: Rsync は、インクリメンタルバックアップでもってソース元のマシンでの状態と合うようにターゲットマシンのファイルを更新しようとします。つまり、SSH を越えてルートユーザがオーナーであるファイルをバックアップする場合 (あるいは -a などによってパーミッションやオーナシップを保とうとする場合) はターゲットマシンのルートアクセスが必要になります。自動的にこれを実行しようとする場合、SSH デーモンに パスワード無しの公開鍵 を使ってルートユーザにログインすることを許可するように設定して、rsync をルート権限で実行することが良いでしょう。

NetworkManager を使った自動バックアップ

以下のスクリプトはケーブルを接続した時にバックアップを開始します。

まず、適当なコマンドオプションを含んだスクリプトを作成:

/etc/NetworkManager/dispatcher.d/backup
#!/bin/sh

if [ x"$2" = "xup" ] ; then
        rsync --force --ignore-errors -a --delete --bwlimit=2000 --files-from=files.rsync /path/to/backup /location/of/backup
fi
  • -a : -rlptgoD オプションと同義 (recursive, links, perms, times, group, owner, devices)
  • --files-from : ファイルから /path/to/backup の相対パスを読み込み
  • --bwlimit : I/O 帯域を制限、単位はキロバイト毎秒

このスクリプトの所有者をルートユーザにして下さい (詳しくは NetworkManager dispatcher を参照)

systemd と inotify を使った自動バックアップ

ノート:
  • inotify と systemd の制限により (この質問と答え を参照) 再帰的なファイルシステムの監視は不可能です。ディレクトリとその中身を監視することはできますが、サブディレクトリにまで再帰的に実行してその中身を監視することはされません。監視するディレクトリは全て明示的に指定する必要があります (ディレクトリが既に指定した監視ディレクトリの下にあっても記述する必要があります。)
  • このセットアップは systemd/ユーザー インスタンスをベースにしています。

cron の実装など、スケジュールによって適宜バックアップを実行するのではなく、この方法ではバックアップするファイルに変更があった度にバックアップを実行することが可能です。systemd.path ユニットは inotify を使ってファイルシステムを監視し、systemd.service と一緒に使うことでファイルシステムのイベントに合わせてあらゆるプロセスを開始することができます (この場合は rsync のバックアップ。)

まず、バックアップするファイルを監視する systemd.path ファイルを作成:

~/.config/systemd/user/backup.path
[Unit]
Description=Checks if paths that are currently being backed up have changed

[Path]
PathChanged=%h/documents
PathChanged=%h/music

[Install]
WantedBy=default.target

そして変更を検出した時に実行される systemd.service ファイルを作成します。デフォルトで、パスユニット (ここでは backup.path) と同じ名前の、拡張子が .path ではなく .service のサービスファイルが実行されます (ここでは backup.service)

ノート: rsync コマンドを複数実行する必要がある場合は、Type=oneshot を使って下さい。実行する rsync ごとに、複数の ExecStart= パラメータを指定することができます。もしくは、cron スクリプトなど、バックアップ作業を全て実行するスクリプトを書いても良いでしょう。
~/.config/systemd/user/backup.service
[Unit]
Description=Backs up files

[Service]
ExecStart=/usr/bin/rsync %h/./documents %h/./music -CERrltm --delete ubuntu:

これで、通常の systemd サービスのように backup.path 起動/有効化 を実行するだけで、ファイルの変更が監視され、backup.service が自動的に開始されます。

一週間ごとに差分バックアップ

実行毎の完全なバックアップを作成して、ファイルに変更があったものだけの差分バックアップのコピーを分かれたディレクトリに保持しつつ、一週間ごとに差分バックアップを行う便利な rsync のオプションです。

まず、適当なコマンドオプションを含むスクリプトを作成:

/etc/cron.daily/backup
#!/bin/sh

DAY=$(date +%A)

if [ -e /location/to/backup/incr/$DAY ] ; then
  rm -fr /location/to/backup/incr/$DAY
fi

rsync -a --delete --quiet --inplace --backup --backup-dir=/location/to/backup/incr/$DAY /path/to/backup/ /location/to/backup/full/

--inplace オプションは --partial を伴ない、転送先のファイルを所定の場所に更新します。

スナップショットバックアップ

同じアイデアを使ってファイルのスナップショットのツリーを作ることができます。言い換えれば、ファイルのコピーが含まれる日付順のディレクトリです。コピーはハードリンクで作られ、変更があったファイルだけが場所を取ります。これは Apple の TimeMachine で使われているアイデアです。

次の基本的なスクリプトは簡単な実装であり、変更がないファイルへハードリンクさせる --link-dest オプションを使って素早くインクリメンタルスナップショットを生成します:

/usr/local/bin/snapbackup.sh
#!/bin/sh

# Basic snapshot-style rsync backup script 

# Config
OPT="-aPh"
LINK="--link-dest=/snapshots/username/last/" 
SRC="/home/username/files/"
SNAP="/snapshots/username/"
LAST="/snapshots/username/last"
date=`date "+%Y-%b-%d:_%T"`

# Run rsync to create snapshot
rsync $OPT $LINK $SRC ${SNAP}$date

# Remove symlink to previous snapshot
rm -f $LAST

# Create new symlink to latest snapshot for the next backup to hardlink
ln -s ${SNAP}$date $LAST

--link-dest のために既にターゲットに存在しているフルバックアップへのシンボリックリンクが必須です。最新のスナップショットが削除された場合、最新のスナップショットへのシンボリックリンクを再生成する必要があります。--link-dest が動作しているシンボリックリンクを見付けられなかった場合、rsync は差分だけでなくソースファイルの全てをコピーします。

より洗練されたバージョンは、$SNAP/lates の最新のフルバックアップと最後のバックアップからの数回分の変更を保持します。現在のフルバックアップのスナップショット $SNAP/$DATETAG を、変更がないファイルへハードリンクさせるために cp -al を使って生成します:

/usr/local/bin/rsnapshot.sh
#!/bin/sh

## my own rsync-based snapshot-style backup procedure
## (cc) marcio rps AT gmail.com

# config vars

SRC="/home/username/files/" #dont forget trailing slash!
SNAP="/snapshots/username"
OPTS="-rltgoi --delay-updates --delete --chmod=a-w"
MINCHANGES=20

# run this process with real low priority

ionice -c 3 -p $$
renice +12  -p $$

# sync

rsync $OPTS $SRC $SNAP/latest >> $SNAP/rsync.log

# check if enough has changed and if so
# make a hardlinked copy named as the date

COUNT=$( wc -l $SNAP/rsync.log|cut -d" " -f1 )
if [ $COUNT -gt $MINCHANGES ] ; then
        DATETAG=$(date +%Y-%m-%d)
        if [ ! -e $SNAP/$DATETAG ] ; then
                cp -al $SNAP/latest $SNAP/$DATETAG
                chmod u+w $SNAP/$DATETAG
                mv $SNAP/rsync.log $SNAP/$DATETAG
               chmod u-w $SNAP/$DATETAG
         fi
fi

このスクリプトを systemd のタイマー ユニットから実行することで、よりシンプルにできます。

システムのフルバックアップ

このセクションでは、 rsync を使用して、選択したいくつかのディレクトリを除く / ツリー全体のコピーを転送する方法について説明します。 このアプローチは、 dd を使用した ディスクのクローン よりも優れていると考えられます。これは、異なるサイズ、パーティションテーブル、およびファイルシステムを使用できるためであり、 cp-a を使用したコピーよりも優れているためです。これにより、ファイルのアクセス許可、属性、 アクセス制御リスト および 拡張属性 をより細かく制御できるようになります。

rsync はシステムの実行中でも機能しますが、転送中に変更されたファイルは転送される場合とされない場合があり、転送されたファイルを使用する一部のプログラムの未定義の動作を引き起こす可能性があります。

このアプローチは、既存の環境を新しい HDD または SSD に移行する場合に適しています。

rootとして次のコマンドを実行して下さい。root権限で実行することで rsync がすべてのシステムファイルにアクセスし、所有権を保持できます:

# rsync -aAXHv --exclude={"/dev/*","/proc/*","/sys/*","/tmp/*","/run/*","/mnt/*","/media/*","/lost+found"} / /path/to/backup

-aAX のオプションセットを使用することにより、ファイルはアーカイブモードで転送され、シンボリックリンク、デバイス、アクセス許可、所有権、変更時間、 ACL、 および拡張属性が保持されます。 ターゲット ファイルシステム がこの機能をサポートしていると仮定します。 オプション -H はハードリンクを保持しますが、より多くのメモリを使用します。

--exclude オプションを指定すると、指定したパターンに一致するファイルが除外されます。​ディレクトリ /dev/proc/sys/tmp/run は上記のコマンドに含まれますが、これらのディレクトリの 内容 は除外されます。​これは、起動時にはディレクトリが作成されますが、ディレクトリ自体は作成されないためです。​/lost+foundはファイルシステム固有です。​上記のコマンドは、 bashおよび zsh シェルの両方で使用できるブレース展開に依存します。​別の シェル を使用する場合は、 --exclude パターンを手動で繰り返す必要があります。​除外パターンを引用符で囲むと、 シェル による展開が回避されます。これは、たとえば SSH のバックアップ時に必要です。​除外パスの最後に * を指定すると、ディレクトリ自体がまだ存在しない場合でも作成されます。

ノート:
  • /mnt または /media 以外の場所でシステムをバックアップする場合は、無限ループを回避するために、除外パターンのリストにシステムを追加することを忘れないでください。
  • システムにバインドマウントがある場合は、それらも除外して、バインドマウントされたコンテンツが1回だけコピーされるようにする必要があります。
  • スワップファイル を使用している場合は、必ず除外してください。
  • /home/ ディレクトリをバックアップするかどうかを検討してください。 データが含まれている場合は、システムよりもかなり大きくなる可能性があります。 それ以外の場合は、 /home/*/.thumbnails/*, /home/*/.cache/mozilla/*, /home/*/.cache/chromium/*, と /home/*/.local/share/Trash/* などの重要でないサブディレクトリを除外することを検討してください。 /home/*/.local/share/Trash/* は、システムにインストールされているソフトウェアによって異なります。
  • GVFS がインストールされている場合、 rsync エラーを防ぐために、 /home/*/.gvfs を除外する必要があります。
  • Dhcpcd ≥9.0.0 がインストールされている場合は、 /var/lib/dhcpcd/* ディレクトリを除外します。これは、いくつかのシステムディレクトリをサブディレクトリとしてマウントするためです。

追加の rsync オプションを含めるか、次のようないくつかを削除することをお勧めします。 完全なリストについては、 rsync(1) を参照してください。

  • メモリが非常に少ないシステムで実行している場合は、 -H オプションを削除することを検討してください。ただし、最近のほとんどのマシンでは問題ありません。使用するソフトウェアによっては、ファイルシステムに多くのハードリンクが存在する可能性があります(たとえば、 Flatpak を使用している場合)。多くのハードリンクは /usr/ ディレクトリの下にあります。
  • これを同じバックアップディレクトリで複数回実行している場合は、rsync の --delete オプションを追加することをお勧めします。この場合、ソースパスが /* で終わっていないことを確認してください。そうでない場合、このオプションはソースディレクトリのサブディレクトリ内のファイルにのみ影響しますが、存在するファイルには影響しません。
  • 仮想ディスク、 Docker イメージなどのスパースファイルを使用する場合は、 -S オプションを追加する必要があります。
  • --numeric-ids オプションは、ユーザー名とグループ名のマッピングを無効にします。代わりに、数値のグループ ID とユーザー ID が転送されます。これは、 SSH を介してバックアップする場合、またはライブシステムを使用して別のシステムディスクをバックアップする場合に役立ちます。
  • -v の代わりに -info=progress2 オプションを選択すると、転送されるファイルのリストではなく、全体的な進行状況情報と転送速度が表示されます。
  • 再帰時にファイルシステムの境界を越えないようにするには、オプション -x/--one-file-system を追加します。これにより、階層内のマウントポイントをバックアップできなくなります。

バックアップを復元する

バックアップを復元する場合は、実行されたのと同じ rsync コマンドを使用しますが、ソースと宛先を逆にします。

フィルター規則の高度な使用法

包含ルールと除外ルールを個別に指定する代わりに、rsync は単一のフィルター ファイルからこれらすべてを読み取ることができます。次に、rsync はルールを上から順に処理します。最初に一致したルールが優先されます。

backup.filter
# Exclude patterns

- .thumbnails/***
- node_modules/***
- venv/***

# Include patterns

+ /Documents/***
+ /Books/***
+ /Music/***

# Exclude everything else
- /**

*** は、フォルダーとそのすべてのコンテンツを再帰的に照合する特別な rsync パターンです。

詳細については、rsync(1) § PATTERN MATCHING RULES および rsync(1) § FILTER RULES IN DEPTH を確認してください。

次に、以下のように rsync を実行します。

$ rsync -aAXHv --filter="merge backup.filter" $SRC $DEST

キーワードは --filter "merge ..." パラメータで、フィルタファイルを受け取り、同期された各ファイルのルールを順番に解析します。

パスのリストからコピー

#フィルター規則の高度な使用法 方法の代わりに、--files-from オプションを使用することもできます。これは、各エントリが改行で区切られたディレクトリまたはファイルパスのリストを含むテキストファイルから入力を受け取ることができます、ユーザーが再帰的なディレクトリのコピーを望む場合は、-a がすでに含まれている場合でも、このオプションに -r フラグを手動で指定する必要があることに注意してください。

たとえば、ディレクトリのリストとすべての再帰ディレクトリは、次のようにアーカイブできます:

$ rsync -aAXHvr --files-from="dir_list.txt" $SRC $DEST

ファイルシステムのクローニング

rsync は、ファイルシステムのメタデータを含む可能な限り多くの情報を保持しながら、ファイルシステム内のすべてのデータのコピーを実行する方法を提供します。 これは、ソースファイルシステムと宛先ファイルシステムが同じタイプである必要がないファイルシステムレベルでのデータ複製の手順です。 バックアップ、ファイルシステムの移行、またはデータ復旧に使用できます。

rsync の "アーカイブ" モードは、アクセス制御リスト、拡張属性、スパースファイルプロパティなどの特別なファイルシステムメタデータはバックアップされません。 ファイルシステムレベルでのクローンを成功させるには、いくつかのオプションを追加する必要があります。

rsync -qaHAXS SOURCE_DIR DESTINATION_DIR

それらの意味は (manpageから):

--hard-links, -H         ハードリンクを保持する
--acls, -A               ACLを保持する(--perms を意味します)
--xattrs, -X             拡張属性を保持する
--sparse, -S             null シーケンスを疎らなブロックに変換する

さらに、コピーから除外するツリーの下に他のファイルシステムがマウントされている場合は、 -x を使用します。 生成されたコピーは、 diff の再帰オプションを使用して、ファイルシステムレベルで簡単に再読み取りおよびチェックできます(たとえば、データ回復の試行後)

ノート: rsync を使用して Arch インストールを新しいドライブに移行する場合は、​末尾のスラッシュに関する注意事項 で述べたように、SOURCE_DIR の最後に末尾のスラッシュを含めることを忘れないでください。

生成されたコピーは、diff の再帰オプションを使用して、ファイルシステムレベルで単純に再読み取りおよびチェックできます (たとえば、データ リカバリの試行後)

diff -r SOURCE_DIR DESTINATION_DIR

rsync を使用し、 新しいハードウェアに移行する で説明されているように fstabブートローダー を更新することで、ファイルシステムの移行を成功させることができます。 これは基本的に、ルートファイルシステムを別のルートファイルシステムに変換する時にも適しています。

デーモンとして

rsync は、ポート 873 で待機しているサーバー上でデーモンとして実行できます。

​テンプレート /etc/rsyncd.conf を編集して共有を設定し、rsyncd.serviceスタート します。

ノート: rsync 3.2.0-1 の時点で、パッケージはアップストリーム systemd ユニットファイル rsyncd.servicersyncd@.service を採用しました。ProtectHome の変更についてコメントがあり、[Service] セクションのセキュリティ機能 ProtectSystem=full は引き続きアクティブです。これにより、/boot//etc/、および /usr/ ディレクトリが読み取り専用になります。rsyncd によるシステムディレクトリの書き込みが必要な場合は、ユニットを 編集 して、スニペットの [Service] セクションで ProtectSystem=off を設定します。

クライアントからの使用法 (例:サーバーのコンテンツリスト):

$ rsync rsync://server/share

クライアントからサーバーにファイルを転送する:

$ rsync local-file rsync://server/share/

ファイアウォール で TCP ポート 873 を開き、ユーザー認証を使用することを検討してください。

ノート: ユーザー認証を含むすべての転送データは暗号化されていません。

設定例

ファイルのリストから共有する

/etc/rsyncd.conf
...

# Needed when crossing filesystem boundaries.
#use chroot  = no
read only = yes

...

[sync]
    path         = /
# List of files to copy.
    include from = /backup.list
# Exclude the rest.
    exclude      = *

ファイルリスト内では、ワイルドカード *** が使用されている場合を除き、すべての 中間パス が必要です:

/backup.list
/etc/
/etc/conf.d/
/etc/conf.d/hwclock
/etc/fonts/***

参照