ファイル同期
ファイル同期は、HandyCafeサーバーからネットワーク全体のクライアントPCにファイルを配布します。ゲームのアップデート、設定ファイル、ソフトウェアインストーラー、クライアントメニューのアセットを各マシンを訪問せずにプッシュするために使用します。
これはマニフェストベースのアプローチを使用しているため、変更されたファイルや新しいファイルのみが転送され、繰り返しの同期が迅速に行われます。
このページは 設定 > ファイル同期 にあります。
クライアント同期を有効にする
ページの右上にあるトグルで全機能を制御します。クライアント同期を有効にする がオフの場合、ページはクライアント同期が一時停止していると報告し、公開および削除のアクションがブロックされます。何かを公開する前にオンにしてください。
同期ソースを公開する
同期ソースを公開する セクションは、同期を作成する場所です。2つの値を取ります:
| フィールド | 内容 |
|---|---|
| ソースパス | 配布したいサーバー上のファイルまたはフォルダー。ファイルを選択 または フォルダーを選択 を使用して選択するか、パスを直接入力します。 |
| クライアント上のターゲットパス | コンテンツが各クライアントに配置される絶対パス。これは必須です。例: C:\Games\SteamLibrary\common\Game または /opt/apps/game。 |
ターゲットパスはクライアントマシン上で有効でなければなりません。クライアントが D: にゲームを保存している場合に C: パスを入力すると、同期が間違った場所に配置されます。
両方のフィールドが入力されたら 同期を公開 を選択します。コンテンツはソースパスから直接クライアントに提供されます。サーバーは2つ目のコピーを保持しません。
同期の仕組み
マニフェストベースの比較
同期が始まると、サーバーは ファイルマニフェスト を生成します。これは同期されるすべてのファイルとそのチェックサムのリストです。各クライアントはこのマニフェストを自身のローカルファイルと比較します。
- クライアントに存在しないファイルはダウンロード対象としてマークされます。
- チェックサムが異なるファイル（つまり変更されたもの）はダウンロード対象としてマークされます。
- 一致するファイルは完全にスキップされます。
サーバーとクライアント間のデルタのみが転送されるため、繰り返しの同期が迅速に行われます。
チャンクベースの転送
大きなファイルはTCPを介して小さなチャンクに分割されて転送されます:
- 信頼性. チャンクが失敗した場合、そのチャンクのみが再試行され、ファイル全体ではありません。
- 進行状況の追跡. 転送の進行状況はチャンクレベルで報告されます。
- ネットワーク効率. チャンクサイズは典型的なLAN条件に合わせて調整されています。
転送は ネットワーク設定 の専用ファイルポートを使用し、デフォルトでは5002です。そのポートがファイアウォールによってブロックされている場合、ファイルはクライアントに届きません。
同期されたフォルダー
同期されたフォルダー リストは、ターゲットパスごとに1行ずつ表示され、各行には最新の公開リリースが表示されます。行にはリリース数、ファイル数、合計サイズが報告されます。更新 を使用してリストを再読み込みします。
行を選択すると、その詳細が右側に表示されます。詳細パネルには、そのソース内のすべてのエントリがパス、種類（ファイルまたはディレクトリ）、サイズ、チェックサムとともに、ソースルートパス、ターゲットパス、公開時間が一覧表示されます。検索ボックスは相対パスまたはターゲットパスでエントリをフィルタリングします。
同期の削除
2つの異なる削除アクションがあります。それぞれ異なることを行います:
- 同期されたフォルダーを削除 は、ターゲットパスを同期リストから削除します。サーバー上のソースファイルには影響しません。
- エントリを削除 は、サーバー上の元のソースパスからアイテムを削除します。これは永久的であり、クライアントにもプッシュされます。HandyCafeは最初に確認を求めます。
両方のアクションには クライアント同期を有効にする がオンである必要があります。
使用例
- ゲームのアップデートを展開する. すべてのゲームPCにゲームパッチを一度にプッシュし、すべてのマシンが同じバージョンを実行するようにします。
- 設定ファイルをプッシュする. 更新されたネットワーク設定やアプリケーションの設定をすべてのクライアントに配布します。
- ソフトウェアを配布する. インストーラーパッケージやポータブルアプリケーションを同期してクライアントPCにアプリケーションをインストールします。
- クライアントメニューのアセットを更新する. クライアントメニューで使用される新しいアイコン、ポスター、メディアファイルを同期します。
ヒント
- 大規模な同期はオフピーク時にスケジュールし、アクティブなセッションが帯域幅を競わないようにします。
- 公開する前にターゲットパスを再確認してください。これは同期が成功したように見えてもクライアントに何も表示されない最も一般的な原因です。
- サーバーとクライアントは同じLAN上にある必要があります。
関連ページ
- ファイルポートの設定については ネットワーク設定 を参照してください。
- 配布したいアセットについては クライアントメニュー を参照してください。
- このページの位置については 設定概要 を参照してください。