Resilio Syncのソースを表示

[[Category:同期]]
[[en:Resilio Sync]]
[[ru:BitTorrent Sync]]
{{Related articles start}}
{{Related|Syncthing}}
{{Related|バックアッププログラム}}
{{Related articles end}}
[https://www.resilio.com/individuals/ Resilio Sync] (旧名: [https://www.getsync.com/ BitTorrent Sync (BTSync)] は [https://en.wikipedia.org/wiki/Bittorrent BitTorrent] プロトコルを用いたファイル同期ソフトウェアです｡他の同期ソフトウェアと違い、ファイルをオンラインのサーバにアップロードせず、各々のデバイスが直接サーバからファイルを取得します｡ファイル転送は直接 (peer to peer) 行われるため、データストレージ容量や転送速度に制限がありません｡

== 安全性 ==
AES-128 暗号と secret (同期するフォルダごとによって固有のランダムな文字列、20バイト以上) を元にして作成された256ビットのキーを使って異なるデバイス間の同期は暗号化されます｡'secret' と呼ばれる、base32 でエンコードしたランダムな21バイトのキーという特殊な方法を用います｡ 

== 同期 ==
同期フォルダをデバイスが追加した時、secret が作成されます｡以降、同期が必要なデバイスはこの鍵を知らなくてはなりません｡

同期には、2者間に十分なディスクスペースがあれば、速度やサイズの制限はありません｡

== インストール ==
{{AUR|rslsync}} は [[Arch User Repository|AUR]] からインストール可能です｡パッケージには rslsync デーモンを管理するための [[systemd]] サービスが含まれています。また、デフォルトの {{ic|/etc/rslsync.conf}} が作成されます｡[[systemctl]] を使って起動する前に、ファイルの中のログイン ID やパスワードなど、変更したい箇所を変更しておいてください｡

また、'tar.gz' でパッケージングされた実行可能ファイルが [http://www.bittorrent.com/sync/download/ 公式ウェブサイト] から取得できます｡以下のガイドは AUR から rslsync をインストールしていることを前提にしています｡

== 使い方 ==
Resilio Sync の Linux クライアントには典型的な GUI が存在しません｡代わりに、{{ic|localhost:8888}} からアクセス可能な WebUI サーバをセットアップします｡同期フォルダは設定ファイルで静的に設定することもできますが、そうすると WebGUI が使えなくなります｡

インストールしたら、{{ic|~/.config/rslsync/rslsync.conf}} に設定ファイルを作成する必要があります｡[[#設定]] を見てください｡{{ic|storage_path}} ディレクトリの作成も必要です。設定が完了したら、以下のようにサービスを開始または（起動時に開始したいなら）有効化してください:
 $ systemctl --user start rslsync
 $ systemctl --user enable rslsync
上記のコマンドは root で実行しないことに注意してください。root で実行すると D-BUS が接続を拒否するためエラーが発生します。

{{note|
* {{ic|rslsync}} をユーザーで実行する場合、{{ic|rslsync.conf}} ファイルと {{ic|rslsync.pid}} ファイルが存在するディレクトリのパーティションが適切に設定されていることを確認してください。ユーザーがアクセスできない場所にファイルが置かれている場合、サービスの起動に失敗します。ユーザーのパーティションは正しいのに {{ic|rslsync}} の起動に失敗する場合、マシンを再起動してください。
* ヘッドレスサーバーで {{ic|rslsync}} を実行する場合、lingering を有効にしてユーザーセッションの外でも {{ic|rslsync}} が実行されるようにしてください: [[Systemd/ユーザー#systemd のユーザーインスタンスを自動起動]]を見てください。}}

{{ic|rslsync}} システムユーザーで実行することもできます。その場合 {{ic|--user}} を取ってください:
 # systemctl enable rslsync
 # systemctl start rslsync
ユーザーの設定は {{ic|/etc/rslsync.conf}} に、メタデータは {{ic|/var/lib/rslsync/}} にデフォルトで保存されます。ユーザー名とパスワードの設定は変更するようにしてください。

== 設定 ==
以下のコマンドでサンプル設定ファイルを作成することができます:
 # rslsync --dump-sample-config > ~/.config/rslsync/rslsync.conf

変更するべき設定は以下の通りです:
* device_name
* storage_path
* webui/login
* webui/password

{{note|
* {{ic|rslsync}} は {{ic|storage_path}} ディレクトリが存在しない場合でも自動的には作成してくれません。ディレクトリが存在しない場合、手動で作成するか[[#設定ファイルの自動作成|設定ファイルの自動作成]]を使ってください。
* storage_path の設定は、メタデータが保存される場所を定義します｡同期するファイルでは'''ありません'''｡同期するファイルの保存場所は WebGUI でフォルダごとに定義します｡
* 最近のバージョンの {{ic|rslsync}} では {{ic|webui/password_hash}} が上手く動作しません。代わりに {{ic|webui/password}} でファイルを指定してください。
}}

===設定ファイルの自動作成===

{{AUR|btsync-autoconfig}} パッケージには systemd のユーザーサービス ({{ic|btsync-autoconfig.service}}) が含まれており、有効にすると、ユーザーの {{ic|btsync.service}} が起動したときにデフォルト値で設定ファイルを作成します。

{{note|{{AUR|btsync-autoconfig}} によって設定ファイルが作成された場合、ポートの設定が違うかもしれません。{{ic|btsync}} のユーザーインスタンスのポートは 8888 ではなく {{ic|7889 + $UID}} になります。{{ic|$UID}} が "1000" なら、ポートは 8889 です。}}

インストールスクリプトはデフォルトで全てのユーザーでサービスを有効化します。以下のコマンドで無効化することができます:

 # systemctl --global disable btsync-autoconfig.service

以下のコマンドを使うことで特定のユーザで有効化できます:

 $ systemctl --user enable btsync-autoconfig.service

{{ic|btsync-autoconfig.service}} は {{ic|~/.config/btsync/btsync.conf}} が存在しない場合、デフォルトで作成しますが、設定のデフォルト値は以下のようになります:

* device_name: {{ic|$USER@$HOSTNAME}}
* storage_path: {{ic|~/.btsync}}
* webui/login: {{ic|$USER/password}}

また、スクリプトは {{ic|storage_path}} ディレクトリも作成します。設定ファイルの作成とは別に行われます。

==トラブルシューティング==

===Missing storage path===

サービスを起動しても WebUI にアクセスできない場合、{{ic|systemctl --user status rslsync}} を実行して rslsync の状態を確認してください (システムインスタンスの場合は {{ic|systemctl status rslsync}} を実行)。

よくあるエラーは {{ic|Storage path specified in config file does not exist.}} です。{{ic|mkdir ~/.rslsync}} を実行するか、{{ic|storage_path}} の設定を変更することで簡単に解決できます。

===特定のファイルやフォルダの同期を無視する===

同期フォルダの特定のファイルを Resilio Sync によって追跡されないようにしたい場合、{{ic|IgnoreList}} を使ってください。{{ic|IgnoreList}} は隠しフォルダの {{ic|.sync}} に入っています。

{{ic|IgnoreList}} は UTF-8 でエンコードされた .txt ファイルで、ファイルのパスやルールを記述して同期の対象から外すことができます。{{ic|IgnoreList}} ファイルは1行ごとに1つのルールを指定します。無視フィルターにかかったファイルはインデックスの対象外になり Sync のメインビューの "Size" カラムにカウントされなくなります。

ワイルドカード記号の '?' や '*' を使用することができます。

{{ic|IgnoreList}} をフォルダに適用した場合、既に同期されたフォルダ内のファイルに効果はありません。インデックスに含まれたファイルを {{ic|IgnoreList}} に追加した場合、他の同期デバイスでファイルが削除されます。削除されないようにしたい場合:

* 全てのデバイスでフォルダを同期から外す。
* 全てのデバイスの {{ic|IgnoreList}} ファイルを編集して同じ情報を記入する。
* 修正を加えたフォルダを再度追加する。

詳しくは [http://help.getsync.com/customer/portal/articles/1673122-ignoring-files-in-sync-ignorelist-?b_id=3895 Ignoring files in Sync (IgnoreList)] を参照してください。

===ARM アライメントエラー===

{{ic|/etc/tmpfiles.d/rslsync.conf}} に {{ic|w /proc/cpu/alignment - - - - 2}} という行を追加してください (ファイルは作成する必要があります)。ただし、この設定をすると性能が劣化する可能性があります。

== 参照 ==

*[http://help.getsync.com/ Official Resilio Sync Help]
*[https://help.getsync.com/hc/en-us/articles/212001046-Resilio-Sync-FAQ Official Resilio Sync FAQ]