クラウドバックアップと自動同期

サービス選択、同期データの範囲、同期方式、自動同期スイッチは自動保存されます。同期間隔は入力欄を離れると保存されます。接続情報と暗号化パスワードも入力欄を離れると自動保存され、空欄への変更も保存されます。必要な設定は同期実行時に確認されます。

WebDAV または GitHub Secret Gist を選び、共有データの定期バックアップ、複数端末間の同期、データ復旧に利用できます。

主な機能

• バックアップと復元：「インポート/エクスポート」ページで同期サービスを選び、JSON バックアップをアップロードまたはダウンロードできます。
• 自動同期：バックグラウンドで定期的に同期し（既定は 1 時間）、選択した方式でデータを統合または上書きします。
• 3 つの同期方式：「統合 / アップロードのみ / ダウンロードのみ」を端末の役割に応じて選べます。
• 競合時の統合：更新日時が新しいアカウント、ブックマーク、設定を優先します。アカウントやブックマークの削除記録も同期し、古いバックアップによる復活を防ぎます。
• WebDAV の書き込み検証：同じディレクトリの一時ファイルへアップロードし、読み戻して検証した後、正式なバックアップへ移動します。坚果云（Nutstore）が既存ファイルへの MOVE に 409 を返した場合は、移動先を削除して再試行します。
• GitHub Secret Gist：GitHub Token で既存の Secret Gist に接続するか、新しい限定公開 Gist を作成できます。Gist へのアップロードは常に暗号化されます。

前提条件

1. WebDAV（Nextcloud、坚果云、Alist WebDAV、NAS など）または GitHub Secret Gist を用意します。
2. WebDAV には読み書き権限のある URL・ユーザー名・パスワード、Gist には GitHub Token とバックアップ暗号化パスワードが必要です。
3. 自動同期を使う場合は、ブラウザーのバックグラウンド実行を許可してください。ブラウザーを終了している間や端末のスリープ中は、定期実行が正常に動作しません。

設定方法

1. 拡張機能 → インポート/エクスポート → クラウド同期 を開きます。
2. 同期サービスで WebDAV または GitHub Secret Gist を選びます。
3. WebDAV の場合は次を入力します。
   • サーバー URL：ディレクトリまたは JSON ファイルを指定します。ディレクトリの場合、その配下の all-api-hub-backup/all-api-hub-1-0.json を使用します。
   • ユーザー名/パスワード：Basic 認証の資格情報です。
4. 接続テスト を実行し、その後にバックアップをアップロードまたはダウンロードします。

GitHub Secret Gist

1. GitHub で Personal Access Token を作成します。fine-grained Token に Gists: Read and write のみを付与する方法を推奨します。classic Token は gist スコープが必要です（GitHub Gist API の権限説明を参照）。Token は現在のブラウザー内に保存され、バックアップには含まれません。
2. GitHub Secret Gist を選び、Token を入力します。既存の Gist は ID または https://gist.github.com/... のリンクを入力します。新規作成時は空欄にできます。
3. 暗号化パスワードを設定し、Secret Gist にアップロード をクリックします。ID が空欄の場合は public: false の限定公開 Gist が自動作成され、all-api-hub-backup.json に暗号化された内容が保存され、ID が自動入力されます。次回以降のアップロードでは同じ Gist が更新されます。
4. 既存の Gist は 接続テスト で、空でないバックアップファイルを含む読み取り可能な Secret Gist か確認します。インポートと同期では復号と形式の検証も行うため、接続テストの成功だけではインポート可能とは限りません。

Secret Gist は一覧に公開されないだけで、アクセス制御ではありません。Token、暗号化パスワード、Gist リンクを保護し、Token をスクリーンショットやバックアップへ含めないでください。手動 JSON エクスポートにも Gist の Token、ID/リンク、暗号化パスワードは含まれません。新しい端末では Gist を再設定してください。既存の WebDAV の手動エクスポート動作は変わりません。

自動同期

同じページで 自動同期 を有効にすると、選択中のサービスを定期的に同期します。

同期の流れ

1. 設定を保存すると、選択中のサービスに合わせてバックグラウンドの定期実行を更新します。
2. 同期時には次の処理を行います。
   • サービスへの接続と資格情報を確認します。
   • リモートバックアップを取得します。WebDAV のバックアップが存在しない場合は、方式に応じて初回バックアップを実行できます。Gist のファイルがない、または空の場合は自動同期を停止するため、先に手動アップロードで初期化してください。
   • ローカルのアカウントと設定をエクスポートし、方式を適用します。
     • 統合：updated_at / lastUpdated が新しい項目を優先します。削除記録も統合し、古いコピーによるアカウントやブックマークの復活を防ぎます。アカウントの競合は項目ごとではなく、アカウント全体で最終更新を優先する LWW 方式です。新しいアカウントはチェックイン設定も含めて古いアカウントを置き換えます。
     • アップロード/ダウンロードのみ：それぞれローカルまたはリモートのデータを使用します。
   • 統合とダウンロードのみでは結果をローカルへ反映し、統合とアップロードのみではバックアップをアップロードします。
   • WebDAV は一時ファイルを検証して正式ファイルと置き換えます。Gist は書き込み前に再取得してリビジョンを比較し、アップロード後も読み戻して内容を検証します。
3. 設定ページで成功・失敗の状態と最終実行時刻を確認できます。

バージョン互換性と複数端末の更新

現在のバックアップ形式は V4 です。旧 V6 アカウントのチェックイン設定は V7 に更新されます。V1～V3 のバックアップは引き続きインポートできます。直前の V3 リーダーは V4 を可能な限り拒否し、古い構造での上書きを防ぎますが、不明なバージョンも許容して解析するさらに古いクライアントの安全性は保証されません。

自動同期を一時停止し、同じバックアップを共有するすべての端末を V7 アカウント対応版へ更新してから同期を再開してください。V6 と V7 のクライアントが同じバックアップへ同時に書き込む構成には対応しません。アカウント全体の LWW により、旧クライアントが V7 のチェックイン設定を V6 アカウントで上書きする可能性があります。旧版へ戻す場合は他の端末の同期を停止し、別のバックアップを残してください。

Gist の書き込み前の確認でリビジョンの変更を検出すると、競合を報告してそのアップロードを停止します。時間をおいて再同期してください。この確認はベストエフォートであり、原子的な条件付き書き込みではありません。確認後に別の端末が書き込む可能性は残るため、できるだけ同期時刻をずらしてください。

自動チェックインと複数端末

アカウントと設定は WebDAV または Gist で同期できますが、当日の実行状態、最近の結果、ブラウザーのアラームは端末間で共有されません。複数端末で毎日のスケジュールを有効にすると、重複してチェックインする可能性があります。避けたい場合は 1 台だけで定期チェックインを有効にしてください。

セキュリティのヒント

• WebDAV のバックアップディレクトリ専用アカウントやアクセストークンを用意し、GitHub Token には必要な Gists 権限のみを付与してください。
• 公共の端末に WebDAV パスワードを保存せず、必要に応じて変更してください。
• WebDAV で 401/403 が発生した場合は資格情報を確認し、Basic 認証と MKCOL/PUT/GET/MOVE/DELETE に対応しているか確認してください。

よくある質問

関連ドキュメント

• 自動更新とリアルタイムデータ
• 自動チェックイン
• Cloudflare ヘルパー